You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@harmony.apache.org by na...@apache.org on 2007/04/03 16:10:52 UTC
svn commit: r525159 [2/5] - in /harmony/standard/site: docs/
docs/subcomponents/classlibrary/ docs/subcomponents/drlvm/ xdocs/
xdocs/subcomponents/classlibrary/ xdocs/subcomponents/drlvm/
Modified: harmony/standard/site/docs/subcomponents/drlvm/JVMTI-PopFrame.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/subcomponents/drlvm/JVMTI-PopFrame.html?view=diff&rev=525159&r1=525158&r2=525159
==============================================================================
--- harmony/standard/site/docs/subcomponents/drlvm/JVMTI-PopFrame.html (original)
+++ harmony/standard/site/docs/subcomponents/drlvm/JVMTI-PopFrame.html Tue Apr 3 07:10:50 2007
@@ -191,6 +191,18 @@
<h1>
<a name="JVMTI Pop Frame">JVMTI Pop Frame</a>
</h1>
+ <ol id="TOC">
+ <li><a href="#About This Document">About This Document</a></li>
+ <li><a href="#Introduction">Introduction</a></li>
+ <li><a href="#How to Pop a Frame">How to Pop a Frame</a></li>
+ <li><a href="#Implementation Specifics">Implementation Specifics</a></li>
+ <li><a href="#Related Information">Related Information</a></li>
+ </ol>
+
+ <h2>
+ <a name="About This Document">About This Document</a>
+ </h2>
+
<p>
Here is a description of how popping a frame is currently
implemented in the DRLVM tool interface (JVMTI). For a
@@ -200,6 +212,7 @@
of related terms, see the <a href="developers_guide.html" title="DRLVM Developer's Guide">developer's
guide</a>.
</p>
+
<h2>
<a name="Introduction">Introduction</a>
@@ -369,7 +382,7 @@
</li>
<li>
The JVMTI Agent calls <code>PopFrame()</code> and does the following:
- <ol>
+ <ul>
<li>
Checks that the flag for the topmost M2nFrame is set to <code>FRAME_POPABLE</code>,
which means that the frame can be popped.
@@ -383,16 +396,16 @@
executes the callback while staying in the function where the
thread is suspended.
</li>
- </ol>
+ </ul>
</li>
<li>
The callback
function pops the frame in one of the following ways depending on
the function and on area of the stack:
- <ol>
+ <ul>
<li>
For <b>hythread_safe_point():</b>
- <ol>
+ <ul>
<li>
VM finds the register
context for the previous frame and saves it in the current M2nFrame.
@@ -403,14 +416,13 @@
the frame is popped, VM transfers control to the saved register
context. Otherwise, VM exits normally.
</li>
- </ol>
+ </ul>
</li>
<li>
- For the <b>suspend_disable()</b> function in an <a href="developers_guide.html#Exception_Handling">
- unwindable
- area of the stack
- </a>:
- <ol>
+ For the <b>suspend_disable()</b> function in an
+ <a href="developers_guide.html#Exception_Handling">
+ unwindable area of the stack</a>:
+ <ul>
<li>
The callback explicitly calls <code>hythread_safe_point()</code> to
stop the current thread in the safe point and wait until
@@ -421,14 +433,13 @@
for the current thread and transfers control to the previous
frame.
</li>
- </ol>
+ </ul>
</li>
<li>
- For the <strong>suspend_disable()</strong> function in a <a href="developers_guide.html#Exception_Handling">
- non-unwindable
- area of the stack
- </a>:
- <ol>
+ For the <strong>suspend_disable()</strong> function in a
+ <a href="developers_guide.html#Exception_Handling">
+ non-unwindable area of the stack</a>:
+ <ul>
<li>
VM raises a special exception object and waits for the end
of the area.
@@ -438,9 +449,9 @@
is set and pops the frame for the current thread and transfers
control to the previous frame.
</li>
- </ol>
+ </ul>
</li>
- </ol>
+ </ul>
</li>
</ol>
Modified: harmony/standard/site/docs/subcomponents/drlvm/TM.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/subcomponents/drlvm/TM.html?view=diff&rev=525159&r1=525158&r2=525159
==============================================================================
--- harmony/standard/site/docs/subcomponents/drlvm/TM.html (original)
+++ harmony/standard/site/docs/subcomponents/drlvm/TM.html Tue Apr 3 07:10:50 2007
@@ -192,11 +192,11 @@
<div>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
+ contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
+ the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
@@ -222,55 +222,55 @@
<h1>
<a id="top" name="top"></a>Thread Manager
</h1>
- <ol class="TOC">
- <li><a href="#RevisionHistory">1. Revision History</a></li>
- <li><a href="#About_This_Document">2. About this Document</a>
+ <ol id="TOC">
+ <li><a href="#RevisionHistory">Revision History</a></li>
+ <li><a href="#About_This_Document">About This Document</a>
<ol>
- <li><a href="#Purpose">2.1 Purpose</a></li>
- <li><a href="#Intended_Audience">2.2 Intended Audience</a></li>
- <li><a href="#Documentation_Conventions">2.3 Documentation Conventions</a></li>
- <li><a href="#Using_this_document">2.4 Using this Document</a></li>
+ <li><a href="#Purpose">Purpose</a></li>
+ <li><a href="#Intended_Audience">Intended Audience</a></li>
+ <li><a href="#Documentation_Conventions">Documentation Conventions</a></li>
+ <li><a href="#Using_this_document">Using This Document</a></li>
</ol></li>
- <li><a href="#Overview">3. Overview</a>
+ <li><a href="#Overview">Overview</a>
<ol>
- <li><a href="#Key_Feature">3.1 Key Features</a></li>
- <li><a href="#TM_in_VM">3.2 Thread Manager in VM</a></li>
- <li><a href="#Portability">3.3 Portability</a></li>
+ <li><a href="#Key_Feature">Key Features</a></li>
+ <li><a href="#TM_in_VM">Thread Manager in VM</a></li>
+ <li><a href="#Portability">Portability</a></li>
</ol></li>
- <li><a href="#Achitecture">4. Architecture</a>
+ <li><a href="#Achitecture">Architecture</a>
<ol>
- <li><a href="#Exported_Interfaces">4.1 Exported interfaces</a>
- <ul>
- <li><a href="#Native_Layer">4.1.1 Native Interface</a></li>
- <li><a href="#Java_interface">4.1.2 Java* Interface</a></li>
- </ul></li>
- <li><a href="#Data_Structures">4.2 Data structures</a></li>
- <li><a href="#Thread_Control_Structure">4.3 Thread control structures</a>
- <ul>
- <li><a href="#Native_Structure">4.3.1 Native Thread Structure</a></li>
- <li><a href="#Java_Structure">4.3.2 Java* Thread Structure</a></li>
- </ul></li>
- <li><a href="#Thread_Group">4.4 Thread Groups</a></li>
- <li><a href="#Synchronizer">4.5 Synchronizers</a></li>
- <li><a href="#Monitors">4.6 Monitors</a>
- <ul>
- <li><a href="#MonitorInflation">4.6.1 Inflation Technique</a></li>
- <li><a href="#Thin_monitors">4.6.2 Monitor Structure</a></li>
- <li><a href="#AcquireMonitor">4.6.3 Acquiring a Monitor</a></li>
- </ul></li>
+ <li><a href="#Exported_Interfaces">Exported interfaces</a>
+ <ol>
+ <li><a href="#Native_Layer">Native Interface</a></li>
+ <li><a href="#Java_interface">Java* Interface</a></li>
+ </ol></li>
+ <li><a href="#Data_Structures">Data Structures</a></li>
+ <li><a href="#Thread_Control_Structure">Thread Control Structures</a>
+ <ol>
+ <li><a href="#Native_Structure">Native Thread Structure</a></li>
+ <li><a href="#Java_Structure">Java* Thread Structure</a></li>
+ </ol></li>
+ <li><a href="#Thread_Group">Thread Groups</a></li>
+ <li><a href="#Synchronizer">Synchronizers</a></li>
+ <li><a href="#Monitors">Monitors</a>
+ <ol>
+ <li><a href="#MonitorInflation">Inflation Technique</a></li>
+ <li><a href="#Thin_monitors">Monitor Structure</a></li>
+ <li><a href="#AcquireMonitor">Acquiring a Monitor</a></li>
+ </ol></li>
</ol></li>
- <li><a href="#Usage_Scenarios">5. Usage scenarios</a>
+ <li><a href="#Usage_Scenarios">Usage Scenarios</a>
<ol>
- <li><a href="#Thread_lifecycle">5.1 Java* Thread Life Cycle</a></li>
- <li><a href="#Thread_suspension">5.2 Thread Suspension</a></li>
- <li><a href="#Stop-the-world_Suspension">5.3 Stop-the-world Thread Suspension</a></li>
- <li><a href="#Thread_locking">5.4 Thread Locking</a></li>
- <li><a href="#Monitor_scenarios">5.5 Monitor Enter and Exit</a></li>
+ <li><a href="#Thread_lifecycle">Java* Thread Life Cycle</a></li>
+ <li><a href="#Thread_suspension">Thread Suspension</a></li>
+ <li><a href="#Stop-the-world_Suspension">Stop-the-world Thread Suspension</a></li>
+ <li><a href="#Thread_locking">Thread Locking</a></li>
+ <li><a href="#Monitor_scenarios">Monitor Enter and Exit</a></li>
</ol></li>
- <li><a href="#References">6. References</a></li>
+ <li><a href="#References">References</a></li>
</ol>
<h1>
- <a id="RevisionHistory" name="RevisionHistory"></a>1. Revision History
+ <a id="RevisionHistory" name="RevisionHistory"></a>Revision History
</h1>
<table border="0" cellpadding="0" width="100%">
<tr>
@@ -298,11 +298,11 @@
</table>
<h1>
- <a id="About_This_Document" name="About_This_Document"></a>2. About
+ <a id="About_This_Document" name="About_This_Document"></a>About
This Document
</h1>
<h2>
- <a id="Purpose" name="Purpose"></a>2.1 Purpose
+ <a id="Purpose" name="Purpose"></a>Purpose
</h2>
<p>
This document introduces the thread manager component delivered as
@@ -312,7 +312,7 @@
organization of the thread management subsystem.
</p>
<h2>
- <a id="Intended_Audience" name="Intended_Audience"></a>2.2 Intended
+ <a id="Intended_Audience" name="Intended_Audience"></a>Intended
Audience
</h2>
<p>
@@ -324,15 +324,15 @@
</p>
<h2>
<a id="Documentation_Conventions"
- name="Documentation_Conventions"></a>2.3 Documentation Conventions
+ name="Documentation_Conventions"></a>Documentation Conventions
</h2>
<p>
This document uses the <a href="../../documentation/conventions.html">
unified conventions</a> for the DRL documentation kit.
</p>
<h2>
- <a id="Using_this_document" name="Using_this_document"></a>2.4 Using
- this Document
+ <a id="Using_this_document" name="Using_this_document"></a>Using
+ This Document
</h2>
<p>
Use this document to learn all about implementation specifics of the
@@ -365,7 +365,7 @@
<a href="#top">Back to Top</a>
</p>
<h1>
- <a id="Overview" name="Overview"></a>3. Overview
+ <a id="Overview" name="Overview"></a>Overview
</h1>
<p>
The thread manager (TM) is a library aimed to provide threading
@@ -420,7 +420,7 @@
<a href="#top">Back to Top</a>
</p>
<h2>
- <a id="Key_Feature" name="Key_Feature"></a>3.1 Key features
+ <a id="Key_Feature" name="Key_Feature"></a>Key Features
</h2>
<p>
The supplied thread manager has the following characteristics:
@@ -448,7 +448,7 @@
</li>
</ul>
<h2>
- <a id="TM_in_VM" name="TM_in_VM"></a>3.2 Thread Manager in VM
+ <a id="TM_in_VM" name="TM_in_VM"></a>Thread Manager in VM
</h2>
<p>
Figure 2 below demonstrates the interaction of the thread manager with
@@ -488,7 +488,7 @@
Figure 2: Thread Manager in VM Architecture
</p>
<h2>
- <a id="Portability" name="Portability"></a>3.3 Portability
+ <a id="Portability" name="Portability"></a>Portability
</h2>
<p>
The thread manager code is mostly platform-independent and relies on
@@ -509,7 +509,7 @@
<a href="#top">Back to Top</a>
</p>
<h1>
- <a id="Achitecture" name="Achitecture"></a>4. Architecture
+ <a id="Achitecture" name="Achitecture"></a>Architecture
</h1>
<p>
Subsequent sections describe the functional interfaces that the thread
@@ -517,8 +517,8 @@
data structures.
</p>
<h2>
- <a id="Exported_Interfaces" name="Exported_Interfaces"></a>4.1
- Exported interfaces
+ <a id="Exported_Interfaces" name="Exported_Interfaces"></a>
+ Exported Interfaces
</h2>
<p>
As indicated in the overview, the thread manager exports the native
@@ -527,7 +527,7 @@
upon external requests, as described in the subsequent sections.
</p>
<h3>
- <a id="Native_Layer" name="Native_Layer"></a>4.1.1 Native Interface
+ <a id="Native_Layer" name="Native_Layer"></a>Native Interface
</h3>
<p>
The native interface is inspired by the Harmony <code>hythread</code>
@@ -623,7 +623,7 @@
<a href="#top">Back to Top</a>
</p>
<h3>
- <a id="Java_interface" name="Java_interface"></a>4.1.2 Java<a
+ <a id="Java_interface" name="Java_interface"></a>Java<a
href="#*">*</a> Interface
</h3>
<p>
@@ -711,7 +711,7 @@
<a href="#Top">Back to Top</a>
</p>
<h2>
- <a id="Data_Structures" name="Data_Structures"></a>4.2 Data structures
+ <a id="Data_Structures" name="Data_Structures"></a>Data Structures
</h2>
<p>
The thread manager data structures are typically not exposed: external
@@ -723,7 +723,7 @@
</p>
<h2>
<a id="Thread_Control_Structure"
- name="Thread_Control_Structure"></a>4.3 Thread control structures
+ name="Thread_Control_Structure"></a>Thread Control Structures
</h2>
<p>
The thread manager requires each thread to be <em>registered</em>
@@ -772,7 +772,7 @@
handle.
</p>
<h3>
- <a id="Native_Structure" name="Native_Structure"></a>4.3.1 Native
+ <a id="Native_Structure" name="Native_Structure"></a>Native
Thread Structure
</h3>
<p>
@@ -788,7 +788,7 @@
</p>
<p class="notetext">
The actual content of a thread control structure is
- implementation-specific and is not exposed to other components.
+ implementation-specific and is not exposed to other components.
</p>
<p>
The following figure shows the thread control structure of a native
@@ -799,7 +799,7 @@
alt="Structure of a native thread not registered in TM" />
</p>
<p class="special">
- Figure 3: Native Thread
+ Figure 3: Native Thread
</p>
<p>
The following table lists the data fields making up the thread control
@@ -1164,7 +1164,7 @@
<a href="#Top">Back to Top</a>
</p>
<h3>
- <a id="Java_Structure" name="Java_Structure"></a>4.3.2 Java<a
+ <a id="Java_Structure" name="Java_Structure"></a>Java<a
href="#*">*</a> Thread Structure
</h3>
<p>
@@ -1356,7 +1356,7 @@
<a href="#Top">Back to Top</a>
</p>
<h2>
- <a id="Thread_Group" name="Thread_Group"></a>4.4 Thread Groups
+ <a id="Thread_Group" name="Thread_Group"></a>Thread Groups
</h2>
<p>
The thread manager enables co-existence of multiple groups of threads,
@@ -1384,7 +1384,7 @@
<a href="#Top">Back to Top</a>
</p>
<h2>
- <a id="Synchronizer" name="Synchronizer"></a>4.5 Synchronizers
+ <a id="Synchronizer" name="Synchronizer"></a>Synchronizers
</h2>
<p>
The thread manager synchronizers are functional modules used for
@@ -1459,7 +1459,7 @@
<a href="#Top">Back to Top</a>
</p>
<h2>
- <a id="Monitors" name="Monitors"></a>4.6 Monitors
+ <a id="Monitors" name="Monitors"></a>Monitors
</h2>
<p>
The current version of the thread manager implements Java<a
@@ -1469,8 +1469,8 @@
optimized for space consumption and single-threaded usage.
</p>
<h3>
- <a id="MonitorInflation" name="MonitorInflation"></a>4.6.1 Inflation
- technique
+ <a id="MonitorInflation" name="MonitorInflation"></a>Inflation
+ Technique
</h3>
<p>
Monitor inflation is implemented using a thin-fat lock technique [<a
@@ -1501,7 +1501,7 @@
href="#*">*</a> monitors space usage more efficient.
</p>
<h3>
- <a id="Thin_monitors" name="Thin_monitors"></a>4.6.2 Monitor Structure
+ <a id="Thin_monitors" name="Thin_monitors"></a>Monitor Structure
</h3>
<p>
The thin monitor is a synchronizer primitive that implements the lock
@@ -1593,7 +1593,7 @@
<a href="#Top">Back to Top</a>
</p>
<h3>
- <a id="AcquireMonitor" name="AcquireMonitor"></a>4.6.3 Acquiring a
+ <a id="AcquireMonitor" name="AcquireMonitor"></a>Acquiring a
Monitor
</h3>
<p>
@@ -1633,14 +1633,14 @@
<a href="#Top">Back to Top</a>
</p>
<h1>
- <a id="Usage_Scenarios" name="Usage_Scenarios"></a>5. Usage scenarios
+ <a id="Usage_Scenarios" name="Usage_Scenarios"></a>Usage Scenarios
</h1>
<p>
This section contains various scenarios of thread manipulation.
</p>
<h2>
- <a id="Thread_lifecycle" name="Thread_lifecycle"></a>5.1 Java<a
- href="#*">*</a> thread life cycle
+ <a id="Thread_lifecycle" name="Thread_lifecycle"></a>Java<a
+ href="#*">*</a> Thread Life Cycle
</h2>
<p>
The Java<a href="#*">*</a> thread creation procedure consists of the
@@ -1736,7 +1736,7 @@
<a href="#Top">Back to Top</a>
</p>
<h2>
- <a id="Thread_suspension" name="Thread_suspension"></a>5.2 Thread
+ <a id="Thread_suspension" name="Thread_suspension"></a>Thread
Suspension
</h2>
<p>
@@ -1764,7 +1764,7 @@
the current state of thread T2, the
<code>hythread_suspend(T2)</code> function activates one of the
following mechanisms:
- <ol>
+ <ul>
<li>
If thread T2 is currently running in a safe code region, the
<code>hythread_suspend(T2)</code> call immediately returns,
@@ -1776,7 +1776,7 @@
thread T2 reaches the beginning of a safe region or a safe
point.
</li>
- </ol>
+ </ul>
</li>
<li>
Thread T2 runs to the end of the safe region and gets blocked until
@@ -1855,7 +1855,7 @@
</p>
<h2>
<a id="Stop-the-world_Suspension"
- name="Stop-the-world_Suspension"></a>5.3 Stop-the-world Thread
+ name="Stop-the-world_Suspension"></a>Stop-the-world Thread
Suspension
</h2>
<p>
@@ -1887,7 +1887,7 @@
<a href="#Top">Back to Top</a>
</p>
<h2>
- <a id="Thread_locking" name="Thread_locking"></a>5.4 Thread Locking
+ <a id="Thread_locking" name="Thread_locking"></a>Thread Locking
</h2>
<p>
Locking with the thread manager can be done by means of a mutex or a
@@ -1922,8 +1922,8 @@
<a href="#Top">Back to Top</a>
</p>
<h2>
- <a id="Monitor_scenarios" name="Monitor_scenarios"></a>5.5 Monitor
- enter and exit
+ <a id="Monitor_scenarios" name="Monitor_scenarios"></a>Monitor
+ Enter and Exit
</h2>
<p>
Locking Java<a href="#*">*</a> monitors implies interaction between
@@ -1982,7 +1982,7 @@
<a href="#Top">Back to Top</a>
</p>
<h1>
- <a id="References" name="References"></a>6. References
+ <a id="References" name="References"></a>References
</h1>
<p>
This section lists the resources used in this document and other
Modified: harmony/standard/site/docs/subcomponents/drlvm/debugging_VM_and_JIT.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/subcomponents/drlvm/debugging_VM_and_JIT.html?view=diff&rev=525159&r1=525158&r2=525159
==============================================================================
--- harmony/standard/site/docs/subcomponents/drlvm/debugging_VM_and_JIT.html (original)
+++ harmony/standard/site/docs/subcomponents/drlvm/debugging_VM_and_JIT.html Tue Apr 3 07:10:50 2007
@@ -214,66 +214,77 @@
"text/html; charset=ISO-8859-1">
<title>Debugging DRL Virtual Machine and JIT Compiler </title>
</head>
-<body>
- <h1>
- <a name="top"></a>Debugging the DRL Virtual Machine and the JIT Compiler
- </h1>
+ <body>
+ <h1><a id="top" name="top"></a>Debugging the DRL Virtual Machine and the JIT Compiler</h1>
+<ol id="TOC">
+<li><a href="#About_This_Document">About This Document</a></li>
+<li><a href="#Debugging_VM">Debugging the Virtual Machine</a>
+ <ol>
+ <li><a href="#How_to_debug_VM">How to Debug the VM</a>
+ <ol>
+ <li><a href="#Basic_Debugging_Steps">Basic Debugging Steps</a></li>
+ <li><a href="#Attaching_the_Debugger">Attaching the Debugger to the Live Process</a></li>
+ </ol>
+ </li>
+ <li><a href="#Extended_Debug_VM">How to Get More of Your Debugging</a>
+ <ol>
+ <li><a href="#Configuration_of_Tracing">Configuration of Tracing</a></li>
+ <li><a href="#Native_Stack_Examination">Native Stack Examination</a></li>
+ <li><a href="#Stack_Examination">Java* Stack Examination</a></li>
+ <li><a href="#Setting_Breakpoints">Setting Smart Breakpoints</a></li>
+ <li><a href="#Handling_Threads">Handling Java* Threads as Native Threads</a></li>
+ <li><a href="#Debugging_Deadlocks">Debugging Deadlocks with the
+ <code>CriticalSection</code> Synchronization Primitive</a></li>
+ <li><a href="#Getting_a_Class_Name">Getting a Class Name for an Object</a></li>
+ </ol>
+ </li>
+ </ol>
+</li>
+<li><a href="#Debugging_JIT">Debugging the Jitrino.JET Baseline Compiler</a>
+ <ol>
+ <li><a href="#Enable_Tracing">How to Enable Tracing in Jitrino.JET</a></li>
+ <li><a href="#Config_Trace_Logging">How to Configure Trace Logging</a>
+ <ol>
+ <li><a href="#Compilation_Results_Tracing">Group 1: Compilation Results Tracing</a></li>
+ <li><a href="#Run-time_Execution_Tracing">Group 2: Run-time Execution Tracing</a></li>
+ </ol>
+ </li>
+ <li><a href="#Extend_Trace_JIT">How to Get More of Your Tracing</a>
+ <ol>
+ <li><a href="#Tracing_Example">Tracing Example</a></li>
+ </ol>
+ </li>
+ </ol>
+</li>
+</ol>
+ <h1><a id="About_This_Document" name="About_This_Document"></a>About This Document</h1>
<p>
This document gives practical instructions on how to debug the DRL virtual machine
and its baseline just-in-time compiler Jitrino.JET. For a definition of components
and details on their internal structure, consult the <a href="../../subcomponents/drlvm/developers_guide.html">
- DRL Virtual Machine Developer’s Guide</a> supplied with the DRLVM image.
+ DRL Virtual Machine Developer’s Guide</a> supplied with the DRLVM image.
</p>
<p>
The document includes two groups of debugging tips, one for VM tips, and the other
for JIT compiler tips, as shown below.
</p>
- <p class="TOCHeading">
- <a href="#Debugging_VM">Debugging the Virtual Machine</a>
- </p>
-<p class="TOC">
- <a href="#How_to_debug_VM">How to debug the VM?</a>
- </p>
-<p class="TOC">
- <a href="#Extended_Debug_VM">How to get more of your debugging?</a>
- </p>
-<p class="TOCHeading">
- <a href="#Debugging_JIT">Debugging the Jitrino.JET Baseline Compiler</a>
- </p>
-<p class="TOC">
- <a href="#Enable_Tracing">How to enable tracing in Jitrino.JET?</a>
- </p>
-<p class="TOC">
- <a href="#Config_Trace_Logging">How to configure trace logging?</a>
- </p>
-<p class="TOC">
- <a href="#Extend_Trace_JIT">How to get more of your tracing?</a>
- </p>
- <p><a href="#top">Back to top</a>
- </p>
- <h1>
- <a name="Debugging_VM">Debugging the Virtual Machine</a>
- </h1>
- <p>
+ <p><a href="#top">Back to top</a></p>
+ <h1><a id="Debugging_VM" name="Debugging_VM"></a>Debugging the Virtual Machine</h1>
+ <p>
This section gives an insight into debugging the DRL virtual machine version 1.0
and provides tips on resolving non-standard debugging issues.
</p>
- <h2>
- <a name="How_to_debug_VM">How to debug the VM?</a>
- </h2>
+ <p><a href="#top">Back to top</a></p>
+ <h2><a id="How_to_debug_VM" name="How_to_debug_VM"></a>How to Debug the VM</h2>
<p>
This section gives instructions on different scenarios of debugging the VM source
code.
</p>
- <h3>
- Basic Debugging Steps
- </h3>
- <p>
- For ordinary tests, start the ij executable with the debugger enabled, as follows:
- </p>
- <p class="class">
- On Windows<a href="#*">*</a></p>
- <ol>
+ <h3><a id="Basic_Debugging_Steps" name="Basic_Debugging_Steps"></a>Basic Debugging Steps</h3>
+ <p>For ordinary tests, start the ij executable with the debugger enabled, as follows:</p>
+ <dl>
+ <dt>On Windows<a href="#*">*</a></dt>
+ <dd><ol>
<li>Start Microsoft Visual Studio<a href="#*">*</a> and open the solution file <code>
vm\build\vm.sln</code>. </li>
<li>Open the source code that you need to debug, set breakpoints and perform all other
@@ -285,10 +296,9 @@
</li>
<li>Start debugging via the menu <strong>Debug</strong> > <strong>Start</strong>,
click <strong>NO</strong> in the popup dialog offering to build the project. </li>
- </ol>
- <p class="class">
- On Linux<a href="#*">*</a></p>
- <ol>
+ </ol></dd>
+ <dt>On Linux<a href="#*">*</a></dt>
+ <dd><ol>
<li>Set up the <code>LD_LIBRARY_PATH</code> to point to the <code>deploy/jre/bin</code>
directory. Change the working directory to the location of the VM executable and
run:
@@ -302,61 +312,41 @@
run <your_params>
</pre>
</li>
- </ol>
- <p>
- <a href="#top">Back to top</a>
- </p>
- <h3>
- Attaching the Debugger to the Live Process
- </h3>
- <p>
- To attach to the running VM process, do the following:
- </p>
- <p class="class">
- On Windows<a href="#*">*</a></p>
- <ol>
+ </ol></dd></dl>
+
+ <h3><a id="Attaching_the_Debugger" name="Attaching_the_Debugger"></a>Attaching the Debugger to the Live Process</h3>
+ <p>
+ To attach to the running VM process, do the following:</p>
+ <dl><dt>On Windows<a href="#*">*</a></dt>
+ <dd><ol>
<li>Start Visual Studio<a href="#*">*</a> . </li>
<li>Go <strong>Debug</strong> > <strong>Processes</strong>. </li>
<li>Select the VM process and click <strong>Attach</strong>.<br>
If you built the VM in the debug mode, the <strong>Microsoft Debug Runtime</strong>
window appears. Click the <strong>Debug</strong> button to go to the crash point.
</li>
- </ol>
- <p class="class">
- On Linux<a href="#*">*</a></p>
- <p>
+ </ol></dd>
+ <dt>On Linux<a href="#*">*</a></dt>
+ <dd>
Run:
- </p>
- <pre>
-gdb –p <PID of ij>
-</pre>
- <p>
+<pre>gdb –p <PID of ij></pre>
+
If the VM crashed during execution, use the core dump to analyze the crash:
- </p>
- <pre>
-gdb ij core
-</pre>
- <p>
- <a href="#top">Back to top</a>
- </p>
- <h2>
- <a name="Extended_Debug_VM">How to get more from your debugging?</a>
- </h2>
+<pre>gdb ij core</pre>
+</dd></dl>
+ <p><a href="#top">Back to top</a></p>
+ <h2><a id="Extended_Debug_VM" name="Extended_Debug_VM"></a>How to Get More from Your Debugging</h2>
<p>
This section includes some tips on optimizing the debug process and getting more
debug information.
</p>
- <h3>
- Configuration of tracing
- </h3>
+ <h3><a id="Configuration_of_Tracing" name="Configuration_of_Tracing"></a>Configuration of Tracing</h3>
<p>
Consult the <a href="../../subcomponents/drlvm/getting_started.html">Getting Started
- guide</a> delivered with DRLVM bundle for information on VM standard and non-standard
+ guide</a> delivered with DRLVM bundle for information on VM standard and non-standard
configuration options. Tracing-related options might be useful for debugging purposes.
</p>
- <h3>
- Native stack examination
- </h3>
+ <h3><a id="Native_Stack_Examination" name="Native_Stack_Examination"></a>Native Stack Examination</h3>
<p>
The debugger might draw the stack incorrectly when the JIT or native stubs are involved.
To avoid this, set esp as the memory location and 4-byte integer values as the output
@@ -387,79 +377,66 @@
call stack in the <strong>Call Stack</strong> window. If you have found a wrong
call site, repeat the instruction from step 2. </li>
</ol>
- <p>
- <a href="#top">Back to top</a>
- </p>
- <h3>
- Java<a href="#*">*</a> stack examination
- </h3>
- <p class="class">
- On Windows<a href="#*">*</a></p>
- <p>
+
+ <h3><a id="Stack_Examination" name="Stack_Examination"></a>Java<a href="#*">*</a> Stack Examination</h3>
+ <dl><dt>On Windows<a href="#*">*</a></dt>
+ <dd>
Running the VM in the interpreter mode, you can get Java<a href="#*">*</a> methods
stack trace almost at any point of execution. For that, break the execution of the
VM and select the <strong>Interpreter</strong> frame in the Visual Studio<a href="#*">*</a>
<strong>Call Stack</strong> window. Then, in the watch window, add the watch <code>stack_dump()</code>.
The stack dump appears in VM output window. Running the VM in the JIT mode, use
the <code>st_print()</code> function for the same purpose.
- </p>
- <p class="class">
- On Linux<a href="#*">*</a></p>
- <p>
+ </dd>
+ <dt>On Linux<a href="#*">*</a></dt>
+ <dd>
Use the <code>gdb</code> command print and specify the <code>stack_dump</code> or
<code>st_print</code> in the interpreter or the JIT compiler mode respectively.
- </p>
- <h3>
- Setting smart breakpoints
- </h3>
- <p class="class">
- On Windows<a href="#*">*</a> / IA-32</p>
- <p>
+ </dd></dl>
+
+ <h3><a id="Setting_Breakpoints" name="Setting_Breakpoints"></a>Setting Smart Breakpoints</h3>
+ <dl><dt>On Windows<a href="#*">*</a> / IA-32</dt>
+ <dd>
Place breakpoints in source code by inserting calls to the <code>_CrtDbgBreak()</code>
function. Placing the call inside a condition calls the function only for the specified
case you need to debug. Analogously, you can use the Windows<a href="#*">*</a> API
function <code>DebugBreak()</code> or print <code>INT 3</code>.
- </p>
+
<p class="note">
Note</p>
<p class="notetext">
- This requires recompiling the VM.</p>
- <p class="class">
- On Linux<a href="#*">*</a></p>
- <p>
+ This requires recompiling the VM.</p></dd>
+ <dt>
+ On Linux<a href="#*">*</a></dt>
+ <dd>
Run the following:
- </p>
- <pre>
-__asm {int 3}
-</pre>
- <p>
- <a href="#top">Back to top</a>
- </p>
- <h3>
- Handling Java<a href="#*">*</a> threads as native threads
- </h3>
+<pre>__asm {int 3}</pre>
+</dd></dl>
+
+ <h3><a id="Handling_Threads" name="Handling_Threads"></a>
+ Handling Java<a href="#*">*</a> Threads as Native Threads</h3>
<p>
DRL VM has 1:1 mapping between native threads visible in the debugger and Java<a
- href="#*">*</a> threads.<br>
+ href="#*">*</a> threads.<br \>
To work with Java<a href="#*">*</a> threads individually, freeze the threads you
do not need with the help of the debugger, and continue execution of other threads.
</p>
- <h3>
- Debugging deadlocks with the CriticalSection synchronization primitive
+ <h3><a id="Debugging_Deadlocks" name="Debugging_Deadlocks"></a>
+ Debugging Deadlocks with the <code>CriticalSection</code> Synchronization Primitive
</h3>
<p>
The <code>CriticalSection</code> primitive is a common cause of deadlocks. If the
code has stopped at a critical section, you can try to find the thread that owns
this primitive.
</p>
- <p class="class">
- On Windows<a href="#*">*</a></p>
- <p>
+ <dl>
+ <dt>On Windows<a href="#*">*</a></dt>
+ <dd>
The file <code>WinNT.H</code> located in <code><PlatformSDK>\Include</code>
contains the definition for the structure <code>_RTL_CRITICAL_SECTION</code>, which
contains the description of the CriticalSection primitive. You can get the owning
thread for the CriticalSection primitive in a number of ways, as indicated below.
- </p>
+
<p>
<strong>Lookup in Memory</strong></p>
<p>
@@ -478,7 +455,7 @@
<p class="notetext">
Visual Studio<a href="#*">*</a> displays thread IDs in decimal representation.</p>
<p>
- <strong>In the watch window</strong></p>
+ <strong>In the Watch Window</strong></p>
<p>
In the watch window of Visual Studio<a href="#*">*</a>, insert the following:
</p>
@@ -487,24 +464,19 @@
</pre>
<p>
Where <code><cs-ptr></code> is the address of your critical section
- </p>
- <p class="class">
- On Linux<a href="#*">*</a></p>
- <p>
+ </p> </dd>
+ <dt>On Linux<a href="#*">*</a></dt>
+ <dd>
The file <code>/usr/include/bits/pthreadtypes.h</code> contains the description
of the <code>pthread_mutex_t</code> type. To get the ID of the thread owning the
<code>CriticalSection</code> primitive, in <code>gdb</code> execute:
- </p>
- <pre>
-x/4w <address of your mutex primitive>
-</pre>
+<pre>x/4w <address of your mutex primitive></pre>
<p>
The third word in the output contains the owning thread descriptor you are looking
for.
- </p>
- <h3>
- Getting a class name for an object
- </h3>
+ </p></dd></dl>
+ <h3><a id="Getting_a_Class_Name" name="Getting_a_Class_Name"></a>
+ Getting a Class Name for an Object</h3>
<p>
You can often need to find out the class name for a Java<a href="#*">*</a> object
used in VM code. For example, you may need to get the class name for an object of
@@ -525,15 +497,16 @@
<a href="#top">Back to top</a>
</p>
<h1>
- <a name="Debugging_JIT"></a>Debugging the Jitrino.JET Baseline Compiler
+ <a id="Debugging_JIT" name="Debugging_JIT"></a>Debugging the Jitrino.JET Baseline Compiler
</h1>
<p>
To use debugging and tracing in Jitrino.JET, use the debug build or the release
build with the <code>JET_PROTO</code> macro defined. See the file <code>jdefs.h</code>
for a definition of the available flags.
</p>
+ <p><a href="#top">Back to top</a></p>
<h2>
- <a name="Enable_Tracing"></a>How to enable tracing in Jitrino.JET?
+ <a id="Enable_Tracing" name="Enable_Tracing"></a>How to Enable Tracing in Jitrino.JET
</h2>
<p>
Currently, Jitrino.JET provides no interface or command line to control tracing
@@ -543,8 +516,9 @@
compiled, and the instance variable <code>m_fname</code> contains its fully qualified
name with no signature. Obtain these options through a call to <code>Compiler::m_infoBlock.get_flags()</code>.
</p>
+ <p><a href="#top">Back to top</a></p>
<h2>
- <a name="Config_Trace_Logging"></a>How to configure trace logging?
+ <a id="Config_Trace_Logging" name="Config_Trace_Logging"></a>How to Configure Trace Logging
</h2>
<p>
Tracing flags control compilation results output and trace run-time execution, as
@@ -552,9 +526,8 @@
the <code>ij</code> executable starts: compilation results are in <code>jet.log</code>,
and run-time output is in <code>jet.rt.log</code>.
</p>
- <h3>
- Group 1: Compilation Results Tracing
- </h3>
+ <h3><a id="Compilation_Results_Tracing" name="Compilation_Results_Tracing"></a>
+ Group 1: Compilation Results Tracing</h3>
<p>
The following flags control tracing compilation of a method:
</p>
@@ -604,12 +577,9 @@
</p>
</li>
</ul>
- <p>
- <a href="#top">Back to top</a>
- </p>
- <h3>
- Group 2: Run-time Execution tracing
- </h3>
+
+ <h3><a id="Run-time_Execution_Tracing" name="Run-time_Execution_Tracing"></a>
+ Group 2: Run-time Execution Tracing</h3>
<p>
The following flags trace run-time life of the method:
</p>
@@ -650,11 +620,8 @@
The output goes to jet.log, with the address (both native and PC) where the event
happens, and some other info.
</p>
- <p>
- <a href="#top">Back to top</a>
- </p>
- <h2>
- <a name="Extend_Trace_JIT">How to get more from your tracing?</a>
+ <p><a href="#top">Back to top</a></p>
+ <h2><a id="Extend_Trace_JIT" name="Extend_Trace_JIT">How to Get More from Your Tracing</a>
</h2>
<p>
To identify one or more problematic methods with another stable JIT compiler, use
@@ -680,10 +647,7 @@
to break execution at the specified bytecode instruction or at the entry point of
the specified method.
</p>
- <p>
- <a href="#top">Back to top</a>
- </p>
- <h3>
+ <h3><a id="Tracing_Example" name="Tracing_Example"></a>
Tracing Example
</h3>
<p>
@@ -908,8 +872,9 @@
<p>
<a name="*"></a>* Other brands and names are the property of their respective owners.
</p>
-</body>
+ </body>
</html>
+
Modified: harmony/standard/site/docs/subcomponents/drlvm/developers_guide.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/subcomponents/drlvm/developers_guide.html?view=diff&rev=525159&r1=525158&r2=525159
==============================================================================
--- harmony/standard/site/docs/subcomponents/drlvm/developers_guide.html (original)
+++ harmony/standard/site/docs/subcomponents/drlvm/developers_guide.html Tue Apr 3 07:10:50 2007
@@ -192,11 +192,11 @@
<div>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
+ contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
+ the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
@@ -223,225 +223,117 @@
<a id="Top" name="Top"></a>Dynamic Runtime Layer Virtual Machine
Developer's Guide
</h1>
- <p class="TOCHeading">
- <a href="#Revision_History">Revision History</a>
- </p>
- <p class="TOCHeading">
- <a href="#About_this_document">1. About this Document</a>
- </p>
- <p class="TOC">
- <a href="#Purpose">1.1 Purpose</a>
- </p>
- <p class="TOC">
- <a href="#Intended_Audience">1.2 Intended Audience</a>
- </p>
- <p class="TOC">
- <a href="#Using_this_document">1.3 Using This Document</a>
- </p>
- <p class="TOC">
- <a href="#Conventions_and_Symbols">1.4 Conventions and Symbols</a>
- </p>
- <p class="TOCHeading">
- <a href="#VM_Architecture">2. VM Architecture</a>
- </p>
- <p class="TOC">
- <a href="#Overview">2.1 Overview</a>
- </p>
- <p class="TOC">
- <a href="#About_Components">2.2 About Components</a>
- </p>
- <blockquote>
- <p class="TOC">
- <a href="#CompInterfInst">2.2.1 Components, Interfaces, and
- Instances</a>
- </p>
- <p class="TOC">
- <a href="#Linking_Models">2.2.2 Linking Models</a>
- </p>
- </blockquote>
- <p class="TOC">
- <a href="#Component_Manager">2.3 Component Manager</a>
- </p>
- <p class="TOC">
- <a href="#Package_Layout">2.4 Package Layout</a>
- </p>
- <p class="TOC">
- <a href="#Data_Structures">2.5 Data Structures</a>
- </p>
- <blockquote>
- <p class="TOC">
- <a href="#Object_Layout">2.5.1 Object Layout</a>
- </p>
- <p class="TOC">
- <a href="#Compressed_References">2.5.2 Compressed References</a>
- </p>
- </blockquote>
- <p class="TOCHeading">
- <a href="#Components">3. Components</a>
- </p>
- <p class="TOC">
- <a href="#Major_Components">3.1 Component Structure</a>
- </p>
- <p class="TOC">
- <a href="#VM_Core">3.2 VM Core</a>
- </p>
- <blockquote>
- <p class="TOC">
- <a href="#Kernel_Classes">3.2.1 Kernel Classes</a>
- </p>
- <p class="TOC">
- <a href="#Native_Code_Support">3.2.2 Native Code Support</a>
- </p>
- <p class="TOC">
- <a href="#JVMTI_Support">3.2.3 JVMTI Support</a>
- </p>
- <p class="TOC">
- <a href="#Class_Support">3.2.4 Class Support</a>
- </p>
- <p class="TOC">
- <a href="#VM_Services">3.2.5 Services</a>
- </p>
- <p class="TOC">
- <a href="#Utilities">3.2.6 Utilities</a>
- </p>
- </blockquote>
- <p class="TOC">
- <a href="#EE">3.3 Execution Engine</a>
- </p>
- <blockquote>
- <p class="TOC">
- <a href="#JIT_Compiler">3.3.1 JIT Compiler</a>
- </p>
- <p class="TOC">
- <a href="#Interpreter">3.3.2 Interpreter</a>
- </p>
- </blockquote>
- <p class="TOC">
- <a href="#EM">3.4 Execution Manager</a>
- </p>
- <p class="TOC">
- <a href="#Thread_Manager">3.5 Thread Manager</a>
- </p>
- <p class="TOC">
- <a href="#GC">3.6 Garbage Collector</a>
- </p>
- <p class="TOC">
- <a href="#Porting_Layer">3.7 Porting Layer</a>
- </p>
- <p class="TOC">
- <a href="#Class_Libraries">3.8 Class Libraries</a>
- </p>
- <p class="TOCHeading">
- <a href="#Processes">4. Processes</a>
- </p>
- <p class="TOC">
- <a href="#Initialization">4.1 Initialization</a>
- </p>
- <blockquote>
- <p class="TOC">
- <a href="#1stpass">4.1.1 Parsing Arguments</a>
- </p>
- <p class="TOC">
- <a href="#Creating_VM">4.1.2 Creating the VM</a>
- </p>
- <p class="TOC">
- <a href="#VMStarter">4.1.3 VMStarter Class</a>
- </p>
- </blockquote>
- <p class="TOC">
- <a href="#Verification">4.2 Verification</a>
- </p>
- <blockquote>
- <p class="TOC">
- <a href="#Optimized_Verification">4.2.1 Optimized Verification
- Procedure</a>
- </p>
- <p class="TOC">
- <a href="#Verifications_Classification">4.2.2 Verifications
- Classification</a>
- </p>
- </blockquote>
- <p class="TOC">
- <a href="#Stack_Walking">4.3 Stack Walking</a>
- </p>
- <blockquote>
- <p class="TOC">
- <a href="#About_the_Stack">4.3.1 About the Stack</a>
- </p>
- <p class="TOC">
- <a href="#Stack">4.3.2 Stack Walking</a>
- </p>
- <p class="TOC">
- <a href="#Stack_Iterator">4.3.3 Stack Iterator</a>
- </p>
- <p class="TOC">
- <a href="#Stack_Trace">4.3.4 Stack Trace</a>
- </p>
- </blockquote>
- <p class="TOC">
- <a href="#Root_Set_Enumeration">4.4 Root Set Enumeration</a>
- </p>
- <blockquote>
- <p class="TOC">
- <a href="#Roots">4.4.1 About Roots</a>
- </p>
- <p class="TOC">
- <a href="#Method">4.4.2 Black-box Metho</a>
- </p>
- <p class="TOC">
- <a href="#Enumeration">4.4.3 Enumeration Procedure</a>
- </p>
- </blockquote>
- <p class="TOC">
- <a href="#Exception_Handling">4.5 Exception Handling</a>
- </p>
- <blockquote>
- <p class="TOC">
- <a href="#Throwing">4.5.1 Throwing Exceptions</a>
- </p>
- <p class="TOC">
- <a href="#Raising_Exceptions">4.5.2 Raising Exception</a>
- </p>
- <p class="TOC">
- <a href="#Choosing">4.5.3 Choosing the Exception Handling Mode</a>
- </p>
- </blockquote>
- <p class="TOC">
- <a href="#Finalization">4.6 Finalization</a>
- </p>
- <blockquote>
- <p class="TOC">
- <a href="#FP">4.6.1 Finalization Procedure</a>
- </p>
- <p class="TOC">
- <a href="#Work_Balance">4.6.2 Work Balancing Subsystem</a>
- </p>
- </blockquote>
- <p class="TOC">
- <a href="#Inter_Component_Optimizations">4.7 Inter-component
- Optimizations</a>
- </p>
- <blockquote>
- <p class="TOC">
- <a href="#Fast_Subtype_Checking">4.7.1 Fast Subtype Checking</a>
- </p>
- <p class="TOC">
- <a href="#Direct_Call_Conversion">4.7.2 Direct-call Conversion</a>
- </p>
- <p class="TOC">
- <a href="#Fast_Constant_String">4.7.3 Fast Constant-string
- Instantiation</a>
- </p>
- <p class="TOC">
- <a href="#Lazy_Exceptions">4.7.4 Lazy Exceptions</a>
- </p>
- </blockquote>
- <p class="TOC">
- <a href="#Destroying_VM">4.8 Destroying the VM</a>
- </p>
- <p class="TOCHeading">
- <a href="#References">5. References</a>
- </p>
+ <ol id="TOC">
+ <li><a href="#Revision_History">Revision History</a></li>
+ <li><a href="#About_this_document">1. About This Document</a>
+ <ol>
+ <li><a href="#Purpose">1.1 Purpose</a></li>
+ <li><a href="#Intended_Audience">1.2 Intended Audience</a></li>
+ <li><a href="#Using_this_document">1.3 Using This Document</a></li>
+ <li><a href="#Conventions_and_Symbols">1.4 Conventions and Symbols</a></li>
+ </ol>
+ </li>
+ <li><a href="#VM_Architecture">2. VM Architecture</a>
+ <ol>
+ <li><a href="#Overview">2.1 Overview</a></li>
+ <li><a href="#About_Components">2.2 About Components</a>
+ <ol>
+ <li><a href="#CompInterfInst">2.2.1 Components, Interfaces, and Instances</a></li>
+ <li><a href="#Linking_Models">2.2.2 Linking Models</a></li>
+ </ol>
+ </li>
+ <li><a href="#Component_Manager">2.3 Component Manager</a></li>
+ <li><a href="#Package_Layout">2.4 Package Layout</a></li>
+ <li><a href="#Data_Structures">2.5 Data Structures</a>
+ <ol>
+ <li><a href="#Object_Layout">2.5.1 Object Layout</a></li>
+ <li><a href="#Compressed_References">2.5.2 Compressed References</a></li>
+ </ol>
+ </li>
+ </ol>
+ </li>
+ <li><a href="#Components">3. Components</a>
+ <ol>
+ <li><a href="#Major_Components">3.1 Component Structure</a></li>
+ <li><a href="#VM_Core">3.2 VM Core</a>
+ <ol>
+ <li><a href="#Kernel_Classes">3.2.1 Kernel Classes</a></li>
+ <li><a href="#Native_Code_Support">3.2.2 Native Code Support</a></li>
+ <li><a href="#JVMTI_Support">3.2.3 JVMTI Support</a></li>
+ <li><a href="#Class_Support">3.2.4 Class Support</a></li>
+ <li><a href="#VM_Services">3.2.5 Services</a></li>
+ <li><a href="#Utilities">3.2.6 Utilities</a></li>
+ </ol>
+ </li>
+ <li><a href="#EE">3.3 Execution Engine</a>
+ <ol>
+ <li><a href="#JIT_Compiler">3.3.1 JIT Compiler</a></li>
+ <li><a href="#Interpreter">3.3.2 Interpreter</a></li>
+ </ol>
+ </li>
+ <li><a href="#EM">3.4 Execution Manager</a></li>
+ <li><a href="#Thread_Manager">3.5 Thread Manager</a></li>
+ <li><a href="#GC">3.6 Garbage Collector</a></li>
+ <li><a href="#Porting_Layer">3.7 Porting Layer</a></li>
+ <li><a href="#Class_Libraries">3.8 Class Libraries</a></li>
+ </ol>
+ </li>
+ <li><a href="#Processes">4. Processes</a>
+ <ol>
+ <li><a href="#Initialization">4.1 Initialization</a>
+ <ol>
+ <li><a href="#1stpass">4.1.1 Parsing Arguments</a></li>
+ <li><a href="#Creating_VM">4.1.2 Creating the VM</a></li>
+ <li><a href="#VMStarter">4.1.3 VMStarter Class</a></li>
+ </ol>
+ </li>
+ <li><a href="#Verification">4.2 Verification</a>
+ <ol>
+ <li><a href="#Optimized_Verification">4.2.1 Optimized Verification Procedure</a></li>
+ <li><a href="#Verifications_Classification">4.2.2 Verifications Classification</a></li>
+ </ol>
+ </li>
+ <li><a href="#Stack_Walking">4.3 Stack Walking</a>
+ <ol>
+ <li><a href="#About_the_Stack">4.3.1 About the Stack</a></li>
+ <li><a href="#Stack">4.3.2 Stack Walking</a></li>
+ <li><a href="#Stack_Iterator">4.3.3 Stack Iterator</a></li>
+ <li><a href="#Stack_Trace">4.3.4 Stack Trace</a></li>
+ </ol>
+ </li>
+ <li><a href="#Root_Set_Enumeration">4.4 Root Set Enumeration</a>
+ <ol>
+ <li><a href="#Roots">4.4.1 About Roots</a></li>
+ <li><a href="#Method">4.4.2 Black-box Metho</a></li>
+ <li><a href="#Enumeration">4.4.3 Enumeration Procedure</a></li>
+ </ol>
+ </li>
+ <li><a href="#Exception_Handling">4.5 Exception Handling</a>
+ <ol>
+ <li><a href="#Throwing">4.5.1 Throwing Exceptions</a></li>
+ <li><a href="#Raising_Exceptions">4.5.2 Raising Exception</a></li>
+ <li><a href="#Choosing">4.5.3 Choosing the Exception Handling Mode</a></li>
+ </ol>
+ </li>
+ <li><a href="#Finalization">4.6 Finalization</a></li>
+ <ol>
+ <li><a href="#FP">4.6.1 Finalization Procedure</a></li>
+ <li><a href="#Work_Balance">4.6.2 Work Balancing Subsystem</a></li>
+ </ol>
+ </li>
+ <li><a href="#Inter_Component_Optimizations">4.7 Inter-component Optimizations</a>
+ <ol>
+ <li><a href="#Fast_Subtype_Checking">4.7.1 Fast Subtype Checking</a></li>
+ <li><a href="#Direct_Call_Conversion">4.7.2 Direct-call Conversion</a></li>
+ <li><a href="#Fast_Constant_String">4.7.3 Fast Constant-string Instantiation</a></li>
+ <li><a href="#Lazy_Exceptions">4.7.4 Lazy Exceptions</a></li>
+ </ol>
+ </li>
+ <li><a href="#Destroying_VM">4.8 Destroying the VM</a></li>
+ </ol>
+ </li>
+ <li><a href="#References">5. References</a></li>
+ </ol>
<h1>
<a id="Revision_History" name="Revision_History"></a>Revision History
</h1>
@@ -1323,7 +1215,7 @@
<a href="#Top">Back to Top</a>
</p>
<h3>
- <a id="Kernel_Classes" name="Kernel_Classes"></a>3.2.1 Kernel classes
+ <a id="Kernel_Classes" name="Kernel_Classes"></a>3.2.1 Kernel Classes
</h3>
<p>
The VM kernel classes link the virtual machine with the Java<a
@@ -2473,7 +2365,7 @@
</li>
</ol>
<h3>
- <a id="VMStarter" name="VMStarter"></a> 4.1.3 VMStarter class
+ <a id="VMStarter" name="VMStarter"></a> 4.1.3 VMStarter Class
</h3>
<p>
This Java<a href="#*">*</a> class supports specific VM core tasks by
@@ -3485,7 +3377,7 @@
</p>
<h3>
<a id="Fast_Constant_String" name="Fast_Constant_String"></a>4.7.3
- Fast constant-string instantiation
+ Fast Constant-string Instantiation
</h3>
<p>
Constant-string instantiation is common in Java<a href="#*">*</a>
@@ -3710,6 +3602,7 @@
</p>
</body>
</html>
+
Modified: harmony/standard/site/docs/subcomponents/drlvm/emguide.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/subcomponents/drlvm/emguide.html?view=diff&rev=525159&r1=525158&r2=525159
==============================================================================
--- harmony/standard/site/docs/subcomponents/drlvm/emguide.html (original)
+++ harmony/standard/site/docs/subcomponents/drlvm/emguide.html Tue Apr 3 07:10:50 2007
@@ -191,21 +191,23 @@
<h1>
<a name="Guide to Execution Manager Configuration">Guide to Execution Manager Configuration</a>
</h1>
-
- <h2>
- <a name="Contents">Contents</a>
- </h2>
-
- <ol>
-<li><a href="#1. What is EM?">What is EM?</a></li>
-<li><a href="#2. EM Configuration File">EM Configuration File</a></li>
-<li><a href="#3. EM Tracing Options">EM tracing options</a></li>
-<li><a href="#4. More EM Configuration Samples">More EM Configuration Samples</a></li>
-</ol>
-
+ <ol id="TOC">
+ <li>
+ <a href="#What is EM?">What is EM?</a>
+ </li>
+ <li>
+ <a href="#EM Configuration File">EM Configuration File</a>
+ </li>
+ <li>
+ <a href="#EM Tracing Options">EM Tracing Options</a>
+ </li>
+ <li>
+ <a href="#More EM Configuration Samples">More EM Configuration Samples</a>
+ </li>
+ </ol>
<h2>
- <a name="1. What is EM?">1. What is EM?</a>
+ <a name="What is EM?">What is EM?</a>
</h2>
<p>
@@ -217,7 +219,7 @@
<h2>
- <a name="2. EM Configuration File">2. EM Configuration File</a>
+ <a name="EM Configuration File">EM Configuration File</a>
</h2>
<p>
@@ -441,7 +443,7 @@
<h2>
- <a name="3. EM Tracing Options">3. EM Tracing Options</a>
+ <a name="EM Tracing Options">EM Tracing Options</a>
</h2>
<p>
@@ -487,7 +489,7 @@
<h2>
- <a name="4. More EM Configuration Samples">4. More EM Configuration Samples</a>
+ <a name="More EM Configuration Samples">More EM Configuration Samples</a>
</h2>
<p>
Modified: harmony/standard/site/docs/subcomponents/drlvm/encoder_library.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/subcomponents/drlvm/encoder_library.html?view=diff&rev=525159&r1=525158&r2=525159
==============================================================================
--- harmony/standard/site/docs/subcomponents/drlvm/encoder_library.html (original)
+++ harmony/standard/site/docs/subcomponents/drlvm/encoder_library.html Tue Apr 3 07:10:50 2007
@@ -191,49 +191,27 @@
<h1>
<a name="Encoder Library Description for IA-32/Intel64">Encoder Library Description for IA-32/Intel64</a>
</h1>
-
- <h2>
- <a name="Contents">Contents</a>
- </h2>
-
- <ol>
- <li>
- <a href="#1. Revision History">Revision History</a>
- </li>
- <li><a href="#2. About this document">About
- this Document</a> </li>
-
- <li>
- <a href="#3. Overview">Overview</a>
- </li>
-
- <li>
- <a href="#4. Goals and Targets">Goals and Targets</a>
- </li>
-
- <li>
- <a href="#5. Structure">Structure</a>
- </li>
- <li>
- <a href="#6. How It Works">How It Works</a></li>
-
- <ul>
- <li><a href="#6.1 Usage Model">6.1 Usage Model</a></li>
- <li><a href="#6.2 Under the Hood">6.2 Under the
- Hood</a></li>
- <ul>
- <li><a href="#6.2.1 Fast Opcode Lookup">6.2.1 Fast
- Opcode Lookup</a>
- </li>
- <li><a href="#6.2.2 Fast Code Generation">6.2.2 Fast
- Code Generation</a></li>
- </ul>
- </ul>
- </ol>
-
+ <ol id="TOC">
+ <li><a href="#Revision History">Revision History</a></li>
+ <li><a href="#About this document">About This Document</a></li>
+ <li><a href="#Overview">Overview</a></li>
+ <li><a href="#Goals and Targets">Goals and Targets</a></li>
+ <li><a href="#Structure">Structure</a></li>
+ <li><a href="#How It Works">How It Works</a>
+ <ol>
+ <li><a href="#Usage Model">Usage Model</a></li>
+ <li><a href="#Under the Hood">Under the Hood</a>
+ <ol>
+ <li><a href="#Fast Opcode Lookup">Fast Opcode Lookup</a></li>
+ <li><a href="#Fast Code Generation">Fast Code Generation</a></li>
+ </ol>
+ </li>
+ </ol>
+ </li>
+ </ol>
<h2>
- <a name="1. Revision History">1. Revision History</a>
+ <a name="Revision History">Revision History</a>
</h2>
<table>
@@ -269,7 +247,7 @@
<h2>
- <a name="2. About this Document">2. About this Document</a>
+ <a name="About This Document">About This Document</a>
</h2>
<p>
@@ -282,7 +260,7 @@
<h2>
- <a name="3. Overview">3. Overview</a>
+ <a name="Overview">Overview</a>
</h2>
<p>
@@ -312,7 +290,7 @@
<h2>
- <a name="4. Goals and Targets">4. Goals and Targets</a>
+ <a name="Goals and Targets">Goals and Targets</a>
</h2>
<p>The encoder library meets the following requirements:</p>
@@ -336,7 +314,7 @@
<p class="notetext">
The encoder library provides a
simple and generic interface. Clients with special
- needs should use <a href="#6. How It Works">adapters</a>,
+ needs should use <a href="#How It Works">adapters</a>,
which provide a handy and convenient interface and then
translate the data into the generic interface.
</p>
@@ -345,7 +323,7 @@
<h2>
- <a name="5. Structure">5. Structure</a>
+ <a name="Structure">Structure</a>
</h2>
<p>The encoder library includes the following modules:</p>
@@ -555,10 +533,10 @@
<h2>
- <a name="6. How It Works">6. How It Works</a>
+ <a name="How It Works">How It Works</a>
</h2>
- <h3><a name="6.1 Usage Model"><b>6.1 Usage Model</b></a></h3>
+ <h3><a name="Usage Model"><b>Usage Model</b></a></h3>
<p>
The base encoding interface
<code>EncoderBase::encode()</code> is a common generic
@@ -605,7 +583,7 @@
<code>vm/vmcore/src/jvmti/jvmti_dasm.cpp</code>,
<code>vm/vmcore/include/jvmti_dasm.h</code>.
</p>
- <h3><a name="6.2 Under the Hood"><b>6.2 Under the Hood</b></a></h3>
+ <h3><a name="Under the Hood"><b>Under the Hood</b></a></h3>
<p>
The engine gets its input as an operation and a set of
operands, and performs the following operations:
@@ -622,13 +600,13 @@
table plain and elementary. At run time, before the first
usage, a special version of data is pre-compiled, which
requires fewer manipulations. The pre-compiled version provides
- the <a href="#6.2.1 Fast Opcode Lookup">fast opcode lookup</a> and
- the <a href="#6.2.2 Fast Code Generation">
+ the <a href="#Fast Opcode Lookup">fast opcode lookup</a> and
+ the <a href="#Fast Code Generation">
fast code generation</a>.
</p>
<dl>
<dt>
- <a name="6.2.1 Fast Opcode Lookup">6.2.1 Fast Opcode Lookup</a>
+ <a name="Fast Opcode Lookup">Fast Opcode Lookup</a>
</dt>
</dl>
<p>
@@ -646,7 +624,7 @@
</p>
<dl>
<dt>
- <a name="6.2.2 Fast Code Generation">6.2.2 Fast Code
+ <a name="Fast Code Generation">Fast Code
Generation</a>
</dt>
</dl>
Modified: harmony/standard/site/docs/subcomponents/drlvm/gc-howto.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/subcomponents/drlvm/gc-howto.html?view=diff&rev=525159&r1=525158&r2=525159
==============================================================================
--- harmony/standard/site/docs/subcomponents/drlvm/gc-howto.html (original)
+++ harmony/standard/site/docs/subcomponents/drlvm/gc-howto.html Tue Apr 3 07:10:50 2007
@@ -219,48 +219,43 @@
</title>
</head>
<body>
-
-
<h1>
<a id="How_to_Write_DRL_GC" name="How_to_Write_DRL_GC"></a>How to
Write DRL GC
</h1>
-
- <h2><a id="Contents" name="Contents"></a>Contents</a></h2>
-
-
-
- <ol>
- <li>
-
- <a href="#1. About This Document">
- About This Document</a></li>
-
- <li>
- <a href="#2. Establishing the Build Infrastructure">
- Establishing the Build
- Infrastructure</a></li>
-
- <li>
- <a href="#3. Implementing Collector that Uses the GC Interface">
- Implementing Collector that Uses the GC Interface</a></li>
-
- <li>
- <a href="#4. Implementing the GC Algorithm">
- Implementing the GC
- Algorithm</a></li>
-
- <li>
- <a href="#5. Running the VM with the Custom GC">
- Running the VM with the Custom
- GC</a></li>
- </ol>
-
-
-
- <h2><a name="1. About This Document"
- id="1. About This Document">1. About
+ <ol id=TOC>
+ <li><a href="#About This Document">About This Document</a></li>
+ <li><a href="#Establishing the Build Infrastructure">Establishing the Build Infrastructure</a>
+ <ol>
+ <li><a href="#Creating a Directory for a New GC Module">Creating a Directory for a New GC
+ Module</a></li>
+ <li><a href="#Creating a Build Descriptor File">Creating a Build Descriptor File</a></li>
+ <li><a href="#Creating a C++ file with essential include files">Creating a C++ file with
+ Essential Include Files</a></li>
+ <li><a href="#Testing the Configuration">Testing the Configuration</a></li>
+ </ol>
+ </li>
+ <li><a href="#Implementing Collector that Uses the GC Interface">Implementing Collector that
+ Uses the GC Interface</a>
+ <ol>
+ <li><a href="#GC Lifecycle">GC Lifecycle</a></li>
+ <li><a href="#Object allocation">Object Allocation</a></li>
+ <li><a href="#Miscellaneous">Miscellaneous</a></li>
+ <li><a href="#Optional">Optional</a></li>
+ <li><a href="#The VM_GC Interface">The <code>VM_GC</code> Interface</a></li>
+ </ol>
+ </li>
+ <li><a href="#Implementing the GC Algorithm">Implementing the GC Algorithm</a>
+ <ol>
+ <li><a href="#Algorithm Overview">Algorithm Overview</a></li>
+ <li><a href="#Source Code Explained">Source Code Explained</a></li>
+ </ol>
+ </li>
+ <li><a href="#Running the VM with the Custom GC">Running the VM with the Custom GC</a></li>
+ </ol>
+ <h2><a name="About This Document"
+ id="About This Document">About
This Document</a></h2>
<p>This document provides instructions
@@ -288,9 +283,9 @@
<h2>
- <a name="2. Establishing the Build Infrastructure"
- id="2. Establishing the Build Infrastructure">
- 2. Establishing the Build
+ <a name="Establishing the Build Infrastructure"
+ id="Establishing the Build Infrastructure">
+ Establishing the Build
Infrastructure</a></h2>
<p>At this stage, you create the
@@ -310,9 +305,9 @@
Windows/IA-32 architecture.</p>
<h3>
- <a name="2.1 Creating a Directory for a New GC Module"
- id="2.1 Creating a Directory for a New GC Module">
- 2.1 Creating a Directory for a New GC
+ <a name="Creating a Directory for a New GC Module"
+ id="Creating a Directory for a New GC Module">
+ Creating a Directory for a New GC
Module</a></h3>
<p>The example below shows how to
@@ -327,14 +322,14 @@
<p>In the newly created directory you
will store the source code. For more
information, refer to the
- <a href="#4. Implementing the GC Algorithm">
+ <a href="#Implementing the GC Algorithm">
Implementing the GC Algorithm
section.</a></p>
<h3>
- <a name="2.2 Creating a Build Descriptor File"
- id="2.2 Creating a Build Descriptor File">
- 2.2 Creating a Build Descriptor
+ <a name="Creating a Build Descriptor File"
+ id="Creating a Build Descriptor File">
+ Creating a Build Descriptor
File</a></h3>
<p>Create the build descriptor file
@@ -386,10 +381,10 @@
to match your needs.</p>
<h3>
- <a name="2.3 Creating a C++ file with essential include files"
- id="2.3 Creating a C++ file with essential include files">
- 2.3 Creating a C++ file with essential
- include files</a></h3>
+ <a name="Creating a C++ file with essential include files"
+ id="Creating a C++ file with essential include files">
+ Creating a C++ file with Essential
+ Include Files</a></h3>
<p>Create a C++ file with essential
include files, namely:</p>
@@ -410,8 +405,7 @@
details of the interface.</p>
<h3>
- <a name="2.4 Testing the Configuration"
- id="2.4 Testing the Configuration">2.4
+ <a name="Testing the Configuration" id="Testing the Configuration">
Testing the Configuration</a></h3>
<p>Run the build system to test whether
@@ -437,9 +431,9 @@
<h2>
- <a name="3. Implementing Collector that Uses the GC Interface"
- id="3. Implementing Collector that Uses the GC Interface">
- 3. Implementing a Collector that Uses the GC Interface</a></h2>
+ <a name="Implementing Collector that Uses the GC Interface"
+ id="Implementing Collector that Uses the GC Interface">
+ Implementing a Collector that Uses the GC Interface</a></h2>
<p>This section lists the functions
that a garbage collector interface must
@@ -451,8 +445,8 @@
<code>gc.h</code> and
<code>vm_gc.h</code>.</p>
- <h3><a name="3.1 GC Lifecycle"
- id="3.1 GC Lifecycle">3.1 GC
+ <h3><a name="GC Lifecycle"
+ id="GC Lifecycle">GC
Lifecycle</a></h3>
<ul>
@@ -483,9 +477,9 @@
prepared classes</li>
</ul>
- <h3><a name="3.2. Object allocation"
- id="3.2. Object allocation">3.2.
- Object allocation</a></h3>
+ <h3><a name="Object allocation"
+ id="Object allocation">
+ Object Allocation</a></h3>
<ul>
<li><code>gc_alloc()</code>
@@ -511,9 +505,8 @@
<a href="developers_guide.html">Developer's
Guide</a> for details.</p>
- <h3><a name="3.3. Miscellaneous"
- id="3.3. Miscellaneous">3.3.
- Miscellaneous</a></h3>
+ <h3><a name="Miscellaneous"
+ id="Miscellaneous">Miscellaneous</a></h3>
<ul>
<li>
@@ -530,9 +523,8 @@
forces a garbage collection</li>
</ul>
- <h3><a name="3.4. Optional"
- id="3.4. Optional">3.4.
- Optional</a></h3>
+ <h3><a name="Optional"
+ id="Optional">Optional</a></h3>
<p>The virtual machine can operate
without the functions listed below, but
@@ -582,9 +574,9 @@
</ul>
<h3>
- <a name="3.5. The <code>VM_GC</code> Interface"
- id="3.5. The lt;codegt;VM_GClt;/codegt; Interface">
- 3.5. The <code>VM_GC</code>
+ <a name="The VM_GC Interface"
+ id="The VM_GC Interface">
+ The <code>VM_GC</code>
Interface</a></h3>
<p>The garbage collector requires VM
@@ -649,10 +641,9 @@
algorithms only.</p>
<h2>
- <a name="4. Implementing the GC Algorithm"
- id="4. Implementing the GC Algorithm">4.
- Implementing the GC
- Algorithm</a></h2>
+ <a name="Implementing the GC Algorithm"
+ id="Implementing the GC Algorithm">Implementing
+ the GC Algorithm</a></h2>
<p>This section gives step-by-step
instructions on how to implement the
@@ -666,9 +657,8 @@
not implement object finalization and
weak references.</p>
- <h3><a name="4.1. Algorithm Overview"
- id="4.1. Algorithm Overview">4.1.
- Algorithm Overview</a></h3>
+ <h3><a name="Algorithm Overview"
+ id="Algorithm Overview">Algorithm Overview</a></h3>
<p>The heap is divided into two equally
sized contiguous semispaces. During
@@ -755,7 +745,9 @@
Garbage Collection Techniques", Paul R.
Wilson.</p>
- <h3>3.2. Source code explained</h3>
+ <h3><a name="Source Code Explained"
+ id="Source Code Explained">Source Code Explained</a>
+ </h3>
<p>The full source code of the
collector is available in
@@ -1542,9 +1534,9 @@
</div>
<h2>
- <a name="5. Running the VM with the Custom GC"
- id="5. Running the VM with the Custom GC">
- 5. Running the VM with the Custom
+ <a name="Running the VM with the Custom GC"
+ id="Running the VM with the Custom GC">
+ Running the VM with the Custom
GC</a></h2>
<p>This section describes how to run
Modified: harmony/standard/site/docs/subcomponents/drlvm/getting_started.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/subcomponents/drlvm/getting_started.html?view=diff&rev=525159&r1=525158&r2=525159
==============================================================================
--- harmony/standard/site/docs/subcomponents/drlvm/getting_started.html (original)
+++ harmony/standard/site/docs/subcomponents/drlvm/getting_started.html Tue Apr 3 07:10:50 2007
@@ -219,6 +219,20 @@
<h1>
<a id="TOP" name="TOP"></a>Getting Started with DRLVM
</h1>
+ <ol id=TOC>
+ <li><a href="#About_This_Document">About This Document</a></li>
+ <li><a href="#Overview">Overview</a></li>
+ <li><a href="#Running_Hello">Running an Application</a></li>
+ <li><a href="#Developing_Code_in_Eclipse">Developing Code in Eclipse</a>
+ <ol>
+ <li><a href="#Eclipse_Hello_world">Running an Application in Eclipse</a></li>
+ <li><a href="#Eclipse_debug_scenario">Debugging an Application in Eclipse</a></li>
+ </ol>
+ </li>
+ </ol>
+
+ <h1>
+ <a id="About_This_Document" name="About_This_Document"></a>About This Document</h1>
<p>
The Dynamic Runtime Layer virtual machine (DRLVM) is a clean-room implementation
of the Java<a href="#*">*</a> virtual machine for Java 2 Platform, Standard Edition
@@ -233,9 +247,9 @@
and anticipated results. After completing this guide, you will be able to run and
debug your own applications with DRLVM.
</p>
- <h2>
+ <h1>
<a id="Overview" name="Overview"></a>Overview
- </h2>
+ </h1>
<p>
For a definition of the DRL virtual machine and links to all docs describing it,
see the DRLVM <a href="index.html">component page</a>. For instructions on how to
@@ -284,9 +298,8 @@
</p>
</li>
</ol>
- <h1>
- Developing Code in Eclipse
- </h1>
+ <h1><a id="Developing_Code_in_Eclipse" name="Developing_Code_in_Eclipse"></a>
+ Developing Code in Eclipse</h1>
<h2>
<a id="Eclipse_Hello_world" name="Eclipse_Hello_world"></a>Running an Application
in Eclipse
@@ -355,6 +368,7 @@
</p>
</body>
</html>
+
</div>