NAME

       TAU_TRACK_MEMORY_HEADROOM_HERE - Takes a sample of the amount of memory available at a
       given point.

SYNOPSIS

       C/C++:

       TAU_TRACK_MEMORY_HEADROOM_HERE(void);

       Fortran:

       TAU_TRACK_MEMORY_HEADROOM_HERE(void);

DESCRIPTION

       Instead of relying on a periodic interrupt to track the amount of memory available to
       grow, this call may be used to take a sample at a given location in the source code.
       Context events are used to track the amount of memory headroom.

EXAMPLE

       C/C++ :

       ary = new double [1024*1024*50];
       TAU_TRACK_MEMORY_HEADROOM_HERE();

       Fortran :

       INTEGER, ALLOCATABLE :: STORAGEARY(:)
       allocate(STORAGEARY(1:999), STAT=IERR)
       TAU_TRACK_MEMORY_HEADROOM_HERE();

SEE ALSO

       TAU_TRACK_MEMORY_HEADROOM(3)

                                            08/31/2005                    TAU_TRACK_MEMORY_HEA(3)