NAME

       tauex - Allows you to choose a tau/papi configuration at runtime.

SYNOPSIS

       tauex [-v] [-u User mode counts] [-k Kernel mode counts] [-S Supervisor mode counts]
             [-I Interrupt mode counts] [-a] [-m] [-e PAPI event] [-T TAU option]
             [-XrunTAU TAU options] {--} {executable} [executable options]

DESCRIPTION

       Replace this script by the execuable during runtime to dynamically load a TAU
       profiling/tracing option or to select which papi events/domain to use during execuation of
       the application. If we compile TAU with the -optShared option and link in the libTAU.so,
       At runtime tauex will set the LD_LIBRARY_PATH and pass any other parameters (or papi
       events) to the program and execute it with the specified TAU measurement option.

OPTIONS

       -v     Verbose mode.

       -a     Count all native events (implies -m).

       -m     Multiple runs (enough runs to gather all events).

       -u User mode counts
              Instructs PAPI to only count user events.

       -k Kernel mode counts
              Instructs PAPI to only count kernel events.

       -S Supervisor mode counts
              Instructs PAPI to only count Supervisor/Hypervisor events.

       -I Interrupt mode counts
              Instructs PAPI to only count Interrupt events.

       -e PAPI event
              set the PAPI to profile this native or local event.

       -T TAU option
              Profiles the application with this TAU option (requires TAU to be built with this
              option).

       Application executable
              The Application you want TAU or PAPI to profile.

       Application option
              Any Application options you need to specify.

EXAMPLE

       mpirun -np 2 tauex -e PAPI_TOT_CYC -e PAPI_FP_OPS -T MPI,PROFILE -- ./ring

                                            08/11/2008                                   TAUEX(1)