TAU also allows you to dynamically instrument your application using
the DynInst package. There are a few limitation to DyInst: 1) only function
level events will be captured and 2) your application must be compiled with
debugging symbols (-g
).
To install the 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