1 /*
   2  * Copyright (c) 1999, 2014, 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_COMPILER_ABSTRACTCOMPILER_HPP
  26 #define SHARE_VM_COMPILER_ABSTRACTCOMPILER_HPP
  27 
  28 #include "ci/compilerInterface.hpp"
  29 
  30 class AbstractCompiler : public CHeapObj<mtCompiler> {
  31  private:
  32   volatile int _num_compiler_threads;
  33 
  34  protected:
  35   volatile int _compiler_state;
  36   // Used for tracking global state of compiler runtime initialization
  37   enum { uninitialized, initializing, initialized, failed, shut_down };
  38 
  39   // This method returns true for the first compiler thread that reaches that methods.
  40   // This thread will initialize the compiler runtime.
  41   bool should_perform_init();
  42 
  43   // The (closed set) of concrete compiler classes.
  44   enum Type {
  45     none,
  46     c1,
  47     c2,
  48     shark
  49   };
  50 
  51  private:
  52   Type _type;
  53 
  54  public:
  55   AbstractCompiler(Type type) : _type(type), _compiler_state(uninitialized), _num_compiler_threads(0) {}
  56 
  57   // This function determines the compiler thread that will perform the
  58   // shutdown of the corresponding compiler runtime.
  59   bool should_perform_shutdown();
  60 
  61   // Name of this compiler
  62   virtual const char* name() = 0;
  63 
  64   // Missing feature tests
  65   virtual bool supports_native()                 { return true; }
  66   virtual bool supports_osr   ()                 { return true; }
  67   virtual bool can_compile_method(methodHandle method)  { return true; }
  68 
  69   // Determine if the current compiler provides an intrinsic
  70   // for method 'method'. An intrinsic is available if:
  71   //  - the intrinsic is enabled (by using the appropriate command-line flag) and
  72   //  - the platform on which the VM is running supports the intrinsic
  73   //    (i.e., the platform provides the instructions necessary for the compiler
  74   //    to generate the intrinsic code).
  75   //
  76   // The DisableIntrinsic command-line flag can be used to prohibit the C2 compiler
  77   // tu use an intrinsic. There are three ways to disable an intrinsic using the
  78   // DisableIntrinsic flag:
  79   //
  80   // (1) -XX:DisableIntrinsic=_hashCode,_getClass
  81   //     Disables intrinsification of _hashCode and _getClass globally
  82   //     (i.e., the intrinsified version the methods will not be used at all).
  83   // (2) -XX:CompileCommand=option,aClass::aMethod,ccstr,DisableIntrinsic,_hashCode
  84   //     Disables intrinsification of _hashCode when it is called from
  85   //     aClass::aMethod (but not for any other call site of _hashCode)
  86   // (3) -XX:CompileCommand=option,java.lang.ref.Reference::get,ccstr,DisableIntrinsic,_Reference_get
  87   //     Some methods are not compiled by C2. Instead, the C2 compiler
  88   //     returns directly the intrinsified version of these methods.
  89   //     The command above forces C2 to compile _Reference_get, but
  90   //     allows using the intrinsified version of _Reference_get at all
  91   //     other call sites.
  92   //
  93   // From the modes above, (1) disable intrinsics globally, (2) and (3)
  94   // disable intrinsics on a per-method basis. In cases (2) and (3) the
  95   // compilation context is aClass::aMethod and java.lang.ref.Reference::get,
  96   // respectively.
  97   virtual bool is_intrinsic_available(methodHandle method, methodHandle compilation_context) {
  98     return false;
  99   }
 100 
 101   // Use the version of 'is_intrinsic_available_for' from below if usage of
 102   // per-method DisableIntrinsic flag is not expected (or not relevant). The
 103   // method below ignores all per-method usages of the DisableIntrinsic flag.
 104   virtual bool is_intrinsic_available(methodHandle method) {
 105     return false;
 106   }
 107 
 108   // Determines if an intrinsic is supported by the compiler, that is,
 109   // the compiler provides the instructions necessary to generate
 110   // the intrinsic code for method 'method'.
 111   //
 112   // The 'is_intrinsic_supported' method is a white list, that is,
 113   // by default no intrinsics are supported by a compiler except
 114   // the ones listed in the method. Overriding methods should conform
 115   // to this behavior.
 116   virtual bool is_intrinsic_supported(methodHandle method) {
 117     return false;
 118   }
 119 
 120   // Implements compiler-specific processing of command-line flags.
 121   // Processing of command-line flags common to all compilers is implemented
 122   // in vmIntrinsicss::is_disabled_by_flag.
 123   virtual bool is_intrinsic_disabled_by_flag(methodHandle method) {
 124     return false;
 125   }
 126 
 127   // Compiler type queries.
 128   bool is_c1()                                   { return _type == c1; }
 129   bool is_c2()                                   { return _type == c2; }
 130   bool is_shark()                                { return _type == shark; }
 131 
 132   // Customization
 133   virtual void initialize () = 0;
 134 
 135   void set_num_compiler_threads(int num) { _num_compiler_threads = num;  }
 136   int num_compiler_threads()             { return _num_compiler_threads; }
 137 
 138   // Get/set state of compiler objects
 139   bool is_initialized()           { return _compiler_state == initialized; }
 140   bool is_failed     ()           { return _compiler_state == failed;}
 141   void set_state     (int state);
 142   void set_shut_down ()           { set_state(shut_down); }
 143   // Compilation entry point for methods
 144   virtual void compile_method(ciEnv* env, ciMethod* target, int entry_bci) {
 145     ShouldNotReachHere();
 146   }
 147 
 148 
 149   // Print compilation timers and statistics
 150   virtual void print_timers() {
 151     ShouldNotReachHere();
 152   }
 153 };
 154 
 155 #endif // SHARE_VM_COMPILER_ABSTRACTCOMPILER_HPP