blob: e68a1b2681c7b1340f6ae0d3c6fb8134d4405ce1 [file] [log] [blame]
Igor Murashkinaaebaa02015-01-26 10:55:53 -08001/*
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//
Igor Murashkinc449e8b2015-06-10 15:56:42 -070033// Please keep the columns aligned if possible when adding new rows.
34//
Igor Murashkinaaebaa02015-01-26 10:55:53 -080035
36// Parse-able keys from the command line.
37RUNTIME_OPTIONS_KEY (Unit, Zygote)
38RUNTIME_OPTIONS_KEY (Unit, Help)
39RUNTIME_OPTIONS_KEY (Unit, ShowVersion)
40RUNTIME_OPTIONS_KEY (std::string, BootClassPath)
41RUNTIME_OPTIONS_KEY (ParseStringList<':'>,BootClassPathLocations) // std::vector<std::string>
42RUNTIME_OPTIONS_KEY (std::string, ClassPath)
43RUNTIME_OPTIONS_KEY (std::string, Image)
44RUNTIME_OPTIONS_KEY (Unit, CheckJni)
45RUNTIME_OPTIONS_KEY (Unit, JniOptsForceCopy)
46RUNTIME_OPTIONS_KEY (JDWP::JdwpOptions, JdwpOptions)
47RUNTIME_OPTIONS_KEY (MemoryKiB, MemoryMaximumSize, gc::Heap::kDefaultMaximumSize) // -Xmx
48RUNTIME_OPTIONS_KEY (MemoryKiB, MemoryInitialSize, gc::Heap::kDefaultInitialSize) // -Xms
49RUNTIME_OPTIONS_KEY (MemoryKiB, HeapGrowthLimit) // Default is 0 for unlimited
50RUNTIME_OPTIONS_KEY (MemoryKiB, HeapMinFree, gc::Heap::kDefaultMinFree)
51RUNTIME_OPTIONS_KEY (MemoryKiB, HeapMaxFree, gc::Heap::kDefaultMaxFree)
52RUNTIME_OPTIONS_KEY (MemoryKiB, NonMovingSpaceCapacity, gc::Heap::kDefaultNonMovingSpaceCapacity)
53RUNTIME_OPTIONS_KEY (double, HeapTargetUtilization, gc::Heap::kDefaultTargetUtilization)
54RUNTIME_OPTIONS_KEY (double, ForegroundHeapGrowthMultiplier, gc::Heap::kDefaultHeapGrowthMultiplier)
Mathieu Chartier10d68862015-04-15 14:21:33 -070055RUNTIME_OPTIONS_KEY (unsigned int, ParallelGCThreads, 0u)
Igor Murashkinaaebaa02015-01-26 10:55:53 -080056RUNTIME_OPTIONS_KEY (unsigned int, ConcGCThreads)
57RUNTIME_OPTIONS_KEY (Memory<1>, StackSize) // -Xss
58RUNTIME_OPTIONS_KEY (unsigned int, MaxSpinsBeforeThinLockInflation,Monitor::kDefaultMaxSpinsBeforeThinLockInflation)
59RUNTIME_OPTIONS_KEY (MillisecondsToNanoseconds, \
60 LongPauseLogThreshold, gc::Heap::kDefaultLongPauseLogThreshold)
61RUNTIME_OPTIONS_KEY (MillisecondsToNanoseconds, \
62 LongGCLogThreshold, gc::Heap::kDefaultLongGCLogThreshold)
Mathieu Chartier3fceaf52017-01-22 13:33:40 -080063RUNTIME_OPTIONS_KEY (MillisecondsToNanoseconds, \
64 ThreadSuspendTimeout, ThreadList::kDefaultThreadSuspendTimeout)
Igor Murashkinaaebaa02015-01-26 10:55:53 -080065RUNTIME_OPTIONS_KEY (Unit, DumpGCPerformanceOnShutdown)
Mathieu Chartiera4885cb2015-03-09 15:38:54 -070066RUNTIME_OPTIONS_KEY (Unit, DumpJITInfoOnShutdown)
Igor Murashkinaaebaa02015-01-26 10:55:53 -080067RUNTIME_OPTIONS_KEY (Unit, IgnoreMaxFootprint)
68RUNTIME_OPTIONS_KEY (Unit, LowMemoryMode)
Hiroshi Yamauchi49b71342015-05-15 16:24:24 -070069RUNTIME_OPTIONS_KEY (bool, UseTLAB, (kUseTlab || kUseReadBarrier))
Igor Murashkinaaebaa02015-01-26 10:55:53 -080070RUNTIME_OPTIONS_KEY (bool, EnableHSpaceCompactForOOM, true)
Calin Juravleffc87072016-04-20 14:22:09 +010071RUNTIME_OPTIONS_KEY (bool, UseJitCompilation, false)
Nicolas Geoffraya73280d2016-02-15 13:05:16 +000072RUNTIME_OPTIONS_KEY (bool, DumpNativeStackOnSigQuit, true)
Igor Murashkinc449e8b2015-06-10 15:56:42 -070073RUNTIME_OPTIONS_KEY (unsigned int, JITCompileThreshold, jit::Jit::kDefaultCompileThreshold)
Nicolas Geoffray83f080a2016-03-08 16:50:21 +000074RUNTIME_OPTIONS_KEY (unsigned int, JITWarmupThreshold)
75RUNTIME_OPTIONS_KEY (unsigned int, JITOsrThreshold)
Calin Juravleb2771b42016-04-07 17:09:25 +010076RUNTIME_OPTIONS_KEY (unsigned int, JITPriorityThreadWeight)
Calin Juravle155ff3d2016-04-27 14:14:58 +010077RUNTIME_OPTIONS_KEY (unsigned int, JITInvokeTransitionWeight)
Nicolas Geoffray0a3be162015-11-18 11:15:22 +000078RUNTIME_OPTIONS_KEY (MemoryKiB, JITCodeCacheInitialCapacity, jit::JitCodeCache::kInitialCapacity)
79RUNTIME_OPTIONS_KEY (MemoryKiB, JITCodeCacheMaxCapacity, jit::JitCodeCache::kMaxCapacity)
Igor Murashkinaaebaa02015-01-26 10:55:53 -080080RUNTIME_OPTIONS_KEY (MillisecondsToNanoseconds, \
81 HSpaceCompactForOOMMinIntervalsMs,\
82 MsToNs(100 * 1000)) // 100s
83RUNTIME_OPTIONS_KEY (std::vector<std::string>, \
84 PropertiesList) // -D<whatever> -D<whatever> ...
85RUNTIME_OPTIONS_KEY (std::string, JniTrace)
86RUNTIME_OPTIONS_KEY (std::string, PatchOat)
87RUNTIME_OPTIONS_KEY (bool, Relocate, kDefaultMustRelocate)
Nicolas Geoffraye722d292015-12-15 11:51:37 +000088RUNTIME_OPTIONS_KEY (bool, Dex2Oat, true)
Igor Murashkinaaebaa02015-01-26 10:55:53 -080089RUNTIME_OPTIONS_KEY (bool, ImageDex2Oat, true)
Roland Levillain0d5a2812015-11-13 10:07:31 +000090RUNTIME_OPTIONS_KEY (bool, Interpret, false) // -Xint
Igor Murashkinaaebaa02015-01-26 10:55:53 -080091 // Disable the compiler for CC (for now).
92RUNTIME_OPTIONS_KEY (XGcOption, GcOption) // -Xgc:
93RUNTIME_OPTIONS_KEY (gc::space::LargeObjectSpaceType, \
94 LargeObjectSpace, gc::Heap::kDefaultLargeObjectSpaceType)
95RUNTIME_OPTIONS_KEY (Memory<1>, LargeObjectThreshold, gc::Heap::kDefaultLargeObjectThreshold)
96RUNTIME_OPTIONS_KEY (BackgroundGcOption, BackgroundGc)
97
98RUNTIME_OPTIONS_KEY (Unit, DisableExplicitGC)
Calin Juravle01aaf6e2015-06-19 22:05:39 +010099RUNTIME_OPTIONS_KEY (Unit, NoSigChain)
Calin Juravled3e7c6c2016-02-04 19:07:51 +0000100RUNTIME_OPTIONS_KEY (Unit, ForceNativeBridge)
Igor Murashkinaaebaa02015-01-26 10:55:53 -0800101RUNTIME_OPTIONS_KEY (LogVerbosity, Verbose)
102RUNTIME_OPTIONS_KEY (unsigned int, LockProfThreshold)
103RUNTIME_OPTIONS_KEY (std::string, StackTraceFile)
104RUNTIME_OPTIONS_KEY (Unit, MethodTrace)
Calin Juravlef83e7332015-11-04 16:16:47 +0000105RUNTIME_OPTIONS_KEY (std::string, MethodTraceFile, "/data/misc/trace/method-trace-file.bin")
Igor Murashkinaaebaa02015-01-26 10:55:53 -0800106RUNTIME_OPTIONS_KEY (unsigned int, MethodTraceFileSize, 10 * MB)
Andreas Gampe40da2862015-02-27 12:49:04 -0800107RUNTIME_OPTIONS_KEY (Unit, MethodTraceStreaming)
Igor Murashkinaaebaa02015-01-26 10:55:53 -0800108RUNTIME_OPTIONS_KEY (TraceClockSource, ProfileClock, kDefaultTraceClockSource) // -Xprofile:
Calin Juravle138dbff2016-06-28 19:36:58 +0100109RUNTIME_OPTIONS_KEY (ProfileSaverOptions, ProfileSaverOpts) // -Xjitsaveprofilinginfo, -Xps-*
Igor Murashkinaaebaa02015-01-26 10:55:53 -0800110RUNTIME_OPTIONS_KEY (std::string, Compiler)
111RUNTIME_OPTIONS_KEY (std::vector<std::string>, \
112 CompilerOptions) // -Xcompiler-option ...
113RUNTIME_OPTIONS_KEY (std::vector<std::string>, \
114 ImageCompilerOptions) // -Ximage-compiler-option ...
Igor Murashkin7617abd2015-07-10 18:27:47 -0700115RUNTIME_OPTIONS_KEY (verifier::VerifyMode, \
116 Verify, verifier::VerifyMode::kEnable)
Igor Murashkinaaebaa02015-01-26 10:55:53 -0800117RUNTIME_OPTIONS_KEY (std::string, NativeBridge)
Igor Murashkinc449e8b2015-06-10 15:56:42 -0700118RUNTIME_OPTIONS_KEY (unsigned int, ZygoteMaxFailedBoots, 10)
119RUNTIME_OPTIONS_KEY (Unit, NoDexFileFallback)
Dmitriy Ivanov785049f2014-07-18 10:08:57 -0700120RUNTIME_OPTIONS_KEY (std::string, CpuAbiList)
Andreas Gampedd671252015-07-23 14:37:18 -0700121RUNTIME_OPTIONS_KEY (std::string, Fingerprint)
Andreas Gampe01fd70b2017-01-25 10:03:08 -0800122RUNTIME_OPTIONS_KEY (ExperimentalFlags, Experimental, ExperimentalFlags::kNone) // -Xexperimental:{...}
123RUNTIME_OPTIONS_KEY (std::vector<ti::Agent>, AgentLib) // -agentlib:<libname>=<options>
124RUNTIME_OPTIONS_KEY (std::vector<ti::Agent>, AgentPath) // -agentpath:<libname>=<options>
125RUNTIME_OPTIONS_KEY (std::vector<Plugin>, Plugins) // -Xplugin:<library>
Igor Murashkinaaebaa02015-01-26 10:55:53 -0800126
127// Not parse-able from command line, but can be provided explicitly.
Igor Murashkinc449e8b2015-06-10 15:56:42 -0700128// (Do not add anything here that is defined in ParsedOptions::MakeParser)
Vladimir Marko9bdf1082016-01-21 12:15:52 +0000129RUNTIME_OPTIONS_KEY (std::vector<std::unique_ptr<const DexFile>>*, \
130 BootClassPathDexList)
Igor Murashkinaaebaa02015-01-26 10:55:53 -0800131RUNTIME_OPTIONS_KEY (InstructionSet, ImageInstructionSet, kRuntimeISA)
132RUNTIME_OPTIONS_KEY (CompilerCallbacks*, CompilerCallbacksPtr) // TDOO: make unique_ptr
133RUNTIME_OPTIONS_KEY (bool (*)(), HookIsSensitiveThread)
134RUNTIME_OPTIONS_KEY (int32_t (*)(FILE* stream, const char* format, va_list ap), \
135 HookVfprintf, vfprintf)
Hiroshi Yamauchi249b4d12016-05-11 19:27:44 -0700136// Use _exit instead of exit so that we won't get DCHECK failures in global data
137// destructors. b/28106055.
Igor Murashkinaaebaa02015-01-26 10:55:53 -0800138RUNTIME_OPTIONS_KEY (void (*)(int32_t status), \
Hiroshi Yamauchi249b4d12016-05-11 19:27:44 -0700139 HookExit, _exit)
Igor Murashkinaaebaa02015-01-26 10:55:53 -0800140 // We don't call abort(3) by default; see
141 // Runtime::Abort.
142RUNTIME_OPTIONS_KEY (void (*)(), HookAbort, nullptr)
Igor Murashkinaaebaa02015-01-26 10:55:53 -0800143
144#undef RUNTIME_OPTIONS_KEY