tau_wrap(1)

tau_wrap1

Instruments an external library with tau without needing to recompile

Usage

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.

Releases

Unchanged in 2 releases since Debian 8 (Jessie).

  1. 8–9

From tau 2.17.3.1.dfsg-4.2 in Debian 9 (Stretch). Parsed by carta from the page's man source.