1 /*
2 * Copyright (c) 1998, 2024, 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 #include "precompiled.hpp"
26 #include "code/debugInfoRec.hpp"
27 #include "code/scopeDesc.hpp"
28 #include "compiler/oopMap.hpp"
29 #include "prims/jvmtiExport.hpp"
30 #include "runtime/globals_extension.hpp"
31
32 // Private definition.
33 // There is one DIR_Chunk for each scope and values array.
34 // A chunk can potentially be used more than once.
35 // We keep track of these chunks in order to detect
36 // repetition and enable sharing.
37 class DIR_Chunk {
38 private:
39 int _offset; // location in the stream of this scope
40 int _length; // number of bytes in the stream
41 int _hash; // hash of stream bytes (for quicker reuse)
42 DebugInformationRecorder* _DIR;
43
44 public:
45 int offset() { return _offset; }
46
47 void* operator new(size_t ignore, DebugInformationRecorder* dir) throw() {
48 assert(ignore == sizeof(DIR_Chunk), "");
49 if (dir->_next_chunk >= dir->_next_chunk_limit) {
50 const int CHUNK = 100;
51 dir->_next_chunk = NEW_RESOURCE_ARRAY(DIR_Chunk, CHUNK);
52 dir->_next_chunk_limit = dir->_next_chunk + CHUNK;
53 }
54 return dir->_next_chunk++;
55 }
56
57 DIR_Chunk(int offset, int length, DebugInformationRecorder* dir) {
58 _offset = offset;
59 _length = length;
60 _DIR = dir;
61 unsigned int hash = 0;
62 address p = dir->stream()->buffer() + _offset;
63 for (int i = 0; i < length; i++) {
64 if (i == 6) break;
65 hash *= 127;
66 hash += p[i];
67 }
68 _hash = hash;
69 }
70
71 DIR_Chunk* find_match(GrowableArray<DIR_Chunk*>* arr,
72 int start_index,
73 DebugInformationRecorder* dir) {
74 int end_index = arr->length();
75 int hash = this->_hash, length = this->_length;
76 address buf = dir->stream()->buffer();
77 for (int i = end_index; --i >= start_index; ) {
78 DIR_Chunk* that = arr->at(i);
79 if (hash == that->_hash &&
80 length == that->_length &&
81 0 == memcmp(buf + this->_offset, buf + that->_offset, length)) {
82 return that;
83 }
84 }
85 return nullptr;
86 }
87
88 static int compare(DIR_Chunk* const & a, DIR_Chunk* const & b) {
89 if (b->_hash > a->_hash) {
90 return 1;
91 }
92 if (b->_hash < a->_hash) {
93 return -1;
94 }
95 if (b->_length > a->_length) {
96 return 1;
97 }
98 if (b->_length < a->_length) {
99 return -1;
100 }
101 address buf = a->_DIR->stream()->buffer();
102 return memcmp(buf + b->_offset, buf + a->_offset, a->_length);
103 }
104 };
105
106 static inline bool compute_recording_non_safepoints() {
107 if (JvmtiExport::should_post_compiled_method_load()
108 && FLAG_IS_DEFAULT(DebugNonSafepoints)) {
109 // The default value of this flag is taken to be true,
110 // if JVMTI is looking at nmethod codes.
111 // We anticipate that JVMTI may wish to participate in profiling.
112 return true;
113 }
114
115 // If the flag is set manually, use it, whether true or false.
116 // Otherwise, if JVMTI is not in the picture, use the default setting.
117 // (This is true in debug, just for the exercise, false in product mode.)
118 return DebugNonSafepoints;
119 }
120
121 DebugInformationRecorder::DebugInformationRecorder(OopRecorder* oop_recorder)
122 : _recording_non_safepoints(compute_recording_non_safepoints())
123 {
124 _pcs_size = 100;
125 _pcs = NEW_RESOURCE_ARRAY(PcDesc, _pcs_size);
126 _pcs_length = 0;
127
128 _prev_safepoint_pc = PcDesc::lower_offset_limit;
129
130 _stream = new DebugInfoWriteStream(this, 10 * K);
131 // make sure that there is no stream_decode_offset that is zero
132 _stream->write_byte((jbyte)0xFF);
133
134 // make sure that we can distinguish the value "serialized_null" from offsets
135 assert(_stream->position() > serialized_null, "sanity");
136
137 _oop_recorder = oop_recorder;
138
139 _all_chunks = new GrowableArray<DIR_Chunk*>(300);
140 _next_chunk = _next_chunk_limit = nullptr;
141
142 add_new_pc_offset(PcDesc::lower_offset_limit); // sentinel record
143
144 debug_only(_recording_state = rs_null);
145 }
146
147 DebugInformationRecorder::DebugInformationRecorder(OopRecorder* oop_recorder, int data_size, int pcs_length)
148 : _recording_non_safepoints(compute_recording_non_safepoints())
149 {
150 _pcs_size = _pcs_length = pcs_length;
151 _pcs = NEW_RESOURCE_ARRAY(PcDesc, _pcs_size);
152
153 _prev_safepoint_pc = PcDesc::lower_offset_limit;
154
155 _stream = new DebugInfoWriteStream(this, data_size);
156 // make sure that there is no stream_decode_offset that is zero
157 _stream->write_byte((jbyte)0xFF);
158
159 // make sure that we can distinguish the value "serialized_null" from offsets
160 assert(_stream->position() > serialized_null, "sanity");
161
162 _oop_recorder = oop_recorder;
163
164 _all_chunks = nullptr;
165 _next_chunk = _next_chunk_limit = nullptr;
166
167 debug_only(_recording_state = rs_null);
168 }
169
170 void DebugInformationRecorder::add_oopmap(int pc_offset, OopMap* map) {
171 // !!!!! Preserve old style handling of oopmaps for now
172 _oopmaps->add_gc_map(pc_offset, map);
173 }
174
175 void DebugInformationRecorder::add_safepoint(int pc_offset, OopMap* map) {
176 assert(!_oop_recorder->is_complete(), "not frozen yet");
177 // Store the new safepoint
178
179 // Add the oop map
180 add_oopmap(pc_offset, map);
181
182 add_new_pc_offset(pc_offset);
183
184 assert(_recording_state == rs_null, "nesting of recording calls");
185 debug_only(_recording_state = rs_safepoint);
186 }
187
188 void DebugInformationRecorder::add_non_safepoint(int pc_offset) {
189 assert(!_oop_recorder->is_complete(), "not frozen yet");
190 assert(_recording_non_safepoints, "must be recording non-safepoints");
191
192 add_new_pc_offset(pc_offset);
193
194 assert(_recording_state == rs_null, "nesting of recording calls");
195 debug_only(_recording_state = rs_non_safepoint);
196 }
197
198 void DebugInformationRecorder::add_new_pc_offset(int pc_offset) {
199 assert(_pcs_length == 0 || last_pc()->pc_offset() < pc_offset,
200 "must specify a new, larger pc offset: %d >= %d", last_pc()->pc_offset(), pc_offset);
201
202 // add the pcdesc
203 if (_pcs_length == _pcs_size) {
204 // Expand
205 int new_pcs_size = _pcs_size * 2;
206 PcDesc* new_pcs = NEW_RESOURCE_ARRAY(PcDesc, new_pcs_size);
207 for (int index = 0; index < _pcs_length; index++) {
208 new_pcs[index] = _pcs[index];
209 }
210 _pcs_size = new_pcs_size;
211 _pcs = new_pcs;
212 }
213 assert(_pcs_size > _pcs_length, "There must be room for after expanding");
214
215 _pcs[_pcs_length++] = PcDesc(pc_offset, DebugInformationRecorder::serialized_null,
216 DebugInformationRecorder::serialized_null);
217 }
218
219
220 int DebugInformationRecorder::serialize_monitor_values(GrowableArray<MonitorValue*>* monitors) {
221 if (monitors == nullptr || monitors->is_empty()) return DebugInformationRecorder::serialized_null;
222 assert(_recording_state == rs_safepoint, "must be recording a safepoint");
223 int result = stream()->position();
224 stream()->write_int(monitors->length());
225 for (int index = 0; index < monitors->length(); index++) {
226 monitors->at(index)->write_on(stream());
227 }
228 assert(result != serialized_null, "sanity");
229
230 // (See comment below on DebugInformationRecorder::describe_scope.)
231 int shared_result = find_sharable_decode_offset(result);
232 if (shared_result != serialized_null) {
233 stream()->set_position(result);
234 result = shared_result;
235 }
236
237 return result;
238 }
239
240
241 int DebugInformationRecorder::serialize_scope_values(GrowableArray<ScopeValue*>* values) {
242 if (values == nullptr || values->is_empty()) return DebugInformationRecorder::serialized_null;
243 assert(_recording_state == rs_safepoint, "must be recording a safepoint");
244 int result = stream()->position();
245 assert(result != serialized_null, "sanity");
246 stream()->write_int(values->length());
247 for (int index = 0; index < values->length(); index++) {
248 values->at(index)->write_on(stream());
249 }
250
251 // (See comment below on DebugInformationRecorder::describe_scope.)
252 int shared_result = find_sharable_decode_offset(result);
253 if (shared_result != serialized_null) {
254 stream()->set_position(result);
255 result = shared_result;
256 }
257
258 return result;
259 }
260
261
262 #ifndef PRODUCT
263 // These variables are put into one block to reduce relocations
264 // and make it simpler to print from the debugger.
265 static
266 struct dir_stats_struct {
267 int chunks_queried;
268 int chunks_shared;
269 int chunks_elided;
270
271 void print() {
272 tty->print_cr("Debug Data Chunks: %d, shared %d, non-SP's elided %d",
273 chunks_queried, chunks_shared, chunks_elided);
274 }
275 } dir_stats;
276 #endif //PRODUCT
277
278
279 int DebugInformationRecorder::find_sharable_decode_offset(int stream_offset) {
280 NOT_PRODUCT(++dir_stats.chunks_queried);
281 int stream_length = stream()->position() - stream_offset;
282 assert(stream_offset != serialized_null, "should not be null");
283 assert(stream_length != 0, "should not be empty");
284
285 DIR_Chunk* ns = new(this) DIR_Chunk(stream_offset, stream_length, this);
286
287 DIR_Chunk* match = _all_chunks->insert_sorted<DIR_Chunk::compare>(ns);
288 if (match != ns) {
289 // Found an existing chunk
290 NOT_PRODUCT(++dir_stats.chunks_shared);
291 assert(ns+1 == _next_chunk, "");
292 _next_chunk = ns;
293 return match->offset();
294 } else {
295 // Inserted this chunk, so nothing to do
296 return serialized_null;
297 }
298 }
299
300
301 // must call add_safepoint before: it sets PcDesc and this routine uses
302 // the last PcDesc set
303 void DebugInformationRecorder::describe_scope(int pc_offset,
304 const methodHandle& methodH,
305 ciMethod* method,
306 int bci,
307 bool reexecute,
308 bool rethrow_exception,
309 bool is_method_handle_invoke,
310 bool return_oop,
311 bool has_ea_local_in_scope,
312 bool arg_escape,
313 DebugToken* locals,
314 DebugToken* expressions,
315 DebugToken* monitors) {
316 assert(_recording_state != rs_null, "nesting of recording calls");
317 PcDesc* last_pd = last_pc();
318 assert(last_pd->pc_offset() == pc_offset, "must be last pc");
319 int sender_stream_offset = last_pd->scope_decode_offset();
320 // update the stream offset of current pc desc
321 int stream_offset = stream()->position();
322 last_pd->set_scope_decode_offset(stream_offset);
323
324 // Record flags into pcDesc.
325 last_pd->set_should_reexecute(reexecute);
326 last_pd->set_rethrow_exception(rethrow_exception);
327 last_pd->set_is_method_handle_invoke(is_method_handle_invoke);
328 last_pd->set_return_oop(return_oop);
329 last_pd->set_has_ea_local_in_scope(has_ea_local_in_scope);
330 last_pd->set_arg_escape(arg_escape);
331
332 // serialize sender stream offset
333 stream()->write_int(sender_stream_offset);
334
335 // serialize scope
336 Metadata* method_enc;
337 if (method != nullptr) {
338 method_enc = method->constant_encoding();
339 } else if (methodH.not_null()) {
340 method_enc = methodH();
341 } else {
342 method_enc = nullptr;
343 }
344 int method_enc_index = oop_recorder()->find_index(method_enc);
345 stream()->write_int(method_enc_index);
346 stream()->write_bci(bci);
347 assert(method == nullptr ||
348 (method->is_native() && bci == 0) ||
349 (!method->is_native() && 0 <= bci && bci < method->code_size()) ||
350 bci == -1, "illegal bci");
351
352 // serialize the locals/expressions/monitors
353 stream()->write_int((intptr_t) locals);
354 stream()->write_int((intptr_t) expressions);
355 stream()->write_int((intptr_t) monitors);
356
357 // Here's a tricky bit. We just wrote some bytes.
358 // Wouldn't it be nice to find that we had already
359 // written those same bytes somewhere else?
360 // If we get lucky this way, reset the stream
361 // and reuse the old bytes. By the way, this
362 // trick not only shares parent scopes, but also
363 // compresses equivalent non-safepoint PcDescs.
364 int shared_stream_offset = find_sharable_decode_offset(stream_offset);
365 if (shared_stream_offset != serialized_null) {
366 stream()->set_position(stream_offset);
367 last_pd->set_scope_decode_offset(shared_stream_offset);
368 }
369 }
370
371 void DebugInformationRecorder::dump_object_pool(GrowableArray<ScopeValue*>* objects) {
372 guarantee( _pcs_length > 0, "safepoint must exist before describing scopes");
373 PcDesc* last_pd = &_pcs[_pcs_length-1];
374 if (objects != nullptr) {
375 for (int i = objects->length() - 1; i >= 0; i--) {
376 objects->at(i)->as_ObjectValue()->set_visited(false);
377 }
378 }
379 int offset = serialize_scope_values(objects);
380 last_pd->set_obj_decode_offset(offset);
381 }
382
383 void DebugInformationRecorder::end_scopes(int pc_offset, bool is_safepoint) {
384 assert(_recording_state == (is_safepoint? rs_safepoint: rs_non_safepoint),
385 "nesting of recording calls");
386 debug_only(_recording_state = rs_null);
387
388 // Try to compress away an equivalent non-safepoint predecessor.
389 // (This only works because we have previously recognized redundant
390 // scope trees and made them use a common scope_decode_offset.)
391 if (_pcs_length >= 2 && recording_non_safepoints()) {
392 PcDesc* last = last_pc();
393 PcDesc* prev = prev_pc();
394 // If prev is (a) not a safepoint and (b) has the same
395 // stream pointer, then it can be coalesced into the last.
396 // This is valid because non-safepoints are only sought
397 // with pc_desc_near, which (when it misses prev) will
398 // search forward until it finds last.
399 // In addition, it does not matter if the last PcDesc
400 // is for a safepoint or not.
401 if (_prev_safepoint_pc < prev->pc_offset() && prev->is_same_info(last)) {
402 assert(prev == last-1, "sane");
403 prev->set_pc_offset(pc_offset);
404 _pcs_length -= 1;
405 NOT_PRODUCT(++dir_stats.chunks_elided);
406 }
407 }
408
409 // We have just recorded this safepoint.
410 // Remember it in case the previous paragraph needs to know.
411 if (is_safepoint) {
412 _prev_safepoint_pc = pc_offset;
413 }
414 }
415
416 #ifdef ASSERT
417 bool DebugInformationRecorder::recorders_frozen() {
418 return _oop_recorder->is_complete();
419 }
420
421 void DebugInformationRecorder::mark_recorders_frozen() {
422 _oop_recorder->freeze();
423 }
424 #endif // PRODUCT
425
426 DebugToken* DebugInformationRecorder::create_scope_values(GrowableArray<ScopeValue*>* values) {
427 assert(!recorders_frozen(), "not frozen yet");
428 return (DebugToken*) (intptr_t) serialize_scope_values(values);
429 }
430
431
432 DebugToken* DebugInformationRecorder::create_monitor_values(GrowableArray<MonitorValue*>* monitors) {
433 assert(!recorders_frozen(), "not frozen yet");
434 return (DebugToken*) (intptr_t) serialize_monitor_values(monitors);
435 }
436
437
438 int DebugInformationRecorder::data_size() {
439 debug_only(mark_recorders_frozen()); // mark it "frozen" for asserts
440 return _stream->position();
441 }
442
443
444 int DebugInformationRecorder::pcs_size() {
445 debug_only(mark_recorders_frozen()); // mark it "frozen" for asserts
446 if (last_pc()->pc_offset() != PcDesc::upper_offset_limit)
447 add_new_pc_offset(PcDesc::upper_offset_limit);
448 return _pcs_length * sizeof(PcDesc);
449 }
450
451
452 void DebugInformationRecorder::copy_to(nmethod* nm) {
453 nm->copy_scopes_data(stream()->buffer(), stream()->position());
454 nm->copy_scopes_pcs(_pcs, _pcs_length);
455 }
456
457
458 void DebugInformationRecorder::verify(const nmethod* code) {
459 Unimplemented();
460 }
461
462 #ifndef PRODUCT
463 void DebugInformationRecorder::print_statistics() {
464 dir_stats.print();
465 }
466 #endif //PRODUCT