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
04/27/2007