Debug

Files
file	memory.h
	🔍 Memory debugging helpers for tracking allocations in debug builds

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