Memory Blocks

Data Structures
struct	pw_mempool
	A memory pool is a collection of pw_memblocks. More...
struct	pw_memblock
	Memory block structure. More...
struct	pw_memmap
	a mapped region of a pw_memblock More...
struct	pw_mempool_events
struct	pw_map_range
	parameters to map a memory range More...

Macros
#define	PW_MAP_RANGE_INIT   (struct pw_map_range){ 0, }

Enumerations
enum	pw_memblock_flags {   PW_MEMBLOCK_FLAG_NONE = 0, PW_MEMBLOCK_FLAG_READABLE = (1 << 0), PW_MEMBLOCK_FLAG_WRITABLE = (1 << 1), PW_MEMBLOCK_FLAG_SEAL = (1 << 2),   PW_MEMBLOCK_FLAG_MAP = (1 << 3), PW_MEMBLOCK_FLAG_DONT_CLOSE = (1 << 4), PW_MEMBLOCK_FLAG_DONT_NOTIFY = (1 << 5), PW_MEMBLOCK_FLAG_READWRITE = PW_MEMBLOCK_FLAG_READABLE | PW_MEMBLOCK_FLAG_WRITABLE }
	Flags passed to pw_mempool_alloc() More...
enum	pw_memmap_flags {   PW_MEMMAP_FLAG_NONE = 0, PW_MEMMAP_FLAG_READ = (1 << 0), PW_MEMMAP_FLAG_WRITE = (1 << 1), PW_MEMMAP_FLAG_TWICE = (1 << 2),   PW_MEMMAP_FLAG_PRIVATE = (1 << 3), PW_MEMMAP_FLAG_LOCKED = (1 << 4), PW_MEMMAP_FLAG_READWRITE = PW_MEMMAP_FLAG_READ | PW_MEMMAP_FLAG_WRITE }

Functions
struct pw_mempool *	pw_mempool_new (struct pw_properties *props)
	Create a new memory pool. More...
void	pw_mempool_add_listener (struct pw_mempool *pool, struct spa_hook *listener, const struct pw_mempool_events *events, void *data)
	Listen for events. More...
void	pw_mempool_clear (struct pw_mempool *pool)
	Clear a pool. More...
void	pw_mempool_destroy (struct pw_mempool *pool)
	Clear and destroy a pool. More...
struct pw_memblock *	pw_mempool_alloc (struct pw_mempool *pool, enum pw_memblock_flags flags, uint32_t type, size_t size)
	Allocate a memory block from the pool. More...
struct pw_memblock *	pw_mempool_import_block (struct pw_mempool *pool, struct pw_memblock *mem)
	Import a block from another pool. More...
struct pw_memblock *	pw_mempool_import (struct pw_mempool *pool, enum pw_memblock_flags flags, uint32_t type, int fd)
	Import an fd into the pool. More...
void	pw_memblock_free (struct pw_memblock *mem)
	Free a memblock regardless of the refcount and destroy all mappings. More...
int	pw_mempool_remove_id (struct pw_mempool *pool, uint32_t id)
	Remove a memblock for given id. More...
struct pw_memblock *	pw_mempool_find_ptr (struct pw_mempool *pool, const void *ptr)
	Find memblock for given ptr. More...
struct pw_memblock *	pw_mempool_find_id (struct pw_mempool *pool, uint32_t id)
	Find memblock for given id. More...
struct pw_memblock *	pw_mempool_find_fd (struct pw_mempool *pool, int fd)
	Find memblock for given fd. More...
struct pw_memmap *	pw_memblock_map (struct pw_memblock *block, enum pw_memmap_flags flags, uint32_t offset, uint32_t size, uint32_t tag[5])
	Map a region of a memory block. More...
struct pw_memmap *	pw_mempool_map_id (struct pw_mempool *pool, uint32_t id, enum pw_memmap_flags flags, uint32_t offset, uint32_t size, uint32_t tag[5])
	Map a region of a memory block with id. More...
struct pw_memmap *	pw_mempool_import_map (struct pw_mempool *pool, struct pw_mempool *other, void *data, uint32_t size, uint32_t tag[5])
struct pw_memmap *	pw_mempool_find_tag (struct pw_mempool *pool, uint32_t tag[5], size_t size)
	find a map with the given tag More...
int	pw_memmap_free (struct pw_memmap *map)
	Unmap a region. More...

Detailed Description

Macro Definition Documentation

PW_MAP_RANGE_INIT

#define PW_MAP_RANGE_INIT   (struct pw_map_range){ 0, }

Enumeration Type Documentation

pw_memblock_flags

enum pw_memblock_flags

Flags passed to pw_mempool_alloc()

Enumerator
PW_MEMBLOCK_FLAG_NONE
PW_MEMBLOCK_FLAG_READABLE	memory is readable
PW_MEMBLOCK_FLAG_WRITABLE	memory is writable
PW_MEMBLOCK_FLAG_SEAL	seal the fd
PW_MEMBLOCK_FLAG_MAP	mmap the fd
PW_MEMBLOCK_FLAG_DONT_CLOSE	don't close fd
PW_MEMBLOCK_FLAG_DONT_NOTIFY	don't notify events
PW_MEMBLOCK_FLAG_READWRITE

pw_memmap_flags

enum pw_memmap_flags

Enumerator
PW_MEMMAP_FLAG_NONE
PW_MEMMAP_FLAG_READ	map in read mode
PW_MEMMAP_FLAG_WRITE	map in write mode
PW_MEMMAP_FLAG_TWICE	map the same area twice after each other, creating a circular ringbuffer
PW_MEMMAP_FLAG_PRIVATE	writes will be private
PW_MEMMAP_FLAG_LOCKED	lock the memory into RAM
PW_MEMMAP_FLAG_READWRITE

Function Documentation

