| The Ideal Graph Visualizer is a tool developed to help examine the |
| intermediate representation of C2 which is commonly referred to as the |
| "ideal graph". It was developed in collaboration with the University |
| of Linz in Austria and has been included as part of hotspot since that |
| was the primary target of the tool. The tool itself is fairly general |
| with only a few modules that contain C2 specific elements. |
| |
| The tool is built on top of the NetBeans 6.1 rich client |
| infrastructure and so requires NetBeans to build. It currently |
| requires Java 6 to run as it needs support for JavaScript for its |
| filtering mechanism and assumes it's built into the platform. It |
| should build out of the box with NetBeans 6.1 and Java 6 or later. |
| It's possible to run it on 1.5 by including Rhino on the classpath |
| though that currently isn't working correctly. Support for exporting |
| graphs as SVG can be enabled by adding batik to the classpath which |
| isn't included by default. It can be built on top of NetBeans 6.0 if |
| you change the required modules to be platform7 instead of platform8. |
| |
| The JVM support is controlled by the flag -XX:PrintIdealGraphLevel=# |
| where # is: |
| |
| 0: no output, the default |
| 1: dumps graph after parsing, before matching, and final code. |
| also dumps graph for failed compiles, if available |
| 2: more detail, including after loop opts |
| 3: even more detail |
| 4: prints graph after parsing every bytecode (very slow) |
| |
| By default the JVM expects that it will connect to a visualizer on the |
| local host on port 4444. This can be configured using the options |
| -XX:PrintIdealGraphAddress= and -XX:PrintIdealGraphPort=. |
| PrintIdealGraphAddress can actually be a hostname. |
| |
| Alternatively the output can be sent to a file using |
| -XX:PrintIdealGraphFile=filename. Each compiler thread will get it's |
| own file with unique names being generated by adding a number onto the |
| provided file name. |
| |
| More information about the tool is available at |
| http://wikis.sun.com/display/HotSpotInternals/IdealGraphVisualizer. |
