IBM Visualization Data Explorer Programmer's Reference

DXPrintAlloc

Function

Prints a summary of memory use.

Syntax
#include <dx/dx.h> void DXPrintAlloc(int t)

Functional Details

This routine can be run from Data Explorer, with the Usage module, in script mode or in the user interface. When it is run, memory areas should be quiescent (on a multiprocessor system, for example, no other tasks should be running). The parameter t specifies the level of detail of the printout:

0 Prints out a summary of the current use of memory, both in small and in large areas. A typical printout might look like:

0: small: 4194304 = hdr 16472 + used 486864 + free 3920
                              + pool 3687048 (limit 4194304)
0: large: 2097152 = hdr 16472 + used 494656 + free 29704
                              + pool 1558120 (limit 54525952)

where:

small
is the total number of bytes currently managed by the memory manager for the small arena.
large
is the total number of bytes currently managed by the memory manager for the large arena.
hdr
is the amount of memory space used by internal data structures.
used
is the amount of memory space allocated for use.
free
is the amount of memory previously used and available for reuse.
pool
is the amount of memory space allocated to Data Explorer but not yet used.
limit
is the largest amount of memory that can be managed by the memory manager.

Prints one line for every individual allocated block, stating its size and address.

In addition to the information for allocated blocks (how = 1), prints the same information for every freed block.

Return Value

None.

13.3 , "Memory Allocation".

[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]

[IBM Home Page | Order | Search | Contact IBM | Legal ]