stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

6533010: SPEC: A few broken links in jvmti.html

Browse Source 
Fix the incorrect links in jvmti.html reported by the LinkCheck tool

Reviewed-by: jjh, dholmes
This commit is contained in:
Serguei Spitsyn 2012-10-29 11:35:20 -07:00 committed by Serguei Spitsyn
parent 4e5ebae2d3
commit cb6de38554
2 changed files with 29 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
hotspot/src/share/vm/prims/jvmti.xml
View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<?xml-stylesheet type="text/xsl" href="jvmti.xsl"?> <?xml-stylesheet type="text/xsl" href="jvmti.xsl"?>
<!-- <!--
Copyright (c) 2002, 2011, Oracle and/or its affiliates. All rights reserved. Copyright (c) 2002, 2012, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it This code is free software; you can redistribute it and/or modify it
@ -358,7 +358,7 @@
<specification label="JVM(TM) Tool Interface" <specification label="JVM(TM) Tool Interface"
majorversion="1" majorversion="1"
minorversion="2" minorversion="2"
microversion="1"> microversion="2">
<title subtitle="Version"> <title subtitle="Version">
<tm>JVM</tm> Tool Interface <tm>JVM</tm> Tool Interface
</title> </title>
@ -405,7 +405,7 @@
interfaces are more appropriate than <jvmti/> for many tools. interfaces are more appropriate than <jvmti/> for many tools.
For more information on the Java Platform Debugger Architecture, For more information on the Java Platform Debugger Architecture,
see the see the
<externallink id="http://java.sun.com/products/jpda/">Java <externallink id="http://docs.oracle.com/javase/7/docs/technotes/guides/jpda/architecture.html">Java
Platform Debugger Architecture website</externallink>. Platform Debugger Architecture website</externallink>.
</intro> </intro>
@ -693,7 +693,7 @@ Agent_OnUnload(JavaVM *vm)</example>
An agent creates a <jvmti/> environment An agent creates a <jvmti/> environment
by passing a <jvmti/> version by passing a <jvmti/> version
as the interface ID to the JNI Invocation API function as the interface ID to the JNI Invocation API function
<externallink id="http://java.sun.com/javase/6/docs/technotes/guides/jni/spec/invocation.html#GetEnv"><code>GetEnv</code></externallink>. <externallink id="http://docs.oracle.com/javase/7/docs/technotes/guides/jni/spec/invocation.html#GetEnv"><code>GetEnv</code></externallink>.
See <internallink id="jvmtiEnvAccess">Accessing <jvmti/> Functions</internallink> See <internallink id="jvmtiEnvAccess">Accessing <jvmti/> Functions</internallink>
for more details on the creation and use of for more details on the creation and use of
<jvmti/> environments. <jvmti/> environments.
@ -797,7 +797,7 @@ Agent_OnUnload(JavaVM *vm)</example>
Modified UTF-8 differs Modified UTF-8 differs
from standard UTF-8 in the representation of supplementary characters from standard UTF-8 in the representation of supplementary characters
and of the null character. See the and of the null character. See the
<externallink id="http://java.sun.com/javase/6/docs/technotes/guides/jni/spec/types.html#wp16542"> <externallink id="http://docs.oracle.com/javase/7/docs/technotes/guides/jni/spec/types.html#wp16542">
Modified UTF-8 Strings</externallink> Modified UTF-8 Strings</externallink>
section of the JNI specification for details. section of the JNI specification for details.
</intro> </intro>
@ -827,7 +827,7 @@ Agent_OnUnload(JavaVM *vm)</example>
by calling <jvmti/> functions. by calling <jvmti/> functions.
Access to <jvmti/> functions is by use of an interface pointer Access to <jvmti/> functions is by use of an interface pointer
in the same manner as in the same manner as
<externallink id="http://java.sun.com/javase/6/docs/technotes/guides/jni/spec/design.html">Java <externallink id="http://docs.oracle.com/javase/7/docs/technotes/guides/jni/spec/design.html">Java
Native Interface (JNI) functions</externallink> are accessed. Native Interface (JNI) functions</externallink> are accessed.
The <jvmti/> interface pointer is called the The <jvmti/> interface pointer is called the
<i>environment pointer</i>. <i>environment pointer</i>.
@ -919,7 +919,7 @@ jvmtiEnv *jvmti;
local references--these local references are created local references--these local references are created
during the <jvmti/> call. during the <jvmti/> call.
Local references are a resource that must be managed (see the Local references are a resource that must be managed (see the
<externallink id="http://java.sun.com/javase/6/docs/guide/jni/spec/functions.html#wp18654">JNI Documentation</externallink>). <externallink id="http://docs.oracle.com/javase/7/docs/technotes/guides/jni/spec/functions.html#wp18654">JNI Documentation</externallink>).
When threads return from native code all local references When threads return from native code all local references
are freed. Note that some threads, including typical are freed. Note that some threads, including typical
agent threads, will never return from native code. agent threads, will never return from native code.
@ -954,7 +954,7 @@ jvmtiEnv *jvmti;
<jvmti/> function. <jvmti/> function.
See the See the
<externallink <externallink
id="http://java.sun.com/javase/6/docs/technotes/guides/jni/spec/design.html#wp770" id="http://docs.oracle.com/javase/7/docs/technotes/guides/jni/spec/design.html#wp770"
>Java Exceptions</externallink> >Java Exceptions</externallink>
section of the JNI specification for information on handling exceptions. section of the JNI specification for information on handling exceptions.
</intro> </intro>
@ -2024,7 +2024,7 @@ jvmtiEnv *jvmti;
<p/> <p/>
Upon execution of <code>proc</code>, the new thread will be attached to the Upon execution of <code>proc</code>, the new thread will be attached to the
VM--see the JNI documentation on VM--see the JNI documentation on
<externallink id="http://java.sun.com/javase/6/docs/technotes/guides/jni/spec/invocation.html#wp1060" <externallink id="http://docs.oracle.com/javase/7/docs/technotes/guides/jni/spec/invocation.html#wp1060"
>Attaching to the VM</externallink>. >Attaching to the VM</externallink>.
</description> </description>
<origin>jvmdiClone</origin> <origin>jvmdiClone</origin>
@ -4010,7 +4010,7 @@ class C2 extends C1 implements I2 {
</inptr> </inptr>
<description> <description>
Details about the reference. Details about the reference.
Set when the <paramlink id="reference_kind"/> is Set when the <datalink id="jvmtiHeapReferenceCallback.reference_kind">reference_kind</datalink> is
<datalink id="JVMTI_HEAP_REFERENCE_FIELD"/>, <datalink id="JVMTI_HEAP_REFERENCE_FIELD"/>,
<datalink id="JVMTI_HEAP_REFERENCE_STATIC_FIELD"/>, <datalink id="JVMTI_HEAP_REFERENCE_STATIC_FIELD"/>,
<datalink id="JVMTI_HEAP_REFERENCE_ARRAY_ELEMENT"/>, <datalink id="JVMTI_HEAP_REFERENCE_ARRAY_ELEMENT"/>,
@ -4378,7 +4378,7 @@ class C2 extends C1 implements I2 {
do not control which objects are visited but they do control which do not control which objects are visited but they do control which
objects and primitive values are reported by the callbacks. objects and primitive values are reported by the callbacks.
For example, if the only callback that was set is For example, if the only callback that was set is
<paramlink id="array_primitive_value_callback"/> and <code>klass</code> <fieldlink id="array_primitive_value_callback" struct="jvmtiHeapCallbacks"/> and <code>klass</code>
is set to the array of bytes class, then only arrays of byte will be is set to the array of bytes class, then only arrays of byte will be
reported. reported.
The table below summarizes this: The table below summarizes this:
@ -4414,7 +4414,7 @@ class C2 extends C1 implements I2 {
</tr> </tr>
<tr> <tr>
<th align="left"> <th align="left">
<fieldlink id="object_reference_callback" struct="jvmtiHeapCallbacks"/> <fieldlink id="array_primitive_value_callback" struct="jvmtiHeapCallbacks"/>
in <paramlink id="callbacks"/> set in <paramlink id="callbacks"/> set
</th> </th>
<td> <td>
@ -4570,7 +4570,7 @@ class C2 extends C1 implements I2 {
do not control which objects are visited but they do control which do not control which objects are visited but they do control which
objects and primitive values are reported by the callbacks. objects and primitive values are reported by the callbacks.
For example, if the only callback that was set is For example, if the only callback that was set is
<paramlink id="array_primitive_value_callback"/> and <code>klass</code> <fieldlink id="array_primitive_value_callback" struct="jvmtiHeapCallbacks"/> and <code>klass</code>
is set to the array of bytes class, then only arrays of byte will be is set to the array of bytes class, then only arrays of byte will be
reported. The table below summarizes this (contrast this with reported. The table below summarizes this (contrast this with
<functionlink id="FollowReferences"/>): <functionlink id="FollowReferences"/>):
@ -4606,7 +4606,7 @@ class C2 extends C1 implements I2 {
</tr> </tr>
<tr> <tr>
<th align="left"> <th align="left">
<fieldlink id="object_callback" struct="jvmtiHeapCallbacks"/> <fieldlink id="array_primitive_value_callback" struct="jvmtiHeapCallbacks"/>
in <paramlink id="callbacks"/> set in <paramlink id="callbacks"/> set
</th> </th>
<td> <td>
@ -6478,7 +6478,7 @@ class C2 extends C1 implements I2 {
<synopsis>Get Class Signature</synopsis> <synopsis>Get Class Signature</synopsis>
<description> <description>
For the class indicated by <code>klass</code>, return the For the class indicated by <code>klass</code>, return the
<externallink id="http://java.sun.com/javase/6/docs/guide/jni/spec/types.html#wp16432">JNI <externallink id="http://docs.oracle.com/javase/7/docs/technotes/guides/jni/spec/types.html#wp16432">JNI
type signature</externallink> type signature</externallink>
and the generic signature of the class. and the generic signature of the class.
For example, <code>java.util.List</code> is <code>"Ljava/util/List;"</code> For example, <code>java.util.List</code> is <code>"Ljava/util/List;"</code>
@ -8763,7 +8763,7 @@ method(wrapped_foo) -> nativeImplementation(foo)</example>
Provides the ability to intercept and resend Provides the ability to intercept and resend
Java Native Interface (JNI) function calls Java Native Interface (JNI) function calls
by manipulating the JNI function table. by manipulating the JNI function table.
See <externallink id="http://java.sun.com/javase/6/docs/guide/jni/spec/functions.html">JNI See <externallink id="http://docs.oracle.com/javase/7/docs/technotes/guides/jni/spec/functions.html">JNI
Functions</externallink> in the <i>Java Native Interface Specification</i>. Functions</externallink> in the <i>Java Native Interface Specification</i>.
<p/> <p/>
The following example illustrates intercepting the The following example illustrates intercepting the
@ -10446,7 +10446,7 @@ myInit() {
for a class. The segment is typically a directory or JAR file. for a class. The segment is typically a directory or JAR file.
<p/> <p/>
In the live phase the <paramlink id="segment"/> may be used to specify any platform-dependent In the live phase the <paramlink id="segment"/> may be used to specify any platform-dependent
path to a <externallink id="http://java.sun.com/javase/6/docs/guide/jar/jar.html"> path to a <externallink id="http://docs.oracle.com/javase/7/docs/technotes/guides/jar/jar.html">
JAR file</externallink>. The agent should take care that the JAR file does not JAR file</externallink>. The agent should take care that the JAR file does not
contain any classes or resources other than those to be defined by the bootstrap contain any classes or resources other than those to be defined by the bootstrap
class loader for the purposes of instrumentation. class loader for the purposes of instrumentation.
@ -10494,7 +10494,7 @@ myInit() {
for a class. The segment is typically a directory or JAR file. for a class. The segment is typically a directory or JAR file.
<p/> <p/>
In the live phase the <paramlink id="segment"/> is a platform-dependent path to a <externallink In the live phase the <paramlink id="segment"/> is a platform-dependent path to a <externallink
id="http://java.sun.com/javase/6/docs/guide/jar/jar.html">JAR file</externallink> to be id="http://docs.oracle.com/javase/7/docs/technotes/guides/jar/jar.html">JAR file</externallink> to be
searched after the system class loader unsuccessfully searches for a class. The agent should searched after the system class loader unsuccessfully searches for a class. The agent should
take care that the JAR file does not contain any classes or resources other than those to be take care that the JAR file does not contain any classes or resources other than those to be
defined by the system class loader for the purposes of instrumentation. defined by the system class loader for the purposes of instrumentation.
@ -13128,6 +13128,12 @@ myInit() {
Unsigned 8 bits. Unsigned 8 bits.
</description> </description>
</basetype> </basetype>
<basetype id="jchar">
<description>
Holds a Java programming language <code>char</code>.
Unsigned 16 bits.
</description>
</basetype>
<basetype id="jint"> <basetype id="jint">
<description> <description>
Holds a Java programming language <code>int</code>. Holds a Java programming language <code>int</code>.
@ -13285,7 +13291,7 @@ typedef void (JNICALL *jvmtiEventVMInit)
<description> <description>
Typedef for the JNI function table <code>JNINativeInterface</code> Typedef for the JNI function table <code>JNINativeInterface</code>
defined in the defined in the
<externallink id="http://java.sun.com/javase/6/docs/guide/jni/spec/functions.html#wp23720">JNI Specification</externallink>. <externallink id="http://docs.oracle.com/javase/7/docs/technotes/guides/jni/spec/functions.html#wp23720">JNI Specification</externallink>.
The JNI reference implementation defines this with an underscore. The JNI reference implementation defines this with an underscore.
</description> </description>
</basetype> </basetype>
@ -14252,6 +14258,9 @@ typedef void (JNICALL *jvmtiEventVMInit)
<change date="6 August 2006" version="1.1.102"> <change date="6 August 2006" version="1.1.102">
Add ResourceExhaustedEvent. Add ResourceExhaustedEvent.
</change> </change>
<change date="11 October 2012" version="1.2.2">
Fixed the "HTTP" and "Missing Anchor" errors reported by the LinkCheck tool.
</change>
</changehistory> </changehistory>
</specification> </specification>

2
hotspot/src/share/vm/prims/jvmtiEnvBase.hpp
View File

@ -69,7 +69,7 @@ class JvmtiEnvBase : public CHeapObj<mtInternal> {
enum { enum {
JDK15_JVMTI_VERSION = JVMTI_VERSION_1_0 + 33, /* version: 1.0.33 */ JDK15_JVMTI_VERSION = JVMTI_VERSION_1_0 + 33, /* version: 1.0.33 */
JDK16_JVMTI_VERSION = JVMTI_VERSION_1_1 + 102, /* version: 1.1.102 */ JDK16_JVMTI_VERSION = JVMTI_VERSION_1_1 + 102, /* version: 1.1.102 */
JDK17_JVMTI_VERSION = JVMTI_VERSION_1_2 + 1 /* version: 1.2.1 */ JDK17_JVMTI_VERSION = JVMTI_VERSION_1_2 + 2 /* version: 1.2.2 */
}; };
static jvmtiPhase get_phase() { return _phase; } static jvmtiPhase get_phase() { return _phase; }