1 /* 2 * Copyright (C) 2015 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 RUNTIME_OPTIONS_KEY 18 #error "Please #define RUNTIME_OPTIONS_KEY before #including this file" 19 #define RUNTIME_OPTIONS_KEY(...) // Don't display errors in this file in IDEs. 20 #endif 21 22 // This file defines the list of keys for RuntimeOptions. 23 // These can be used with RuntimeOptions.Get/Set/etc, for example: 24 // RuntimeOptions opt; bool* dex2oat_enabled = opt.Get(RuntimeOptions::Dex2Oat); 25 // 26 // Column Descriptions: 27 // <<Type>> <<Key Name>> <<Default Value>> 28 // 29 // Default values are only used by Map::GetOrDefault(K<T>). 30 // If a default value is omitted here, T{} is used as the default value, which is 31 // almost-always the value of the type as if it was memset to all 0. 32 // 33 34 // Parse-able keys from the command line. 35 RUNTIME_OPTIONS_KEY (Unit, Zygote) 36 RUNTIME_OPTIONS_KEY (Unit, Help) 37 RUNTIME_OPTIONS_KEY (Unit, ShowVersion) 38 RUNTIME_OPTIONS_KEY (std::string, BootClassPath) 39 RUNTIME_OPTIONS_KEY (ParseStringList<':'>,BootClassPathLocations) // std::vector<std::string> 40 RUNTIME_OPTIONS_KEY (std::string, ClassPath) 41 RUNTIME_OPTIONS_KEY (std::string, Image) 42 RUNTIME_OPTIONS_KEY (Unit, CheckJni) 43 RUNTIME_OPTIONS_KEY (Unit, JniOptsForceCopy) 44 RUNTIME_OPTIONS_KEY (JDWP::JdwpOptions, JdwpOptions) 45 RUNTIME_OPTIONS_KEY (MemoryKiB, MemoryMaximumSize, gc::Heap::kDefaultMaximumSize) // -Xmx 46 RUNTIME_OPTIONS_KEY (MemoryKiB, MemoryInitialSize, gc::Heap::kDefaultInitialSize) // -Xms 47 RUNTIME_OPTIONS_KEY (MemoryKiB, HeapGrowthLimit) // Default is 0 for unlimited 48 RUNTIME_OPTIONS_KEY (MemoryKiB, HeapMinFree, gc::Heap::kDefaultMinFree) 49 RUNTIME_OPTIONS_KEY (MemoryKiB, HeapMaxFree, gc::Heap::kDefaultMaxFree) 50 RUNTIME_OPTIONS_KEY (MemoryKiB, NonMovingSpaceCapacity, gc::Heap::kDefaultNonMovingSpaceCapacity) 51 RUNTIME_OPTIONS_KEY (double, HeapTargetUtilization, gc::Heap::kDefaultTargetUtilization) 52 RUNTIME_OPTIONS_KEY (double, ForegroundHeapGrowthMultiplier, gc::Heap::kDefaultHeapGrowthMultiplier) 53 RUNTIME_OPTIONS_KEY (unsigned int, ParallelGCThreads, 0u) 54 RUNTIME_OPTIONS_KEY (unsigned int, ConcGCThreads) 55 RUNTIME_OPTIONS_KEY (Memory<1>, StackSize) // -Xss 56 RUNTIME_OPTIONS_KEY (unsigned int, MaxSpinsBeforeThinLockInflation,Monitor::kDefaultMaxSpinsBeforeThinLockInflation) 57 RUNTIME_OPTIONS_KEY (MillisecondsToNanoseconds, \ 58 LongPauseLogThreshold, gc::Heap::kDefaultLongPauseLogThreshold) 59 RUNTIME_OPTIONS_KEY (MillisecondsToNanoseconds, \ 60 LongGCLogThreshold, gc::Heap::kDefaultLongGCLogThreshold) 61 RUNTIME_OPTIONS_KEY (Unit, DumpGCPerformanceOnShutdown) 62 RUNTIME_OPTIONS_KEY (Unit, DumpJITInfoOnShutdown) 63 RUNTIME_OPTIONS_KEY (Unit, IgnoreMaxFootprint) 64 RUNTIME_OPTIONS_KEY (Unit, LowMemoryMode) 65 RUNTIME_OPTIONS_KEY (bool, UseTLAB, kUseTlab) 66 RUNTIME_OPTIONS_KEY (bool, EnableHSpaceCompactForOOM, true) 67 RUNTIME_OPTIONS_KEY (bool, UseJIT, false) 68 RUNTIME_OPTIONS_KEY (unsigned int, JITCompileThreshold, jit::Jit::kDefaultCompileThreshold) 69 RUNTIME_OPTIONS_KEY (MemoryKiB, JITCodeCacheCapacity, jit::JitCodeCache::kDefaultCapacity) 70 RUNTIME_OPTIONS_KEY (MillisecondsToNanoseconds, \ 71 HSpaceCompactForOOMMinIntervalsMs,\ 72 MsToNs(100 * 1000)) // 100s 73 RUNTIME_OPTIONS_KEY (std::vector<std::string>, \ 74 PropertiesList) // -D<whatever> -D<whatever> ... 75 RUNTIME_OPTIONS_KEY (std::string, JniTrace) 76 RUNTIME_OPTIONS_KEY (std::string, PatchOat) 77 RUNTIME_OPTIONS_KEY (bool, Relocate, kDefaultMustRelocate) 78 RUNTIME_OPTIONS_KEY (bool, Dex2Oat, true) 79 RUNTIME_OPTIONS_KEY (bool, ImageDex2Oat, true) 80 // kPoisonHeapReferences currently works with 81 // the interpreter only. 82 // TODO: make it work with the compiler. 83 RUNTIME_OPTIONS_KEY (bool, Interpret, (kPoisonHeapReferences || kUseReadBarrier)) // -Xint 84 // Disable the compiler for CC (for now). 85 RUNTIME_OPTIONS_KEY (XGcOption, GcOption) // -Xgc: 86 RUNTIME_OPTIONS_KEY (gc::space::LargeObjectSpaceType, \ 87 LargeObjectSpace, gc::Heap::kDefaultLargeObjectSpaceType) 88 RUNTIME_OPTIONS_KEY (Memory<1>, LargeObjectThreshold, gc::Heap::kDefaultLargeObjectThreshold) 89 RUNTIME_OPTIONS_KEY (BackgroundGcOption, BackgroundGc) 90 91 RUNTIME_OPTIONS_KEY (Unit, DisableExplicitGC) 92 RUNTIME_OPTIONS_KEY (LogVerbosity, Verbose) 93 RUNTIME_OPTIONS_KEY (unsigned int, LockProfThreshold) 94 RUNTIME_OPTIONS_KEY (std::string, StackTraceFile) 95 RUNTIME_OPTIONS_KEY (Unit, MethodTrace) 96 RUNTIME_OPTIONS_KEY (std::string, MethodTraceFile, "/data/method-trace-file.bin") 97 RUNTIME_OPTIONS_KEY (unsigned int, MethodTraceFileSize, 10 * MB) 98 RUNTIME_OPTIONS_KEY (Unit, MethodTraceStreaming) 99 RUNTIME_OPTIONS_KEY (TraceClockSource, ProfileClock, kDefaultTraceClockSource) // -Xprofile: 100 RUNTIME_OPTIONS_KEY (TestProfilerOptions, ProfilerOpts) // -Xenable-profiler, -Xprofile-* 101 RUNTIME_OPTIONS_KEY (std::string, Compiler) 102 RUNTIME_OPTIONS_KEY (std::vector<std::string>, \ 103 CompilerOptions) // -Xcompiler-option ... 104 RUNTIME_OPTIONS_KEY (std::vector<std::string>, \ 105 ImageCompilerOptions) // -Ximage-compiler-option ... 106 RUNTIME_OPTIONS_KEY (bool, Verify, true) 107 RUNTIME_OPTIONS_KEY (std::string, NativeBridge) 108 RUNTIME_OPTIONS_KEY (std::string, CpuAbiList) 109 110 // Not parse-able from command line, but can be provided explicitly. 111 RUNTIME_OPTIONS_KEY (const std::vector<const DexFile*>*, \ 112 BootClassPathDexList) // TODO: make unique_ptr 113 RUNTIME_OPTIONS_KEY (InstructionSet, ImageInstructionSet, kRuntimeISA) 114 RUNTIME_OPTIONS_KEY (CompilerCallbacks*, CompilerCallbacksPtr) // TDOO: make unique_ptr 115 RUNTIME_OPTIONS_KEY (bool (*)(), HookIsSensitiveThread) 116 RUNTIME_OPTIONS_KEY (int32_t (*)(FILE* stream, const char* format, va_list ap), \ 117 HookVfprintf, vfprintf) 118 RUNTIME_OPTIONS_KEY (void (*)(int32_t status), \ 119 HookExit, exit) 120 // We don't call abort(3) by default; see 121 // Runtime::Abort. 122 RUNTIME_OPTIONS_KEY (void (*)(), HookAbort, nullptr) 123 RUNTIME_OPTIONS_KEY (unsigned int, ZygoteMaxFailedBoots, 10) 124 RUNTIME_OPTIONS_KEY (Unit, NoDexFileFallback) 125 RUNTIME_OPTIONS_KEY (std::string, Fingerprint) 126 127 #undef RUNTIME_OPTIONS_KEY 128