dma.c File Reference

DMA mappings. More...

#include <assert.h>
#include <errno.h>
#include <ipxe/dma.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
	PROVIDE_DMAAPI_INLINE (flat, dma_map)
	PROVIDE_DMAAPI_INLINE (flat, dma_unmap)
	PROVIDE_DMAAPI_INLINE (flat, dma_alloc)
	PROVIDE_DMAAPI_INLINE (flat, dma_free)
	PROVIDE_DMAAPI_INLINE (flat, dma_umalloc)
	PROVIDE_DMAAPI_INLINE (flat, dma_ufree)
	PROVIDE_DMAAPI_INLINE (flat, dma_set_mask)
	PROVIDE_DMAAPI_INLINE (flat, dma)
static int	dma_op_map (struct dma_device *dma, struct dma_mapping *map, void *addr, size_t len, int flags)
	Map buffer for DMA. More...
static void	dma_op_unmap (struct dma_mapping *map, size_t len)
	Unmap buffer. More...
static void *	dma_op_alloc (struct dma_device *dma, struct dma_mapping *map, size_t len, size_t align)
	Allocate and map DMA-coherent buffer. More...
static void	dma_op_free (struct dma_mapping *map, void *addr, size_t len)
	Unmap and free DMA-coherent buffer. More...
static void *	dma_op_umalloc (struct dma_device *dma, struct dma_mapping *map, size_t len, size_t align)
	Allocate and map DMA-coherent buffer from external (user) memory. More...
static void	dma_op_ufree (struct dma_mapping *map, void *addr, size_t len)
	Unmap and free DMA-coherent buffer from external (user) memory. More...
static void	dma_op_set_mask (struct dma_device *dma, physaddr_t mask)
	Set addressable space mask. More...
	PROVIDE_DMAAPI (op, dma_map, dma_op_map)
	PROVIDE_DMAAPI (op, dma_unmap, dma_op_unmap)
	PROVIDE_DMAAPI (op, dma_alloc, dma_op_alloc)
	PROVIDE_DMAAPI (op, dma_free, dma_op_free)
	PROVIDE_DMAAPI (op, dma_umalloc, dma_op_umalloc)
	PROVIDE_DMAAPI (op, dma_ufree, dma_op_ufree)
	PROVIDE_DMAAPI (op, dma_set_mask, dma_op_set_mask)
	PROVIDE_DMAAPI_INLINE (op, dma)

Detailed Description

DMA mappings.

Definition in file dma.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

PROVIDE_DMAAPI_INLINE() [1/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma_map
	)

PROVIDE_DMAAPI_INLINE() [2/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma_unmap
	)

PROVIDE_DMAAPI_INLINE() [3/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma_alloc
	)

PROVIDE_DMAAPI_INLINE() [4/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma_free
	)

PROVIDE_DMAAPI_INLINE() [5/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma_umalloc
	)

PROVIDE_DMAAPI_INLINE() [6/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma_ufree
	)

PROVIDE_DMAAPI_INLINE() [7/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma_set_mask
	)

PROVIDE_DMAAPI_INLINE() [8/9]

PROVIDE_DMAAPI_INLINE	(	flat	,
		dma
	)

dma_op_map()

static int dma_op_map ( struct dma_device *  dma, struct dma_mapping *  map, void *  addr, size_t  len, int  flags  )

static

Map buffer for DMA.

Parameters

dma	DMA device
map	DMA mapping to fill in
addr	Buffer address
len	Length of buffer
flags	Mapping flags

Return values

rc	Return status code

Definition at line 70 of file dma.c.

                                                            {
        struct dma_operations *op = dma->op;

        if ( ! op )
                return -ENODEV;
        return op->map ( dma, map, addr, len, flags );
}

References addr, dma(), ENODEV, flags, len, map, and op.

dma_op_unmap()

static void dma_op_unmap ( struct dma_mapping *  map, size_t  len  )

static

Unmap buffer.

Parameters

map	DMA mapping
len	Used length

Definition at line 85 of file dma.c.

                                                                 {
        struct dma_device *dma = map->dma;

        assert ( dma != NULL );
        assert ( dma->op != NULL );
        dma->op->unmap ( dma, map, len );
}

