1 /*
2 * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation.
8 *
9 * This code is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
12 * version 2 for more details (a copy is included in the LICENSE file that
13 * accompanied this code).
14 *
15 * You should have received a copy of the GNU General Public License version
16 * 2 along with this work; if not, write to the Free Software Foundation,
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 *
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 * or visit www.oracle.com if you need additional information or have any
21 * questions.
22 *
23 */
24
25 #ifndef SHARE_VM_PRIMS_JVMTIREDEFINECLASSESTRACE_HPP
26 #define SHARE_VM_PRIMS_JVMTIREDEFINECLASSESTRACE_HPP
27
28 // RedefineClasses tracing support via the TraceRedefineClasses
29 // option. A bit is assigned to each group of trace messages.
30 // Groups of messages are individually selectable. We have to use
31 // decimal values on the command line since the command option
32 // parsing logic doesn't like non-decimal numerics. The HEX values
33 // are used in the actual RC_TRACE() calls for sanity. To achieve
34 // the old cumulative behavior, pick the level after the one in
35 // which you are interested and subtract one, e.g., 33554431 will
36 // print every tracing message.
37 //
38 // 0x00000000 | 0 - default; no tracing messages
39 // 0x00000001 | 1 - name each target class before loading, after
40 // loading and after redefinition is completed
41 // 0x00000002 | 2 - print info if parsing, linking or
42 // verification throws an exception
43 // 0x00000004 | 4 - print timer info for the VM operation
44 // 0x00000008 | 8 - print subclass counter updates
45 // 0x00000010 | 16 - unused
46 // 0x00000020 | 32 - unused
47 // 0x00000040 | 64 - unused
48 // 0x00000080 | 128 - unused
49 // 0x00000100 | 256 - previous class weak reference addition
50 // 0x00000200 | 512 - previous class weak reference mgmt during
51 // class unloading checks (GC)
52 // 0x00000400 | 1024 - previous class weak reference mgmt during
53 // add previous ops (GC)
54 // 0x00000800 | 2048 - previous class breakpoint mgmt
55 // 0x00001000 | 4096 - detect calls to obsolete methods
56 // 0x00002000 | 8192 - fail a guarantee() in addition to detection
57 // 0x00004000 | 16384 - unused
58 // 0x00008000 | 32768 - old/new method matching/add/delete
59 // 0x00010000 | 65536 - impl details: CP size info
60 // 0x00020000 | 131072 - impl details: CP merge pass info
61 // 0x00040000 | 262144 - impl details: CP index maps
62 // 0x00080000 | 524288 - impl details: modified CP index values
63 // 0x00100000 | 1048576 - impl details: vtable updates
64 // 0x00200000 | 2097152 - impl details: itable updates
65 // 0x00400000 | 4194304 - impl details: constant pool cache updates
66 // 0x00800000 | 8388608 - impl details: methodComparator info
67 // 0x01000000 | 16777216 - impl details: nmethod evolution info
68 // 0x02000000 | 33554432 - impl details: annotation updates
69 // 0x04000000 | 67108864 - impl details: StackMapTable updates
70 // 0x08000000 | 134217728 - impl details: OopMapCache updates
71 // 0x10000000 | 268435456 - unused
72 // 0x20000000 | 536870912 - unused
73 // 0x40000000 | 1073741824 - unused
74 // 0x80000000 | 2147483648 - unused
75 //
76 // Note: The ResourceMark is to cleanup resource allocated args.
77 // The "while (0)" is so we can use semi-colon at end of RC_TRACE().
78 #define RC_TRACE(level, args) \
79 if ((TraceRedefineClasses & level) != 0) { \
80 ResourceMark rm; \
81 tty->print("RedefineClasses-0x%x: ", level); \
82 tty->print_cr args; \
83 } while (0)
84
85 #define RC_TRACE_WITH_THREAD(level, thread, args) \
86 if ((TraceRedefineClasses & level) != 0) { \
87 ResourceMark rm(thread); \
88 tty->print("RedefineClasses-0x%x: ", level); \
89 tty->print_cr args; \
90 } while (0)
91
92 #define RC_TRACE_MESG(args) \
93 { \
94 ResourceMark rm; \
95 tty->print("RedefineClasses: "); \
96 tty->print_cr args; \
97 } while (0)
98
99 // Macro for checking if TraceRedefineClasses has a specific bit
100 // enabled. Returns true if the bit specified by level is set.
101 #define RC_TRACE_ENABLED(level) ((TraceRedefineClasses & level) != 0)
102
103 // Macro for checking if TraceRedefineClasses has one or more bits
104 // set in a range of bit values. Returns true if one or more bits
105 // is set in the range from low..high inclusive. Assumes that low
106 // and high are single bit values.
107 //
108 // ((high << 1) - 1)
109 // Yields a mask that removes bits greater than the high bit value.
110 // This algorithm doesn't work with highest bit.
111 // ~(low - 1)
112 // Yields a mask that removes bits lower than the low bit value.
113 #define RC_TRACE_IN_RANGE(low, high) \
114 (((TraceRedefineClasses & ((high << 1) - 1)) & ~(low - 1)) != 0)
115
116 // Timer support macros. Only do timer operations if timer tracing
117 // is enabled. The "while (0)" is so we can use semi-colon at end of
118 // the macro.
119 #define RC_TIMER_START(t) \
120 if (RC_TRACE_ENABLED(0x00000004)) { \
121 t.start(); \
122 } while (0)
123 #define RC_TIMER_STOP(t) \
124 if (RC_TRACE_ENABLED(0x00000004)) { \
125 t.stop(); \
126 } while (0)
127
128 #endif // SHARE_VM_PRIMS_JVMTIREDEFINECLASSESTRACE_HPP