Manual Pages for UNIX Operating System command usage for man ddi_dma_buf_setup

Kernel Functions for Drivers                ddi_dma_buf_setup(9F)



NAME
     ddi_dma_buf_setup - easier DMA setup  for  use  with  buffer
     structures

SYNOPSIS
     #include 
     #include 



     int ddi_dma_buf_setup(dev_info_t *dip, struct buf *bp, uint_t flags,
          int (*waitfp) (caddr_t),, caddr_t arg, ddi_dma_lim_t *lim,
          ddi_dma_handle_t *handlep);


INTERFACE LEVEL
     This  interface  is  obsolete.   ddi_dma_buf_bind_handle(9F)
     should be used instead.

PARAMETERS
     dip        A pointer to the device's dev_info structure.


     bp         A pointer  to  a  system  buffer  structure  (see
                buf(9S)).


     flags      Flags that go into a ddi_dma_req  structure  (see
                ddi_dma_req(9S)).


     waitfp     The address of a function to call back  later  if
                resources aren't available now. The special func-
                tion addresses DDI_DMA_SLEEP and DDI_DMA_DONTWAIT
                (see  ddi_dma_req(9S)) are taken to mean, respec-
                tively, wait until resources are available, or do
                not wait at all and do not schedule a callback.


     arg        Argument to be passed to a callback function,  if
                such a function is specified.


     lim        A pointer to a DMA limits structure for this dev-
                ice       (see      ddi_dma_lim_sparc(9S)      or
                ddi_dma_lim_x86(9S)). If this pointer is NULL,  a
                default set of DMA limits is assumed.


     handlep    Pointer to a DMA  handle.  See  ddi_dma_setup(9F)
                for a discussion of handle.




SunOS 5.11          Last change: 16 Jan 2006                    1






Kernel Functions for Drivers                ddi_dma_buf_setup(9F)



DESCRIPTION
     The  ddi_dma_buf_setup()  function  is   an   interface   to
     ddi_dma_setup(9F).  It  uses  its  arguments to construct an
     appropriate ddi_dma_req structure and calls  ddi_dma_setup()
     with it.

RETURN VALUES
     See ddi_dma_setup(9F) for the  possible  return  values  for
     this function.

CONTEXT
     The ddi_dma_buf_setup() function can be  called  from  user,
     interrupt,  or  kernel context, except when waitfp is set to
     DDI_DMA_SLEEP, in which case it cannot be called from inter-
     rupt context.

ATTRIBUTES
     See attributes(5) for a description of the following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Stability Level             | Obsolete                    |
    |_____________________________|_____________________________|


SEE ALSO
     attributes(5),   ddi_dma_addr_setup(9F),   ddi_dma_free(9F),
     ddi_dma_htoc(9F),    ddi_dma_setup(9F),    ddi_dma_sync(9F),
     physio(9F),         buf(9S),          ddi_dma_lim_sparc(9S),
     ddi_dma_lim_x86(9S), ddi_dma_req(9S)


     Writing Device Drivers


















SunOS 5.11          Last change: 16 Jan 2006                    2