view src/share/tools/IdealGraphVisualizer/README @ 5763:a3d71693e0ce

removed bytecode disassembly from CodeCacheRuntime into separate BytecodeDisassembler class removed VM call for doing bytecode disassembly added support for explicitly excluding classes from JaCoCo (put '// JaCoCo Exclude' somewhere in the source file) added node intrinsics to MaterializeNode added snippets for the UnsignedMath classes each file opened by CFGPrinter now includes a unique id in its name to avoid a race of multiple threads writing to the same file the IdealGraphPrinter uses the new BytecodeDisassembler mechanism teh UnsignedMath class is exclude from JaCoCo processing as it is used in snippets
author Doug Simon <doug.simon@oracle.com>
date Wed, 04 Jul 2012 21:57:49 +0200
parents 2fd52cd64156
children
line wrap: on
line source

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 7 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 7.0 and Java 6 or later.

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.