References assert(), dma_mapping::dma, dma(), len, map, and NULL.

dma_op_alloc()

static void* dma_op_alloc ( struct dma_device *  dma, struct dma_mapping *  map, size_t  len, size_t  align  )

static

Allocate and map DMA-coherent buffer.

Parameters

dma	DMA device
map	DMA mapping to fill in
len	Length of buffer
align	Physical alignment

Return values

addr	Buffer address, or NULL on error

Definition at line 102 of file dma.c.

                                                        {
        struct dma_operations *op = dma->op;

        if ( ! op )
                return NULL;
        return op->alloc ( dma, map, len, align );
}

References dma(), len, map, NULL, and op.

dma_op_free()

static void dma_op_free ( struct dma_mapping *  map, void *  addr, size_t  len  )

static

Unmap and free DMA-coherent buffer.

Parameters

map	DMA mapping
addr	Buffer address
len	Length of buffer

Definition at line 118 of file dma.c.

                                                                            {
        struct dma_device *dma = map->dma;

        assert ( dma != NULL );
        assert ( dma->op != NULL );
        dma->op->free ( dma, map, addr, len );
}

References addr, assert(), dma_mapping::dma, dma(), len, map, and NULL.

dma_op_umalloc()

static void* dma_op_umalloc ( struct dma_device *  dma, struct dma_mapping *  map, size_t  len, size_t  align  )

static

Allocate and map DMA-coherent buffer from external (user) memory.

Parameters

dma	DMA device
map	DMA mapping to fill in
len	Length of buffer
align	Physical alignment

Return values

addr	Buffer address, or NULL on error

Definition at line 135 of file dma.c.

                                                          {
        struct dma_operations *op = dma->op;

        if ( ! op )
                return NULL;
        return op->umalloc ( dma, map, len, align );
}

References dma(), len, map, NULL, and op.

dma_op_ufree()

static void dma_op_ufree ( struct dma_mapping *  map, void *  addr, size_t  len  )

static

Unmap and free DMA-coherent buffer from external (user) memory.

Parameters

map	DMA mapping
addr	Buffer address
len	Length of buffer

Definition at line 152 of file dma.c.

                                                                             {
        struct dma_device *dma = map->dma;

        assert ( dma != NULL );
        assert ( dma->op != NULL );
        dma->op->ufree ( dma, map, addr, len );
}

References addr, assert(), dma_mapping::dma, dma(), len, map, and NULL.

dma_op_set_mask()

static void dma_op_set_mask ( struct dma_device *  dma, physaddr_t  mask  )

static

Set addressable space mask.

Parameters

dma	DMA device
mask	Addressable space mask

Definition at line 166 of file dma.c.

                                                                        {
        struct dma_operations *op = dma->op;

        if ( op )
                op->set_mask ( dma, mask );
}

References dma(), and op.

PROVIDE_DMAAPI() [1/7]

PROVIDE_DMAAPI	(	op	,
		dma_map	,
		dma_op_map
	)

PROVIDE_DMAAPI() [2/7]

PROVIDE_DMAAPI	(	op	,
		dma_unmap	,
		dma_op_unmap
	)

PROVIDE_DMAAPI() [3/7]

PROVIDE_DMAAPI	(	op	,
		dma_alloc	,
		dma_op_alloc
	)

PROVIDE_DMAAPI() [4/7]

PROVIDE_DMAAPI	(	op	,
		dma_free	,
		dma_op_free
	)

PROVIDE_DMAAPI() [5/7]

PROVIDE_DMAAPI	(	op	,
		dma_umalloc	,
		dma_op_umalloc
	)

PROVIDE_DMAAPI() [6/7]

PROVIDE_DMAAPI	(	op	,
		dma_ufree	,
		dma_op_ufree
	)

PROVIDE_DMAAPI() [7/7]

PROVIDE_DMAAPI	(	op	,
		dma_set_mask	,
		dma_op_set_mask
	)

PROVIDE_DMAAPI_INLINE() [9/9]

PROVIDE_DMAAPI_INLINE	(	op	,
		dma
	)