compiler.h revision b0fa5dc7769c1e054032f39de0a3f6d6dd06f8cf 
1/*
2 * Copyright (C) 2014 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17#ifndef ART_COMPILER_COMPILER_H_
18#define ART_COMPILER_COMPILER_H_
19
20#include "dex_file.h"
21#include "os.h"
22
23namespace art {
24
25class Backend;
26struct CompilationUnit;
27class CompilerDriver;
28class CompiledMethod;
29class MIRGraph;
30class OatWriter;
31
32namespace mirror {
33  class ArtMethod;
34}
35
36class Compiler {
37 public:
38  enum Kind {
39    kQuick,
40    kOptimizing,
41    kPortable
42  };
43
44  explicit Compiler(uint64_t warning)
45      : maximum_compilation_time_before_warning_(warning) {
46  }
47
48  static Compiler* Create(Kind kind);
49
50  virtual void Init(CompilerDriver& driver) const = 0;
51
52  virtual void UnInit(CompilerDriver& driver) const = 0;
53
54  virtual CompiledMethod* Compile(CompilerDriver& driver,
55                                  const DexFile::CodeItem* code_item,
56                                  uint32_t access_flags,
57                                  InvokeType invoke_type,
58                                  uint16_t class_def_idx,
59                                  uint32_t method_idx,
60                                  jobject class_loader,
61                                  const DexFile& dex_file) const = 0;
62
63  static CompiledMethod* TryCompileWithSeaIR(art::CompilerDriver& driver,
64                                             const art::DexFile::CodeItem* code_item,
65                                             uint32_t access_flags,
66                                             art::InvokeType invoke_type,
67                                             uint16_t class_def_idx,
68                                             uint32_t method_idx,
69                                             jobject class_loader,
70                                             const art::DexFile& dex_file);
71
72  virtual CompiledMethod* JniCompile(CompilerDriver& driver,
73                                     uint32_t access_flags,
74                                     uint32_t method_idx,
75                                     const DexFile& dex_file) const = 0;
76
77  virtual uintptr_t GetEntryPointOf(mirror::ArtMethod* method) const
78     SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) = 0;
79
80  virtual bool WriteElf(art::File* file,
81                        OatWriter* oat_writer,
82                        const std::vector<const art::DexFile*>& dex_files,
83                        const std::string& android_root,
84                        bool is_host, const CompilerDriver& driver) const
85    SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) = 0;
86
87  virtual Backend* GetCodeGenerator(CompilationUnit* cu,
88                                    void* compilation_unit) const = 0;
89
90  uint64_t GetMaximumCompilationTimeBeforeWarning() const {
91    return maximum_compilation_time_before_warning_;
92  }
93
94  virtual bool IsPortable() const {
95    return false;
96  }
97
98  void SetBitcodeFileName(const CompilerDriver& driver, const std::string& filename) {
99    UNUSED(driver);
100    UNUSED(filename);
101  }
102
103  virtual void InitCompilationUnit(CompilationUnit& cu) const = 0;
104
105  virtual ~Compiler() {}
106
107  /*
108   * @brief Generate and return Dwarf CFI initialization, if supported by the
109   * backend.
110   * @param driver CompilerDriver for this compile.
111   * @returns nullptr if not supported by backend or a vector of bytes for CFI DWARF
112   * information.
113   * @note This is used for backtrace information in generated code.
114   */
115  virtual std::vector<uint8_t>* GetCallFrameInformationInitialization(const CompilerDriver& driver)
116      const {
117    return nullptr;
118  }
119
120 private:
121  const uint64_t maximum_compilation_time_before_warning_;
122
123  DISALLOW_COPY_AND_ASSIGN(Compiler);
124};
125
126}  // namespace art
127
128#endif  // ART_COMPILER_COMPILER_H_
129