1.3. Using tau_compiler.sh
Prev     Next

1.3. Using tau_compiler.sh

If you want to instrument a single file, without using a makefile to handle all of the heavy lifting, you can use tau_compiler.sh by itself to instrument a file. Its syntax is: 

% tau_compiler.sh <tau_compiler_options> <compiler> \
    <compiler_options>

The options available for tau_compiler.sh are:

  • -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 gfparse instead 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 well as the place in the callstack where the memory allocation was made.

  • -optIncludeMemory

    For interal 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>

    Reset C 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

Prev     Next
1.2. Installing TAU Compiler  Home  1.4. TAU scripted compilation