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