annotate src/share/vm/code/debugInfoRec.hpp @ 62:cd0742ba123c

Merge
author kamg
date Thu, 20 Mar 2008 09:17:30 -0500
parents a61af66fc99e
children 9987d9d5eb0e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
a61af66fc99e Initial load
duke
parents:
diff changeset
1 /*
a61af66fc99e Initial load
duke
parents:
diff changeset
2 * Copyright 1998-2005 Sun Microsystems, Inc. All Rights Reserved.
a61af66fc99e Initial load
duke
parents:
diff changeset
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
a61af66fc99e Initial load
duke
parents:
diff changeset
4 *
a61af66fc99e Initial load
duke
parents:
diff changeset
5 * This code is free software; you can redistribute it and/or modify it
a61af66fc99e Initial load
duke
parents:
diff changeset
6 * under the terms of the GNU General Public License version 2 only, as
a61af66fc99e Initial load
duke
parents:
diff changeset
7 * published by the Free Software Foundation.
a61af66fc99e Initial load
duke
parents:
diff changeset
8 *
a61af66fc99e Initial load
duke
parents:
diff changeset
9 * This code is distributed in the hope that it will be useful, but WITHOUT
a61af66fc99e Initial load
duke
parents:
diff changeset
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
a61af66fc99e Initial load
duke
parents:
diff changeset
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
a61af66fc99e Initial load
duke
parents:
diff changeset
12 * version 2 for more details (a copy is included in the LICENSE file that
a61af66fc99e Initial load
duke
parents:
diff changeset
13 * accompanied this code).
a61af66fc99e Initial load
duke
parents:
diff changeset
14 *
a61af66fc99e Initial load
duke
parents:
diff changeset
15 * You should have received a copy of the GNU General Public License version
a61af66fc99e Initial load
duke
parents:
diff changeset
16 * 2 along with this work; if not, write to the Free Software Foundation,
a61af66fc99e Initial load
duke
parents:
diff changeset
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
a61af66fc99e Initial load
duke
parents:
diff changeset
18 *
a61af66fc99e Initial load
duke
parents:
diff changeset
19 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
a61af66fc99e Initial load
duke
parents:
diff changeset
20 * CA 95054 USA or visit www.sun.com if you need additional information or
a61af66fc99e Initial load
duke
parents:
diff changeset
21 * have any questions.
a61af66fc99e Initial load
duke
parents:
diff changeset
22 *
a61af66fc99e Initial load
duke
parents:
diff changeset
23 */
a61af66fc99e Initial load
duke
parents:
diff changeset
24
a61af66fc99e Initial load
duke
parents:
diff changeset
25 //** The DebugInformationRecorder collects debugging information
a61af66fc99e Initial load
duke
parents:
diff changeset
26 // for a compiled method.
a61af66fc99e Initial load
duke
parents:
diff changeset
27 // Debugging information is used for:
a61af66fc99e Initial load
duke
parents:
diff changeset
28 // - garbage collecting compiled frames
a61af66fc99e Initial load
duke
parents:
diff changeset
29 // - stack tracing across compiled frames
a61af66fc99e Initial load
duke
parents:
diff changeset
30 // - deoptimizating compiled frames
a61af66fc99e Initial load
duke
parents:
diff changeset
31 //
a61af66fc99e Initial load
duke
parents:
diff changeset
32 // The implementation requires the compiler to use the recorder
a61af66fc99e Initial load
duke
parents:
diff changeset
33 // in the following order:
a61af66fc99e Initial load
duke
parents:
diff changeset
34 // 1) Describe debug information for safepoints at increasing addresses.
a61af66fc99e Initial load
duke
parents:
diff changeset
35 // a) Add safepoint entry (use add_safepoint or add_non_safepoint)
a61af66fc99e Initial load
duke
parents:
diff changeset
36 // b) Describe scopes for that safepoint
a61af66fc99e Initial load
duke
parents:
diff changeset
37 // - create locals if needed (use create_scope_values)
a61af66fc99e Initial load
duke
parents:
diff changeset
38 // - create expressions if needed (use create_scope_values)
a61af66fc99e Initial load
duke
parents:
diff changeset
39 // - create monitor stack if needed (use create_monitor_values)
a61af66fc99e Initial load
duke
parents:
diff changeset
40 // - describe scope (use describe_scope)
a61af66fc99e Initial load
duke
parents:
diff changeset
41 // "repeat last four steps for all scopes"
a61af66fc99e Initial load
duke
parents:
diff changeset
42 // "outer most scope first and inner most scope last"
a61af66fc99e Initial load
duke
parents:
diff changeset
43 // NB: nodes from create_scope_values and create_locations
a61af66fc99e Initial load
duke
parents:
diff changeset
44 // can be reused for simple sharing.
a61af66fc99e Initial load
duke
parents:
diff changeset
45 // - mark the end of the scopes (end_safepoint or end_non_safepoint)
a61af66fc99e Initial load
duke
parents:
diff changeset
46 // 2) Use oop_size, data_size, pcs_size to create the nmethod and
a61af66fc99e Initial load
duke
parents:
diff changeset
47 // finally migrate the debugging information into the nmethod
a61af66fc99e Initial load
duke
parents:
diff changeset
48 // by calling copy_to.
a61af66fc99e Initial load
duke
parents:
diff changeset
49
a61af66fc99e Initial load
duke
parents:
diff changeset
50 class DebugToken; // Opaque datatype for stored:
a61af66fc99e Initial load
duke
parents:
diff changeset
51 // - GrowableArray<ScopeValue*>
a61af66fc99e Initial load
duke
parents:
diff changeset
52 // - GrowableArray<MonitorValue*>
a61af66fc99e Initial load
duke
parents:
diff changeset
53
a61af66fc99e Initial load
duke
parents:
diff changeset
54 // Alias for InvocationEntryBci.
a61af66fc99e Initial load
duke
parents:
diff changeset
55 // Both constants are used for a pseudo-BCI which refers
a61af66fc99e Initial load
duke
parents:
diff changeset
56 // to the state just _before_ a method is entered.
a61af66fc99e Initial load
duke
parents:
diff changeset
57 // SynchronizationEntryBCI is used where the emphasis
a61af66fc99e Initial load
duke
parents:
diff changeset
58 // is on the implicit monitorenter of a synchronized method.
a61af66fc99e Initial load
duke
parents:
diff changeset
59 const int SynchronizationEntryBCI = InvocationEntryBci;
a61af66fc99e Initial load
duke
parents:
diff changeset
60
a61af66fc99e Initial load
duke
parents:
diff changeset
61 class DIR_Chunk; // private class, a nugget of collected information
a61af66fc99e Initial load
duke
parents:
diff changeset
62
a61af66fc99e Initial load
duke
parents:
diff changeset
63 class DebugInformationRecorder: public ResourceObj {
a61af66fc99e Initial load
duke
parents:
diff changeset
64 public:
a61af66fc99e Initial load
duke
parents:
diff changeset
65 // constructor
a61af66fc99e Initial load
duke
parents:
diff changeset
66 DebugInformationRecorder(OopRecorder* oop_recorder);
a61af66fc99e Initial load
duke
parents:
diff changeset
67
a61af66fc99e Initial load
duke
parents:
diff changeset
68 // adds an oopmap at a specific offset
a61af66fc99e Initial load
duke
parents:
diff changeset
69 void add_oopmap(int pc_offset, OopMap* map);
a61af66fc99e Initial load
duke
parents:
diff changeset
70
a61af66fc99e Initial load
duke
parents:
diff changeset
71 // adds a jvm mapping at pc-offset, for a safepoint only
a61af66fc99e Initial load
duke
parents:
diff changeset
72 void add_safepoint(int pc_offset, OopMap* map);
a61af66fc99e Initial load
duke
parents:
diff changeset
73
a61af66fc99e Initial load
duke
parents:
diff changeset
74 // adds a jvm mapping at pc-offset, for a non-safepoint (profile point)
a61af66fc99e Initial load
duke
parents:
diff changeset
75 void add_non_safepoint(int pc_offset);
a61af66fc99e Initial load
duke
parents:
diff changeset
76
a61af66fc99e Initial load
duke
parents:
diff changeset
77 // Describes debugging information for a scope at the given pc_offset.
a61af66fc99e Initial load
duke
parents:
diff changeset
78 // Calls must be in non-decreasing order of pc_offset.
a61af66fc99e Initial load
duke
parents:
diff changeset
79 // If there are several calls at a single pc_offset,
a61af66fc99e Initial load
duke
parents:
diff changeset
80 // then they occur in the same order as they were performed by the JVM,
a61af66fc99e Initial load
duke
parents:
diff changeset
81 // with the most recent (innermost) call being described last.
a61af66fc99e Initial load
duke
parents:
diff changeset
82 // For a safepoint, the pc_offset must have been mentioned
a61af66fc99e Initial load
duke
parents:
diff changeset
83 // previously by add_safepoint.
a61af66fc99e Initial load
duke
parents:
diff changeset
84 // Otherwise, the pc_offset must have been mentioned previously
a61af66fc99e Initial load
duke
parents:
diff changeset
85 // by add_non_safepoint, and the locals, expressions, and monitors
a61af66fc99e Initial load
duke
parents:
diff changeset
86 // must all be null.
a61af66fc99e Initial load
duke
parents:
diff changeset
87 void describe_scope(int pc_offset,
a61af66fc99e Initial load
duke
parents:
diff changeset
88 ciMethod* method,
a61af66fc99e Initial load
duke
parents:
diff changeset
89 int bci,
a61af66fc99e Initial load
duke
parents:
diff changeset
90 DebugToken* locals = NULL,
a61af66fc99e Initial load
duke
parents:
diff changeset
91 DebugToken* expressions = NULL,
a61af66fc99e Initial load
duke
parents:
diff changeset
92 DebugToken* monitors = NULL);
a61af66fc99e Initial load
duke
parents:
diff changeset
93
a61af66fc99e Initial load
duke
parents:
diff changeset
94
a61af66fc99e Initial load
duke
parents:
diff changeset
95 void dump_object_pool(GrowableArray<ScopeValue*>* objects);
a61af66fc99e Initial load
duke
parents:
diff changeset
96
a61af66fc99e Initial load
duke
parents:
diff changeset
97 // This call must follow every add_safepoint,
a61af66fc99e Initial load
duke
parents:
diff changeset
98 // after any intervening describe_scope calls.
a61af66fc99e Initial load
duke
parents:
diff changeset
99 void end_safepoint(int pc_offset) { end_scopes(pc_offset, true); }
a61af66fc99e Initial load
duke
parents:
diff changeset
100 void end_non_safepoint(int pc_offset) { end_scopes(pc_offset, false); }
a61af66fc99e Initial load
duke
parents:
diff changeset
101
a61af66fc99e Initial load
duke
parents:
diff changeset
102 // helper fuctions for describe_scope to enable sharing
a61af66fc99e Initial load
duke
parents:
diff changeset
103 DebugToken* create_scope_values(GrowableArray<ScopeValue*>* values);
a61af66fc99e Initial load
duke
parents:
diff changeset
104 DebugToken* create_monitor_values(GrowableArray<MonitorValue*>* monitors);
a61af66fc99e Initial load
duke
parents:
diff changeset
105
a61af66fc99e Initial load
duke
parents:
diff changeset
106 // returns the size of the generated scopeDescs.
a61af66fc99e Initial load
duke
parents:
diff changeset
107 int data_size();
a61af66fc99e Initial load
duke
parents:
diff changeset
108 int pcs_size();
a61af66fc99e Initial load
duke
parents:
diff changeset
109 int oop_size() { return oop_recorder()->oop_size(); }
a61af66fc99e Initial load
duke
parents:
diff changeset
110
a61af66fc99e Initial load
duke
parents:
diff changeset
111 // copy the generated debugging information to nmethod
a61af66fc99e Initial load
duke
parents:
diff changeset
112 void copy_to(nmethod* nm);
a61af66fc99e Initial load
duke
parents:
diff changeset
113
a61af66fc99e Initial load
duke
parents:
diff changeset
114 // verifies the debug information
a61af66fc99e Initial load
duke
parents:
diff changeset
115 void verify(const nmethod* code);
a61af66fc99e Initial load
duke
parents:
diff changeset
116
a61af66fc99e Initial load
duke
parents:
diff changeset
117 static void print_statistics() PRODUCT_RETURN;
a61af66fc99e Initial load
duke
parents:
diff changeset
118
a61af66fc99e Initial load
duke
parents:
diff changeset
119 // Method for setting oopmaps to temporarily preserve old handling of oopmaps
a61af66fc99e Initial load
duke
parents:
diff changeset
120 OopMapSet *_oopmaps;
a61af66fc99e Initial load
duke
parents:
diff changeset
121 void set_oopmaps(OopMapSet *oopmaps) { _oopmaps = oopmaps; }
a61af66fc99e Initial load
duke
parents:
diff changeset
122
a61af66fc99e Initial load
duke
parents:
diff changeset
123 OopRecorder* oop_recorder() { return _oop_recorder; }
a61af66fc99e Initial load
duke
parents:
diff changeset
124
a61af66fc99e Initial load
duke
parents:
diff changeset
125 int last_pc_offset() { return last_pc()->pc_offset(); }
a61af66fc99e Initial load
duke
parents:
diff changeset
126
a61af66fc99e Initial load
duke
parents:
diff changeset
127 bool recording_non_safepoints() { return _recording_non_safepoints; }
a61af66fc99e Initial load
duke
parents:
diff changeset
128
a61af66fc99e Initial load
duke
parents:
diff changeset
129 private:
a61af66fc99e Initial load
duke
parents:
diff changeset
130 friend class ScopeDesc;
a61af66fc99e Initial load
duke
parents:
diff changeset
131 friend class vframeStreamCommon;
a61af66fc99e Initial load
duke
parents:
diff changeset
132 friend class DIR_Chunk;
a61af66fc99e Initial load
duke
parents:
diff changeset
133
a61af66fc99e Initial load
duke
parents:
diff changeset
134 // True if we are recording non-safepoint scopes.
a61af66fc99e Initial load
duke
parents:
diff changeset
135 // This flag is set if DebugNonSafepoints is true, or if
a61af66fc99e Initial load
duke
parents:
diff changeset
136 // JVMTI post_compiled_method_load events are enabled.
a61af66fc99e Initial load
duke
parents:
diff changeset
137 const bool _recording_non_safepoints;
a61af66fc99e Initial load
duke
parents:
diff changeset
138
a61af66fc99e Initial load
duke
parents:
diff changeset
139 DebugInfoWriteStream* _stream;
a61af66fc99e Initial load
duke
parents:
diff changeset
140
a61af66fc99e Initial load
duke
parents:
diff changeset
141 DebugInfoWriteStream* stream() const { return _stream; }
a61af66fc99e Initial load
duke
parents:
diff changeset
142
a61af66fc99e Initial load
duke
parents:
diff changeset
143 OopRecorder* _oop_recorder;
a61af66fc99e Initial load
duke
parents:
diff changeset
144
a61af66fc99e Initial load
duke
parents:
diff changeset
145 // Scopes that have been described so far.
a61af66fc99e Initial load
duke
parents:
diff changeset
146 GrowableArray<DIR_Chunk*>* _all_chunks;
a61af66fc99e Initial load
duke
parents:
diff changeset
147 GrowableArray<DIR_Chunk*>* _shared_chunks;
a61af66fc99e Initial load
duke
parents:
diff changeset
148 DIR_Chunk* _next_chunk;
a61af66fc99e Initial load
duke
parents:
diff changeset
149 DIR_Chunk* _next_chunk_limit;
a61af66fc99e Initial load
duke
parents:
diff changeset
150
a61af66fc99e Initial load
duke
parents:
diff changeset
151 #ifdef ASSERT
a61af66fc99e Initial load
duke
parents:
diff changeset
152 enum { rs_null, rs_safepoint, rs_non_safepoint };
a61af66fc99e Initial load
duke
parents:
diff changeset
153 int _recording_state;
a61af66fc99e Initial load
duke
parents:
diff changeset
154 #endif
a61af66fc99e Initial load
duke
parents:
diff changeset
155
a61af66fc99e Initial load
duke
parents:
diff changeset
156 PcDesc* _pcs;
a61af66fc99e Initial load
duke
parents:
diff changeset
157 int _pcs_size;
a61af66fc99e Initial load
duke
parents:
diff changeset
158 int _pcs_length;
a61af66fc99e Initial load
duke
parents:
diff changeset
159 // Note: Would use GrowableArray<PcDesc>, but structs are not supported.
a61af66fc99e Initial load
duke
parents:
diff changeset
160
a61af66fc99e Initial load
duke
parents:
diff changeset
161 // PC of most recent real safepoint before the current one,
a61af66fc99e Initial load
duke
parents:
diff changeset
162 // updated after end_scopes.
a61af66fc99e Initial load
duke
parents:
diff changeset
163 int _prev_safepoint_pc;
a61af66fc99e Initial load
duke
parents:
diff changeset
164
a61af66fc99e Initial load
duke
parents:
diff changeset
165 PcDesc* last_pc() {
a61af66fc99e Initial load
duke
parents:
diff changeset
166 guarantee(_pcs_length > 0, "a safepoint must be declared already");
a61af66fc99e Initial load
duke
parents:
diff changeset
167 return &_pcs[_pcs_length-1];
a61af66fc99e Initial load
duke
parents:
diff changeset
168 }
a61af66fc99e Initial load
duke
parents:
diff changeset
169 PcDesc* prev_pc() {
a61af66fc99e Initial load
duke
parents:
diff changeset
170 guarantee(_pcs_length > 1, "a safepoint must be declared already");
a61af66fc99e Initial load
duke
parents:
diff changeset
171 return &_pcs[_pcs_length-2];
a61af66fc99e Initial load
duke
parents:
diff changeset
172 }
a61af66fc99e Initial load
duke
parents:
diff changeset
173 void add_new_pc_offset(int pc_offset);
a61af66fc99e Initial load
duke
parents:
diff changeset
174 void end_scopes(int pc_offset, bool is_safepoint);
a61af66fc99e Initial load
duke
parents:
diff changeset
175
a61af66fc99e Initial load
duke
parents:
diff changeset
176 int serialize_monitor_values(GrowableArray<MonitorValue*>* monitors);
a61af66fc99e Initial load
duke
parents:
diff changeset
177 int serialize_scope_values(GrowableArray<ScopeValue*>* values);
a61af66fc99e Initial load
duke
parents:
diff changeset
178 int find_sharable_decode_offset(int stream_offset);
a61af66fc99e Initial load
duke
parents:
diff changeset
179
a61af66fc99e Initial load
duke
parents:
diff changeset
180 public:
a61af66fc99e Initial load
duke
parents:
diff changeset
181 enum { serialized_null = 0 };
a61af66fc99e Initial load
duke
parents:
diff changeset
182 };