File: README.JAVA

package info (click to toggle)
tau 2.15.6b1-4
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 29,200 kB
  • ctags: 20,506
  • sloc: java: 65,016; ansic: 45,889; cpp: 40,242; tcl: 15,473; fortran: 8,357; sh: 7,104; makefile: 3,131; python: 822; sql: 454; f90: 354; csh: 178; xml: 153; perl: 132; yacc: 117; sed: 42; modula3: 29; awk: 19
file content (62 lines) | stat: -rw-r--r-- 2,470 bytes parent folder | download | duplicates (5)
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