Mercurial > hg > graal-compiler

comparison src/share/vm/trace/tracetypes.xml @ 10405:f2110083203d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
8005849: JEP 167: Event-Based JVM Tracing Reviewed-by: acorn, coleenp, sla Contributed-by: Karen Kinnear <karen.kinnear@oracle.com>, Bengt Rutisson <bengt.rutisson@oracle.com>, Calvin Cheung <calvin.cheung@oracle.com>, Erik Gahlin <erik.gahlin@oracle.com>, Erik Helin <erik.helin@oracle.com>, Jesper Wilhelmsson <jesper.wilhelmsson@oracle.com>, Keith McGuigan <keith.mcguigan@oracle.com>, Mattias Tobiasson <mattias.tobiasson@oracle.com>, Markus Gronlund <markus.gronlund@oracle.com>, Mikael Auno <mikael.auno@oracle.com>, Nils Eliasson <nils.eliasson@oracle.com>, Nils Loodin <nils.loodin@oracle.com>, Rickard Backman <rickard.backman@oracle.com>, Staffan Larsen <staffan.larsen@oracle.com>, Stefan Karlsson <stefan.karlsson@oracle.com>, Yekaterina Kantserova <yekaterina.kantserova@oracle.com>
author sla
date Mon, 10 Jun 2013 11:30:51 +0200
parents
children 060ae9b7ffea
comparison
equal deleted inserted replaced
10404:d0add7016434 10405:f2110083203d
1 <?xml version="1.0" encoding="utf-8"?>
2 <!--
3 Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved.
4 DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5
6 This code is free software; you can redistribute it and/or modify it
7 under the terms of the GNU General Public License version 2 only, as
8 published by the Free Software Foundation.
9
10 This code is distributed in the hope that it will be useful, but WITHOUT
11 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
13 version 2 for more details (a copy is included in the LICENSE file that
14 accompanied this code).
15
16 You should have received a copy of the GNU General Public License version
17 2 along with this work; if not, write to the Free Software Foundation,
18 Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
19
20 Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
21 or visit www.oracle.com if you need additional information or have any
22 questions.
23 -->
24
25 <!DOCTYPE types SYSTEM "trace.dtd">
26
27 <!--
28
29 Content types (complex) should create constant pool data
30 in the recording.
31 Currently at least, there is _NO_ verification that whatever
32 writer you have is actually writing correctly. So BE CAREFUL!
33
34 Declared with the 'content_type' tag.
35
36 <type> is the ID type, i.e the integer type that resolves this. Most often
37 U4 or U8, but for example really small number constants, like GCTYPE uses U1.
38
39 <content-type> is where it gets interesting. 'builtin_type' means we're
40 defining how we resolve one of the trace built-in types (Class, Thread etc),
41 jvm_type means defining a new one for our own use.
42
43 Example: (GcMode)
44
45 <content_type id="GCMode" hr_name="GC mode" type="U1" jvm_type="GCMODE">
46 <value type="UTF8" field="desc" description="Description"/>
47 </content_type>
48
49 This creates a content type CONTENT_TYPE_GCMODE
50 The field type referencing it is u1 (U1), and the constant pool struct has one field, the name.
51
52 Before we can use it we need also define a primary field data type:
53
54 <primary_type symbol="GCMODE" datatype="U1" contenttype="NONE"
55 type="u8" sizeop="sizeof(u1)"/>
56
57 Now we can use the content + data type in declaring event fields.
58 Remember however, that for us to be able to resolve the value later we must also add
59 creating the constant pool data in VM_JFRCheckpoint::write_checkpoint
60
61 ...
62 //CGMODE
63 w->be_uint(CONTENT_TYPE_GCMODE);
64 w->be_uint(MM_GC_MODE_UNINITIALIZED);
65 for (i = 0; i < MM_GC_MODE_UNINITIALIZED; i++) {
66 w->uchar(i);
67 w->write_utf8(gcModeGetName(i));
68 }
69
70 -->
71
72 <types>
73 <content_types>
74 <content_type id="Thread" hr_name="Thread"
75 type="U4" builtin_type="OSTHREAD">
76 <value type="UTF8" field="name" label="Thread name"/>
77 </content_type>
78
79 <content_type id="VMThread" hr_name="VM Thread"
80 type="U8" jvm_type="VMTHREAD">
81 <value type="OSTHREAD" field="thread" label="VM Thread"/>
82 </content_type>
83
84 <!-- The first argument ("JavaThread") is misleading, it's really a
85 java.lang.Thread id (long), but Mission Control depends on the name
86 being "JavaThread" so it shouldn't be changed.
87 -->
88 <content_type id="JavaThread" hr_name="Java thread"
89 type="U8" builtin_type="JAVALANGTHREAD">
90 <value type="OSTHREAD" field="thread" label="OS Thread ID"/>
91 <value type="BYTES64" field="allocInsideTla"
92 label="Allocated bytes inside TLAs"/>
93 <value type="BYTES64" field="allocOutsideTla"
94 label="Allocated bytes outside TLAs"/>
95 <value type="THREADGROUP" field="group" label="Java Thread Group"/>
96 </content_type>
97
98 <content_type id="ThreadGroup" hr_name="Thread group"
99 type="U4" jvm_type="THREADGROUP">
100 <value type="THREADGROUP" field="parent" label="Parent"/>
101 <value type="UTF8" field="name" label="Name"/>
102 </content_type>
103
104 <content_type id="StackTrace" hr_name="Stacktrace"
105 type="U8" builtin_type="STACKTRACE">
106 <value type="BOOLEAN" field="truncated" label="Truncated"/>
107 <structarray type="StackFrame" field="frames" label="Stack frames"/>
108 </content_type>
109
110 <content_type id="Class" hr_name="Java class"
111 type="U8" builtin_type="CLASS">
112 <value type="CLASS" field="loaderClass" label="ClassLoader"/>
113 <value type="SYMBOL" field="name" label="Name"/>
114 <value type="SHORT" field="modifiers" label="Access modifiers"/>
115 </content_type>
116
117 <content_type id="Method" hr_name="Java method"
118 type="U8" jvm_type="METHOD">
119 <value type="CLASS" field="class" label="Class"/>
120 <value type="SYMBOL" field="name" label="Name"/>
121 <value type="SYMBOL" field="signature" label="Signature"/>
122 <value type="SHORT" field="modifiers" label="Access modifiers"/>
123 </content_type>
124
125 <content_type id="UTFConstant" hr_name="UTF constant"
126 type="U8" jvm_type="SYMBOL">
127 <value type="UTF8" field="utf8" label="UTF8 data"/>
128 </content_type>
129
130 <content_type id="ThreadState" hr_name="Java Thread State"
131 type="U2" jvm_type="THREADSTATE">
132 <value type="UTF8" field="name" label="Name"/>
133 </content_type>
134
135 <content_type id="FrameType" hr_name="Frame type"
136 type="U1" jvm_type="FRAMETYPE">
137 <value type="UTF8" field="desc" label="Description"/>
138 </content_type>
139
140 <struct_type id="StackFrame">
141 <value type="METHOD" field="method" label="Java Method"/>
142 <value type="INTEGER" field="line" label="Line number"/>
143 <value type="FRAMETYPE" field="type" label="Frame type"/>
144 </struct_type>
145
146 <content_type id="GCName" hr_name="GC Name"
147 type="U1" jvm_type="GCNAME">
148 <value type="UTF8" field="name" label="name" />
149 </content_type>
150
151 <content_type id="GCCause" hr_name="GC Cause"
152 type="U2" jvm_type="GCCAUSE">
153 <value type="UTF8" field="cause" label="cause" />
154 </content_type>
155
156 <content_type id="GCWhen" hr_name="GC When"
157 type="U1" jvm_type="GCWHEN">
158 <value type="UTF8" field="when" label="when" />
159 </content_type>
160
161 <content_type id="G1YCType" hr_name="G1 YC Type"
162 type="U1" jvm_type="G1YCTYPE">
163 <value type="UTF8" field="type" label="type" />
164 </content_type>
165
166 <content_type id="ReferenceType" hr_name="Reference Type"
167 type="U1" jvm_type="REFERENCETYPE">
168 <value type="UTF8" field="type" label="type" />
169 </content_type>
170
171 <content_type id="NARROW_OOP_MODE" hr_name="Narrow Oop Mode"
172 type="U1" jvm_type="NARROWOOPMODE">
173 <value type="UTF8" field="mode" label="mode" />
174 </content_type>
175
176 <content_type id="VMOperationType" hr_name="VM Operation Type"
177 type="U2" jvm_type="VMOPERATIONTYPE">
178 <value type="UTF8" field="type" label="type" />
179 </content_type>
180
181 <content_type id="CompilerPhaseType" hr_name="Compiler Phase Type"
182 type="U1" jvm_type="COMPILERPHASETYPE">
183 <value type="UTF8" field="phase" label="phase" />
184 </content_type>
185
186 </content_types>
187
188
189 <primary_types>
190 <!--
191 - primary_type takes these attributes:
192 - symbol INTEGER, LONG etc
193 - datatype The trace datatype, see enum DataType
194 - contenttype Either resolved content type or the semantic meaning
195 - type The actual type as used in structures etc
196 - sizeop A function/macro that can be applied on a single
197 - struct value of type "type" and yield the factual byte
198 - size we need to write. The % is replaced by the value
199 -->
200
201 <!-- SIGNED 64bit -->
202 <primary_type symbol="LONG" datatype="LONG" contenttype="NONE"
203 type="s8" sizeop="sizeof(s8)"/>
204
205 <!-- UNSIGNED 64bit -->
206 <primary_type symbol="ULONG" datatype="U8" contenttype="NONE"
207 type="u8" sizeop="sizeof(u8)"/>
208
209 <!-- SIGNED 32bit -->
210 <primary_type symbol="INTEGER" datatype="INT" contenttype="NONE"
211 type="s4" sizeop="sizeof(s4)"/>
212
213 <!-- UNSIGNED 32bit -->
214 <primary_type symbol="UINT" datatype="U4" contenttype="NONE"
215 type="unsigned" sizeop="sizeof(unsigned)"/>
216
217 <!-- UNSIGNED 16bit -->
218 <primary_type symbol="USHORT" datatype="U2" contenttype="NONE"
219 type="u2" sizeop="sizeof(u2)"/>
220
221 <!-- SIGNED 16bit -->
222 <primary_type symbol="SHORT" datatype="SHORT" contenttype="NONE"
223 type="s2" sizeop="sizeof(s2)"/>
224
225 <!-- SIGNED 8bit -->
226 <primary_type symbol="BYTE" datatype="BYTE" contenttype="NONE"
227 type="s1" sizeop="sizeof(s1)"/>
228
229 <!-- UNSIGNED 8bit -->
230 <primary_type symbol="UBYTE" datatype="U1" contenttype="NONE"
231 type="u1" sizeop="sizeof(u1)"/>
232
233 <!-- float 32bit -->
234 <primary_type symbol="FLOAT" datatype="FLOAT" contenttype="NONE"
235 type="float" sizeop="sizeof(float)"/>
236
237 <!-- float 64bit -->
238 <primary_type symbol="DOUBLE" datatype="DOUBLE" contenttype="NONE"
239 type="double" sizeop="sizeof(double)"/>
240
241 <!-- boolean type (1-byte) -->
242 <primary_type symbol="BOOLEAN" datatype="BOOLEAN" contenttype="NONE"
243 type="bool" sizeop="1"/>
244
245 <!-- 32-bit unsigned integer, SEMANTIC value BYTES -->
246 <primary_type symbol="BYTES" datatype="U4" contenttype="BYTES"
247 type="u4" sizeop="sizeof(u4)"/>
248
249 <primary_type symbol="IOBYTES" datatype="U4" contenttype="BYTES"
250 type="u4" sizeop="sizeof(u4)"/>
251
252 <!-- 64-bit unsigned integer, SEMANTIC value BYTES -->
253 <primary_type symbol="BYTES64" datatype="U8" contenttype="BYTES"
254 type="u8" sizeop="sizeof(u8)"/>
255
256 <!-- 64-bit unsigned integer, SEMANTIC value ABSOLUTE MILLISECONDS -->
257 <primary_type symbol="EPOCHMILLIS" datatype="LONG" contenttype="EPOCHMILLIS"
258 type="s8" sizeop="sizeof(s8)"/>
259
260 <!-- 64-bit unsigned integer, SEMANTIC value RELATIVE MILLISECONDS -->
261 <primary_type symbol="MILLIS" datatype="LONG" contenttype="MILLIS"
262 type="s8" sizeop="sizeof(s8)"/>
263
264 <!-- 64-bit unsigned integer, SEMANTIC value RELATIVE NANOSECONDS -->
265 <primary_type symbol="NANOS" datatype="LONG" contenttype="NANOS"
266 type="s8" sizeop="sizeof(s8)"/>
267
268 <!-- 64-bit signed integer, SEMANTIC value ABSOLUTE TICKS -->
269 <primary_type symbol="TICKS" datatype="LONG" contenttype="TICKS"
270 type="s8" sizeop="sizeof(s8)"/>
271
272 <!-- 64-bit signed integer, SEMANTIC value RELATIVE TICKS -->
273 <primary_type symbol="RELATIVE_TICKS" datatype="LONG" contenttype="TICKS"
274 type="s8" sizeop="sizeof(s8)"/>
275
276 <!-- 64-bit unsigned integer, SEMANTIC value ADDRESS (mem loc) -->
277 <primary_type symbol="ADDRESS" datatype="U8" contenttype="ADDRESS"
278 type="u8" sizeop="sizeof(u8)"/>
279
280 <!-- 32-bit float, SEMANTIC value PERCENTAGE (0.0-1.0) -->
281 <primary_type symbol="PERCENT" datatype="FLOAT" contenttype="PERCENTAGE"
282 type="float" sizeop="sizeof(float)"/>
283
284 <!-- UTF-encoded string, max length 64k -->
285 <primary_type symbol="UTF8" datatype="UTF8" contenttype="NONE"
286 type="const char *" sizeop="sizeof_utf(%)"/>
287
288 <!-- Symbol* constant. Note that this may currently ONLY be used by
289 classes, methods fields. This restriction might be lifted. -->
290 <primary_type symbol="SYMBOL" datatype="U8" contenttype="SYMBOL"
291 type="Symbol *" sizeop="sizeof(u8)"/>
292
293 <!-- A Klass *. The actual class is marked as "used" and will
294 eventually be written into the recording constant pool -->
295 <primary_type symbol="CLASS" datatype="U8" contenttype="CLASS"
296 type="Klass *" sizeop="sizeof(u8)"/>
297
298 <!-- A Method *. The method is marked as "used" and will eventually be
299 written into the recording constant pool. -->
300 <primary_type symbol="METHOD" datatype="U8" contenttype="METHOD"
301 type="Method *" sizeop="sizeof(u8)"/>
302
303 <!-- The type for stacktraces in the recording. Shoudl not be used by
304 events explicitly -->
305 <primary_type symbol="STACKTRACE" datatype="U8" contenttype="STACKTRACE"
306 type="u8" sizeop="sizeof(u8)"/>
307
308 <!-- OS Thread ID -->
309 <primary_type symbol="OSTHREAD" datatype="U4" contenttype="OSTHREAD"
310 type="u4" sizeop="sizeof(u4)"/>
311
312 <!-- VM Thread ID Note: changed from U2 to U8 for hotspot -->
313 <primary_type symbol="VMTHREAD" datatype="U8" contenttype="VMTHREAD"
314 type="u8" sizeop="sizeof(u8)"/>
315
316 <!-- Java Thread ID -->
317 <primary_type symbol="JAVALANGTHREAD" datatype="LONG"
318 contenttype="JAVALANGTHREAD" type="s8"
319 sizeop="sizeof(s8)"/>
320
321 <!-- Threadgroup THIS TYPE MAY NOT BE USED IN NORMAL EVENTS (ATM). Only
322 for thread constant pool // KK TODO: u8 should be ObjectP -->
323 <primary_type symbol="THREADGROUP" datatype="U4" contenttype="THREADGROUP"
324 type="u8"
325 sizeop="sizeof(u4)"/>
326
327 <!-- FRAMETYPE enum -->
328 <primary_type symbol="FRAMETYPE" datatype="U1" contenttype="FRAMETYPE"
329 type="u1" sizeop="sizeof(u1)"/>
330
331 <!-- THREADSTATE enum -->
332 <primary_type symbol="THREADSTATE" datatype="U2" contenttype="THREADSTATE"
333 type="u2" sizeop="sizeof(u2)"/>
334
335 <!-- GCName -->
336 <primary_type symbol="GCNAME" datatype="U1" contenttype="GCNAME"
337 type="u1" sizeop="sizeof(u1)" />
338
339 <!-- GCCAUSE -->
340 <primary_type symbol="GCCAUSE" datatype="U2" contenttype="GCCAUSE"
341 type="u2" sizeop="sizeof(u2)" />
342
343 <!-- GCWHEN -->
344 <primary_type symbol="GCWHEN" datatype="U1" contenttype="GCWHEN"
345 type="u1" sizeop="sizeof(u1)" />
346
347 <!-- G1YCType -->
348 <primary_type symbol="G1YCTYPE" datatype="U1" contenttype="G1YCTYPE"
349 type="u1" sizeop="sizeof(u1)" />
350
351 <!-- REFERENCETYPE -->
352 <primary_type symbol="REFERENCETYPE" datatype="U1"
353 contenttype="REFERENCETYPE" type="u1" sizeop="sizeof(u1)" />
354
355 <!-- NARROWOOPMODE -->
356 <primary_type symbol="NARROWOOPMODE" datatype="U1"
357 contenttype="NARROWOOPMODE" type="u1" sizeop="sizeof(u1)" />
358
359 <!-- COMPILERPHASETYPE -->
360 <primary_type symbol="COMPILERPHASETYPE" datatype="U1"
361 contenttype="COMPILERPHASETYPE" type="u1" sizeop="sizeof(u1)" />
362
363 <!-- VMOPERATIONTYPE -->
364 <primary_type symbol="VMOPERATIONTYPE" datatype="U2" contenttype="VMOPERATIONTYPE"
365 type="u2" sizeop="sizeof(u2)" />
366
367 </primary_types>
368 </types>