/* * Copyright (C) 2014 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef ART_COMPILER_DRIVER_COMPILER_OPTIONS_H_ #define ART_COMPILER_DRIVER_COMPILER_OPTIONS_H_ #include #include #include "base/macros.h" namespace art { class CompilerOptions FINAL { public: enum CompilerFilter { kVerifyNone, // Skip verification and compile nothing except JNI stubs. kInterpretOnly, // Compile nothing except JNI stubs. kSpace, // Maximize space savings. kBalanced, // Try to get the best performance return on compilation investment. kSpeed, // Maximize runtime performance. kEverything, // Force compilation (Note: excludes compilation of class initializers). kTime, // Compile methods, but minimize compilation time. }; // Guide heuristics to determine whether to compile method if profile data not available. #if ART_SMALL_MODE static const CompilerFilter kDefaultCompilerFilter = kInterpretOnly; #else static const CompilerFilter kDefaultCompilerFilter = kSpeed; #endif static const size_t kDefaultHugeMethodThreshold = 10000; static const size_t kDefaultLargeMethodThreshold = 600; static const size_t kDefaultSmallMethodThreshold = 60; static const size_t kDefaultTinyMethodThreshold = 20; static const size_t kDefaultNumDexMethodsThreshold = 900; static constexpr double kDefaultTopKProfileThreshold = 90.0; static const bool kDefaultIncludeDebugSymbols = kIsDebugBuild; static const bool kDefaultIncludePatchInformation = false; CompilerOptions() : compiler_filter_(kDefaultCompilerFilter), huge_method_threshold_(kDefaultHugeMethodThreshold), large_method_threshold_(kDefaultLargeMethodThreshold), small_method_threshold_(kDefaultSmallMethodThreshold), tiny_method_threshold_(kDefaultTinyMethodThreshold), num_dex_methods_threshold_(kDefaultNumDexMethodsThreshold), generate_gdb_information_(false), include_patch_information_(kDefaultIncludePatchInformation), top_k_profile_threshold_(kDefaultTopKProfileThreshold), include_debug_symbols_(kDefaultIncludeDebugSymbols), implicit_null_checks_(false), implicit_so_checks_(false), implicit_suspend_checks_(false), compile_pic_(false), #ifdef ART_SEA_IR_MODE sea_ir_mode_(false), #endif verbose_methods_(nullptr) { } CompilerOptions(CompilerFilter compiler_filter, size_t huge_method_threshold, size_t large_method_threshold, size_t small_method_threshold, size_t tiny_method_threshold, size_t num_dex_methods_threshold, bool generate_gdb_information, bool include_patch_information, double top_k_profile_threshold, bool include_debug_symbols, bool implicit_null_checks, bool implicit_so_checks, bool implicit_suspend_checks, bool compile_pic, #ifdef ART_SEA_IR_MODE bool sea_ir_mode, #endif const std::vector* verbose_methods ) : // NOLINT(whitespace/parens) compiler_filter_(compiler_filter), huge_method_threshold_(huge_method_threshold), large_method_threshold_(large_method_threshold), small_method_threshold_(small_method_threshold), tiny_method_threshold_(tiny_method_threshold), num_dex_methods_threshold_(num_dex_methods_threshold), generate_gdb_information_(generate_gdb_information), include_patch_information_(include_patch_information), top_k_profile_threshold_(top_k_profile_threshold), include_debug_symbols_(include_debug_symbols), implicit_null_checks_(implicit_null_checks), implicit_so_checks_(implicit_so_checks), implicit_suspend_checks_(implicit_suspend_checks), compile_pic_(compile_pic), #ifdef ART_SEA_IR_MODE sea_ir_mode_(sea_ir_mode), #endif verbose_methods_(verbose_methods) { } CompilerFilter GetCompilerFilter() const { return compiler_filter_; } void SetCompilerFilter(CompilerFilter compiler_filter) { compiler_filter_ = compiler_filter; } bool IsCompilationEnabled() const { return ((compiler_filter_ != CompilerOptions::kVerifyNone) && (compiler_filter_ != CompilerOptions::kInterpretOnly)); } bool IsVerificationEnabled() const { return (compiler_filter_ != CompilerOptions::kVerifyNone); } size_t GetHugeMethodThreshold() const { return huge_method_threshold_; } size_t GetLargeMethodThreshold() const { return large_method_threshold_; } size_t GetSmallMethodThreshold() const { return small_method_threshold_; } size_t GetTinyMethodThreshold() const { return tiny_method_threshold_; } bool IsHugeMethod(size_t num_dalvik_instructions) const { return num_dalvik_instructions > huge_method_threshold_; } bool IsLargeMethod(size_t num_dalvik_instructions) const { return num_dalvik_instructions > large_method_threshold_; } bool IsSmallMethod(size_t num_dalvik_instructions) const { return num_dalvik_instructions > small_method_threshold_; } bool IsTinyMethod(size_t num_dalvik_instructions) const { return num_dalvik_instructions > tiny_method_threshold_; } size_t GetNumDexMethodsThreshold() const { return num_dex_methods_threshold_; } double GetTopKProfileThreshold() const { return top_k_profile_threshold_; } bool GetIncludeDebugSymbols() const { return include_debug_symbols_; } bool GetImplicitNullChecks() const { return implicit_null_checks_; } bool GetImplicitStackOverflowChecks() const { return implicit_so_checks_; } bool GetImplicitSuspendChecks() const { return implicit_suspend_checks_; } #ifdef ART_SEA_IR_MODE bool GetSeaIrMode() const { return sea_ir_mode_; } #endif bool GetGenerateGDBInformation() const { return generate_gdb_information_; } bool GetIncludePatchInformation() const { return include_patch_information_; } // Should the code be compiled as position independent? bool GetCompilePic() const { return compile_pic_; } bool HasVerboseMethods() const { return verbose_methods_ != nullptr && !verbose_methods_->empty(); } bool IsVerboseMethod(const std::string& pretty_method) const { for (const std::string& cur_method : *verbose_methods_) { if (pretty_method.find(cur_method) != std::string::npos) { return true; } } return false; } private: CompilerFilter compiler_filter_; const size_t huge_method_threshold_; const size_t large_method_threshold_; const size_t small_method_threshold_; const size_t tiny_method_threshold_; const size_t num_dex_methods_threshold_; const bool generate_gdb_information_; const bool include_patch_information_; // When using a profile file only the top K% of the profiled samples will be compiled. const double top_k_profile_threshold_; const bool include_debug_symbols_; const bool implicit_null_checks_; const bool implicit_so_checks_; const bool implicit_suspend_checks_; const bool compile_pic_; #ifdef ART_SEA_IR_MODE const bool sea_ir_mode_; #endif // Vector of methods to have verbose output enabled for. const std::vector* const verbose_methods_; DISALLOW_COPY_AND_ASSIGN(CompilerOptions); }; } // namespace art #endif // ART_COMPILER_DRIVER_COMPILER_OPTIONS_H_