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

# tau\_wrap(1)

Instruments an external library with TAU without needing to recompile

## NAME

tau\_wrap - Instruments an external library with TAU without needing to recompile

## SYNOPSIS

**tau\_wrap** {*pdbfile*} {*sourcefile*} \[-o *outputfile*\] \[-g *groupname*\] \[-i *headerfile*\] \[-f *selectivefile*\]

## OPTIONS

- pdbfile

  A pdb file generated by cparse, cxxparse, or f90parse; these commands are found in the \[PDT\_HOME\]/\[arch\]/bin directory.

- sourcefile

  The source file corresponding to the pdbfile.

- \-o outputfile

  The filename of the resulting instrumented source file.

- \-g groupname

  This associates all the functions profiled as belonging to the this group. Once profiled you will be able to analysis these functions separately.

- \-i headerfile

  By default tau\_wrap will include Profile/Profile.h; use this option to specify a different header file.

- \-f selectivefile

  You can specify a selective instrumentation file that defines how the source file is to be instrumented.

## EXAMPLES

```
%> tau_wrap hdf5.h.pdb hdf5.h -o hdf5.inst.c -f select.tau -g hdf5
```

This specifies the instrumented wrapper library source (hdf5.inst.c), the instrumentation specification file (select.tau) and the group (hdf5). It creates the wrapper/ directory.