| // SPDX-License-Identifier: GPL-2.0+ | |
| #ifndef __MEMORY_POOL_H | |
| #define __MEMORY_POOL_H | |
| struct memory_pool; | |
| /** | |
| * Creates a new memory pool object. | |
| * | |
| * @pool_start - starting address of an existing contiguous memory range. | |
| * @pool_size - size in bytes of the contiguous memory range. | |
| * @block_size - fixed size in bytes of each allocation unit. | |
| * | |
| * Returns a pointer to the new memory pool or NULL on error. | |
| */ | |
| struct memory_pool *memory_pool_create(uintptr_t pool_start, size_t pool_size, | |
| size_t block_size); | |
| /** | |
| * Destroyes a memory pool. | |
| * | |
| * Does nothing if @pool == NULL. | |
| */ | |
| void memory_pool_destroy(struct memory_pool *pool); | |
| /** | |
| * Allocates a buffer from the memory pool. | |
| * | |
| * @pool - pointer to an initialized pool. | |
| * @align - desired buffer address alignment, zero or a power of 2. | |
| * @bytes - desired buffer size in bytes. | |
| * | |
| * Returns NULL on error else buffer address. | |
| */ | |
| void *memory_pool_allocate(struct memory_pool *pool, size_t align, | |
| size_t bytes); | |
| /** | |
| * Returns an allocated buffer to the memory pool. | |
| * | |
| * @pool - pointer to an initialized memory pool. | |
| * @ptr - pointer to an previously allocated buffer. | |
| */ | |
| void memory_pool_deallocate(struct memory_pool *pool, void *ptr); | |
| #endif /* __MEMORY_POOL_H */ |