Please enable JavaScript to view this site.

Memory Validator Help

The Types tab summarises all the types of objects in the target program.

 

interactiveRead on, or click a part of the images below to jump straight to the help for that area.

 

The left hand side of the view shows controls and a variety of statistics:

 

objects-tab-with-menu

 

 

 The right hand side of the view shows information about event sequence id:

 

objects-tab-seq-activity-columns

 

The view lists of all the objects in the program with their type, size and number allocated as well as other information.

 

You can constrain the displayed objects to those in particular threads or DLLs, and those between watermarks or being tracked by tag trackers.

 

seeAlsoMuch of the statistics and settings here are also relevant for the Sizes tab.

 

 

Types tab

 

At the top of the Types tab is a set of five more tabs allowing you to change the scope within which objects and types are shown in the table.

 

object-tabs

 

Thread instructionStep show stats for an individual thread in the list or All threads (the default)

 

DLL instructionStep show stats for a chosen DLL or All of them (the default)

 

Watermark instructionStep filter the display to show objects used between two watermarks

 

Tag Tracker instructionStep display stats for an individual tag tracker or for All trackers

 

Tag Tracker Macro instructionStep shows amalgamated values of all object types in each tag tracker group, allowing overviews of memory use within each tag

 

 

Colours used in the display

 

Each object type's row is coloured according to whether the object has:

 

objects-colours-red  an increasing count

objects-colours-blue  a decreasing count

objects-colours-gray  a static count - i.e. not recently changed

objects-colours-white  a zero count

 

The importance of each value within most of the columns is highlighted with a percentage bar:

 

objects-colours-dkgreen  the object type with the maximum value in a given column

objects-colours-green  relative contribution of the object value in each column

 

seeAlsoSee also the Data Highlighting dialog to customise the first two colours.

 

 

The data columns

 

The data in each column is summarised below and described in more detail further down, with the help of examples.

 

Some of the header columns display a total for the column underneath the column name.

 

Type

R Size

C Size

Count

Max

Cumulative

% R Size

% C Size

% Objects

R Total

C Total

Seq 1

Add Seq

Del Seq

Cur Seq

Activity

object type  

running allocation size

cumulative allocation size

number of live allocations

maximum number of live allocations

cumulative number of allocations

size as percentage of total running allocations

size as percentage of total cumulative allocations

object count as percentage of total number of objects

running total size (R Size x Count)

cumulative total size (C Size x Cumulative)

sequence id of first allocation of this type

id of most recent allocation

id of most recent deallocation

id of most recent allocation or deallocation

the span between first and most recent event sequence ids

 

To best explain the numbers in each column we'll use a simple example scenario which has a series of char[] allocations and deallocations shown in order of their event sequence id.

 

This event sequence below (not actual code) will be used to demonstrate how some of the figures in the columns would change with each event. Note this would leak allocations s4 and s5.

 

objects-column-example

 

 

Type

 

The type is simply that of the memory allocation, determined by parsing the source code at the allocation location, eg char[] in our example above.

 

When a type cannot be determined, a pseudo-type is created by merging the filename and the line number for the allocation:

 

objects-pseudo-type

 

 

About Running and Cumulative values (R & C)

 

Some of the columns make reference to R or C values.

 

Running (R) values increase with each allocation and then decrease with deallocations, thus giving a snapshot of the live or current state.

 

Cumulative (C) figures only ever increase, ignoring deallocations, so give a quantitative extent of overall or historical activity.

 

 

 

R Total and C Total

 

Although not first in the column order, these two values are used to calculate some of the other column values.

 

R Total instructionStep the running total gives the total size of all live objects of each type

 

C Total instructionStep the cumulative total tells you how much of each type has ever been allocated

 

objects-column-example-rtotal-ctotal

 

 

R Size and C size

 

R Size instructionStep the running size for each object type is R Total / Count - i.e. the average size of all live objects

 

objects-column-example-rsize

 

 

C Size instructionStep the cumulative size for each object type is C Total / Cumulative - i.e. the average size of all allocated objects whether live or freed

 

objects-column-example-csize

 

For objects with a fixed size these values will both always be the size of the object.

 

Objects with an average size calculation have the value prefixed with (Av.):

 

objects-av

 

 

Count, Max and Cumulative

 

Count instructionStep the number of live objects of each type, so in our example the count increases and decreases, resulting in an overall increase of 2

 

Max instructionStep the maximum value that the count ever reaches - i.e. the peak number of live objects at any one time

 

Cumulative instructionStep increases with every single allocation, giving a historical total.

 

objects-column-example-count-max-cum

 

 

Percentage contributions: % R Size, % C Size and % Objects

 

The percentage figures give an indication of how important each type is relative to others:

 

