Filtering Heap Information: dheap –filter

Depending upon the way in which your program manages memory, MemoryScape might be managing a lot of information. You can filter this information down to focus on things that are important to you at the moment by using filters. These filters can only be created using the GUI. However, after you create a filter using the GUI, you can apply it from within the CLI by using the dheap –filter commands.

Here is an excerpt from a CLI interaction:

d1.<> dheap -filter -list

Filtering of heap reports is 'disabled'
Individual filters are set as follows:

Disabled MyFilter Function contains strdup

d1.<> dheap -filter -enable MyFilter

d1.<> dheap -filter -enable

d1.<> dheap -filter -list

Filtering of heap reports is 'enabled'

Individual filters are set as follows:
Enabled MyFilter Function contains strdup

d1.<>

Notice that TotalView automatically knew about your filters. That is, it always reads your filter file. However, TotalView ignores the file until you both enable the file and enable filtering. That is, while the following two commands look about the same, they are different:

dheap -filter -enable MyFilter
dheap -filter -enable

The first command tells MemoryScape that it could use the information contained within the MyFilter filter. However, MemoryScape only uses it after you enter the second command.