1ddi_dma_free(9F)         Kernel Functions for Drivers         ddi_dma_free(9F)
2
3
4

NAME

6       ddi_dma_free - release system DMA resources
7

SYNOPSIS

9       #include <sys/ddi.h>
10       #include <sys/sunddi.h>
11
12
13
14       int ddi_dma_free(ddi_dma_handle_t handle);
15
16

INTERFACE LEVEL

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

PARAMETERS

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

DESCRIPTION

26       The ddi_dma_free() function releases system DMA  resources  set  up  by
27       ddi_dma_setup(9F).  When  a  DMA  transfer completes, the driver should
28       free up system DMA resources established  by  a  call  to  ddi_dma_set‐
29       up(9F).  This  is done by a call to ddi_dma_free(). ddi_dma_free() does
30       an implicit ddi_dma_sync(9F) for you  so  any  further  synchronization
31       steps are not necessary.
32

RETURN VALUES

34       The ddi_dma_free() function returns:
35
36       DDI_SUCCESS    Successfully released resources
37
38
39       DDI_FAILURE    Failed to free resources
40
41

CONTEXT

43       The ddi_dma_free() function can be called from user, interrupt, or ker‐
44       nel context.
45

ATTRIBUTES

47       See attributes(5) for a description of the following attributes:
48
49
50
51
52       ┌─────────────────────────────┬─────────────────────────────┐
53       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
54       ├─────────────────────────────┼─────────────────────────────┤
55       │Stability Level              │Obsolete                     │
56       └─────────────────────────────┴─────────────────────────────┘
57

SEE ALSO

59       attributes(5),      ddi_dma_addr_setup(9F),      ddi_dma_buf_setup(9F),
60       ddi_dma_free_handle(9F),       ddi_dma_htoc(9F),      ddi_dma_sync(9F),
61       ddi_dma_req(9S)
62
63
64       Writing Device Drivers
65
66
67
68SunOS 5.11                        16 Jan 2006                 ddi_dma_free(9F)
Impressum