ata_sg_setup(9) [suse man page]

ATA_SG_SETUP(9) 					       libata Core Internals						   ATA_SG_SETUP(9)

NAME

       ata_sg_setup - DMA-map the scatter-gather table associated with a command.

SYNOPSIS

       int ata_sg_setup(struct ata_queued_cmd * qc);

ARGUMENTS

       qc
	   Command with scatter-gather table to be mapped.

DESCRIPTION

       DMA-map the scatter-gather table associated with queued_cmd qc.

LOCKING

       spin_lock_irqsave(host lock)

RETURNS

       Zero on success, negative on error.

AUTHOR

       Jeff Garzik
	   Author.

COPYRIGHT

Kernel Hackers Manual 2.6.					     July 2010							   ATA_SG_SETUP(9)

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

NAME

       ddi_dma_nextcookie - retrieve subsequent DMA cookie

SYNOPSIS

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

       void ddi_dma_nextcookie(ddi_dma_handle_t handle, ddi_dma_cookie_t *cookiep);

PARAMETERS

       handle	       The handle previously allocated by a call to  ddi_dma_alloc_handle(9F).

       cookiep	       A pointer to a  ddi_dma_cookie(9S) structure.

INTERFACE LEVEL

       Solaris DDI specific (Solaris DDI).

DESCRIPTION

       ddi_dma_nextcookie() retrieves subsequent  DMA cookies for a  DMA object.   ddi_dma_nextcookie() fills in the  ddi_dma_cookie(9S) structure
       pointed to by  cookiep. The ddi_dma_cookie(9S) structure must be allocated prior to calling  ddi_dma_nextcookie().

       The DMA cookie count returned by ddi_dma_buf_bind_handle(9F), ddi_dma_addr_bind_handle(9F), or ddi_dma_getwin(9F) indicates the	number	of
       DMA  cookies  a DMA object consists of. If the resulting cookie count,  N, is larger than 1,  ddi_dma_nextcookie() must be called N-1 times
       to retrieve all
	DMA cookies.

CONTEXT

       ddi_dma_nextcookie() can be called from user, kernel, or interrupt context.

EXAMPLES

       Example 1: process a scatter-gather list of I/O requests

       This example demonstrates the use of  ddi_dma_nextcookie() to process a scatter-gather list of I/O requests.

       /* setup scatter-gather list with multiple DMA cookies */
       ddi_dma_cookie_t    dmacookie;
       uint_t		   ccount;
       ...

       status = ddi_dma_buf_bind_handle(handle, bp, DDI_DMA_READ,
	    NULL, NULL, &dmacookie, &ccount);

       if (status == DDI_DMA_MAPPED) {

	    /* program DMA engine with first cookie */

	    while (--ccount > 0) {
		 ddi_dma_nextcookie(handle, &dmacookie);
		 /* program DMA engine with next cookie */
	    }
       }
       ...

SEE ALSO

       ddi_dma_addr_bind_handle(9F), ddi_dma_alloc_handle(9F), ddi_dma_buf_bind_handle(9F), ddi_dma_unbind_handle(9F), ddi_dma_cookie(9S)

       Writing Device Drivers

SunOS 5.10							    26 Sep 1994 					    ddi_dma_nextcookie(9F)