src/hotspot/share/prims/jvmti.xml
changeset 50735 2f2af62dfac7
parent 50578 e2a7f431f65c
child 50737 ada9735476b2
equal deleted inserted replaced
50734:0828a0f6676b 50735:2f2af62dfac7
   356 
   356 
   357    <!ELEMENT li  ANY>
   357    <!ELEMENT li  ANY>
   358  ]>
   358  ]>
   359 
   359 
   360 <specification label="JVM(TM) Tool Interface"
   360 <specification label="JVM(TM) Tool Interface"
   361         majorversion="9"
   361         majorversion="11"
   362         minorversion="0"
   362         minorversion="0"
   363         microversion="0">
   363         microversion="0">
   364   <title subtitle="Version">
   364   <title subtitle="Version">
   365     <tm>JVM</tm> Tool Interface
   365     <tm>JVM</tm> Tool Interface
   366   </title>
   366   </title>
  7629         <p/>
  7629         <p/>
  7630         In response to this call, no events other than the
  7630         In response to this call, no events other than the
  7631         <eventlink id="ClassFileLoadHook"/> event
  7631         <eventlink id="ClassFileLoadHook"/> event
  7632         will be sent.
  7632         will be sent.
  7633         <p/>
  7633         <p/>
  7634         The retransformation may change method bodies, the constant pool and attributes.
  7634         The retransformation may change method bodies, the constant pool and attributes
       
  7635         (unless explicitly prohibited).
  7635         The retransformation must not add, remove or rename fields or methods, change the
  7636         The retransformation must not add, remove or rename fields or methods, change the
  7636         signatures of methods, change modifiers, or change inheritance.
  7637         signatures of methods, change modifiers, or change inheritance.
       
  7638         The retransformation must not change the <code>NestHost</code> or
       
  7639         <code>NestMembers</code> attributes.
  7637         These restrictions may be lifted in future versions.
  7640         These restrictions may be lifted in future versions.
  7638         See the error return description below for information on error codes
  7641         See the error return description below for information on error codes
  7639         returned if an unsupported retransformation is attempted.
  7642         returned if an unsupported retransformation is attempted.
  7640         The class file bytes are not verified or installed until they have passed
  7643         The class file bytes are not verified or installed until they have passed
  7641         through the chain of <eventlink id="ClassFileLoadHook"/> events, thus the
  7644         through the chain of <eventlink id="ClassFileLoadHook"/> events, thus the
  7701           interfaces is different.
  7704           interfaces is different.
  7702         </error>
  7705         </error>
  7703         <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_METHOD_DELETED">
  7706         <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_METHOD_DELETED">
  7704           A retransformed class file does not declare a method
  7707           A retransformed class file does not declare a method
  7705           declared in the old class version.
  7708           declared in the old class version.
       
  7709         </error>
       
  7710         <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_CLASS_ATTRIBUTE_CHANGED">
       
  7711           A retransformed class file has unsupported differences in class attributes.
  7706         </error>
  7712         </error>
  7707         <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_CLASS_MODIFIERS_CHANGED">
  7713         <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_CLASS_MODIFIERS_CHANGED">
  7708           A retransformed class file has different class modifiers.
  7714           A retransformed class file has different class modifiers.
  7709         </error>
  7715         </error>
  7710         <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_METHOD_MODIFIERS_CHANGED">
  7716         <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_METHOD_MODIFIERS_CHANGED">
  7776 	<p/>
  7782 	<p/>
  7777 	In response to this call, the <jvmti/> event
  7783 	In response to this call, the <jvmti/> event
  7778         <eventlink id="ClassFileLoadHook">Class File Load Hook</eventlink>
  7784         <eventlink id="ClassFileLoadHook">Class File Load Hook</eventlink>
  7779         will be sent (if enabled), but no other <jvmti/> events will be sent.
  7785         will be sent (if enabled), but no other <jvmti/> events will be sent.
  7780         <p/>
  7786         <p/>
  7781         The redefinition may change method bodies, the constant pool and attributes.
  7787         The redefinition may change method bodies, the constant pool and attributes
       
  7788         (unless explicitly prohibited).
  7782         The redefinition must not add, remove or rename fields or methods, change the
  7789         The redefinition must not add, remove or rename fields or methods, change the
  7783         signatures of methods, change modifiers, or change inheritance.
  7790         signatures of methods, change modifiers, or change inheritance.
       
  7791         The retransformation must not change the <code>NestHost</code> or
       
  7792         <code>NestMembers</code> attributes.
  7784         These restrictions may be lifted in future versions.
  7793         These restrictions may be lifted in future versions.
  7785 	See the error return description below for information on error codes
  7794 	See the error return description below for information on error codes
  7786 	returned if an unsupported redefinition is attempted.
  7795 	returned if an unsupported redefinition is attempted.
  7787         The class file bytes are not verified or installed until they have passed
  7796         The class file bytes are not verified or installed until they have passed
  7788         through the chain of <eventlink id="ClassFileLoadHook"/> events, thus the
  7797         through the chain of <eventlink id="ClassFileLoadHook"/> events, thus the
  7853 	</error>
  7862 	</error>
  7854 	<error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_METHOD_DELETED">
  7863 	<error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_METHOD_DELETED">
  7855 	  A new class version does not declare a method
  7864 	  A new class version does not declare a method
  7856 	  declared in the old class version.
  7865 	  declared in the old class version.
  7857 	</error>
  7866 	</error>
       
  7867         <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_CLASS_ATTRIBUTE_CHANGED">
       
  7868           A new class version has unsupported differences in class attributes.
       
  7869         </error>
  7858 	<error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_CLASS_MODIFIERS_CHANGED">
  7870 	<error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_CLASS_MODIFIERS_CHANGED">
  7859 	  A new class version has different modifiers.
  7871 	  A new class version has different modifiers.
  7860 	</error>
  7872 	</error>
  7861 	<error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_METHOD_MODIFIERS_CHANGED">
  7873 	<error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_METHOD_MODIFIERS_CHANGED">
  7862 	  A method in the new class version has different modifiers
  7874 	  A method in the new class version has different modifiers
 11786     </errorid>
 11798     </errorid>
 11787     <errorid id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_METHOD_MODIFIERS_CHANGED" num="71">
 11799     <errorid id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_METHOD_MODIFIERS_CHANGED" num="71">
 11788       A method in the new class version has different modifiers
 11800       A method in the new class version has different modifiers
 11789       than its counterpart in the old class version.
 11801       than its counterpart in the old class version.
 11790     </errorid>
 11802     </errorid>
       
 11803     <errorid id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_CLASS_ATTRIBUTE_CHANGED" num="72">
       
 11804       A new class version has unsupported differences in class attributes.
       
 11805     </errorid>
 11791   </errorcategory>
 11806   </errorcategory>
 11792 </errorsection>
 11807 </errorsection>
 11793 
 11808 
 11794 <eventsection label="Events">
 11809 <eventsection label="Events">
 11795   <intro label="Handling Events" id="eventIntro">
 11810   <intro label="Handling Events" id="eventIntro">
 14925   <change date="12 February 2017" version="9.0.0">
 14940   <change date="12 February 2017" version="9.0.0">
 14926       Minor update for GetCurrentThread function:
 14941       Minor update for GetCurrentThread function:
 14927        - The function may return NULL in the start phase if the
 14942        - The function may return NULL in the start phase if the
 14928          can_generate_early_vmstart capability is enabled.
 14943          can_generate_early_vmstart capability is enabled.
 14929   </change>
 14944   </change>
       
 14945   <change date="7 February 2018" version="11.0.0">
       
 14946       Minor update for new class file NestHost and NestMembers attributes:
       
 14947         - Specify that RedefineClasses and RetransformClasses are not allowed
       
 14948           to change the class file NestHost and NestMembers attributes.
       
 14949         - Add new error JVMTI_ERROR_UNSUPPORTED_REDEFINITION_CLASS_ATTRIBUTE_CHANGED
       
 14950           that can be returned by RedefineClasses and RetransformClasses.
       
 14951   </change>
 14930 </changehistory>
 14952 </changehistory>
 14931 
 14953 
 14932 </specification>
 14954 </specification>
 14933 <!-- Keep this comment at the end of the file
 14955 <!-- Keep this comment at the end of the file
 14934 Local variables:
 14956 Local variables: