Name
TAU_TRACK_MEMORY_HEADROOM — Track the headroom (amount of memory for a process to grow) by periodically interrupting the program
Synopsis
C/C++:
TAU_TRACK_MEMORY_HEADROOM();
Fortran:
TAU_TRACK_MEMORY_HEADROOM();
Description
Tracks the amount of memory available for the process before it runs
out of free memory on the heap. This call sets up a signal handler that is
invoked every 10 seconds by an interrupt (this interval may be altered by
using the TAU_SET_INTERRUPT_INTERVAL call). Inside the
interrupt handler, TAU evaluates how much memory it can allocate and
associates it with the callstack using the TAU context events (See TAU_REGISTER_CONTEXT_EVENT). The user can vary the size of the
callstack by setting the environment variable
TAU_CALLPATH_DEPTH (default is 2). This call is useful
on machines like IBM BG/L where no virtual memory (or paging using the swap
space) is present. The amount of heap memory available to the program is
limited by the amount of available physical memory. TAU executes a series
of malloc calls with a granularity of 1MB and determines the amount of
memory available for the program to grow.