150 arena->debug.label = label;
207 arena->debug.error_context = cb ? context : NULL;
259 vsnprintf(message,
sizeof(message), fmt, args);
262 if (arena && arena->debug.error_cb)
264 arena->debug.error_cb(message, arena->debug.error_context);
268 fprintf(stderr,
"[ARENA ERROR]");
269 if (arena && arena->debug.label)
270 fprintf(stderr,
" (%s)", arena->debug.label);
271 fprintf(stderr,
" %s\n", message);
313 fprintf(stderr,
"[ARENA ERROR] %s\n", msg);
354#ifdef ARENA_POISON_MEMORY
357 if (!ptr || size == 0)
360 uint32_t* p = (uint32_t*) ptr;
361 size_t words = size /
sizeof(uint32_t);
362 size_t remaining = size %
sizeof(uint32_t);
364 for (
size_t i = 0; i < words; ++i)
368 memset((uint8_t*) (p + words), 0xEF, remaining);
426#ifdef ARENA_DEBUG_CHECKS
428#define LOG_LOCATION "[%s:%d] (%s)", file, line, func
430void arena_integrity_check(
t_arena* arena,
const char* file,
int line,
const char* func)
438#ifdef ARENA_ENABLE_THREAD_SAFE
439 if (!arena->use_lock || atomic_load_explicit(&arena->is_destroying, memory_order_acquire))
442 if (pthread_mutex_trylock(&arena->lock) != 0)
450 if (!arena->buffer && arena->size > 0)
452 arena_report_error(arena, LOG_LOCATION,
" Buffer is NULL but size is %zu", file, line, func, arena->size);
455 if (arena->offset > arena->size)
457 arena_report_error(arena, LOG_LOCATION,
" Offset (%zu) exceeds size (%zu)", file, line, func, arena->offset,
461 if (arena->stats.peak_usage > arena->size)
463 arena_report_error(arena, LOG_LOCATION,
" Peak usage (%zu) exceeds size (%zu)", file, line, func,
464 arena->stats.peak_usage, arena->size);
467 if (arena->stats.reallocations > arena->stats.allocations)
469 arena_report_error(arena, LOG_LOCATION,
" Reallocations (%zu) exceed allocations (%zu)", file, line, func,
470 arena->stats.reallocations, arena->stats.allocations);
473 if (arena->offset > arena->stats.peak_usage)
475 arena_report_error(arena, LOG_LOCATION,
" Offset (%zu) exceeds peak usage (%zu)", file, line, func,
476 arena->offset, arena->stats.peak_usage);
479 if (arena->stats.wasted_alignment_bytes > arena->stats.bytes_allocated)
481 arena_report_error(arena, LOG_LOCATION,
" Wasted (%zu) exceeds allocated (%zu)", file, line, func,
482 arena->stats.wasted_alignment_bytes, arena->stats.bytes_allocated);
485 if (arena->stats.growth_history_count > 0 && !arena->stats.growth_history)
487 arena_report_error(arena, LOG_LOCATION,
" Growth history count > 0 but pointer is NULL", file, line, func);
490#ifdef ARENA_ENABLE_THREAD_SAFE
491 pthread_mutex_unlock(&arena->lock);
Core public API for the Arena memory allocator.
#define ARENA_ID_LEN
Max characters for arena ID strings.
Debugging utilities and hooks for the arena memory allocator.
void(* arena_error_callback)(const char *message, void *context)
Type for error callback functions.
#define arena_poison_memory(ptr, size)
No-op poison macro when poisoning is disabled.
#define ARENA_POISON_PATTERN
Poison value used when overwriting memory in debug mode.
Runtime statistics tracking and diagnostics for memory arenas.
void arena_generate_id(t_arena *arena)
Generate a unique debug ID for an arena.
void arena_default_error_callback(const char *msg, void *ctx)
Default fallback error callback (prints to stderr).
void arena_set_error_callback(t_arena *arena, arena_error_callback cb, void *context)
Set a custom error callback function for reporting arena errors.
static atomic_int g_arena_id_counter
Global atomic counter for generating unique arena IDs.
void arena_set_debug_label(t_arena *arena, const char *label)
Assign a debug label to an arena.
void arena_report_error(t_arena *arena, const char *fmt,...)
Report an error from an arena using its configured error callback.
The main memory arena structure used for fast allocation.