src/hotspot/share/prims/jvmtiEnv.xsl
changeset 47216 71c04702a3d5
parent 13728 882756847a04
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/hotspot/share/prims/jvmtiEnv.xsl	Tue Sep 12 19:03:39 2017 +0200
@@ -0,0 +1,198 @@
+<?xml version="1.0"?> 
+<!--
+ Copyright (c) 2002, 2012, 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.
+
+ This code is distributed in the hope that it will be useful, but WITHOUT
+ ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ version 2 for more details (a copy is included in the LICENSE file that
+ accompanied this code).
+
+ You should have received a copy of the GNU General Public License version
+ 2 along with this work; if not, write to the Free Software Foundation,
+ Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+
+ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ or visit www.oracle.com if you need additional information or have any
+ questions.
+  
+-->
+
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+
+<xsl:import href="jvmtiLib.xsl"/>
+
+<xsl:output method="text" indent="no" omit-xml-declaration="yes"/>
+
+<xsl:template match="/">
+  <xsl:apply-templates select="specification"/>
+</xsl:template>
+
+<xsl:template match="specification">
+  <xsl:call-template name="sourceHeader"/>
+  <xsl:text>
+
+// end file prefix - do not modify or remove this line
+</xsl:text>
+  <xsl:apply-templates select="functionsection"/>
+</xsl:template>
+
+<xsl:template match="functionsection">
+  <xsl:apply-templates select="category"/>
+</xsl:template>
+
+<xsl:template match="category">
+  <xsl:text>
+  //
+  // </xsl:text><xsl:value-of select="@label"/><xsl:text> functions
+  // 
+</xsl:text>
+  <xsl:apply-templates select="function[not(contains(@impl,'unimpl'))]"/>
+</xsl:template>
+
+<xsl:template match="function">
+  <xsl:apply-templates select="parameters" mode="advice"/>
+  <xsl:text>
+jvmtiError
+JvmtiEnv::</xsl:text>
+  <xsl:if test="count(@hide)=1">
+    <xsl:value-of select="@hide"/>
+  </xsl:if>
+  <xsl:value-of select="@id"/>
+  <xsl:text>(</xsl:text>
+  <xsl:apply-templates select="parameters" mode="HotSpotSig"/>
+  <xsl:text>) {</xsl:text>
+  <xsl:for-each select="parameters/param/jclass">
+    <xsl:if test="count(@method|@field)=0">
+<xsl:text>
+  if (java_lang_Class::is_primitive(k_mirror)) {
+    // DO PRIMITIVE CLASS PROCESSING
+    return JVMTI_ERROR_MUST_POSSESS_CAPABILITY;
+  }
+  Klass* k_oop = java_lang_Class::as_Klass(k_mirror);
+  if (k_oop == NULL) {
+    return JVMTI_ERROR_INVALID_CLASS;
+  }</xsl:text>
+    </xsl:if>
+  </xsl:for-each>
+<xsl:text>
+  return JVMTI_ERROR_MUST_POSSESS_CAPABILITY;
+} /* end </xsl:text>
+  <xsl:if test="count(@hide)=1">
+    <xsl:value-of select="@hide"/>
+  </xsl:if>
+  <xsl:value-of select="@id"/>
+  <xsl:text> */
+
+</xsl:text>
+</xsl:template>
+
+
+<!-- ======== ADVICE ======== -->
+
+<xsl:template match="parameters" mode="advice">
+  <xsl:apply-templates select="param" mode="advice"/>
+</xsl:template>
+
+<xsl:template match="param" mode="advice">
+  <xsl:apply-templates select="child::*[position()=1]" mode="advice">
+    <xsl:with-param name="name" select="@id"/>
+  </xsl:apply-templates>
+</xsl:template>
+
+<xsl:template match="jthread" mode="advice">
+  <xsl:param name="name"/>
+  <xsl:choose>
+    <xsl:when test="count(@impl)=0 or not(contains(@impl,'noconvert'))">
+      <xsl:text>
+// Threads_lock NOT held, java_thread not protected by lock
+// java_thread - pre-checked</xsl:text>
+    </xsl:when>
+    <xsl:otherwise>
+      <xsl:text>
+// Threads_lock NOT held
+// </xsl:text>
+      <xsl:value-of select="$name"/>
+      <xsl:text> - NOT pre-checked</xsl:text>
+    </xsl:otherwise>
+  </xsl:choose>
+</xsl:template>
+
+<xsl:template match="jrawMonitorID" mode="advice">
+  <xsl:param name="name"/>
+  <xsl:text>
+// rmonitor - pre-checked for validity</xsl:text>
+</xsl:template>
+
+<xsl:template match="jframeID" mode="advice">
+  <xsl:param name="name"/>
+  <xsl:text>
+// java_thread - unchecked 
+// depth - pre-checked as non-negative</xsl:text>
+</xsl:template>
+
+<xsl:template match="jmethodID" mode="advice">
+  <xsl:param name="name"/>
+  <xsl:text>
+// method_oop - pre-checked for validity, but may be NULL meaning obsolete method</xsl:text>
+</xsl:template>
+
+<xsl:template match="jfieldID" mode="advice">
+  <xsl:param name="name"/>
+</xsl:template>
+
+<xsl:template match="jclass" mode="advice">
+  <xsl:param name="name"/>
+  <!--
+    classes passed as part of a class/method or class/field pair are used
+    by the wrapper to get the internal type but are not needed by nor 
+    passed to the implementation layer.
+  -->
+  <xsl:if test="count(@method|@field)=0">
+    <xsl:text>
+// k_mirror - may be primitive, this must be checked</xsl:text>
+  </xsl:if>
+</xsl:template>
+
+<xsl:template match="nullok" mode="advice">
+</xsl:template>
+
+<xsl:template match="outptr|outbuf|allocfieldbuf|ptrtype|inptr|inbuf|vmbuf|allocbuf|agentbuf|allocallocbuf" mode="advice">
+  <xsl:param name="name"/>
+  <xsl:choose>
+    <xsl:when test="count(nullok)=0">
+      <xsl:text>
+// </xsl:text>
+      <xsl:value-of select="$name"/>
+      <xsl:text> - pre-checked for NULL</xsl:text>
+    </xsl:when>
+    <xsl:otherwise>
+      <xsl:text>
+// </xsl:text>
+      <xsl:value-of select="$name"/>
+      <xsl:text> - NULL is a valid value, must be checked</xsl:text>
+    </xsl:otherwise>
+  </xsl:choose>
+</xsl:template>
+
+<xsl:template match="jint" mode="advice">
+  <xsl:param name="name"/>
+  <xsl:if test="count(@min)=1">
+    <xsl:text>
+// </xsl:text>
+    <xsl:value-of select="$name"/>
+    <xsl:text> - pre-checked to be greater than or equal to </xsl:text>
+    <xsl:value-of select="@min"/>
+  </xsl:if>
+</xsl:template>
+
+<xsl:template match="jobject|jvalue|jthreadGroup|enum|jlong|jfloat|jdouble|jlocation|jboolean|char|uchar|size_t|void|varargs|struct" mode="advice">
+  <xsl:param name="name"/>
+</xsl:template>
+
+</xsl:stylesheet>