DMA_POOL_CREATE

Section: Memory Management in Linux (9)
Updated: February 2011
Index Return to Main Contents

NAME

dma_pool_create - Creates a pool of consistent memory blocks, for dma.

SYNOPSIS

struct dma_pool * dma_pool_create(const char * name, struct device * dev, size_t size, size_t align, size_t boundary);

ARGUMENTS

name

: name of pool, for diagnostics

dev

: device that will be doing the DMA

size

: size of the blocks in this pool.

align

: alignment requirement for blocks; must be a power of two

boundary

: returned blocks won't cross this power of two boundary

CONTEXT

!in_interrupt

DESCRIPTION

Returns a dma allocation pool with the requested characteristics, or null if one can't be created. Given one of these pools, dma_pool_alloc may be used to allocate memory. Such memory will all have lqconsistentrq DMA mappings, accessible by the device and its driver without using cache flushing primitives. The actual size of blocks allocated may be larger than requested because of alignment.