memory_arena
Loading...
Searching...
No Matches
Functions
arena_create.c File Reference
#include "arena.h"
#include <stdatomic.h>
#include <stdlib.h>
#include <string.h>
+ Include dependency graph for arena_create.c:

Go to the source code of this file.

Functions

static void * arena_alloc_buffer (size_t size)
 Allocate a zero-initialized memory buffer for the arena.
 
static t_arena * arena_alloc_struct (void)
 Allocate and zero-initialize a new arena struct.
 
t_arena * arena_create (size_t size, bool allow_grow)
 
static bool arena_finish_init (t_arena *arena, void *buffer, size_t size, bool allow_grow)
 Finalize the initialization of an arena with a provided buffer.
 
bool arena_init (t_arena *arena, size_t size, bool allow_grow)
 
static bool arena_init_mutex (t_arena *arena)
 Initialize the mutex used for thread-safe arena operations.
 
void arena_init_with_buffer (t_arena *arena, void *buffer, size_t size, bool allow_grow)
 
static void arena_log_and_teardown (t_arena **arena, const char *msg)
 Report an error, destroy the arena, and free its memory.
 
void arena_reinit_with_buffer (t_arena *arena, void *buffer, size_t size, bool allow_grow)
 
static void arena_reset_metadata (t_arena *arena)
 Reset all arena metadata fields to their default initial state.
 
static bool arena_set_allocated_buffer (t_arena *arena, size_t size)
 Allocate and assign a zero-initialized buffer to an arena.
 
static void arena_set_default_label (t_arena *arena, const char *fallback)
 Set a fallback debug label if none is set.
 
static bool arena_set_or_alloc_buffer (t_arena *arena, void *buffer, size_t size)
 Configure an arena's buffer by either assigning a user-provided region or allocating one internally.
 
static void arena_set_user_buffer (t_arena *arena, void *buffer, size_t size)
 Assign a user-provided buffer to an arena without taking ownership.
 

Function Documentation

◆ arena_create()

t_arena * arena_create ( size_t  size,
bool  allow_grow 
)

Definition at line 111 of file arena_create.c.

112{
113 if (size == 0)
114 {
115 arena_report_error(NULL, "arena_create failed: zero size requested");
116 return NULL;
117 }
118
119 t_arena* arena = arena_alloc_struct();
120 if (!arena)
121 return NULL;
122
123 void* buffer = arena_alloc_buffer(size);
124 if (!buffer)
125 {
126 arena_log_and_teardown(&arena, "arena_create: buffer allocation failed");
127 return NULL;
128 }
129
130 if (!arena_finish_init(arena, buffer, size, allow_grow))
131 {
132 arena_log_and_teardown(&arena, "arena_create: init failure");
133 return NULL;
134 }
135
136 arena_set_default_label(arena, "arena_heap");
137 arena_generate_id(arena);
138 return arena;
139}
void arena_generate_id(t_arena *arena)
Generate a unique debug ID for an arena.
void arena_report_error(t_arena *arena, const char *fmt,...)
Report an error from an arena using its configured error callback.
static void arena_log_and_teardown(t_arena **arena, const char *msg)
Report an error, destroy the arena, and free its memory.
static bool arena_finish_init(t_arena *arena, void *buffer, size_t size, bool allow_grow)
Finalize the initialization of an arena with a provided buffer.
static void * arena_alloc_buffer(size_t size)
Allocate a zero-initialized memory buffer for the arena.
static void arena_set_default_label(t_arena *arena, const char *fallback)
Set a fallback debug label if none is set.
static t_arena * arena_alloc_struct(void)
Allocate and zero-initialize a new arena struct.
The main memory arena structure used for fast allocation.

References arena_alloc_buffer(), arena_alloc_struct(), arena_finish_init(), arena_generate_id(), arena_log_and_teardown(), arena_report_error(), and arena_set_default_label().

◆ arena_init()

bool arena_init ( t_arena *  arena,
size_t  size,
bool  allow_grow 
)

Definition at line 190 of file arena_create.c.

191{
192 if (!arena || size == 0)
193 {
194 arena_report_error(NULL, "arena_init failed: invalid arena or size");
195 return false;
196 }
197
198 void* buffer = arena_alloc_buffer(size);
199 if (!buffer)
200 {
201 arena_log_and_teardown(&arena, "arena_init: buffer allocation failed");
202 return NULL;
203 }
204
205 if (!arena_finish_init(arena, buffer, size, allow_grow))
206 {
207 arena_report_error(arena, "arena_init: arena_finish_init failed");
208 free(buffer);
209 return false;
210 }
211
212 arena_set_default_label(arena, "arena_stack");
213 arena_generate_id(arena);
214 return true;
215}

References arena_alloc_buffer(), arena_finish_init(), arena_generate_id(), arena_log_and_teardown(), arena_report_error(), and arena_set_default_label().

◆ arena_init_with_buffer()

void arena_init_with_buffer ( t_arena *  arena,
void *  buffer,
size_t  size,
bool  allow_grow 
)

Definition at line 286 of file arena_create.c.

287{
288 if (!arena)
289 {
290 arena_report_error(NULL, "arena_init_with_buffer: NULL arena");
291 return;
292 }
293
295 atomic_store_explicit(&arena->can_grow, allow_grow, memory_order_release);
296 arena_init_mutex(arena);
297
298 if (!arena_set_or_alloc_buffer(arena, buffer, size))
299 return;
300
301 arena_set_default_label(arena, "arena_from_buffer");
302 arena_generate_id(arena);
303}
static void arena_reset_metadata(t_arena *arena)
Reset all arena metadata fields to their default initial state.
static bool arena_set_or_alloc_buffer(t_arena *arena, void *buffer, size_t size)
Configure an arena's buffer by either assigning a user-provided region or allocating one internally.
static bool arena_init_mutex(t_arena *arena)
Initialize the mutex used for thread-safe arena operations.

References arena_generate_id(), arena_init_mutex(), arena_report_error(), arena_reset_metadata(), arena_set_default_label(), and arena_set_or_alloc_buffer().

◆ arena_reinit_with_buffer()

void arena_reinit_with_buffer ( t_arena *  arena,
void *  buffer,
size_t  size,
bool  allow_grow 
)

Definition at line 361 of file arena_create.c.

362{
363 arena_destroy(arena);
364 arena_init_with_buffer(arena, buffer, size, allow_grow);
365}
void arena_destroy(t_arena *arena)
void arena_init_with_buffer(t_arena *arena, void *buffer, size_t size, bool allow_grow)

References arena_destroy(), and arena_init_with_buffer().