Tool options and environment variables

The following table lists the librcheck environment variables and the corresponding UI options (if applicable):
Environment variable Where to find in Memory Analysis UI What option to set Additional information
LD_PRELOAD=librcheck.so Advanced Settings Runtime library The library file is librcheck.so.
MALLOC_ACTION=number Memory Errors When an error is detected Set the error action behavior to: 0 to ignore, 1 to abort, 2 to exit, 3 for core, and 4 to stop.
MALLOC_CKACCESS=1 Memory Errors Verify parameters in string and memory functions Check strings and memory functions for errors.
MALLOC_CKBOUNDS=1 Memory Errors Enable bounds checking (where possible) Check for out of bounds errors.
MALLOC_CKALLOC=1 Memory Errors Enable check on realloc()/free() argument Check that the pointers passed to realloc() and free() point to memory that the allocator manages.
MALLOC_CKCHAIN=1 Memory Errors Perform a full heap integrity check on every allocation/deallocation Check the allocator chain integrity for every allocation/deallocation.
MALLOC_CTHREAD=1|2 Advanced Settings Create control thread Start a control thread. Set to 1 to allow the IDE to send commands to the application through /dev/rcheck. Set to 2 to allow the IDE to send commands using signals.
MALLOC_CTRL_FILE=file N/A N/A Specify a file for the control command (to use with the control signal). You can use ${pid} in the filename to add the process ID and escape $ if running from the shell.
MALLOC_CTRL_SIG=sigs N/A N/A Override the default signals (e.g., "control:41,leaks:42, start:44,stop:43, marker:45").
MALLOC_DUMP_LEAKS=1 Memory Errors Perform leak check when process exits Enable the dumping of leaks on exit.
MALLOC_EVENTBTDEPTH=number Memory Tracing Limit back-trace depth to: 5 Set the error traces depth to a specific number.
MALLOC_FATAL=0 Memory Errors When an error is detected Specify how to handle a fatal error. The list of supported numeric values for this variable is given in the mallopt() reference.
MALLOC_FILE=file Advanced Settings Target output file or device Redirect output to a file. You can use ${pid} in the filename to replace with process ID and escape $ if running from the shell.
MALLOC_HANDLE_SIGNALS=0 N/A N/A When the value is 0, don't install signal handlers.
MALLOC_HELP=1 N/A N/A Print a list of used environment variables.
MALLOC_SAMPLING=millis N/A N/A Run sampling thread to produce heap statistics every millis milliseconds.
MALLOC_START_TRACING=1 Memory Tracing Enable memory allocation/deallocation tracing Enable memory tracing (0 to disable).
MALLOC_STAT_BINS=bin1,bin2,... Memory Snapshots Bin counters (comma separated) e.g. 8, 16, 32, 1024 Set custom bins.
MALLOC_TRACEBTDEPTH=number Memory Tracing Limit back-trace depth to Set the allocation traces depth to a specific number.
MALLOC_TRACEMAX=number Memory Tracing Maximum allocation to trace Only trace the allocation for the <= number of bytes.
MALLOC_TRACEMIN=number Memory Tracing Minimum allocation to trace Only trace the allocation for the >= number of bytes.
MALLOC_TRUNCATE=1 N/A N/A Truncate the output files before writing.
MALLOC_USE_CACHE=number N/A N/A Set to 0 to disable optimization. The default is 32.
MALLOC_VERBOSE=1 Advanced Settings Show debug output on console A value of 1 enables the debug output.
MALLOC_WARN=0 Memory Errors When an error is detected Specify how to handle a warning. The list of supported numeric values for this variable is given in the mallopt() reference.