---
name: "TAU_TRACK_MEMORY_HEADROOM_HERE"
section: "3"
platform: "linux"
package: "tau"
version: "2.17.3.1.dfsg-4.2"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/TAU_TRACK_MEMORY_HEADROOM_HERE"
---

# TAU\_TRACK\_MEMORY\_HEADROOM\_HERE(3)

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

## 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)](/TAU_TRACK_MEMORY_HEADROOM/3.md)