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