pw_memblock_free()

void pw_memblock_free

(

struct pw_memblock *

block

)

Free a memblock regardless of the refcount and destroy all mappings.

Free a memblock regardless of the refcount and destroy all mappings.

Parameters

block

a memblock

References mapping::block, NAME, pool, pw_log_debug, SPA_CONTAINER_OF, SPA_ID_INVALID, and spa_return_if_fail.

Referenced by pw_mempool_clear().

pw_memblock_map()

struct pw_memmap* pw_memblock_map	(	struct pw_memblock *	block,
		enum pw_memmap_flags	flags,
		uint32_t	offset,
		uint32_t	size,
		uint32_t	tag[5]
	)

Map a region of a memory block.

References pool, and SPA_CONTAINER_OF.

pw_memmap_free()

int pw_memmap_free

(

struct pw_memmap *

map

)

Unmap a region.

References mapping::block, fd, memmap::link, mempool::map, memmap::mapping, NAME, pool, pw_memmap::ptr, pw_log_debug, mapping::ref, SPA_CONTAINER_OF, spa_list_remove(), memblock::this, and memmap::this.

pw_mempool_add_listener()

void pw_mempool_add_listener	(	struct pw_mempool *	pool,
		struct spa_hook *	listener,
		const struct pw_mempool_events *	events,
		void *	data
	)

Listen for events.

References SPA_CONTAINER_OF, and spa_hook_list_append().

pw_mempool_alloc()

struct pw_memblock* pw_mempool_alloc	(	struct pw_mempool *	pool,
		enum pw_memblock_flags	flags,
		uint32_t	type,
		size_t	size
	)

Allocate a memory block from the pool.

Allocate a memory block from the pool.

Parameters

pool	the pool to use
flags	memblock flags
type	the requested memory type one of enum spa_data_type
size	size to allocate

Returns

a memblock structure or NULL with errno on error

References fd, flags, memblock::mappings, memblock::memmaps, pool, ref, size, SPA_CONTAINER_OF, spa_list_init(), memblock::this, and type.

Referenced by pw_control_add_link().

pw_mempool_clear()

void pw_mempool_clear

(

struct pw_mempool *

pool

)

Clear a pool.

References NAME, pw_log_debug, pw_memblock_free(), SPA_CONTAINER_OF, spa_list_consume, and memblock::this.

Referenced by pw_mempool_destroy().

pw_mempool_destroy()

void pw_mempool_destroy

(

struct pw_mempool *

pool

)

Clear and destroy a pool.

References NAME, pw_log_debug, pw_mempool_clear(), pw_mempool_emit_destroy, SPA_CONTAINER_OF, and spa_hook_list_clean().

Referenced by pw_context_destroy().

pw_mempool_find_fd()

struct pw_memblock* pw_mempool_find_fd	(	struct pw_mempool *	pool,
		int	fd
	)

Find memblock for given fd.

pw_mempool_find_id()

struct pw_memblock* pw_mempool_find_id	(	struct pw_mempool *	pool,
		uint32_t	id
	)

Find memblock for given id.

References SPA_CONTAINER_OF.

pw_mempool_find_ptr()

struct pw_memblock* pw_mempool_find_ptr	(	struct pw_mempool *	pool,
		const void *	ptr
	)

Find memblock for given ptr.

References id, memblock::mappings, NAME, mapping::ptr, pw_log_debug, mapping::size, SPA_CONTAINER_OF, spa_list_for_each, SPA_PTROFF, and memblock::this.

Referenced by pw_mempool_import_map().

pw_mempool_find_tag()

struct pw_memmap* pw_mempool_find_tag	(	struct pw_mempool *	pool,
		uint32_t	tag[5],
		size_t	size
	)

find a map with the given tag

References memblock::memmaps, NAME, pw_log_debug, SPA_CONTAINER_OF, spa_list_for_each, pw_memmap::tag, and memmap::this.

pw_mempool_import()

struct pw_memblock* pw_mempool_import	(	struct pw_mempool *	pool,
		enum pw_memblock_flags	flags,
		uint32_t	type,
		int	fd
	)

Import an fd into the pool.

References SPA_CONTAINER_OF.

Referenced by pw_mempool_import_block().

pw_mempool_import_block()

struct pw_memblock* pw_mempool_import_block	(	struct pw_mempool *	pool,
		struct pw_memblock *	mem
	)

Import a block from another pool.

References fd, flags, NAME, pool, pw_log_debug, PW_MEMBLOCK_FLAG_DONT_CLOSE, pw_mempool_import(), and type.

Referenced by pw_mempool_import_map().

pw_mempool_import_map()

struct pw_memmap* pw_mempool_import_map	(	struct pw_mempool *	pool,
		struct pw_mempool *	other,
		void *	data,
		uint32_t	size,
		uint32_t	tag[5]
	)

References mapping::block, pw_memmap::block, map, pw_memmap::offset, pw_mempool_find_ptr(), pw_mempool_import_block(), ref, and SPA_CONTAINER_OF.

pw_mempool_map_id()

struct pw_memmap* pw_mempool_map_id	(	struct pw_mempool *	pool,
		uint32_t	id,
		enum pw_memmap_flags	flags,
		uint32_t	offset,
		uint32_t	size,
		uint32_t	tag[5]
	)

Map a region of a memory block with id.

References SPA_CONTAINER_OF.

pw_mempool_new()

struct pw_mempool* pw_mempool_new

(

struct pw_properties *

props

)

Create a new memory pool.

References NAME, props, pw_log_debug, spa_hook_list_init(), and impl::this.

pw_mempool_remove_id()

int pw_mempool_remove_id	(	struct pw_mempool *	pool,
		uint32_t	id
	)

Remove a memblock for given id.

References SPA_CONTAINER_OF.