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