1 /*
2 * Copyright (c) 1999, 2013, 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_CI_CIENV_HPP
26 #define SHARE_VM_CI_CIENV_HPP
27
28 #include "ci/ciClassList.hpp"
29 #include "ci/ciObjectFactory.hpp"
30 #include "classfile/systemDictionary.hpp"
31 #include "code/debugInfoRec.hpp"
32 #include "code/dependencies.hpp"
33 #include "code/exceptionHandlerTable.hpp"
34 #include "compiler/oopMap.hpp"
35 #include "compiler/compilerDirectives.hpp"
36 #include "runtime/thread.hpp"
37
38 class CompileTask;
39 class DirectiveSet;
40
41 // ciEnv
42 //
43 // This class is the top level broker for requests from the compiler
44 // to the VM.
45 class ciEnv : StackObj {
46 CI_PACKAGE_ACCESS_TO
47
48 friend class CompileBroker;
49 friend class Dependencies; // for get_object, during logging
50
51 private:
52 Arena* _arena; // Alias for _ciEnv_arena except in init_shared_objects()
53 Arena _ciEnv_arena;
54 int _system_dictionary_modification_counter;
55 ciObjectFactory* _factory;
56 OopRecorder* _oop_recorder;
57 DebugInformationRecorder* _debug_info;
58 Dependencies* _dependencies;
59 const char* _failure_reason;
60 int _compilable;
61 int _num_inlined_bytecodes;
62 CompileTask* _task; // faster access to CompilerThread::task
63 CompileLog* _log; // faster access to CompilerThread::log
64 void* _compiler_data; // compiler-specific stuff, if any
65
66 char* _name_buffer;
67 int _name_buffer_len;
68
69 // Cache Jvmti state
70 bool _jvmti_can_hotswap_or_post_breakpoint;
71 bool _jvmti_can_access_local_variables;
72 bool _jvmti_can_post_on_exceptions;
73 bool _jvmti_can_pop_frame;
74
75 // Cache DTrace flags
76 bool _dtrace_extended_probes;
77 bool _dtrace_monitor_probes;
78 bool _dtrace_method_probes;
79 bool _dtrace_alloc_probes;
80
81 // Distinguished instances of certain ciObjects..
82 static ciObject* _null_object_instance;
83
84 #define WK_KLASS_DECL(name, ignore_s, ignore_o) static ciInstanceKlass* _##name;
85 WK_KLASSES_DO(WK_KLASS_DECL)
86 #undef WK_KLASS_DECL
87
88 static ciSymbol* _unloaded_cisymbol;
89 static ciInstanceKlass* _unloaded_ciinstance_klass;
90 static ciObjArrayKlass* _unloaded_ciobjarrayklass;
91
92 static jobject _ArrayIndexOutOfBoundsException_handle;
93 static jobject _ArrayStoreException_handle;
94 static jobject _ClassCastException_handle;
95
96 ciInstance* _NullPointerException_instance;
97 ciInstance* _ArithmeticException_instance;
98 ciInstance* _ArrayIndexOutOfBoundsException_instance;
99 ciInstance* _ArrayStoreException_instance;
100 ciInstance* _ClassCastException_instance;
101
102 ciInstance* _the_null_string; // The Java string "null"
103 ciInstance* _the_min_jint_string; // The Java string "-2147483648"
104
105 // Look up a klass by name from a particular class loader (the accessor's).
106 // If require_local, result must be defined in that class loader, or NULL.
107 // If !require_local, a result from remote class loader may be reported,
108 // if sufficient class loader constraints exist such that initiating
109 // a class loading request from the given loader is bound to return
110 // the class defined in the remote loader (or throw an error).
111 //
112 // Return an unloaded klass if !require_local and no class at all is found.
113 //
114 // The CI treats a klass as loaded if it is consistently defined in
115 // another loader, even if it hasn't yet been loaded in all loaders
116 // that could potentially see it via delegation.
117 ciKlass* get_klass_by_name(ciKlass* accessing_klass,
118 ciSymbol* klass_name,
119 bool require_local);
120
121 // Constant pool access.
122 ciKlass* get_klass_by_index(constantPoolHandle cpool,
123 int klass_index,
124 bool& is_accessible,
125 ciInstanceKlass* loading_klass);
126 ciConstant get_constant_by_index(constantPoolHandle cpool,
127 int pool_index, int cache_index,
128 ciInstanceKlass* accessor);
129 ciField* get_field_by_index(ciInstanceKlass* loading_klass,
130 int field_index);
131 ciMethod* get_method_by_index(constantPoolHandle cpool,
132 int method_index, Bytecodes::Code bc,
133 ciInstanceKlass* loading_klass);
134
135 // Implementation methods for loading and constant pool access.
136 ciKlass* get_klass_by_name_impl(ciKlass* accessing_klass,
137 constantPoolHandle cpool,
138 ciSymbol* klass_name,
139 bool require_local);
140 ciKlass* get_klass_by_index_impl(constantPoolHandle cpool,
141 int klass_index,
142 bool& is_accessible,
143 ciInstanceKlass* loading_klass);
144 ciConstant get_constant_by_index_impl(constantPoolHandle cpool,
145 int pool_index, int cache_index,
146 ciInstanceKlass* loading_klass);
147 ciField* get_field_by_index_impl(ciInstanceKlass* loading_klass,
148 int field_index);
149 ciMethod* get_method_by_index_impl(constantPoolHandle cpool,
150 int method_index, Bytecodes::Code bc,
151 ciInstanceKlass* loading_klass);
152
153 // Helper methods
154 bool check_klass_accessibility(ciKlass* accessing_klass,
155 Klass* resolved_klass);
156 Method* lookup_method(InstanceKlass* accessor,
157 InstanceKlass* holder,
158 Symbol* name,
159 Symbol* sig,
160 Bytecodes::Code bc);
161
162 // Get a ciObject from the object factory. Ensures uniqueness
163 // of ciObjects.
164 ciObject* get_object(oop o) {
165 if (o == NULL) {
166 return _null_object_instance;
167 } else {
168 return _factory->get(o);
169 }
170 }
171
172 ciSymbol* get_symbol(Symbol* o) {
173 if (o == NULL) {
174 ShouldNotReachHere();
175 return NULL;
176 } else {
177 return _factory->get_symbol(o);
178 }
179 }
180
181 ciMetadata* get_metadata(Metadata* o) {
182 if (o == NULL) {
183 return NULL;
184 } else {
185 return _factory->get_metadata(o);
186 }
187 }
188
189 void ensure_metadata_alive(ciMetadata* m) {
190 _factory->ensure_metadata_alive(m);
191 }
192
193 ciInstance* get_instance(oop o) {
194 if (o == NULL) return NULL;
195 return get_object(o)->as_instance();
196 }
197 ciObjArrayKlass* get_obj_array_klass(Klass* o) {
198 if (o == NULL) return NULL;
199 return get_metadata(o)->as_obj_array_klass();
200 }
201 ciTypeArrayKlass* get_type_array_klass(Klass* o) {
202 if (o == NULL) return NULL;
203 return get_metadata(o)->as_type_array_klass();
204 }
205 ciKlass* get_klass(Klass* o) {
206 if (o == NULL) return NULL;
207 return get_metadata(o)->as_klass();
208 }
209 ciInstanceKlass* get_instance_klass(Klass* o) {
210 if (o == NULL) return NULL;
211 return get_metadata(o)->as_instance_klass();
212 }
213 ciMethod* get_method(Method* o) {
214 if (o == NULL) return NULL;
215 return get_metadata(o)->as_method();
216 }
217 ciMethodData* get_method_data(MethodData* o) {
218 if (o == NULL) return NULL;
219 return get_metadata(o)->as_method_data();
220 }
221
222 ciMethod* get_method_from_handle(Method* method);
223
224 ciInstance* get_or_create_exception(jobject& handle, Symbol* name);
225
226 // Get a ciMethod representing either an unfound method or
227 // a method with an unloaded holder. Ensures uniqueness of
228 // the result.
229 ciMethod* get_unloaded_method(ciInstanceKlass* holder,
230 ciSymbol* name,
231 ciSymbol* signature,
232 ciInstanceKlass* accessor) {
233 return _factory->get_unloaded_method(holder, name, signature, accessor);
234 }
235
236 // Get a ciKlass representing an unloaded klass.
237 // Ensures uniqueness of the result.
238 ciKlass* get_unloaded_klass(ciKlass* accessing_klass,
239 ciSymbol* name) {
240 return _factory->get_unloaded_klass(accessing_klass, name, true);
241 }
242
243 // Get a ciKlass representing an unloaded klass mirror.
244 // Result is not necessarily unique, but will be unloaded.
245 ciInstance* get_unloaded_klass_mirror(ciKlass* type) {
246 return _factory->get_unloaded_klass_mirror(type);
247 }
248
249 // Get a ciInstance representing an unresolved method handle constant.
250 ciInstance* get_unloaded_method_handle_constant(ciKlass* holder,
251 ciSymbol* name,
252 ciSymbol* signature,
253 int ref_kind) {
254 return _factory->get_unloaded_method_handle_constant(holder, name, signature, ref_kind);
255 }
256
257 // Get a ciInstance representing an unresolved method type constant.
258 ciInstance* get_unloaded_method_type_constant(ciSymbol* signature) {
259 return _factory->get_unloaded_method_type_constant(signature);
260 }
261
262 // See if we already have an unloaded klass for the given name
263 // or return NULL if not.
264 ciKlass *check_get_unloaded_klass(ciKlass* accessing_klass, ciSymbol* name) {
265 return _factory->get_unloaded_klass(accessing_klass, name, false);
266 }
267
268 // Get a ciReturnAddress corresponding to the given bci.
269 // Ensures uniqueness of the result.
270 ciReturnAddress* get_return_address(int bci) {
271 return _factory->get_return_address(bci);
272 }
273
274 // Get a ciMethodData representing the methodData for a method
275 // with none.
276 ciMethodData* get_empty_methodData() {
277 return _factory->get_empty_methodData();
278 }
279
280 // General utility : get a buffer of some required length.
281 // Used in symbol creation.
282 char* name_buffer(int req_len);
283
284 // Is this thread currently in the VM state?
285 static bool is_in_vm();
286
287 // Helper routine for determining the validity of a compilation with
288 // respect to method dependencies (e.g. concurrent class loading).
289 void validate_compile_task_dependencies(ciMethod* target);
290
291 public:
292 enum {
293 MethodCompilable,
294 MethodCompilable_not_at_tier,
295 MethodCompilable_never
296 };
297
298 ciEnv(CompileTask* task, int system_dictionary_modification_counter);
299 // Used only during initialization of the ci
300 ciEnv(Arena* arena);
301 ~ciEnv();
302
303 OopRecorder* oop_recorder() { return _oop_recorder; }
304 void set_oop_recorder(OopRecorder* r) { _oop_recorder = r; }
305
306 DebugInformationRecorder* debug_info() { return _debug_info; }
307 void set_debug_info(DebugInformationRecorder* i) { _debug_info = i; }
308
309 Dependencies* dependencies() { return _dependencies; }
310 void set_dependencies(Dependencies* d) { _dependencies = d; }
311
312 // This is true if the compilation is not going to produce code.
313 // (It is reasonable to retry failed compilations.)
314 bool failing() { return _failure_reason != NULL; }
315
316 // Reason this compilation is failing, such as "too many basic blocks".
317 const char* failure_reason() { return _failure_reason; }
318
319 // Return state of appropriate compilability
320 int compilable() { return _compilable; }
321
322 const char* retry_message() const {
323 switch (_compilable) {
324 case ciEnv::MethodCompilable_not_at_tier:
325 return "retry at different tier";
326 case ciEnv::MethodCompilable_never:
327 return "not retryable";
328 case ciEnv::MethodCompilable:
329 return NULL;
330 default:
331 ShouldNotReachHere();
332 return NULL;
333 }
334 }
335
336 // Cache Jvmti state
337 void cache_jvmti_state();
338 bool jvmti_state_changed() const;
339 bool should_retain_local_variables() const;
340 bool jvmti_can_hotswap_or_post_breakpoint() const { return _jvmti_can_hotswap_or_post_breakpoint; }
341 bool jvmti_can_post_on_exceptions() const { return _jvmti_can_post_on_exceptions; }
342
343 // Cache DTrace flags
344 void cache_dtrace_flags();
345 bool dtrace_extended_probes() const { return _dtrace_extended_probes; }
346 bool dtrace_monitor_probes() const { return _dtrace_monitor_probes; }
347 bool dtrace_method_probes() const { return _dtrace_method_probes; }
348 bool dtrace_alloc_probes() const { return _dtrace_alloc_probes; }
349
350 // The compiler task which has created this env.
351 // May be useful to find out compile_id, comp_level, etc.
352 CompileTask* task() { return _task; }
353
354 // Handy forwards to the task:
355 int comp_level(); // task()->comp_level()
356 uint compile_id(); // task()->compile_id()
357
358 // Register the result of a compilation.
359 void register_method(ciMethod* target,
360 int entry_bci,
361 CodeOffsets* offsets,
362 int orig_pc_offset,
363 CodeBuffer* code_buffer,
364 int frame_words,
365 OopMapSet* oop_map_set,
366 ExceptionHandlerTable* handler_table,
367 ImplicitExceptionTable* inc_table,
368 AbstractCompiler* compiler,
369 bool has_unsafe_access,
370 bool has_wide_vectors,
371 DirectiveSet* dirset,
372 RTMState rtm_state = NoRTM);
373
374
375 // Access to certain well known ciObjects.
376 #define WK_KLASS_FUNC(name, ignore_s, ignore_o) \
377 ciInstanceKlass* name() { \
378 return _##name;\
379 }
380 WK_KLASSES_DO(WK_KLASS_FUNC)
381 #undef WK_KLASS_FUNC
382
383 ciInstance* NullPointerException_instance() {
384 assert(_NullPointerException_instance != NULL, "initialization problem");
385 return _NullPointerException_instance;
386 }
387 ciInstance* ArithmeticException_instance() {
388 assert(_ArithmeticException_instance != NULL, "initialization problem");
389 return _ArithmeticException_instance;
390 }
391
392 // Lazy constructors:
393 ciInstance* ArrayIndexOutOfBoundsException_instance();
394 ciInstance* ArrayStoreException_instance();
395 ciInstance* ClassCastException_instance();
396
397 ciInstance* the_null_string();
398 ciInstance* the_min_jint_string();
399
400 static ciSymbol* unloaded_cisymbol() {
401 return _unloaded_cisymbol;
402 }
403 static ciObjArrayKlass* unloaded_ciobjarrayklass() {
404 return _unloaded_ciobjarrayklass;
405 }
406 static ciInstanceKlass* unloaded_ciinstance_klass() {
407 return _unloaded_ciinstance_klass;
408 }
409 ciInstance* unloaded_ciinstance();
410
411 ciKlass* find_system_klass(ciSymbol* klass_name);
412 // Note: To find a class from its name string, use ciSymbol::make,
413 // but consider adding to vmSymbols.hpp instead.
414
415 // converts the ciKlass* representing the holder of a method into a
416 // ciInstanceKlass*. This is needed since the holder of a method in
417 // the bytecodes could be an array type. Basically this converts
418 // array types into java/lang/Object and other types stay as they are.
419 static ciInstanceKlass* get_instance_klass_for_declared_method_holder(ciKlass* klass);
420
421 // Return the machine-level offset of o, which must be an element of a.
422 // This may be used to form constant-loading expressions in lieu of simpler encodings.
423 int array_element_offset_in_bytes(ciArray* a, ciObject* o);
424
425 // Access to the compile-lifetime allocation arena.
426 Arena* arena() { return _arena; }
427
428 // What is the current compilation environment?
429 static ciEnv* current() { return CompilerThread::current()->env(); }
430
431 // Overload with current thread argument
432 static ciEnv* current(CompilerThread *thread) { return thread->env(); }
433
434 // Per-compiler data. (Used by C2 to publish the Compile* pointer.)
435 void* compiler_data() { return _compiler_data; }
436 void set_compiler_data(void* x) { _compiler_data = x; }
437
438 // Notice that a method has been inlined in the current compile;
439 // used only for statistics.
440 void notice_inlined_method(ciMethod* method);
441
442 // Total number of bytecodes in inlined methods in this compile
443 int num_inlined_bytecodes() const;
444
445 // Output stream for logging compilation info.
446 CompileLog* log() { return _log; }
447 void set_log(CompileLog* log) { _log = log; }
448
449 // Check for changes to the system dictionary during compilation
450 bool system_dictionary_modification_counter_changed();
451
452 void record_failure(const char* reason); // Record failure and report later
453 void report_failure(const char* reason); // Report failure immediately
454 void record_method_not_compilable(const char* reason, bool all_tiers = true);
455 void record_out_of_memory_failure();
456
457 // RedefineClasses support
458 void metadata_do(void f(Metadata*)) { _factory->metadata_do(f); }
459
460 // Dump the compilation replay data for the ciEnv to the stream.
461 void dump_replay_data(int compile_id);
462 void dump_inline_data(int compile_id);
463 void dump_replay_data(outputStream* out);
464 void dump_replay_data_unsafe(outputStream* out);
465 void dump_compile_data(outputStream* out);
466
467 // Compilation directives
468 bool should_inline(ciMethod* inlinee);
469 bool should_not_inline(ciMethod* inlinee);
470
471 };
472
473 #endif // SHARE_VM_CI_CIENV_HPP