8164523: Clean up metadata for event based tracing
Reviewed-by: mlarsson, mgronlun
<?xml version="1.0" encoding="utf-8"?>
<!--
Copyright (c) 2012, 2016, 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.
-->
<!DOCTYPE types SYSTEM "trace.dtd">
<!--
Content types (complex) should create constant pool data
in the recording.
Currently at least, there is _NO_ verification that whatever
writer you have is actually writing correctly. So BE CAREFUL!
Declared with the 'content_type' tag.
<type> is the ID type, i.e the integer type that resolves this. Most often
U4 or U8, but for example really small number constants, like GCTYPE uses U1.
<content-type> is where it gets interesting. 'builtin_type' means we're
defining how we resolve one of the trace built-in types (Class, Thread etc),
jvm_type means defining a new one for our own use.
Example: (GcMode)
<content_type id="GCMode" hr_name="GC mode" type="U1" jvm_type="GCMODE">
<value type="STRING" field="desc" description="Description"/>
</content_type>
This creates a content type CONTENT_TYPE_GCMODE
The field type referencing it is u1 (U1), and the constant pool struct has one field, the name.
Before we can use it we need also define a primary field data type:
<primary_type symbol="GCMODE" datatype="U1" contenttype="NONE"
type="u8" sizeop="sizeof(u1)"/>
Now we can use the content + data type in declaring event fields.
-->
<types>
<content_types>
<content_type id="Thread" hr_name="Thread"
type="U8" builtin_type="THREAD">
<value type="STRING" field="osName" label="OS Thread Name"/>
<value type="LONG" field="osThreadId" label="OS Thread Id"/>
<value type="STRING" field="javaName" label="Java Thread Name"/>
<value type="LONG" field="javaThreadId" label="Java Thread Id"/>
<value type="THREADGROUP" field="group" label="Java Thread Group"/>
</content_type>
<content_type id="ThreadGroup" hr_name="Thread group"
type="U8" jvm_type="THREADGROUP">
<value type="THREADGROUP" field="parent" label="Parent"/>
<value type="STRING" field="name" label="Name"/>
</content_type>
<content_type id="Class" hr_name="Java class"
type="U8" builtin_type="CLASS">
<value type="CLASS" field="classLoaderType" label="Class Loader"/>
<value type="SYMBOL" field="name" label="Name"/>
<value type="PACKAGE" field="package" label="Package"/>
<value type="INTEGER" field="modifiers" label="Access Modifiers"/>
</content_type>
<content_type id="Method" hr_name="Java method"
type="U8" jvm_type="METHOD">
<value type="CLASS" field="type" label="Type"/>
<value type="SYMBOL" field="name" label="Name"/>
<value type="SYMBOL" field="descriptor" label="Descriptor"/>
<value type="INTEGER" field="modifiers" label="Access Modifiers"/>
<value type="BOOLEAN" field="hidden" label="Hidden"/>
</content_type>
<content_type id="Symbol" hr_name="Symbol"
type="U8" jvm_type="SYMBOL">
<value type="STRING" field="string" label="String"/>
</content_type>
<content_type id="ThreadState" hr_name="Java Thread State"
type="U8" jvm_type="THREADSTATE">
<value type="STRING" field="name" label="Name"/>
</content_type>
<content_type id="GCName" hr_name="GC Name"
type="U8" jvm_type="GCNAME">
<value type="STRING" field="name" label="Name" />
</content_type>
<content_type id="GCCause" hr_name="GC Cause"
type="U8" jvm_type="GCCAUSE">
<value type="STRING" field="cause" label="Cause" />
</content_type>
<content_type id="GCWhen" hr_name="GC When"
type="U8" jvm_type="GCWHEN">
<value type="STRING" field="when" label="When" />
</content_type>
<content_type id="G1HeapRegionType" hr_name="G1 Heap Region Type"
type="U8" jvm_type="G1HEAPREGIONTYPE">
<value type="STRING" field="type" label="Type" />
</content_type>
<content_type id="G1YCType" hr_name="G1 YC Type"
type="U8" jvm_type="G1YCTYPE">
<value type="STRING" field="type" label="Type" />
</content_type>
<content_type id="GCThresholdUpdater" hr_name="GC Treshold Updater"
type="U8" jvm_type="GCTHRESHOLDUPDATER">
<value type="STRING" field="updater" label="Updater" />
</content_type>
<content_type id="ReferenceType" hr_name="Reference Type"
type="U8" jvm_type="REFERENCETYPE">
<value type="STRING" field="type" label="Type" />
</content_type>
<content_type id="MetadataType" hr_name="Metadata Type"
type="U8" jvm_type="METADATATYPE">
<value type="STRING" field="type" label="Type" />
</content_type>
<content_type id="MetaspaceObjectType" hr_name="Metaspace Object Type"
type="U8" jvm_type="METASPACEOBJTYPE">
<value type="STRING" field="type" label="Type" />
</content_type>
<content_type id="NarrowOopMode" hr_name="Narrow oop Mode"
type="U8" jvm_type="NARROWOOPMODE">
<value type="STRING" field="mode" label="Mode" />
</content_type>
<content_type id="VMOperationType" hr_name="VM Operation Type"
type="U8" jvm_type="VMOPERATIONTYPE">
<value type="STRING" field="type" label="Type" />
</content_type>
<content_type id="CompilerPhaseType" hr_name="Compiler Phase Type"
type="U8" jvm_type="COMPILERPHASETYPE">
<value type="STRING" field="phase" label="Phase" />
</content_type>
<content_type id="FlagValueOrigin" hr_name="Flag Value Origin"
type="U8" jvm_type="FLAGVALUEORIGIN">
<value type="STRING" field="origin" label="Origin" />
</content_type>
<content_type id="CodeBlobType" hr_name="Code Blob Type"
type="U8" jvm_type="CODEBLOBTYPE">
<value type="STRING" field="type" label="Type" />
</content_type>
<content_type id="InflateCause" hr_name="Inflation Cause"
type="U8" jvm_type="INFLATECAUSE">
<value type="STRING" field="cause" label="Cause" />
</content_type>
<content_type id="Module" hr_name="Module"
type="U8" jvm_type="MODULE">
<value type="SYMBOL" field="name" label="Name"/>
<value type="SYMBOL" field="version" label="Version"/>
<value type="SYMBOL" field="location" label="Location"/>
<value type="CLASS" field="classLoader" label="Class Loader"/>
</content_type>
<content_type id="Package" hr_name="Package"
type="U8" jvm_type="PACKAGE">
<value type="SYMBOL" field="name" label="Name"/>
<value type="MODULE" field="module" label="Module"/>
<value type="BOOLEAN" field="exported" label="Exported"/>
</content_type>
</content_types>
<primary_types>
<!--
- primary_type takes these attributes:
- symbol INTEGER, LONG etc
- datatype The trace datatype, see enum DataType
- contenttype Either resolved content type or the semantic meaning
- type The actual type as used in structures etc
- sizeop A function/macro that can be applied on a single
- struct value of type "type" and yield the factual byte
- size we need to write. The % is replaced by the value
-->
<!-- SIGNED 64bit -->
<primary_type symbol="LONG" datatype="LONG" contenttype="NONE"
type="s8" sizeop="sizeof(s8)"/>
<!-- UNSIGNED 64bit -->
<primary_type symbol="ULONG" datatype="U8" contenttype="NONE"
type="u8" sizeop="sizeof(u8)"/>
<!-- SIGNED 32bit -->
<primary_type symbol="INTEGER" datatype="INT" contenttype="NONE"
type="s4" sizeop="sizeof(s4)"/>
<!-- UNSIGNED 32bit -->
<primary_type symbol="UINT" datatype="U4" contenttype="NONE"
type="unsigned" sizeop="sizeof(unsigned)"/>
<!-- UNSIGNED 16bit -->
<primary_type symbol="USHORT" datatype="U2" contenttype="NONE"
type="u2" sizeop="sizeof(u2)"/>
<!-- SIGNED 16bit -->
<primary_type symbol="SHORT" datatype="SHORT" contenttype="NONE"
type="s2" sizeop="sizeof(s2)"/>
<!-- SIGNED 8bit -->
<primary_type symbol="BYTE" datatype="BYTE" contenttype="NONE"
type="s1" sizeop="sizeof(s1)"/>
<!-- UNSIGNED 8bit -->
<primary_type symbol="UBYTE" datatype="U1" contenttype="NONE"
type="u1" sizeop="sizeof(u1)"/>
<!-- float 32bit -->
<primary_type symbol="FLOAT" datatype="FLOAT" contenttype="NONE"
type="float" sizeop="sizeof(float)"/>
<!-- float 64bit -->
<primary_type symbol="DOUBLE" datatype="DOUBLE" contenttype="NONE"
type="double" sizeop="sizeof(double)"/>
<!-- boolean type (1-byte) -->
<primary_type symbol="BOOLEAN" datatype="BOOLEAN" contenttype="NONE"
type="bool" sizeop="1"/>
<!-- 32-bit unsigned integer, SEMANTIC value BYTES -->
<primary_type symbol="BYTES" datatype="U8" contenttype="BYTES"
type="u8" sizeop="sizeof(u8)"/>
<primary_type symbol="IOBYTES" datatype="U8" contenttype="BYTES"
type="u8" sizeop="sizeof(u8)"/>
<!-- 64-bit unsigned integer, SEMANTIC value BYTES -->
<primary_type symbol="BYTES64" datatype="U8" contenttype="BYTES"
type="u8" sizeop="sizeof(u8)"/>
<!-- 64-bit unsigned integer, SEMANTIC value ABSOLUTE MILLISECONDS -->
<primary_type symbol="EPOCHMILLIS" datatype="LONG" contenttype="EPOCHMILLIS"
type="s8" sizeop="sizeof(s8)"/>
<!-- 64-bit unsigned integer, SEMANTIC value RELATIVE MILLISECONDS -->
<primary_type symbol="MILLIS" datatype="LONG" contenttype="MILLIS"
type="s8" sizeop="sizeof(s8)"/>
<!-- 64-bit unsigned integer, SEMANTIC value RELATIVE NANOSECONDS -->
<primary_type symbol="NANOS" datatype="LONG" contenttype="NANOS"
type="s8" sizeop="sizeof(s8)"/>
<!-- 64-bit signed integer, SEMANTIC value TICKS -->
<primary_type symbol="TICKS" datatype="LONG" contenttype="TICKS"
type="Ticks" sizeop="sizeof(s8)"/>
<!-- 64-bit signed integer, SEMANTIC value TICKS duration -->
<primary_type symbol="TICKSPAN" datatype="LONG" contenttype="TICKS"
type="Tickspan" sizeop="sizeof(s8)"/>
<!-- 64-bit unsigned integer, SEMANTIC value ADDRESS (mem loc) -->
<primary_type symbol="ADDRESS" datatype="U8" contenttype="ADDRESS"
type="u8" sizeop="sizeof(u8)"/>
<!-- 32-bit float, SEMANTIC value PERCENTAGE (0.0-1.0) -->
<primary_type symbol="PERCENTAGE" datatype="FLOAT" contenttype="PERCENTAGE"
type="float" sizeop="sizeof(float)"/>
<!-- STRING is a virtual type - depending on encoding
it will have polymorphic content -->
<primary_type symbol="STRING" datatype="STRING" contenttype="NONE"
type="const char*" sizeop="sizeof_utf(%)"/>
<!-- Symbol* constant. Note that this may currently ONLY be used by
classes, methods fields. This restriction might be lifted. -->
<primary_type symbol="SYMBOL" datatype="U8" contenttype="SYMBOL"
type="const Symbol*" sizeop="sizeof(u8)"/>
<!-- A Klass *. The actual class is marked as "used" and will
eventually be written into the recording constant pool -->
<primary_type symbol="CLASS" datatype="U8" contenttype="CLASS"
type="const Klass*" sizeop="sizeof(u8)"/>
<primary_type symbol="MODULE" datatype="U8" contenttype="MODULE"
type="const ModuleEntry*" sizeop="sizeof(u8)"/>
<primary_type symbol="PACKAGE" datatype="U8" contenttype="PACKAGE"
type="const PackageEntry*" sizeop="sizeof(u8)"/>
<!-- A Method *. The method is marked as "used" and will eventually be
written into the recording constant pool. -->
<primary_type symbol="METHOD" datatype="U8" contenttype="METHOD"
type="const Method*" sizeop="sizeof(u8)"/>
<!-- The type for stacktraces in the recording. Shoudl not be used by
events explicitly -->
<primary_type symbol="STACKTRACE" datatype="U8" contenttype="STACKTRACE"
type="u8" sizeop="sizeof(u8)"/>
<!-- Thread ID -->
<primary_type symbol="THREAD" datatype="U8" contenttype="THREAD"
type="u8" sizeop="sizeof(u8)"/>
<!-- Threadgroup THIS TYPE MAY NOT BE USED IN NORMAL EVENTS (ATM). Only
for thread constant pool // KK TODO: u8 should be ObjectP -->
<primary_type symbol="THREADGROUP" datatype="U8" contenttype="THREADGROUP"
type="u8" sizeop="sizeof(u8)"/>
<!-- FRAMETYPE enum -->
<primary_type symbol="FRAMETYPE" datatype="U8" contenttype="FRAMETYPE"
type="u8" sizeop="sizeof(u8)"/>
<!-- THREADSTATE enum -->
<primary_type symbol="THREADSTATE" datatype="U8" contenttype="THREADSTATE"
type="u8" sizeop="sizeof(u8)"/>
<!-- GCName -->
<primary_type symbol="GCNAME" datatype="U8" contenttype="GCNAME"
type="u8" sizeop="sizeof(u8)" />
<!-- GCCAUSE -->
<primary_type symbol="GCCAUSE" datatype="U8" contenttype="GCCAUSE"
type="u8" sizeop="sizeof(u8)" />
<!-- GCWHEN -->
<primary_type symbol="GCWHEN" datatype="U8" contenttype="GCWHEN"
type="u8" sizeop="sizeof(u8)" />
<!-- G1HEAPREGIONTYPE -->
<primary_type symbol="G1HEAPREGIONTYPE" datatype="U8" contenttype="G1HEAPREGIONTYPE"
type="u8" sizeop="sizeof(u8)" />
<!-- G1YCType -->
<primary_type symbol="G1YCTYPE" datatype="U8" contenttype="G1YCTYPE"
type="u8" sizeop="sizeof(u8)" />
<!-- GCTHRESHOLDUPDATER -->
<primary_type symbol="GCTHRESHOLDUPDATER" datatype="U8" contenttype="GCTHRESHOLDUPDATER"
type="u8" sizeop="sizeof(u8)" />
<!-- REFERENCETYPE -->
<primary_type symbol="REFERENCETYPE" datatype="U8" contenttype="REFERENCETYPE"
type="u8" sizeop="sizeof(u8)" />
<!-- METADATATYPE -->
<primary_type symbol="METADATATYPE" datatype="U8" contenttype="METADATATYPE"
type="u8" sizeop="sizeof(u8)" />
<!-- METADATAOBJTYPE -->
<primary_type symbol="METASPACEOBJTYPE" datatype="U8" contenttype="METASPACEOBJTYPE"
type="u8" sizeop="sizeof(u8)" />
<!-- NARROWOOPMODE -->
<primary_type symbol="NARROWOOPMODE" datatype="U8" contenttype="NARROWOOPMODE"
type="u8" sizeop="sizeof(u8)" />
<!-- COMPILERPHASETYPE -->
<primary_type symbol="COMPILERPHASETYPE" datatype="U8" contenttype="COMPILERPHASETYPE"
type="u8" sizeop="sizeof(u8)" />
<!-- VMOPERATIONTYPE -->
<primary_type symbol="VMOPERATIONTYPE" datatype="U8" contenttype="VMOPERATIONTYPE"
type="u8" sizeop="sizeof(u8)" />
<!-- FLAGVALUEORIGIN -->
<primary_type symbol="FLAGVALUEORIGIN" datatype="U8" contenttype="FLAGVALUEORIGIN"
type="u8" sizeop="sizeof(u8)" />
<!-- CODEBLOBTYPE -->
<primary_type symbol="CODEBLOBTYPE" datatype="U8" contenttype="CODEBLOBTYPE"
type="u8" sizeop="sizeof(u8)" />
<!-- INFLATECAUSE -->
<primary_type symbol="INFLATECAUSE" datatype="U8" contenttype="INFLATECAUSE"
type="u8" sizeop="sizeof(u8)" />
</primary_types>
</types>