ddi_dma_devalign(9f)

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

NAME

6       ddi_dma_devalign - find DMA mapping alignment and minimum transfer size
7

SYNOPSIS

9       #include <sys/conf.h>
10       #include <sys/ddi.h>
11       #include <sys/sunddi.h>
12
13
14
15       int ddi_dma_devalign(ddi_dma_handle_t handle, uint_t *alignment,
16            uint_t *minxfr);
17
18

INTERFACE LEVEL

20       Solaris DDI specific (Solaris DDI). This interface is obsolete.
21

PARAMETERS

23       handle       The   DMAhandle   filled   in  by  a  successful  call  to
24                    ddi_dma_setup(9F).
25
26
27       alignment    A pointer to an unsigned integer to be filled in with  the
28                    minimum required alignment for DMA. The alignment is guar‐
29                    anteed to be a power of two.
30
31
32       minxfr       A pointer to an unsigned integer to be filled in with  the
33                    minimum   effective   transfer  size  (see  ddi_iomin(9F),
34                    ddi_dma_lim_sparc(9S) and ddi_dma_lim_x86(9S)). This  also
35                    is guaranteed to be a power of two.
36
37

DESCRIPTION

39       The  ddi_dma_devalign() Function determines after a successful DMA map‐
40       ping (see ddi_dma_setup(9F)) the minimum required  data  alignment  and
41       minimum DMA transfer size.
42

RETURN VALUES

44       The ddi_dma_devalign() function returns:
45
46       DDI_SUCCESS    The alignment and minxfr values have been filled.
47
48
49       DDI_FAILURE    The handle was illegal.
50
51

CONTEXT

53       The  ddi_dma_devalign() function can be called from user, interrupt, or
54       kernel context.
55

ATTRIBUTES

57       See attributes(5) for descriptions of the following attributes:
58
59
60
61
62       ┌─────────────────────────────┬─────────────────────────────┐
63       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
64       ├─────────────────────────────┼─────────────────────────────┤
65       │Interface Stability          │Obsolete                     │
66       └─────────────────────────────┴─────────────────────────────┘
67