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)