AnalHeapBase(5)AnalHeapBase(5)NAMEAnalHeapBase - Obtains the base address of the analysis heap
SYNOPSIS
#include <cmplrs/atom.anal.h>
unsigned long AnalHeapBase(
void );
DESCRIPTION
An Atom tool's analysis routine calls the AnalHeapBase routine to
obtain the base address of the analysis heap.
Although Atom's default location for the analysis heap is usually suf‐
ficient for most applications, it may sometimes conflict with an
address range used by the application.
Normally, an address conflict would result in a call to malloc return‐
ing zero to the Atom tool's analysis routine. The routine should
check for this case and, if it does occur, ask the tool's user to
select another location for the analysis heap. The -heapbase flag to
the atom command accomplishes this.
RETURN VALUES
The AnalHeapBase routine returns an unsigned long containing the base
address of the analysis heap.
FILES
Header file contain external definitions of routines used by Atom anal‐
ysis routines
SEE ALSO
Commands: atom(1)
Functions: atom_application_instrumentation(5), atom_application_navi‐
gation(5), atom_application_query(5), atom_application_symbols(5),
atom_description_file(5), atom_instrumentation_routines(5),
atom_object_management(5), Thread(5), Xlate(5)
Programmer's Guide
AnalHeapBase(5)