NAME    [Toc]    [Back]

       AnalHeapBase  -  Obtains  the base address of the analysis
       heap

SYNOPSIS    [Toc]    [Back]

       #include <cmplrs/atom.anal.h>

       unsigned long AnalHeapBase(
               void );

DESCRIPTION    [Toc]    [Back]

       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 sufficient 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 returning 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    [Toc]    [Back]

       The AnalHeapBase routine returns an unsigned long containing
 the base address of the analysis heap.

FILES    [Toc]    [Back]

       Header  file contain external definitions of routines used
       by Atom analysis routines

SEE ALSO    [Toc]    [Back]

       Commands: atom(1)

       Functions:            atom_application_instrumentation(5),
       atom_application_navigation(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)