---
name: "tauex"
section: "1"
platform: "linux"
package: "tau"
version: "2.17.3.1.dfsg-4.2"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/tauex"
---

# tauex(1)

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

## 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