8205113: Update JVMTI doc references to object allocation tracking
authorjmanson
Sat, 23 Jun 2018 01:22:52 -0700
changeset 50737 ada9735476b2
parent 50736 f703d45c5687
child 50740 edf11e5dc766
8205113: Update JVMTI doc references to object allocation tracking Summary: Update the JVMTI VMObjectAlloc spec Reviewed-by: dholmes, sspitsyn
src/hotspot/share/prims/jvmti.xml
--- a/src/hotspot/share/prims/jvmti.xml	Tue Jun 05 11:55:39 2018 +0200
+++ b/src/hotspot/share/prims/jvmti.xml	Sat Jun 23 01:22:52 2018 -0700
@@ -13507,9 +13507,8 @@
   <event label="VM Object Allocation"
 	 id="VMObjectAlloc" const="JVMTI_EVENT_VM_OBJECT_ALLOC" num="84">
     <description>
-      Sent when a method causes the virtual machine to allocate an
-      Object visible to Java programming language code and the
-      allocation is not detectable by other intrumentation mechanisms.
+      Sent when a method causes the virtual machine to directly allocate an
+      Object visible to Java programming language code.
       Generally object allocation should be detected by instrumenting
       the bytecodes of allocating methods.
       Object allocation generated in native code by JNI function
@@ -13520,6 +13519,12 @@
       VM. These methods should send this event.
       Virtual machines which are incapable of bytecode instrumentation
       for some or all of their methods can send this event.
+
+      Note that the <internallink
+      id="SampledObjectAlloc">SampledObjectAlloc</internallink>
+      event is triggered on all Java object allocations, including those
+      caused by bytecode method execution, JNI method execution, and
+      directly by VM methods.
       <p/>
       Typical examples where this event might be sent:
       <ul>