src/hotspot/share/prims/jvmti.xml

rev 50604 : imported patch jep181-rev1

*** 356,366 ****
  
     <!ELEMENT li  ANY>
   ]>
  
  <specification label="JVM(TM) Tool Interface"
!         majorversion="9"
          minorversion="0"
          microversion="0">
    <title subtitle="Version">
      <tm>JVM</tm> Tool Interface
    </title>
--- 356,366 ----
  
     <!ELEMENT li  ANY>
   ]>
  
  <specification label="JVM(TM) Tool Interface"
!         majorversion="11"
          minorversion="0"
          microversion="0">
    <title subtitle="Version">
      <tm>JVM</tm> Tool Interface
    </title>
*** 7629,7641 ****
          <p/>
          In response to this call, no events other than the
          <eventlink id="ClassFileLoadHook"/> event
          will be sent.
          <p/>
!         The retransformation may change method bodies, the constant pool and attributes.
          The retransformation must not add, remove or rename fields or methods, change the
          signatures of methods, change modifiers, or change inheritance.
          These restrictions may be lifted in future versions.
          See the error return description below for information on error codes
          returned if an unsupported retransformation is attempted.
          The class file bytes are not verified or installed until they have passed
          through the chain of <eventlink id="ClassFileLoadHook"/> events, thus the
--- 7629,7644 ----
          <p/>
          In response to this call, no events other than the
          <eventlink id="ClassFileLoadHook"/> event
          will be sent.
          <p/>
!         The retransformation may change method bodies, the constant pool and attributes
!         (unless explicitly prohibited).
          The retransformation must not add, remove or rename fields or methods, change the
          signatures of methods, change modifiers, or change inheritance.
+         The retransformation must not change the <code>NestHost</code> or
+         <code>NestMembers</code> attributes.
          These restrictions may be lifted in future versions.
          See the error return description below for information on error codes
          returned if an unsupported retransformation is attempted.
          The class file bytes are not verified or installed until they have passed
          through the chain of <eventlink id="ClassFileLoadHook"/> events, thus the
*** 7702,7711 ****
--- 7705,7717 ----
          </error>
          <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_METHOD_DELETED">
            A retransformed class file does not declare a method
            declared in the old class version.
          </error>
+         <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_CLASS_ATTRIBUTE_CHANGED">
+           A retransformed class file has unsupported differences in class attributes.
+         </error>
          <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_CLASS_MODIFIERS_CHANGED">
            A retransformed class file has different class modifiers.
          </error>
          <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_METHOD_MODIFIERS_CHANGED">
            A method in the retransformed class file has different modifiers
*** 7776,7788 ****
          <p/>
          In response to this call, the <jvmti/> event
          <eventlink id="ClassFileLoadHook">Class File Load Hook</eventlink>
          will be sent (if enabled), but no other <jvmti/> events will be sent.
          <p/>
!         The redefinition may change method bodies, the constant pool and attributes.
          The redefinition must not add, remove or rename fields or methods, change the
          signatures of methods, change modifiers, or change inheritance.
          These restrictions may be lifted in future versions.
          See the error return description below for information on error codes
          returned if an unsupported redefinition is attempted.
          The class file bytes are not verified or installed until they have passed
          through the chain of <eventlink id="ClassFileLoadHook"/> events, thus the
--- 7782,7797 ----
          <p/>
          In response to this call, the <jvmti/> event
          <eventlink id="ClassFileLoadHook">Class File Load Hook</eventlink>
          will be sent (if enabled), but no other <jvmti/> events will be sent.
          <p/>
!         The redefinition may change method bodies, the constant pool and attributes
!         (unless explicitly prohibited).
          The redefinition must not add, remove or rename fields or methods, change the
          signatures of methods, change modifiers, or change inheritance.
+         The retransformation must not change the <code>NestHost</code> or
+         <code>NestMembers</code> attributes.
          These restrictions may be lifted in future versions.
          See the error return description below for information on error codes
          returned if an unsupported redefinition is attempted.
          The class file bytes are not verified or installed until they have passed
          through the chain of <eventlink id="ClassFileLoadHook"/> events, thus the
*** 7853,7862 ****
--- 7862,7874 ----
          </error>
          <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_METHOD_DELETED">
            A new class version does not declare a method
            declared in the old class version.
          </error>
+         <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_CLASS_ATTRIBUTE_CHANGED">
+           A new class version has unsupported differences in class attributes.
+         </error>
          <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_CLASS_MODIFIERS_CHANGED">
            A new class version has different modifiers.
          </error>
          <error id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_METHOD_MODIFIERS_CHANGED">
            A method in the new class version has different modifiers
*** 11786,11795 ****
--- 11798,11810 ----
      </errorid>
      <errorid id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_METHOD_MODIFIERS_CHANGED" num="71">
        A method in the new class version has different modifiers
        than its counterpart in the old class version.
      </errorid>
+     <errorid id="JVMTI_ERROR_UNSUPPORTED_REDEFINITION_CLASS_ATTRIBUTE_CHANGED" num="72">
+       A new class version has unsupported differences in class attributes.
+     </errorid>
    </errorcategory>
  </errorsection>
  
  <eventsection label="Events">
    <intro label="Handling Events" id="eventIntro">
*** 14925,14934 ****
--- 14940,14956 ----
    <change date="12 February 2017" version="9.0.0">
        Minor update for GetCurrentThread function:
         - The function may return NULL in the start phase if the
           can_generate_early_vmstart capability is enabled.
    </change>
+   <change date="7 February 2018" version="11.0.0">
+       Minor update for new class file NestHost and NestMembers attributes:
+         - Specify that RedefineClasses and RetransformClasses are not allowed
+           to change the class file NestHost and NestMembers attributes.
+         - Add new error JVMTI_ERROR_UNSUPPORTED_REDEFINITION_CLASS_ATTRIBUTE_CHANGED
+           that can be returned by RedefineClasses and RetransformClasses.
+   </change>
  </changehistory>
  
  </specification>
  <!-- Keep this comment at the end of the file
  Local variables: