Settings tab

You can configure the Memory Analysis settings for a running program from the Settings tab:

Memory Analysis tool - Settings tab

Icons

Icon Description
Icon - Refresh Update the current display with the latest data.
Icon - Prevent Auto-refresh Determine whether the IDE automatically refreshes the displayed information when streaming data from the target. When selected, you'll need to click Refresh to update the information.
Icon - Collect Memory Leaks Gather information about any memory leaks encountered.
Icon - Get Snapshots Take a snapshot of the current results.
Icon - Get Traces Obtain a stack trace.

Field descriptions

Group/Field Description
Memory Errors group This group of configuration options controls the Memory Analysis tool's behavior when memory errors are detected.
Enable error detection Detect memory allocation, deallocation, and access errors:
  • Verify parameters in string and memory functions

    When enabled, check the parameters in calls to str*() and mem*() functions for sanity.

  • Perform full heap integrity check on every allocation/deallocation

    When enabled, check the heap's memory chains for consistency before every allocation or deallocation. Note that this checking comes with a performance penalty.

  • Enable bounds checking (where possible)

    When enabled, check for buffer overruns and underruns. Note that this is possible only for dynamically allocated buffers.

When an error is detected Memory Analysis takes the selected action when a memory error is detected. By default, it reports the error and attempts to continue, but you can also choose to launch the debugger or terminate the process.
Limit trace-back depth to Specify the number of stack frames to record when logging a memory error.
Perform leak check every (ms) Specify how often you want to check for leaks. Note that this checking comes with a performance penalty.
Perform leak check when process exits When selected, look for memory leaks when the process exits, before the operating system cleans up the process's resources.
Memory Tracing group This group of configuration options controls the Memory Analysis tool's memory tracing features.
Enable memory allocation/deallocation tracing When selected, trace all memory allocations and deallocations.
Limit back-trace depth to Specify the number of stack frames to record when tracing memory events.
Minimum allocation to trace The size, in bytes, of the smallest allocation to trace. Use 0 to trace all allocations.
Maximum allocation to trace The size, in bytes, of the largest allocation to trace. Use 0 to trace all allocations.
Perform tracing every (ms) How often to collect information about your program's allocation and deallocation activity. When setting this, consider how often your program allocates and deallocates memory, and for how long you plan to run the program.
Memory Snapshots group Control the Memory Analysis tool's memory snapshot feature to capture memory information at a specific time.
Memory Snapshots Enable the capture of memory information to create a snapshot.
Perform snapshot every (ms) Specify the number of milliseconds between each memory snapshot.
Bins counters (comma separated) ex: 8, 16, 32, 1024 ... A comma-separated list of the memory bins you want to trace.
Related concepts
Selecting data
Controlling the page layout
Controlling the overview
Allocations tab
Bins tab
Bands tab
Usage tab
Related tasks
Controlling the detail pane