% R Size instructionStep the percentage of total live object sizes represented by each type i.e. the contribution of R Total for each object to that of all object types combined

 

% C Size instructionStep similar to above but for cumulative figures - the contribution of each C Total to that of all object types combined

 

% Objects instructionStep the contribution of each object count to the combined counts of all objects

 

 

Sequence numbers: Seq 1, Add Seq, Del Seq and Cur Seq

 

The sequence numbers show significant event sequence ids relating to each object type:

 

Seq 1 instructionStep the first allocation sequence id for each object type

 

Add Seq instructionStep the sequence id for the most recent allocation
 

Del Seq instructionStep the sequence id for the most recent deallocation

 

If no objects of a type have ever been deleted, the value just shows a hyphen

 

Cur Seq instructionStep the most recent event sequence id related to each object type - usually the greater of Add Seq or Del Seq

 

objects-column-example-seq

 

Looking at the values for the range Seq 1 to Cur Seq helps give an indication of the span of activity of each object type.

 

 

Event sequence id markers

 

The four sequence id columns show markers visualizing the event's position relative to the the total number of events so far.

 

Each row shows green markers denoting the relative position of the first and most recent sequence ids for the object type.

 

In the following example there have been approximately 3000 events to date:

 

objects-tab-seq-markers

 

These markers can help you see the relative timing and order of object type allocation and deallocation much more quickly than scanning through the numbers alone.

 

 

Object activity

 

The 'activity' of an object type is the span between its first allocation id and the most recent event sequence id at which at least one object was still live.

 

The Activity column in the view shows a graph of that lifespan, with the value being the number of events spanned:

 

objects-tab-activity

 

Below are some examples of what the activity graph means, where:

 

Start corresponds to the first known event in the target program

Now indicates the most recent event sequence id for any event in the target program

 

Example 1: Some objects of the given type have been allocated, but none freed

 

activity-1

 

 

Example 2: Some objects of the given type have been allocated, and all have been freed

 

activity-3

 

 

Example 3: Some objects of the given type have been allocated. Some of those have been freed, but not all

 

activity-2

 

Sorting columns

 

Sorted columns are shown yellow. Just click on the column header to change the sorting column or it's sort direction order.

 

object-sorting

 

The sorted column takes effect in each of the five object tab views, Thread, DLL, etc.

 

 

Object tab options

 

Each of the five object tab views has different options at the top, with Tag Tracker Macro having none.

 

objects-thread-options   objects-dll-options   objects-wm-options   objects-tag-options

 

The first two tabs allow you to choose a single Thread or DLL for which to show object types used.

 

The Memory tab topic describes use of the Watermark and Tracker options in detail.

 

The following options are common to all five tabs:

 
objects-common-options

 

 

Updating the display

 

Update Interval (s) instructionStep automatically updates the display at your choice of interval between 0.1 and 60 seconds - or never!

 

Refresh instructionStep updates the display - as does the refresh button on the Tools menu and toolbar

 

With an update interval set to Never, you'll need to use this Refresh button to update the display.

 

 

Local filters and settings

 

Filter... instructionStep shows the local filters dialog for the types tab, allowing you to fine tune what is included or excluded from the display

 

 The filter button also indicates the number of local filters, although not all of these may be enabled
 

num-local-filters

 

seeAlsoSee also the popup menu options to create filters based on the selected object type

 

See the Data Highlighting settings dialog to set the appearance of rows in the table depending on the object count and whether it's increasing or decreasing

 

 

 

Types view popup menuright_mouse_button

 

The following popup menu is available over the data area to allow filter creation or data drill-down.

 

objects-menu

 

 

right_mouse_buttonMenu option: Filters

 

Filter By Type instructionStep creates a filter using the selected object type, so that it is removed from the view
 

Filter By Size instructionStep creates a filter based on the size of the selected object so all rows with an object type of this size are removed

 

Filters created this way are added to the local filters dialog where they can be modified or removed.

 

note Filters apply to each of the five object tabs and do not affect the values in each column - only whether the object type is actually shown in the view.

 

 

right_mouse_buttonMenu option: Showing locations - drilling down into the data

 

The following three options all open the Analysis Tab, adding a callstack for every allocation or deallocation of the selected object type.

 

This enables a deeper inspection of where and how instances of an object type is allocated or freed.

 

Show Allocation Locations instructionStep shows allocations only
 

Show Deallocation Locations instructionStep shows deallocations only
 

Show Allocation and Deallocation Locations instructionStep shows both

 

For example, showing allocations for the following row in the Types tab will show the callstacks for six allocations of various sizes in the Analysis tab below:

 

objects-show-in-analysis1

 

objects-show-in-analysis2