tau_poe — Instruments a MPI application while it is being executed with poe.


tau_poe [ -XrunTAUsh- tauOptions ] { applcation } [ poe options ]


This tool dynamically instruments a mpi application by loading a specific mpi library file.


tauOptions To instrument a mpi application a specific TAU library file is loaded when the application is executed. To select which library is loaded use this option. The library files are build according to the options set when TAU is configured. The library file that have been build and thus available for use are in the [TAU_HOME]/[arch]/lib directory. The file are listed as libTAUsh-*.so where * is the instrumentation options. For example to use the file let the comman line option be -XrunTAUsh-pdt-openmp-opari.


Instrument a.out wit the currently configured options and then run it on four nodes:

%>tau_poe ./a.out -procs 4

Select the library to instrument a.out with:

%>tau_poe -XrunTAUsh-mpi ./a.out -procs 4