manual.html revision 0
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<html>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<head>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <meta content="deepa viswanathan" name="Author">
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <meta content="Mozilla/4.04 [en] (WinNT; U) [Netscape]"
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright name="GENERATOR">
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <title>HPROF Agent</title>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <meta name="author" content="Kelly O'Hair">
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright</head>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<body alink="#ff0000" bgcolor="#ffffff" link="#0000ee" text="#000000"
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright vlink="#551a8b">
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<h1 style="text-align: center;"><a name="mozTocId137594"
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright class="mozTocH1"></a><span style="font-weight: bold;"></span>HPROF
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek GathrightAgent<br>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright</h1>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<h2><a name="mozTocId558923" class="mozTocH2"></a>Contents</h2>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<span style="text-decoration: underline;"></span>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<ol id="mozToc">
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<!--mozToc h1 1 h2 2 h3 3 h4 4 h5 5 h6 6--><li><a href="#mozTocId137594">HPROF
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek GathrightAgent</a>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <ol>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <li><a href="#mozTocId558923">Contents</a></li>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <li><a href="#mozTocId550204">Overview</a></li>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <li><a href="#mozTocId634758">Start-up</a></li>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <li><a href="#mozTocId708821">Heap Allocation
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek GathrightProfiles (heap=sites) </a></li>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <li><a href="#mozTocId634725">Heap Dump (heap=dump)</a></li>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <li><a href="#mozTocId546448">CPU Usage Sampling
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek GathrightProfiles (cpu=samples) </a></li>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <li><a href="#mozTocId116568">CPU Usage Times Profile (cpu=times)
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright </a></li>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <li><a href="#mozTocId848088">Binary Dump Format
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright(format=b)</a>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <ol>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <li><a href="#mozTocId348369">Socket Connection and
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek GathrightCommunication</a></li>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright </ol>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <ol>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <li><a href="#mozTocId348360">Handling of Arrays</a></li>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright </ol>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright </li>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright <li><a href="#mozTocId589424">Source Code </a></li>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright </ol>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright </li>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright</ol>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<span style="text-decoration: underline;"></span>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<h2><a name="mozTocId550204" class="mozTocH2"></a>Overview</h2>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<p>This document describes the JVM TI Agent HPROF delivered in
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightthe Java Development Kit (JDK). It is intended as demonstration code
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightfor JVM TI, and as a functional
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightreplacement for the older HPROF JVMPI Agent delivered in past releases.<br>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright</p>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek GathrightPrevious 1.4 and earlier releases of the JDK contained an HPROF
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightagent built on the experimental JVMPI.&nbsp;
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek GathrightThe newer JVM TI replaces both JVMDI and JVMPI.&nbsp;&nbsp;
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<p><span style="font-weight: bold;">Note</span>: Differences between
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightthis HPROF implementation and the older JVMPI based HPROF are marked in
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<span style="font-style: italic; color: rgb(255, 0, 0);">RED ITALICS</span>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightthroughout this document.<br>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright</p>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<br>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<h2><a name="mozTocId634758" class="mozTocH3"></a>Start-up</h2>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<p>HPROF is a simple profiler agent shipped with the JDK. It is
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrighta dynamically-linked
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightlibrary that interacts with the JVM TI and
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightwrites out profiling
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightinformation either to a file or to a socket in ascii or binary format.
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek GathrightThis information can
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightbe further processed by a profiler front-end tool.</p>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<p>It is capable of presenting CPU usage, heap allocation statistics
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightand monitor contention
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightprofiles. In addition it can also report complete heap dumps and states
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightof all the monitors and threads in the Java virtual machine.
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright</p>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<p>HPROF can be invoked by:
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright</p>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<pre>java -<span style="font-weight: bold;">agentlib:</span><b>hprof</b> ToBeProfiledClass</pre>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek GathrightDepending on the type of profiling requested, HPROF instructs the
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightvirtual machine to send it the relevant JVM TI events and processes
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightthe event data into profiling information. For example, the following
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathrightcommand obtains the heap allocation profile:
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek Gathright<pre>java -agentlib:hprof=heap=sites ToBeProfiledClass</pre>
319dda44f5f6791ff8c130f3200eca33bd3f3c7fDerek GathrightFollowing is the complete list of options that can passed to hprof :
<blockquote>
<pre>java -agentlib:hprof=help<br><br> HPROF: Heap and CPU Profiling Agent (JVMTI Demonstration Code)<br><br>hprof usage: java -agentlib:hprof=[help]|[&lt;option&gt;=&lt;value&gt;, ...]<br><br>Option Name and Value Description Default<br>--------------------- ----------- -------<br>heap=dump|sites|all heap profiling all<br>cpu=samples|times|old CPU usage off<br>monitor=y|n monitor contention n<br>format=a|b text(txt) or binary output a<br>file=&lt;file&gt; write data to file java.hprof[{.txt}]<br>net=&lt;host&gt;:&lt;port&gt; send data over a socket off<br>depth=&lt;size&gt; stack trace depth 4<br>interval=&lt;ms&gt; sample interval in ms 10<br>cutoff=&lt;value&gt; output cutoff point 0.0001<br>lineno=y|n line number in traces? y<br>thread=y|n thread in traces? n<br>doe=y|n dump on exit? y<br>msa=y|n Solaris micro state accounting n<br>force=y|n force output to &lt;file&gt; y<br>verbose=y|n print messages about dumps y<br><br>Obsolete Options<br>----------------<br>gc_okay=y|n<br><br>Examples<br>--------<br> - Get sample cpu information every 20 millisec, with a stack depth of 3:<br> java -agentlib:hprof=cpu=samples,interval=20,depth=3 classname<br> - Get heap usage information based on the allocation sites:<br> java -agentlib:hprof=heap=sites classname<br><br>Notes<br>-----<br> - The option format=b cannot be used with monitor=y.<br> - The option format=b cannot be used with cpu=old|times.<br> - Use of the -Xrunhprof interface can still be used, e.g.<br> java -Xrunhprof:[help]|[&lt;option&gt;=&lt;value&gt;, ...]<br> will behave exactly the same as:<br> java -agentlib:hprof=[help]|[&lt;option&gt;=&lt;value&gt;, ...]<br><br>Warnings<br>--------<br> - This is demonstration code for the JVMTI interface and use of BCI,<br> it is not an official product or formal part of the JDK.<br> - The -Xrunhprof interface will be removed in a future release.<br> - The option format=b is considered experimental, this format may change<br> in a future release.<br></pre>
</blockquote>
<p>By default, heap profiling information (sites and dump) is written
out
to java.hprof.txt (ascii).&nbsp;
The monitor=y|n option has proven to be problematic and may be replaced
with something more useful.<br>
</p>
<p>The output in most cases will contain ID's for traces, threads,
objects, etc.&nbsp; Each type of ID will typically start with a
different number than the other ID's, e.g. traces might start with
300000.<br>
</p>
<p><span style="font-weight: bold;">Note</span>: <span
style="font-style: italic; color: rgb(255, 0, 0);">The gc_okay option
is no longer supported.</span><br>
</p>
<h2><a name="mozTocId708821" class="mozTocH4"></a>Heap Allocation
Profiles (heap=sites)<br>
</h2>
Following is the heap allocation profile generated by running the Java
compiler
(<code>javac</code>) on a set of input files. Only parts of the
profiler output are shown here.
<p></p>
<pre>Command used: javac -J-agentlib:hprof=heap=sites Hello.java<br><br>SITES BEGIN (ordered by live bytes) Fri Feb 6 13:13:42 2004<br> percent live alloc'ed stack class<br> rank self accum bytes objs bytes objs trace name<br> 1 44.13% 44.13% 1117360 13967 1117360 13967 301926 java.util.zip.ZipEntry<br> 2 8.83% 52.95% 223472 13967 223472 13967 301927 com.sun.tools.javac.util.List<br> 3 5.18% 58.13% 131088 1 131088 1 300996 byte[]<br> 4 5.18% 63.31% 131088 1 131088 1 300995 com.sun.tools.javac.util.Name[]<br> <br></pre>
A crucial piece of information in heap profile is the amount of
allocation that occurs
in various parts of the program. The <code>SITES</code> record above
tells us that 44.13% of the total space was allocated for
java.util.zip.ZipEntry objects. Note that the amount of live data is
only a fraction
of the total allocation that has occurred at a given site; the rest has
been garbage collected.
<p>A good way to relate allocation sites to the source code is to
record
the dynamic stack traces that led to the heap allocation. Following is
another part of the profiler output that illustrates the stack traces
referred to by the four allocation sites in output shown above.
<span style="font-family: monospace;"><br>
</span></p>
<pre><span style="font-family: monospace;"></span>TRACE 301926:<br> java.util.zip.ZipEntry.&lt;init&gt;(ZipEntry.java:101)<br> java.util.zip.ZipFile+3.nextElement(ZipFile.java:417)<br> com.sun.tools.javac.jvm.ClassReader.openArchive(ClassReader.java:1374)<br> com.sun.tools.javac.jvm.ClassReader.list(ClassReader.java:1631)<br><br>TRACE 301927:<br> com.sun.tools.javac.util.List.&lt;init&gt;(List.java:42)<br> com.sun.tools.javac.util.List.&lt;init&gt;(List.java:50)<br> com.sun.tools.javac.util.ListBuffer.append(ListBuffer.java:94)<br> com.sun.tools.javac.jvm.ClassReader.openArchive(ClassReader.java:1374)<br><br>TRACE 300996:<br> com.sun.tools.javac.util.Name$Table.&lt;init&gt;(Name.java:379)<br> com.sun.tools.javac.util.Name$Table.&lt;init&gt;(Name.java:481)<br> com.sun.tools.javac.util.Name$Table.make(Name.java:332)<br> com.sun.tools.javac.util.Name$Table.instance(Name.java:349)<br><br>TRACE 300995:<br> com.sun.tools.javac.util.Name$Table.&lt;init&gt;(Name.java:378)<br> com.sun.tools.javac.util.Name$Table.&lt;init&gt;(Name.java:481)<br> com.sun.tools.javac.util.Name$Table.make(Name.java:332)<br> com.sun.tools.javac.util.Name$Table.instance(Name.java:349)<init><init><init><br></init></init></init></pre>
<blockquote></blockquote>
<p>
Each frame in the stack trace contains class name, method name, source
file name, and the line number. The user can set the maximum number
of frames collected by the HPROF agent. The default limit is 4. Stack
traces reveal not only which methods performed heap allocation, but
also which methods were ultimately responsible for making calls that
resulted in memory allocation. <br>
</p>
<h2><a name="mozTocId634725" class="mozTocH2"></a>Heap Dump (heap=dump)</h2>
A complete dump of the current live objects in the heap can be obtained
with:<br>
<pre>Command used: javac -J-agentlib:hprof=heap=dump Hello.java<br></pre>
This is a very large output file, but can be viewed and searched in any
editor.<br>
<br>
<h2><a name="mozTocId546448" class="mozTocH4"></a>CPU Usage Sampling
Profiles (cpu=samples)<br>
</h2>
HPROF can collect CPU usage information by sampling threads. Following
is part of the output collected from a run
of the <code>javac</code> compiler.
<p></p>
<pre>Command used: javac -J-agentlib:hprof=cpu=samples Hello.java<br><br>CPU SAMPLES BEGIN (total = 462) Fri Feb 6 13:33:07 2004<br>rank self accum count trace method<br> 1 49.57% 49.57% 229 300187 java.util.zip.ZipFile.getNextEntry<br> 2 6.93% 56.49% 32 300190 java.util.zip.ZipEntry.initFields<br> 3 4.76% 61.26% 22 300122 java.lang.ClassLoader.defineClass2<br> 4 2.81% 64.07% 13 300188 java.util.zip.ZipFile.freeEntry<br> 5 1.95% 66.02% 9 300129 java.util.Vector.addElement<br> 6 1.73% 67.75% 8 300124 java.util.zip.ZipFile.getEntry<br> 7 1.52% 69.26% 7 300125 java.lang.ClassLoader.findBootstrapClass<br> 8 0.87% 70.13% 4 300172 com.sun.tools.javac.main.JavaCompiler.&lt;init&gt;<br> 9 0.65% 70.78% 3 300030 java.util.zip.ZipFile.open<br> 10 0.65% 71.43% 3 300175 com.sun.tools.javac.main.JavaCompiler.&lt;init&gt;<br><init>
...
CPU SAMPLES END
</init></pre>
<blockquote>
</blockquote>
<p>
The HPROF agent periodically samples the stack of all running threads
to record the most frequently active stack traces. The <code>count</code>
field above indicates how many times a particular stack trace was found
to be active. These stack traces correspond to the CPU usage hot spots
in the application.<br>
</p>
<h2><a name="mozTocId116568" class="mozTocH2"></a>CPU Usage Times
Profile (cpu=times)<br>
</h2>
HPROF can collect CPU usage information by injecting code into every
method entry and exit, keeping track of exact method call counts and
the time spent in each method. This uses Byte Code Injection (BCI) and
runs considerably slower than cpu=samples. Following is part of the
output collected from a run
of the <code>javac</code> compiler.
<p></p>
<pre>Command used: javac -J-agentlib:hprof=cpu=times Hello.java<br><br>CPU TIME (ms) BEGIN (total = 2082665289) Fri Feb 6 13:43:42 2004<br>rank self accum count trace method<br> 1 3.70% 3.70% 1 311243 com.sun.tools.javac.Main.compile<br> 2 3.64% 7.34% 1 311242 com.sun.tools.javac.main.Main.compile<br> 3 3.64% 10.97% 1 311241 com.sun.tools.javac.main.Main.compile<br> 4 3.11% 14.08% 1 311173 com.sun.tools.javac.main.JavaCompiler.compile<br> 5 2.54% 16.62% 8 306183 com.sun.tools.javac.jvm.ClassReader.listAll<br> 6 2.53% 19.15% 36 306182 com.sun.tools.javac.jvm.ClassReader.list<br> 7 2.03% 21.18% 1 307195 com.sun.tools.javac.comp.Enter.main<br> 8 2.03% 23.21% 1 307194 com.sun.tools.javac.comp.Enter.complete<br> 9 1.68% 24.90% 1 306392 com.sun.tools.javac.comp.Enter.classEnter<br> 10 1.68% 26.58% 1 306388 com.sun.tools.javac.comp.Enter.classEnter<br><br>...<br>CPU TIME (ms) END</pre>
Here the count represents the true count of the times this method was
entered, and the percentages represent a measure of thread CPU time
spent in those methods.<br>
<br>
<h2><a class="mozTocH3" name="mozTocId848088"></a>Binary Dump Format
(format=b)</h2>
The basic fields in the binary output are u1 (1 byte), u2 (2 byte), u4
(4 byte), and u8 (8 byte). An ID in this implementation is a u4,
however the size of an ID is really determined by the "size of
identifiers" field in the header.<br>
<br>
<span style="font-weight: bold;">WARNING</span>: This format is still
considered highly experimental, however, all attempts were made to
match the format of past HPROF implementations.<br>
<br>
The binary output begins with the information:<br>
<br>
<table style="text-align: left; width: 100%; height: 124px;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">[u1]*<br>
</td>
<td style="vertical-align: top;">An initial NULL terminated
series of bytes representing the format name and version, in this
implementation and historically, the string "JAVA PROFILE 1.0.1" (18
u1 bytes) followed by a NULL byte. If the TAG "HEAP DUMP SEGMENT" is
used this string will be "JAVA PROFILE 1.0.2". </td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">size of identifiers. Identifiers
are used to represent UTF8 strings, objects, stack traces, etc. They
can have the same size as host pointers or sizeof(void*), but are not
required to be.<span style="color: rgb(0, 0, 0);"></span></td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">high word of number of
milliseconds since 0:00 GMT, 1/1/70</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">low word of number of
milliseconds since 0:00 GMT, 1/1/70</td>
</tr>
</tbody>
</table>
<br>
Followed by a se<span style="font-family: monospace;"></span>quence of
records that look like:<br>
<br>
<table style="text-align: left; width: 100%;" border="1" cellpadding="2"
cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u1<br>
</td>
<td style="vertical-align: top;">TAG: denoting the type of the
record</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">TIME: number of microseconds
since the
time stamp in the header<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">LENGTH: number of bytes that
follow this
u4 field and belong to this record<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">[u1]*<br>
</td>
<td style="vertical-align: top;">BODY: as many bytes as specified
in
the above u4 field<br>
</td>
</tr>
</tbody>
</table>
<br>
<br>
The following TAGs are supported:<br>
<br>
<table style="text-align: left; width: 100%;" border="1" cellpadding="2"
cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">STRING IN UTF8<br>
</td>
<td style="vertical-align: top;">0x01<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">ID for this string<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">[u1]*<br>
</td>
<td style="vertical-align: top;">UTF8 characters for string
(NOT NULL terminated)<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">LOAD CLASS<br>
</td>
<td style="vertical-align: top;">0x02<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">class serial number
(always &gt; 0)<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">class object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">stack trace serial number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">class name string ID<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">UNLOAD CLASS<br>
</td>
<td style="vertical-align: top;">0x03<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">class serial number<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">STACK FRAME<br>
</td>
<td style="vertical-align: top;">0x04<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">stack frame ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">method name string ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">method signature string ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">source file name string ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">class serial number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">&gt; 0<br>
</td>
<td style="vertical-align: top;">line number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">0<br>
</td>
<td style="vertical-align: top;">no line information
available<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">-1<br>
</td>
<td style="vertical-align: top;">unknown location<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">-2<br>
</td>
<td style="vertical-align: top;">compiled method (<span
style="font-style: italic; color: rgb(255, 0, 0);">Not implemented</span>)<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">-3<br>
</td>
<td style="vertical-align: top;">native method (<span
style="color: rgb(255, 0, 0); font-style: italic;">Not implemented</span>)<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">STACK TRACE<br>
</td>
<td style="vertical-align: top;">0x05<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">stack trace serial number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">thread serial number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">number of frames<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">[ID]*<br>
</td>
<td style="vertical-align: top;">series of stack frame ID's<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ALLOC SITES<br>
</td>
<td style="vertical-align: top;">0x06<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u2<br>
</td>
<td style="vertical-align: top;">Bit mask flags:<br>
<table style="text-align: left; width: 441px; height: 74px;"
border="1" cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">0x1<br>
</td>
<td style="vertical-align: top;">incremental vs.
complete<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">0x2<br>
</td>
<td style="vertical-align: top; text-align: left;">sorted
by allocation vs. line<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">0x4<br>
</td>
<td style="vertical-align: top;">whether to force GC
(<span style="font-style: italic; color: rgb(255, 0, 0);">Not
Implemented</span>)<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">cutoff ratio (floating
point)<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">total live bytes<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">total live instances<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u8<br>
</td>
<td style="vertical-align: top;">total bytes allocated<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u8<br>
</td>
<td style="vertical-align: top;">total instances allocated<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">number of sites that
follow:<br>
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u1<br>
</td>
<td style="vertical-align: top;">array indicator: 0
means not an array, non-zero means an array of this type (See <a
href="#Basic_Type">Basic Type</a>)<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">class serial number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">stack trace serial
number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">number of live bytes<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">number of live
instances<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">number of bytes
allocated<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">number of instances
allocated<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">HEAP SUMMARY<br>
</td>
<td style="vertical-align: top;">0x07<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">total live bytes<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">total live instances<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u8<br>
</td>
<td style="vertical-align: top;">total bytes allocated<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u8<br>
</td>
<td style="vertical-align: top;">total instances allocated<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">START THREAD<br>
</td>
<td style="vertical-align: top;">0x0A<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">thread serial number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">thread object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">stack trace serial number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">thread name string ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">thread group name ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">thread parent group name ID<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">END THREAD<br>
</td>
<td style="vertical-align: top;">0x0B<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">thread serial number<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">HEAP DUMP<br>
<span style="font-style: italic;">or</span><br>
HEAP DUMP SEGMENT<br>
</td>
<td style="vertical-align: top;">0x0C<br>
<span style="font-style: italic;">or</span><br>
0x1C<br>
</td>
<td style="vertical-align: top;">Contains any number of sub-tags,
each begins a u1 field (no order implied here):<br>
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ROOT UNKNOWN<br>
</td>
<td style="vertical-align: top;">0xFF<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">object ID<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ROOT JNI GLOBAL<br>
</td>
<td style="vertical-align: top;">0x01<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">JNI global ref ID<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ROOT JNI LOCAL<br>
</td>
<td style="vertical-align: top;">0x02<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">thread serial number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">frame number in
stack trace (-1 for empty)<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ROOT JAVA FRAME<br>
</td>
<td style="vertical-align: top;">0x03<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">thread serial number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">frame number in
stack trace (-1 for empty)</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ROOT NATIVE STACK<br>
</td>
<td style="vertical-align: top;">0x04<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">thread serial number<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ROOT STICKY CLASS<br>
</td>
<td style="vertical-align: top;">0x05<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">object ID<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ROOT THREAD BLOCK<br>
</td>
<td style="vertical-align: top;">0x06<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">thread serial number<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ROOT MONITOR USED<br>
</td>
<td style="vertical-align: top;">0x07<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">object ID<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ROOT THREAD OBJECT<br>
</td>
<td style="vertical-align: top;">0x08<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">thread object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">thread serial number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">stack trace serial
number<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">CLASS DUMP<br>
</td>
<td style="vertical-align: top;">0x20<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">class object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">stack trace serial
number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">super class object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">class loader object
ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">signers object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">protection domain
object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">reserved<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">reserved<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">instance size (in
bytes)<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u2<br>
</td>
<td style="vertical-align: top;">size of constant
pool and number of records that follow:<br>
<table style="text-align: left; width: 100%;"
border="1" cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u2<br>
</td>
<td style="vertical-align: top;">constant pool
index<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u1<br>
</td>
<td style="vertical-align: top;">type of entry:
(See <a href="#Basic_Type">Basic Type</a>)<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">value<br>
</td>
<td style="vertical-align: top;">value of entry
(u1, u2, u4, or u8 based on type of entry)<span
style="font-style: italic; color: rgb(255, 0, 0);"></span><br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u2<br>
</td>
<td style="vertical-align: top;">Number of static
fields:<br>
<table style="text-align: left; width: 100%;"
border="1" cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">static field
name string ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u1<br>
</td>
<td style="vertical-align: top;">type of field:
(See <a href="#Basic_Type">Basic Type</a>)<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">value<br>
</td>
<td style="vertical-align: top;">value of entry
(u1, u2, u4, or u8 based on type of field) <span
style="font-style: italic; color: rgb(255, 0, 0);"></span><br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u2<br>
</td>
<td style="vertical-align: top;">Number of instance
fields (not including super class's)<br>
<table style="text-align: left; width: 100%;"
border="1" cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">field name
string ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u1<br>
</td>
<td style="vertical-align: top;">type of field:
(See <a href="#Basic_Type">Basic Type</a>)<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">INSTANCE DUMP<br>
</td>
<td style="vertical-align: top;">0x21<br>
</td>
<td style="vertical-align: top;"><br>
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">stack trace serial
number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">class object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">number of bytes that
follow<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">[value]*<br>
</td>
<td style="vertical-align: top;">instance field
values (this class, followed by super class, etc)<span
style="font-style: italic; color: rgb(255, 0, 0);"></span><br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">OBJECT ARRAY DUMP<br>
</td>
<td style="vertical-align: top;">0x22<br>
</td>
<td style="vertical-align: top;"><br>
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">array object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">stack trace serial
number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">number of elements<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">array class object
ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">[ID]*<br>
</td>
<td style="vertical-align: top;">elements<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">PRIMITIVE ARRAY DUMP<br>
</td>
<td style="vertical-align: top;">0x23<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">array object ID<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">stack trace serial
number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">number of elements<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u1<br>
</td>
<td style="vertical-align: top;">element type (See <a
href="#Basic_Type">Basic Type</a>)<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">[u1]*<br>
</td>
<td style="vertical-align: top;">elements (packed
array) </td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">HEAP DUMP END<br>
</td>
<td style="vertical-align: top;">0x2C<br>
</td>
<td style="vertical-align: top;">Terminates a series of HEAP DUMP
SEGMENTS.&nbsp; Concatenation of HEAP DUMP SEGMENTS equals a HEAP DUMP.<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">CPU SAMPLES<br>
</td>
<td style="vertical-align: top;">0x0D<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">total number of samples<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">number of traces that
follow:<br>
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">number of samples<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">stack trace serial
number<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">CONTROL SETTINGS<br>
</td>
<td style="vertical-align: top;">0x0E<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">Bit mask flags:<br>
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">0x1<br>
</td>
<td style="vertical-align: top;">alloc traces on/off<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">0x2<br>
</td>
<td style="vertical-align: top;">cpu sampling on/off<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u2<br>
</td>
<td style="vertical-align: top;">stack trace depth<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
</tbody>
</table>
<span style="font-weight: bold;"><br>
</span><a name="Basic_Type"></a>Basic Type
<table style="text-align: left; width: 296px; height: 221px;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">2<br>
</td>
<td style="vertical-align: top;">object<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">4<br>
</td>
<td style="vertical-align: top;">boolean<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">5<br>
</td>
<td style="vertical-align: top;">char<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">6<br>
</td>
<td style="vertical-align: top;">float<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">7<br>
</td>
<td style="vertical-align: top;">double<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">8<br>
</td>
<td style="vertical-align: top;">byte<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">9<br>
</td>
<td style="vertical-align: top;">short<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">10<br>
</td>
<td style="vertical-align: top;">int<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">11<br>
</td>
<td style="vertical-align: top;">long<br>
</td>
</tr>
</tbody>
</table>
<h3><a name="mozTocId348360" class="mozTocH3"></a>Handling of Arrays</h3>
<br>
There will be a "LOAD CLASS" tag for type type of each array
in the dump. In the LOAD CLASS record, the class name string ID
will refer to a string with a human-readable name of the array
type that is formatted as the type name would be in Java source
code. Thus, the LOAD CLASS record for the type char[] will
be "char[]", for short[][][] will be "short[][][]" and for
MyType[] will be "MyType[]".
<br>
<h3><a name="mozTocId348369" class="mozTocH3"></a>Socket Connection and
Communication</h3>
<br>
<span style="font-weight: bold;">WARNING</span>: This command format is
still
considered highly experimental, however, all attempts were made to
match the format of past HPROF implementations.<br>
<br>
<br>
Commands can be sent to HPROF via the socket connection, the accepted
COMMAND TAGS are:<br>
<br>
<table style="text-align: left; width: 100%;" border="1" cellpadding="2"
cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">FORCE GC (<span
style="font-style: italic; color: rgb(255, 0, 0);">Not implemented</span>)<br>
</td>
<td style="vertical-align: top;">0x01<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">DUMP HEAP<br>
</td>
<td style="vertical-align: top;">0x02<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">ALLOC SITES<br>
</td>
<td style="vertical-align: top;">0x03<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">HEAP SUMMARY<br>
</td>
<td style="vertical-align: top;">0x04<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">EXIT THE VM<br>
</td>
<td style="vertical-align: top;">0x05<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">DUMP TRACES<br>
</td>
<td style="vertical-align: top;">0x06<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">CPU SAMPLES<br>
</td>
<td style="vertical-align: top;">0x07<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">CONTROL<br>
</td>
<td style="vertical-align: top;">0x08<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">EOF (used to terminate socket
connection)<br>
</td>
<td style="vertical-align: top;">0xFF<br>
</td>
</tr>
</tbody>
</table>
<br>
The commands take the form:<br>
<br>
<table style="text-align: left; width: 100%;" border="1" cellpadding="2"
cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u1<br>
</td>
<td style="vertical-align: top;">COMMAND TAG<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">serial number<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">number of bytes that follow<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">[u1]*<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ALLOC SITES<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u2<br>
</td>
<td style="vertical-align: top;">Flags:<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">cutoff ratio
(floating point between 0.0 and 1.0)<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">CPU SAMPLES<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u2<br>
</td>
<td style="vertical-align: top;">ignored<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">u4<br>
</td>
<td style="vertical-align: top;">cutoff ratio
(floating point between 0.0 and 1.0)<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">CONTROL<br>
</td>
<td style="vertical-align: top;">
<table style="text-align: left; width: 100%;" border="1"
cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u2<br>
</td>
<td style="vertical-align: top;">Sub option:<br>
<table style="text-align: left; width: 100%;"
border="1" cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">0x1<br>
</td>
<td style="vertical-align: top;">Turn alloc
traces on<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">0x2<br>
</td>
<td style="vertical-align: top;">Turn alloc
traces off<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">0x3<br>
</td>
<td style="vertical-align: top;">Turn CPU
sampling on:<br>
<table style="text-align: left; width: 100%;"
border="1" cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">thread
object ID (0 for all threads)<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">0x4<br>
</td>
<td style="vertical-align: top;">Turn CPU
sampling off:<br>
<table style="text-align: left; width: 100%;"
border="1" cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">ID<br>
</td>
<td style="vertical-align: top;">thread
object ID (0 for all threads)</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">0x5<br>
</td>
<td style="vertical-align: top;">Clear CPU
sampling<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;">0x6<br>
</td>
<td style="vertical-align: top;">Set max stack
depth:<br>
<table style="text-align: left; width: 100%;"
border="1" cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td style="vertical-align: top;">u2<br>
</td>
<td style="vertical-align: top;">New max
stack depth<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
</tbody>
</table>
<br>
</td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
<br>
<p></p>
<h2><a name="mozTocId589424" class="mozTocH4"></a>Source Code<br>
</h2>
The source to HPROF is available in the JDK download in the
demo/jvmti/hprof directory.
<p><font size="-1"><b>*As used on this web site, the terms "Java
Virtual Machine" or "JVM" mean a virtual machine for the Java platform.</b></font>
</p>
<p></p>
<hr><!-- hhmts start -->
Last modified: 2005<!-- hhmts end -->
</body>
</html>