ddi_dma_devalign(9f) [bsd man page]

ddi_dma_devalign(9F)					   Kernel Functions for Drivers 				      ddi_dma_devalign(9F)

NAME

       ddi_dma_devalign - find DMA mapping alignment and minimum transfer size

SYNOPSIS

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

       int ddi_dma_devalign(ddi_dma_handle_t handle, uint_t *alignment, uint_t *minxfr);

INTERFACE LEVEL

       Solaris DDI specific (Solaris DDI).

PARAMETERS

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

       alignment       A  pointer  to an unsigned integer to be filled in with the minimum required alignment for DMA. The alignment is guaranteed
		       to be a power of two.

       minxfr	       A pointer to an	unsigned  integer  to  be  filled  in  with  the  minimum  effective  transfer	size  (see  ddi_iomin(9F),
		       ddi_dma_lim_sparc(9S) and ddi_dma_lim_x86(9S)).	This also is guaranteed to be a power of two.

DESCRIPTION

       ddi_dma_devalign()  determines  after  a successful DMA mapping (see ddi_dma_setup(9F)) the minimum required data alignment and minimum DMA
       transfer size.

RETURN VALUES

       ddi_dma_devalign() returns:

       DDI_SUCCESS     The alignment and minxfr values have been filled.

       DDI_FAILURE     The handle was illegal.

CONTEXT

       ddi_dma_devalign() can be called from user or interrupt context.

SEE ALSO

       ddi_dma_setup(9F), ddi_iomin(9F), ddi_dma_lim_sparc(9S), ddi_dma_lim_x86(9S), ddi_dma_req(9S)

       Writing Device Drivers

SunOS 5.10							    1 Feb 1994						      ddi_dma_devalign(9F)

ddi_iomin(9F)						   Kernel Functions for Drivers 					     ddi_iomin(9F)

NAME

       ddi_iomin - find minimum alignment and transfer size for DMA

SYNOPSIS

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

       int ddi_iomin(dev_info_t *dip, int initial, int streaming);

INTERFACE LEVEL

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

PARAMETERS

       dip	    A pointer to the device's dev_info structure.

       initial	    The  initial minimum DMAtransfer size in bytes. This may be zero or an appropriate dlim_minxfer value for device's ddi_dma_lim
		    structure (see ddi_dma_lim_sparc(9S) or ddi_dma_lim_x86(9S)). This value must be a power of two.

       streaming    This argument, if non-zero, indicates that the returned value should be modified to account for streaming mode  accesses  (see
		    ddi_dma_req(9S) for a discussion of streaming versus non-streaming access mode).

DESCRIPTION

       The  ddi_iomin()  function,  finds  out the minimum DMAtransfer size for the device pointed to by dip. This provides a mechanism by which a
       driver can determine the effects of underlying caches as well as intervening bus adapters on the granularity of a DMA transfer.

RETURN VALUES

       The ddi_iomin() function returns the minimum DMAtransfer size for the calling device, or it returns zero, which means that you  cannot  get
       there from here.

CONTEXT

       This function can be called from user, interrupt, or kernel context.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Obsolete			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       ddi_dma_devalign(9F), ddi_dma_setup(9F), ddi_dma_sync(9F), ddi_dma_lim_sparc(9S), ddi_dma_lim_x86(9S), ddi_dma_req(9S)

       Writing Device Drivers

SunOS 5.11							    04 Apr 2006 						     ddi_iomin(9F)