PipeWire 1.1.0
Loading...
Searching...
No Matches
mem.h
Go to the documentation of this file.
1/* PipeWire */
2/* SPDX-FileCopyrightText: Copyright © 2018 Wim Taymans */
3/* SPDX-License-Identifier: MIT */
4
5#ifndef PIPEWIRE_MEM_H
6#define PIPEWIRE_MEM_H
7
9
10#ifdef __cplusplus
11extern "C" {
12#endif
13
26 PW_MEMBLOCK_FLAG_READABLE = (1 << 0),
27 PW_MEMBLOCK_FLAG_WRITABLE = (1 << 1),
34};
36enum pw_memmap_flags {
38 PW_MEMMAP_FLAG_READ = (1 << 0),
39 PW_MEMMAP_FLAG_WRITE = (1 << 1),
45};
52struct pw_mempool {
53 struct pw_properties *props;
54};
55
58struct pw_memblock {
59 struct pw_mempool *pool;
60 uint32_t id;
61 int ref;
62 uint32_t flags;
63 uint32_t type;
64 int fd;
65 uint32_t size;
66 struct pw_memmap *map;
67};
70struct pw_memmap {
72 void *ptr;
73 uint32_t flags;
74 uint32_t offset;
75 uint32_t size;
76 uint32_t tag[5];
77};
80#define PW_VERSION_MEMPOOL_EVENTS 0
81 uint32_t version;
82
84 void (*destroy) (void *data);
85
87 void (*added) (void *data, struct pw_memblock *block);
88
90 void (*removed) (void *data, struct pw_memblock *block);
91};
92
94struct pw_mempool *pw_mempool_new(struct pw_properties *props);
95
97void pw_mempool_add_listener(struct pw_mempool *pool,
98 struct spa_hook *listener,
99 const struct pw_mempool_events *events,
100 void *data);
101
103void pw_mempool_clear(struct pw_mempool *pool);
104
106void pw_mempool_destroy(struct pw_mempool *pool);
107
108
111 enum pw_memblock_flags flags, uint32_t type, size_t size);
112
115 struct pw_memblock *mem);
116
119 enum pw_memblock_flags flags, uint32_t type, int fd);
120
122void pw_memblock_free(struct pw_memblock *mem);
123
125static inline void pw_memblock_unref(struct pw_memblock *mem)
126{
127 if (--mem->ref == 0)
128 pw_memblock_free(mem);
129}
130
132int pw_mempool_remove_id(struct pw_mempool *pool, uint32_t id);
133
135struct pw_memblock * pw_mempool_find_ptr(struct pw_mempool *pool, const void *ptr);
136
138struct pw_memblock * pw_mempool_find_id(struct pw_mempool *pool, uint32_t id);
139
141struct pw_memblock * pw_mempool_find_fd(struct pw_mempool *pool, int fd);
142
143
146 enum pw_memmap_flags flags, uint32_t offset, uint32_t size,
147 uint32_t tag[5]);
148
150struct pw_memmap * pw_mempool_map_id(struct pw_mempool *pool, uint32_t id,
151 enum pw_memmap_flags flags, uint32_t offset, uint32_t size,
152 uint32_t tag[5]);
153
154struct pw_memmap * pw_mempool_import_map(struct pw_mempool *pool,
155 struct pw_mempool *other, void *data, uint32_t size, uint32_t tag[5]);
156
158struct pw_memmap * pw_mempool_find_tag(struct pw_mempool *pool, uint32_t tag[5], size_t size);
159
161int pw_memmap_free(struct pw_memmap *map);
162
163
165struct pw_map_range {
166 uint32_t start;
167 uint32_t offset;
168 uint32_t size;
169};
170
171#define PW_MAP_RANGE_INIT (struct pw_map_range){ 0, }
172
175static inline void pw_map_range_init(struct pw_map_range *range,
176 uint32_t offset, uint32_t size,
177 uint32_t page_size)
179 range->offset = SPA_ROUND_DOWN_N(offset, page_size);
180 range->start = offset - range->offset;
181 range->size = SPA_ROUND_UP_N(range->start + size, page_size);
183
188#ifdef __cplusplus
189}
190#endif
191
192#endif /* PIPEWIRE_MEM_H */
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
Definition mem.c:816
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.
Definition mem.c:607
pw_memmap_flags
Definition mem.h:40
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.
Definition mem.c:494
struct pw_mempool * pw_mempool_new(struct pw_properties *props)
Create a new memory pool.
Definition mem.c:144
int pw_memmap_free(struct pw_memmap *map)
Unmap a region.
Definition mem.c:446
int pw_mempool_remove_id(struct pw_mempool *pool, uint32_t id)
Remove a memblock for given id.
Definition mem.c:708
struct pw_memblock * pw_mempool_import_block(struct pw_mempool *pool, struct pw_memblock *mem)
Import a block from another pool.
Definition mem.c:644
void pw_mempool_add_listener(struct pw_mempool *pool, struct spa_hook *listener, const struct pw_mempool_events *events, void *data)
Listen for events.
Definition mem.c:199
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.
Definition mem.c:431
struct pw_memmap * pw_mempool_import_map(struct pw_mempool *pool, struct pw_mempool *other, void *data, uint32_t size, uint32_t tag[5])
Definition mem.c:655
struct pw_memblock * pw_mempool_find_fd(struct pw_mempool *pool, int fd)
Find memblock for given fd.
Definition mem.c:804
static void pw_memblock_unref(struct pw_memblock *mem)
Unref a memblock.
Definition mem.h:131
static void pw_map_range_init(struct pw_map_range *range, uint32_t offset, uint32_t size, uint32_t page_size)
Calculate parameters to mmap() memory into range so that size bytes at offset can be mapped with mmap...
Definition mem.h:182
struct pw_memblock * pw_mempool_find_id(struct pw_mempool *pool, uint32_t id)
Find memblock for given id.
Definition mem.c:790
struct pw_memblock * pw_mempool_find_ptr(struct pw_mempool *pool, const void *ptr)
Find memblock for given ptr.
Definition mem.c:771
void pw_mempool_clear(struct pw_mempool *pool)
Clear a pool.
Definition mem.c:168
void pw_memblock_free(struct pw_memblock *mem)
Free a memblock regardless of the refcount and destroy all mappings.
Definition mem.c:731
pw_memblock_flags
Flags passed to pw_mempool_alloc()
Definition mem.h:28
void pw_mempool_destroy(struct pw_mempool *pool)
Clear and destroy a pool.
Definition mem.c:181
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.
Definition mem.c:367
@ PW_MEMMAP_FLAG_LOCKED
lock the memory into RAM
Definition mem.h:47
@ PW_MEMMAP_FLAG_READ
map in read mode
Definition mem.h:42
@ PW_MEMMAP_FLAG_READWRITE
Definition mem.h:48
@ PW_MEMMAP_FLAG_WRITE
map in write mode
Definition mem.h:43
@ PW_MEMMAP_FLAG_NONE
Definition mem.h:41
@ PW_MEMMAP_FLAG_TWICE
map the same area twice after each other, creating a circular ringbuffer
Definition mem.h:44
@ PW_MEMMAP_FLAG_PRIVATE
writes will be private
Definition mem.h:46
@ PW_MEMBLOCK_FLAG_READWRITE
Definition mem.h:37
@ PW_MEMBLOCK_FLAG_MAP
mmap the fd
Definition mem.h:33
@ PW_MEMBLOCK_FLAG_DONT_NOTIFY
don't notify events
Definition mem.h:35
@ PW_MEMBLOCK_FLAG_READABLE
memory is readable
Definition mem.h:30
@ PW_MEMBLOCK_FLAG_SEAL
seal the fd
Definition mem.h:32
@ PW_MEMBLOCK_FLAG_WRITABLE
memory is writable
Definition mem.h:31
@ PW_MEMBLOCK_FLAG_NONE
Definition mem.h:29
@ PW_MEMBLOCK_FLAG_DONT_CLOSE
don't close fd
Definition mem.h:34
#define SPA_ROUND_UP_N(num, align)
Definition defs.h:332
#define SPA_ROUND_DOWN_N(num, align)
Definition defs.h:330
pipewire/properties.h
parameters to map a memory range
Definition mem.h:171
uint32_t size
page aligned offset to map
Definition mem.h:174
uint32_t offset
offset in first page with start of data
Definition mem.h:173
Memory block structure.
Definition mem.h:63
uint32_t id
unique id
Definition mem.h:65
int fd
fd
Definition mem.h:69
struct pw_mempool * pool
owner pool
Definition mem.h:64
uint32_t flags
flags for the memory block on of enum pw_memblock_flags
Definition mem.h:67
uint32_t size
size of memory
Definition mem.h:70
uint32_t type
type of the fd, one of enum spa_data_type
Definition mem.h:68
int ref
refcount
Definition mem.h:66
struct pw_memmap * map
optional map when PW_MEMBLOCK_FLAG_MAP was given
Definition mem.h:71
a mapped region of a pw_memblock
Definition mem.h:75
uint32_t offset
offset in memblock
Definition mem.h:79
void * ptr
mapped pointer
Definition mem.h:77
uint32_t flags
flags for the mapping on of enum pw_memmap_flags
Definition mem.h:78
uint32_t size
size in memblock
Definition mem.h:80
struct pw_memblock * block
owner memblock
Definition mem.h:76
uint32_t tag[5]
user tag
Definition mem.h:81
Definition mem.h:84
void(* removed)(void *data, struct pw_memblock *block)
a memory block is removed from the pool
Definition mem.h:96
void(* destroy)(void *data)
the pool is destroyed
Definition mem.h:90
void(* added)(void *data, struct pw_memblock *block)
a new memory block is added to the pool
Definition mem.h:93
uint32_t version
Definition mem.h:87
A memory pool is a collection of pw_memblocks.
Definition mem.h:57
Definition properties.h:33
A hook, contains the structure with functions and the data passed to the functions.
Definition hook.h:350