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