annotate src/share/tools/IdealGraphVisualizer/README @ 2765:2fd52cd64156

IdealGraphVisualizer: Upgrade to NetBeans 7.0 as platform
author Peter Hofer <peter.hofer@jku.at>
date Mon, 23 May 2011 18:03:55 +0200
parents f4fe12e429a4
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
222
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
1 The Ideal Graph Visualizer is a tool developed to help examine the
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
2 intermediate representation of C2 which is commonly referred to as the
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
3 "ideal graph". It was developed in collaboration with the University
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
4 of Linz in Austria and has been included as part of hotspot since that
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
5 was the primary target of the tool. The tool itself is fairly general
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
6 with only a few modules that contain C2 specific elements.
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
7
2765
2fd52cd64156 IdealGraphVisualizer: Upgrade to NetBeans 7.0 as platform
Peter Hofer <peter.hofer@jku.at>
parents: 417
diff changeset
8 The tool is built on top of the NetBeans 7 rich client
222
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
9 infrastructure and so requires NetBeans to build. It currently
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
10 requires Java 6 to run as it needs support for JavaScript for its
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
11 filtering mechanism and assumes it's built into the platform. It
2765
2fd52cd64156 IdealGraphVisualizer: Upgrade to NetBeans 7.0 as platform
Peter Hofer <peter.hofer@jku.at>
parents: 417
diff changeset
12 should build out of the box with NetBeans 7.0 and Java 6 or later.
222
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
13
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
14 The JVM support is controlled by the flag -XX:PrintIdealGraphLevel=#
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
15 where # is:
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
16
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
17 0: no output, the default
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
18 1: dumps graph after parsing, before matching, and final code.
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
19 also dumps graph for failed compiles, if available
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
20 2: more detail, including after loop opts
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
21 3: even more detail
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
22 4: prints graph after parsing every bytecode (very slow)
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
23
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
24 By default the JVM expects that it will connect to a visualizer on the
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
25 local host on port 4444. This can be configured using the options
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
26 -XX:PrintIdealGraphAddress= and -XX:PrintIdealGraphPort=.
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
27 PrintIdealGraphAddress can actually be a hostname.
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
28
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
29 Alternatively the output can be sent to a file using
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
30 -XX:PrintIdealGraphFile=filename. Each compiler thread will get it's
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
31 own file with unique names being generated by adding a number onto the
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
32 provided file name.
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
33
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
34 More information about the tool is available at
2a1a77d3458f 6718676: putback for 6604014 is incomplete
never
parents:
diff changeset
35 http://wikis.sun.com/display/HotSpotInternals/IdealGraphVisualizer.