Manual Pages for UNIX Operating System command usage for man ddi_dma_coff

Kernel Functions for Drivers                     ddi_dma_coff(9F)



NAME
     ddi_dma_coff - convert a DMA cookie to an  offset  within  a
     DMA handle.

SYNOPSIS
     #include 
     #include 
     #include 



     int ddi_dma_coff(ddi_dma_handle_t handle, ddi_dma_cookie_t *cookiep,
          off_t *offp);


INTERFACE LEVEL
     Solaris SPARC DDI (Solaris SPARC  DDI).  This  interface  is
     obsolete.

PARAMETERS
     handle     The   handle   filled   in   by   a    call    to
                ddi_dma_setup(9F).


     cookiep    A    pointer    to    a    DMA    cookie     (see
                ddi_dma_cookie(9S)) that contains the appropriate
                address, length and bus type to be used  in  pro-
                gramming the DMA engine.


     offp       A pointer to an offset to be filled in.


DESCRIPTION
     The ddi_dma_coff()  function  converts  the  values  in  DMA
     cookie  pointed  to  by cookiep to an offset (in bytes) from
     the beginning of the object that the DMAhandle has mapped.


     The ddi_dma_coff() function allows a driver to update a  DMA
     cookie  with  values  it  reads from its device's DMA engine
     after a transfer completes and convert that  value  into  an
     offset into the object that is mapped for DMA.

RETURN VALUES
     The ddi_dma_coff() function returns:

     DDI_SUCCESS    Successfully filled in offp.


     DDI_FAILURE    Failed to successfully fill in offp.




SunOS 5.11          Last change: 16 Jan 2006                    1






Kernel Functions for Drivers                     ddi_dma_coff(9F)



CONTEXT
     The ddi_dma_coff() function can be called from user,  inter-
     rupt, or kernel context.

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



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


SEE ALSO
     ddi_dma_setup(9F), ddi_dma_sync(9F), ddi_dma_cookie(9S)


     Writing Device Drivers

































SunOS 5.11          Last change: 16 Jan 2006                    2