heap(1)                   BSD General Commands Manual                  heap(1)

NAME
     heap -- List all the malloc-allocated buffers in the process's heap

SYNOPSIS
     heap [-guessNonObjects] pid

DESCRIPTION
     heap lists the objects currently allocated on the heap of the current
     process.  Any Objective C objects will also be described, listed by
     class.  heap also prints summarizing data.

     The -guessNonObjects option causes leaks to look through the memory con-
     tents of each Objective-C object to find pointers to malloc'ed blocks
     (non-objects), such as the variable array hanging from an NSArray.  These
     referenced blocks of memory are identified as their offset from the start
     of the object (say "NSCFArray[12]").  The count, number of bytes, and
     average size of memory blocks referenced from each different object off-
     set location are listed in the output.

SEE ALSO
     malloc(3), leaks(1), mallochistory(1), vmmap(1)

     Similar graphical applications are part of the developer tools for the
     system.  They are located in /Developer/Applications/Performance Tools.

     ObjectAlloc.app is a graphical application that shows dynamic, real-time
     information about the object and memory use in an application.

     MallocDebug.app is a graphical application that also provides information
     about heap-allocated memory.  It also performs leak analysis.

     heap has the advantage that the data can be immediately parsed by text-
     based tools, and impacts the system less because it is not a full graphi-
     cal application.

BSD                             April 26, 2000                             BSD