ddi_dma_htoc(9f)

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

NAME

6       ddi_dma_htoc - convert a DMA handle to a DMA address cookie
7

SYNOPSIS

9       #include <sys/conf.h>
10       #include <sys/ddi.h>
11       #include <sys/sunddi.h>
12
13
14
15       int ddi_dma_htoc(ddi_dma_handle_t handle, off_t off,
16            ddi_dma_cookie_t *cookiep);
17
18

INTERFACE LEVEL

20       This    interface    is   obsolete.   ddi_dma_addr_bind_handle(9F)   or
21       ddi_dma_buf_bind_handle(9F) should be used instead.
22

PARAMETERS

24       handle     The handle filled in by a call to ddi_dma_setup(9F).
25
26
27       off        An offset into the object that handle maps.
28
29
30       cookiep    A pointer to a ddi_dma_cookie(9S) structure.
31
32

DESCRIPTION

34       The  ddi_dma_htoc()  function  takes  a  DMA  handle  (established   by
35       ddi_dma_setup(9F)),  and fills in the cookie pointed to by cookiep with
36       the appropriate address, length, and bus type to be used to program the
37       DMA engine.
38

RETURN VALUES

40       The ddi_dma_htoc() function returns:
41
42       DDI_SUCCESS    Successfully filled in the cookie pointed to by cookiep.
43
44
45       DDI_FAILURE    Failed to successfully fill in the cookie.
46
47

CONTEXT

49       The ddi_dma_htoc() function can be called from user, interrupt, or ker‐
50       nel context.
51

ATTRIBUTES

53       See attributes(5) for a description of the following attributes:
54
55
56
57
58       ┌─────────────────────────────┬─────────────────────────────┐
59       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
60       ├─────────────────────────────┼─────────────────────────────┤
61       │Stability Level              │Obsolete                     │
62       └─────────────────────────────┴─────────────────────────────┘
63