.\" ** You probably do not want to edit this file directly **
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
.TH "TAU_WRAP" "1" "08/11/2008" "" "Tools"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
tau_wrap \- Instruments an external library with TAU without needing to recompile
.SH "SYNOPSIS"
.HP 9
\fBtau_wrap\fR {\fIpdbfile\fR} {\fIsourcefile\fR} [\-o\ \fIoutputfile\fR] [\-g\ \fIgroupname\fR] [\-i\ \fIheaderfile\fR] [\-f\ \fIselectivefile\fR]
.SH "OPTIONS"
.TP
pdbfile
A pdb file generated by cparse, cxxparse, or f90parse; these commands are found in the [PDT_HOME]/[arch]/bin directory.
.TP
sourcefile
The source file corresponding to the pdbfile.
.TP
\-o outputfile
The filename of the resulting instrumented source file.
.TP
\-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.
.TP
\-i headerfile
By default
tau_wrap
will include Profile/Profile.h; use this option to specify a different header file.
.TP
\-f selectivefile
You can specify a selective instrumentation file that defines how the source file is to be instrumented.
.SH "EXAMPLES"
.PP
.nf
%> tau_wrap hdf5.h.pdb hdf5.h \-o hdf5.inst.c \-f select.tau \-g hdf5
.fi
.sp
.PP
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.