TAU - Tuning and Analysis Utilities -

Tuning and Analysis Utilities

TAU

PRL

1.2. Running an application using DynInstAPI

TAU also allow you to dynamically instrument your application using the DynInst package. There are a few limitation to DyInst-only function level event will be captured and your application must be compiler with debugging symbols: -g.

To install DynInstAPI package, configure TAU with -dyinst= option which will point TAU to where dyninst is installed. Use the tau_run tool to instrument your application at runtime.

The command-line options accepted by tau_run are:

Usage: tau_run [-Xrun<Taulibrary> ][-v][-o outfile] \
       [-f <instrumentation file> ] <application> [args]

By default, libTAU. so is loaded by tau_run. However, the user can override this and specify another file using the -Xrun<Taulibrary>. In this case lib<Taulibrary>.so will be loaded using LD_LIBRARY_PATH.

To use tau_run, TAU is configured with DyninstAPI as shown below:

% configure -dyninst=/usr/local/packages/dyninstAPI
% make install
% cd tau/examples/dyninst
% make install
% tau_run klargest 2500 23
% pprof; paraprof

Support for new platforms and compilers is being added and this DyninstAPI option is experimental for now.