ddi_iomin(9f) [xfree86 man page]

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).

PARAMETERS

       dip	       A pointer to the device's dev_info structure.

       initial	       The  initial  minimum  DMA  transfer  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

       ddi_iomin(),  finds  out  the  minimum  DMA transfer 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

       ddi_iomin() returns the minimum DMA transfer 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 or interrupt context.

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.10							    1 Feb 1994							     ddi_iomin(9F)

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). This interface is obsolete.

PARAMETERS

       handle	    The DMAhandle 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

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

RETURN VALUES

       The ddi_dma_devalign() function returns:

       DDI_SUCCESS    The alignment and minxfr values have been filled.

       DDI_FAILURE    The handle was illegal.

CONTEXT

       The ddi_dma_devalign() 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_setup(9F), ddi_iomin(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_dma_devalign(9F)