ddi_dma_free(9F)

NAME

     ddi_dma_free - release system DMA resources

SYNOPSIS

     #include <sys/ddi.h>
     #include <sys/sunddi.h>

     int ddi_dma_free(ddi_dma_handle_t handle);

INTERFACE LEVEL

     This interface is obsolete.  ddi_dma_free_handle(9F)  should
     be used instead.

PARAMETERS

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

DESCRIPTION

     ddi_dma_free() releases  system  DMA  resources  set  up  by
     ddi_dma_setup(9F). When a DMA transfer completes, the driver
     should free up system DMA resources established by a call to
     ddi_dma_setup(9F). This is done by a call to ddi_dma_free().
     ddi_dma_free() does an implicit ddi_dma_sync(9F) for you  so
     any further synchronization steps are not necessary.

RETURN VALUES

     ddi_dma_free() returns:

     DDI_SUCCESS
           Successfully released resources

     DDI_FAILURE
           Failed to free resources

CONTEXT

     ddi_dma_free() can be called from user or interrupt 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_buf_setup(9F),              ddi_dma_free_handle(9F),
     ddi_dma_htoc(9F), ddi_dma_sync(9F), ddi_dma_req(9S)
     Writing Device Drivers