src/share/vm/prims/jvmti.xml

Print this page

        

@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <?xml-stylesheet type="text/xsl" href="jvmti.xsl"?>
 <!--
- Copyright (c) 2002, 2013, Oracle and/or its affiliates. All rights reserved.
+ Copyright (c) 2002, 2015, Oracle and/or its affiliates. All rights reserved.
  DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 
  This code is free software; you can redistribute it and/or modify it
  under the terms of the GNU General Public License version 2 only, as
  published by the Free Software Foundation.

@@ -355,12 +355,12 @@
    <!ELEMENT li  ANY>
  ]>
 
 <specification label="JVM(TM) Tool Interface"
         majorversion="1"
-        minorversion="2"
-        microversion="3">
+        minorversion="3"
+        microversion="1">
   <title subtitle="Version">
     <tm>JVM</tm> Tool Interface
   </title>
   
   <intro id="whatIs" label="What is the JVM Tool Interface?">

@@ -12349,11 +12349,11 @@
           </description>
       </param>
     </parameters>
   </event>
 
-  <event label="Class File Load Hook" phase="any"
+  <event label="Class File Load Hook" phase="start"
          id="ClassFileLoadHook" const="JVMTI_EVENT_CLASS_FILE_LOAD_HOOK" num="54">
     <description>
       This event is sent when the VM obtains class file data,
       but before it constructs
       the in-memory representation for that class. 

@@ -12365,24 +12365,22 @@
       the existing class file data sent by the VM to include profiling/debugging hooks.
       See the description of 
       <internallink id="bci">bytecode instrumentation</internallink>
       for usage information.
       <p/>
-    This event may be sent before the VM is initialized (the primordial 
-    <functionlink id="GetPhase">phase</functionlink>). During this time
-    no VM resources should be created.  Some classes might not be compatible
+    This event may be sent before the VM is initialized (the start 
+    <functionlink id="GetPhase">phase</functionlink>).
+    Some classes might not be compatible
     with the function (eg. ROMized classes) and this event will not be
     generated for these classes.
     <p/>
     The agent must allocate the space for the modified 
     class file data buffer
     using the memory allocation function 
     <functionlink id="Allocate"></functionlink> because the
     VM is responsible for freeing the new class file data buffer
     using <functionlink id="Deallocate"></functionlink>.  
-    Note that <functionlink id="Allocate"></functionlink>
-    is permitted during the primordial phase.
     <p/>
     If the agent wishes to modify the class file, it must set 
     <code>new_class_data</code> to point
     to the newly instrumented class file data buffer and set
     <code>new_class_data_len</code> to the length of that 

@@ -12425,12 +12423,10 @@
         <outptr>
           <struct>JNIEnv</struct>
         </outptr>
           <description>
             The JNI environment of the event (current) thread.
-            Will be <code>NULL</code> if sent during the primordial 
-            <functionlink id="GetPhase">phase</functionlink>.
           </description>
       </param>
       <param id="class_being_redefined">
         <jclass/>
         <description>

@@ -14338,10 +14334,13 @@
       Fixed the "HTTP" and "Missing Anchor" errors reported by the LinkCheck tool.
   </change>
   <change date="19 June 2013" version="1.2.3">
       Added support for statically linked agents.
   </change>
+  <change date="1 July 2015" version="1.3.1">
+      The ClassFileLoadHook events are not sent during the primordial phase anymore.
+  </change>
 </changehistory>
 
 </specification>
 <!-- Keep this comment at the end of the file
 Local variables: