1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62
|
*****************************************************************************
** Tuning and Analysis Utilities **
** http://www.cs.uoregon.edu/research/paracomp/tau **
*****************************************************************************
** Copyright 1997-2004 **
** Department of Computer and Information Science, University of Oregon **
** Advanced Computing Laboratory, Los Alamos National Laboratory **
** Research Center Juelich, ZAM Germany **
*****************************************************************************
To use TAU with JAVA, you'll need Java 2 (jdk1.2+).
1) Configuration
For profiling
% ./configure -c++=g++ -jdk=/usr/local/packages/jdk1.2
For tracing
% ./configure -c++=g++ -jdk=/usr/local/packages/jdk1.2 -TRACE
For both profiling and tracing
% ./configure -c++=g++ -jdk=/usr/local/packages/jdk1.4.x -TRACE -PROFILE
2) Installing
% make install
3) Running an example
% set path=($path <taudir>/<tauarch>/bin)
% setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH:<taudir>/<tauarch>/lib
% cd examples/java/pi
% java -XrunTAU Pi 200000
(java -version shows the version of JVM).
4) Selective instrumentation
To exclude certain classes, you may use the -XrunTAU:exclude=<classes> flag.
e.g., to exclude java/*, sun/*, com/* methods, you may use:
% java -XrunTAU:exclude=java,sun,com Pi 200000
To exclude all methods (and *not* incur the JVMPI method invocation overhead), you may use the -XrunTAU:nomethods flag as:
% java -XrunTAU:nomethods Pi 20000
This allows you to use source level timers (see examples/java/api for an example) and generate accurate multi-threaded performance data without the JVMPI overhead.
5) Displaying profiles/traces
For Profiling:
% pprof
% paraprof
pprof is for text profile display and paraprof is the GUI.
For Tracing:
First merge the traces using tau_merge
% tau_merge tautrace*.trc Pi.trc
Then convert to Vampir trace format
% tau_convert -vampir Pi.trc tau.edf Pi.pv
Download and install Vampir (free evaluation license typically lasts for a
month) from http://www.pallas.de.
% vampir Pi.pv
Then assign colors to the groups by choosing the menu option
Preferences -> Colors -> Activities.
See TAU user's Guide for further details on using racy and Vampir.
For any comments/suggestions/questions on TAU, please send mail to
tau-bugs@cs.uoregon.edu
|