Debug

Files
file	atomic.c
	Debug formatting and state tracking for atomic operations.
file	atomic.h
	Debug tracking for atomic operations.
file	memory.h
	🔍 Memory debugging helpers for tracking allocations in debug builds

Functions
void	debug_memory_ensure_init (void)
	Init the lifecycle of the debug memory module.

Detailed Description

This module provides memory allocation wrappers that track all heap allocations for debugging and leak detection. When DEBUG_MEMORY is defined and NDEBUG is not set, all allocations are recorded in a linked list with source location metadata.

Features

• Allocation Tracking: Records every malloc/calloc/realloc/free with source file and line number
• Memory Statistics: Tracks total allocated, total freed, current usage, and peak memory usage
• Call Counting: Counts malloc, calloc, realloc, and free calls
• Leak Detection: Reports unfreed allocations with source locations
• Thread Safety: Uses mutex-protected access and atomic counters
• Recursion Prevention: Thread-local guard prevents infinite recursion

Usage

Typically used via macros that inject __FILE__ and __LINE__:

#define TRACKED_MALLOC(size) debug_malloc(size, __FILE__, __LINE__)
#define TRACKED_FREE(ptr)    debug_free(ptr, __FILE__, __LINE__)

At program exit, call debug_memory_report() to print memory statistics and any outstanding (leaked) allocations.

Build Modes

• Full tracking (DEBUG_MEMORY + debug build): Full allocation tracking with linked list, atomic statistics, and mutex protection
• Passthrough (DEBUG_MEMORY + NDEBUG): Functions become thin wrappers around standard allocators with no tracking overhead
• Disabled (no DEBUG_MEMORY): Header provides no declarations

See also

debug_memory_report() for generating leak reports

Function Documentation

debug_memory_ensure_init()

void debug_memory_ensure_init

(

void

)

#include <memory.h>

Init the lifecycle of the debug memory module.

Definition at line 1427 of file debug/memory.c.

                                    {
  // No-op in release builds
}

Referenced by asciichat_shared_init().