NAME¶
tau_compiler.sh - Instrumenting source files.
SYNOPSIS¶
tau_compiler.sh
[ -p profile] [-optVerbose] [-optQuiet]
[-optPdtDir= dir] [-optPdtF95Opts=opts]
[-optPdtF95Reset= opts] [-optPdtCOpts=opts]
[-optPdtCReset= opts] [-optPdtCxxOpts=opts]
[-optPdtCReset= opts] [-optPdtF90Parser=parser]
[-optGnuFortranParser=parser] [-optPdtUser=opts]
[-optTauInstr=path] [-optDetectMemoryLeaks]
[-optIncludeMemory] [ -optPreProcess]
[-optCPP=path] [ -optCPPOpts=options]
[-optCPPReset= options] [-optTauSelectFile=file]
[-optPDBFile=file] [-optTau=opts]
[-optCompile= opts] [-optTauDefs=opts]
[-optTauIncludes= opts] [-optReset=opts]
[-optLinking= opts] [-optLinkReset=opts]
[-optTauCC= cc] [-optOpariTool=path/opari]
[-optOpariDir= path] [-optOpariOpts=opts]
[-optOpariReset= opts] [-optNoMpi] [-optMpi]
[-optNoRevert] [ -optRevert] [-optKeepFiles]
[-optAppC] [ -optAppCXX] [-optAppF90] {compiler}
[compiler_options]
DESCRIPTION¶
The TAU Compiler provides a simple way to automatically instrument an entire
project. The TAU Compiler can be used on C, C++, fixed form Fortran, and free
form Fortran.
OPTIONS¶
-f tracefile -Specify the Vampir tracefile to be converted.
-optVerbose Turn on verbose debugging messages.
-optQuiet Suppresses excessive output.
-optPdtDir=<dir> The PDT architecture directory. Typically
$(PDTDIR)/$(PDTARCHDIR).
-optPdtF95Opts=<opts> Options for Fortran parser in PDT (f95parse).
-optPdtF95Reset=<opts> Reset options to the Fortran parser to the
given list.
-optPdtCOpts=<opts> Options for C parser in PDT (cparse). Typically
$(TAU_MPI_INCLUDE) $(TAU_INCLUDE) $(TAU_DEFS).
-optPdtCReset=<opts> Reset options to the C parser to the given
list
-optPdtCxxOpts=<opts> Options for C++ parser in PDT (cxxparse).
Typically
$(TAU_MPI_INCLUDE) $(TAU_INCLUDE) $(TAU_DEFS).
-optPdtCReset=<opts> Reset options to the C++ parser to the given
list
-optPdtF90Parser=<parser> Specify a different Fortran parser. For
e.g.,
f90parse instead of
f95parse.
-optGnuFortranParser=<parser> Specify the GNU
gfortran
Fortran parser
gfparseinstead of
f95parse
-optPdtUser=<opts> Optional arguments for parsing source code.
-optTauInstr=<path> Specify location of tau_instrumentor. Typically
$(TAUROOT)/$(CONFIG_ARCH)/bin/tau_instrumentor.
-optDetectMemoryLeaks Instructs TAU to detect any memory leaks in C/C++
programs.TAU then tracks the source location of the memory leak as wellas the
place in the callstack where the memory allocation wasmade.
-optIncludeMemory Forinteral use only
-optPreProcess Preprocess the source code before parsing. Uses
/usr/bin/cpp-P by default.
-optCPP=<path> Specify an alternative preprocessor and pre-process
the sources.
-optCPPOpts=<options> Specify additional options to the C
pre-processor.
-optCPPReset=<options> ResetC preprocessor options to the specified
list.
-optTauSelectFile=<file> Specify selective instrumentation file for
tau_instrumentor
-optPDBFile=<file> Specify PDB file for tau_instrumentor. Skips
parsing stage.
-optTau=<opts> Specify options for tau_instrumentor.
-optCompile=<opts> Options passed to the compiler. Typically
$(TAU_MPI_INCLUDE) $(TAU_INCLUDE) $(TAU_DEFS) .
-optTauDefs=<opts> Options passed to the compiler by TAU. Typically
$(TAU_DEFS) .
-optTauIncludes=<opts> Options passed to the compiler by TAU.
Typically
$(TAU_MPI_INCLUDE) $(TAU_INCLUDE) .
-optReset=<opts> Reset options to the compiler to the given list
-optLinking=<opts> Options passed to the linker. Typically
$(TAU_MPI_FLIBS) $(TAU_LIBS) $(TAU_CXXLIBS) .
-optLinkReset=<opts> Reset options to the linker to the given list.
-optTauCC=<cc> Specifies the C compiler used by TAU.
-optOpariTool=<path/opari> Specifies the location of the Opari
tool.
-optOpariDir=<path> Specifies the location of the Opari directory.
-optOpariOpts=<opts> Specifies optional arguments to the Opari
tool.
-optOpariReset=<opts> Resets options passed to the Opari tool.
-optNoMpi Removes
-l*mpi* libraries during linking (default).
-optMpi Does not remove
-l*mpi* libraries during linking.
-optNoRevert Exit on error. Does not revert to the original compilation
rule on error.
-optRevert Revert to the original compilation rule on error (default).
-optKeepFiles Does not remove intermediate
.pdb and
.inst.*
files.
-optAppC Sets the failsafe C compiler.
-optAppCXX Sets the failsafe C++ compiler.
-optAppF90 Sets the failsafe F90 compiler