blob: d4e64b86e5ee09ba633a8f199dd9de69f16d79d0 [file] [log] [blame]
Brian Carlstrom491ca9e2014-03-02 18:24:38 -08001/*
2 * Copyright (C) 2011 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#include "parsed_options.h"
Dave Allisonb373e092014-02-20 16:06:36 -080018#ifdef HAVE_ANDROID_OS
19#include "cutils/properties.h"
20#endif
Brian Carlstrom491ca9e2014-03-02 18:24:38 -080021
22#include "debugger.h"
23#include "monitor.h"
24
25namespace art {
26
27ParsedOptions* ParsedOptions::Create(const Runtime::Options& options, bool ignore_unrecognized) {
28 UniquePtr<ParsedOptions> parsed(new ParsedOptions());
29 if (parsed->Parse(options, ignore_unrecognized)) {
30 return parsed.release();
31 }
32 return nullptr;
33}
34
35// Parse a string of the form /[0-9]+[kKmMgG]?/, which is used to specify
36// memory sizes. [kK] indicates kilobytes, [mM] megabytes, and
37// [gG] gigabytes.
38//
39// "s" should point just past the "-Xm?" part of the string.
40// "div" specifies a divisor, e.g. 1024 if the value must be a multiple
41// of 1024.
42//
43// The spec says the -Xmx and -Xms options must be multiples of 1024. It
44// doesn't say anything about -Xss.
45//
46// Returns 0 (a useless size) if "s" is malformed or specifies a low or
47// non-evenly-divisible value.
48//
49size_t ParseMemoryOption(const char* s, size_t div) {
50 // strtoul accepts a leading [+-], which we don't want,
51 // so make sure our string starts with a decimal digit.
52 if (isdigit(*s)) {
53 char* s2;
54 size_t val = strtoul(s, &s2, 10);
55 if (s2 != s) {
56 // s2 should be pointing just after the number.
57 // If this is the end of the string, the user
58 // has specified a number of bytes. Otherwise,
59 // there should be exactly one more character
60 // that specifies a multiplier.
61 if (*s2 != '\0') {
62 // The remainder of the string is either a single multiplier
63 // character, or nothing to indicate that the value is in
64 // bytes.
65 char c = *s2++;
66 if (*s2 == '\0') {
67 size_t mul;
68 if (c == '\0') {
69 mul = 1;
70 } else if (c == 'k' || c == 'K') {
71 mul = KB;
72 } else if (c == 'm' || c == 'M') {
73 mul = MB;
74 } else if (c == 'g' || c == 'G') {
75 mul = GB;
76 } else {
77 // Unknown multiplier character.
78 return 0;
79 }
80
81 if (val <= std::numeric_limits<size_t>::max() / mul) {
82 val *= mul;
83 } else {
84 // Clamp to a multiple of 1024.
85 val = std::numeric_limits<size_t>::max() & ~(1024-1);
86 }
87 } else {
88 // There's more than one character after the numeric part.
89 return 0;
90 }
91 }
92 // The man page says that a -Xm value must be a multiple of 1024.
93 if (val % div == 0) {
94 return val;
95 }
96 }
97 }
98 return 0;
99}
100
101static gc::CollectorType ParseCollectorType(const std::string& option) {
102 if (option == "MS" || option == "nonconcurrent") {
103 return gc::kCollectorTypeMS;
104 } else if (option == "CMS" || option == "concurrent") {
105 return gc::kCollectorTypeCMS;
106 } else if (option == "SS") {
107 return gc::kCollectorTypeSS;
108 } else if (option == "GSS") {
109 return gc::kCollectorTypeGSS;
Hiroshi Yamauchid5307ec2014-03-27 21:07:51 -0700110 } else if (option == "CC") {
111 return gc::kCollectorTypeCC;
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800112 } else {
113 return gc::kCollectorTypeNone;
114 }
115}
116
117bool ParsedOptions::Parse(const Runtime::Options& options, bool ignore_unrecognized) {
118 const char* boot_class_path_string = getenv("BOOTCLASSPATH");
119 if (boot_class_path_string != NULL) {
120 boot_class_path_string_ = boot_class_path_string;
121 }
122 const char* class_path_string = getenv("CLASSPATH");
123 if (class_path_string != NULL) {
124 class_path_string_ = class_path_string;
125 }
126 // -Xcheck:jni is off by default for regular builds but on by default in debug builds.
127 check_jni_ = kIsDebugBuild;
128
129 heap_initial_size_ = gc::Heap::kDefaultInitialSize;
130 heap_maximum_size_ = gc::Heap::kDefaultMaximumSize;
131 heap_min_free_ = gc::Heap::kDefaultMinFree;
132 heap_max_free_ = gc::Heap::kDefaultMaxFree;
133 heap_target_utilization_ = gc::Heap::kDefaultTargetUtilization;
Mathieu Chartier2f8da3e2014-04-15 15:37:02 -0700134 foreground_heap_growth_multiplier_ = gc::Heap::kDefaultHeapGrowthMultiplier;
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800135 heap_growth_limit_ = 0; // 0 means no growth limit .
136 // Default to number of processors minus one since the main GC thread also does work.
137 parallel_gc_threads_ = sysconf(_SC_NPROCESSORS_CONF) - 1;
138 // Only the main GC thread, no workers.
139 conc_gc_threads_ = 0;
140 // Default is CMS which is Sticky + Partial + Full CMS GC.
141 collector_type_ = gc::kCollectorTypeCMS;
142 // If background_collector_type_ is kCollectorTypeNone, it defaults to the collector_type_ after
143 // parsing options.
144 background_collector_type_ = gc::kCollectorTypeNone;
145 stack_size_ = 0; // 0 means default.
146 max_spins_before_thin_lock_inflation_ = Monitor::kDefaultMaxSpinsBeforeThinLockInflation;
147 low_memory_mode_ = false;
148 use_tlab_ = false;
149 verify_pre_gc_heap_ = false;
150 verify_post_gc_heap_ = kIsDebugBuild;
151 verify_pre_gc_rosalloc_ = kIsDebugBuild;
152 verify_post_gc_rosalloc_ = false;
153
154 compiler_callbacks_ = nullptr;
155 is_zygote_ = false;
Hiroshi Yamauchie63a7452014-02-27 14:44:36 -0800156 if (kPoisonHeapReferences) {
157 // kPoisonHeapReferences currently works only with the interpreter only.
158 // TODO: make it work with the compiler.
159 interpreter_only_ = true;
160 } else {
161 interpreter_only_ = false;
162 }
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800163 is_explicit_gc_disabled_ = false;
164
165 long_pause_log_threshold_ = gc::Heap::kDefaultLongPauseLogThreshold;
166 long_gc_log_threshold_ = gc::Heap::kDefaultLongGCLogThreshold;
167 dump_gc_performance_on_shutdown_ = false;
168 ignore_max_footprint_ = false;
169
170 lock_profiling_threshold_ = 0;
171 hook_is_sensitive_thread_ = NULL;
172
173 hook_vfprintf_ = vfprintf;
174 hook_exit_ = exit;
175 hook_abort_ = NULL; // We don't call abort(3) by default; see Runtime::Abort.
176
177// gLogVerbosity.class_linker = true; // TODO: don't check this in!
178// gLogVerbosity.compiler = true; // TODO: don't check this in!
179// gLogVerbosity.verifier = true; // TODO: don't check this in!
180// gLogVerbosity.heap = true; // TODO: don't check this in!
181// gLogVerbosity.gc = true; // TODO: don't check this in!
182// gLogVerbosity.jdwp = true; // TODO: don't check this in!
183// gLogVerbosity.jni = true; // TODO: don't check this in!
184// gLogVerbosity.monitor = true; // TODO: don't check this in!
185// gLogVerbosity.startup = true; // TODO: don't check this in!
186// gLogVerbosity.third_party_jni = true; // TODO: don't check this in!
187// gLogVerbosity.threads = true; // TODO: don't check this in!
188
189 method_trace_ = false;
190 method_trace_file_ = "/data/method-trace-file.bin";
191 method_trace_file_size_ = 10 * MB;
192
193 profile_ = false;
194 profile_period_s_ = 10; // Seconds.
195 profile_duration_s_ = 20; // Seconds.
196 profile_interval_us_ = 500; // Microseconds.
197 profile_backoff_coefficient_ = 2.0;
Calin Juravle16590062014-04-07 18:07:43 +0300198 profile_start_immediately_ = true;
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800199 profile_clock_source_ = kDefaultProfilerClockSource;
200
Jeff Hao4a200f52014-04-01 14:58:49 -0700201 verify_ = true;
202
Dave Allisonb373e092014-02-20 16:06:36 -0800203 // Default to explicit checks. Switch off with -implicit-checks:.
204 // or setprop dalvik.vm.implicit_checks check1,check2,...
205#ifdef HAVE_ANDROID_OS
206 {
207 char buf[PROP_VALUE_MAX];
208 property_get("dalvik.vm.implicit_checks", buf, "none");
209 std::string checks(buf);
210 std::vector<std::string> checkvec;
211 Split(checks, ',', checkvec);
Dave Allisondd2e8252014-03-20 14:45:17 -0700212 explicit_checks_ = kExplicitNullCheck | kExplicitSuspendCheck |
213 kExplicitStackOverflowCheck;
Dave Allisonb373e092014-02-20 16:06:36 -0800214 for (auto& str : checkvec) {
215 std::string val = Trim(str);
216 if (val == "none") {
217 explicit_checks_ = kExplicitNullCheck | kExplicitSuspendCheck |
Dave Allisondd2e8252014-03-20 14:45:17 -0700218 kExplicitStackOverflowCheck;
Dave Allisonb373e092014-02-20 16:06:36 -0800219 } else if (val == "null") {
220 explicit_checks_ &= ~kExplicitNullCheck;
221 } else if (val == "suspend") {
222 explicit_checks_ &= ~kExplicitSuspendCheck;
223 } else if (val == "stack") {
224 explicit_checks_ &= ~kExplicitStackOverflowCheck;
225 } else if (val == "all") {
226 explicit_checks_ = 0;
227 }
228 }
229 }
230#else
231 explicit_checks_ = kExplicitNullCheck | kExplicitSuspendCheck |
232 kExplicitStackOverflowCheck;
233#endif
234
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800235 for (size_t i = 0; i < options.size(); ++i) {
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800236 if (true && options[0].first == "-Xzygote") {
Brian Carlstrom2ec65202014-03-03 15:16:37 -0800237 LOG(INFO) << "option[" << i << "]=" << options[i].first;
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800238 }
Brian Carlstrom2ec65202014-03-03 15:16:37 -0800239 }
240 for (size_t i = 0; i < options.size(); ++i) {
241 const std::string option(options[i].first);
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800242 if (StartsWith(option, "-help")) {
243 Usage(nullptr);
244 return false;
245 } else if (StartsWith(option, "-showversion")) {
246 UsageMessage(stdout, "ART version %s\n", Runtime::GetVersion());
247 Exit(0);
248 } else if (StartsWith(option, "-Xbootclasspath:")) {
249 boot_class_path_string_ = option.substr(strlen("-Xbootclasspath:")).data();
250 } else if (option == "-classpath" || option == "-cp") {
251 // TODO: support -Djava.class.path
252 i++;
253 if (i == options.size()) {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700254 Usage("Missing required class path value for %s\n", option.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800255 return false;
256 }
257 const StringPiece& value = options[i].first;
258 class_path_string_ = value.data();
259 } else if (option == "bootclasspath") {
260 boot_class_path_
261 = reinterpret_cast<const std::vector<const DexFile*>*>(options[i].second);
262 } else if (StartsWith(option, "-Ximage:")) {
263 if (!ParseStringAfterChar(option, ':', &image_)) {
264 return false;
265 }
266 } else if (StartsWith(option, "-Xcheck:jni")) {
267 check_jni_ = true;
268 } else if (StartsWith(option, "-Xrunjdwp:") || StartsWith(option, "-agentlib:jdwp=")) {
269 std::string tail(option.substr(option[1] == 'X' ? 10 : 15));
270 // TODO: move parsing logic out of Dbg
271 if (tail == "help" || !Dbg::ParseJdwpOptions(tail)) {
272 if (tail != "help") {
273 UsageMessage(stderr, "Failed to parse JDWP option %s\n", tail.c_str());
274 }
275 Usage("Example: -Xrunjdwp:transport=dt_socket,address=8000,server=y\n"
276 "Example: -Xrunjdwp:transport=dt_socket,address=localhost:6500,server=n\n");
277 return false;
278 }
279 } else if (StartsWith(option, "-Xms")) {
280 size_t size = ParseMemoryOption(option.substr(strlen("-Xms")).c_str(), 1024);
281 if (size == 0) {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700282 Usage("Failed to parse memory option %s\n", option.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800283 return false;
284 }
285 heap_initial_size_ = size;
286 } else if (StartsWith(option, "-Xmx")) {
287 size_t size = ParseMemoryOption(option.substr(strlen("-Xmx")).c_str(), 1024);
288 if (size == 0) {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700289 Usage("Failed to parse memory option %s\n", option.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800290 return false;
291 }
292 heap_maximum_size_ = size;
293 } else if (StartsWith(option, "-XX:HeapGrowthLimit=")) {
294 size_t size = ParseMemoryOption(option.substr(strlen("-XX:HeapGrowthLimit=")).c_str(), 1024);
295 if (size == 0) {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700296 Usage("Failed to parse memory option %s\n", option.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800297 return false;
298 }
299 heap_growth_limit_ = size;
300 } else if (StartsWith(option, "-XX:HeapMinFree=")) {
301 size_t size = ParseMemoryOption(option.substr(strlen("-XX:HeapMinFree=")).c_str(), 1024);
302 if (size == 0) {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700303 Usage("Failed to parse memory option %s\n", option.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800304 return false;
305 }
306 heap_min_free_ = size;
307 } else if (StartsWith(option, "-XX:HeapMaxFree=")) {
308 size_t size = ParseMemoryOption(option.substr(strlen("-XX:HeapMaxFree=")).c_str(), 1024);
309 if (size == 0) {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700310 Usage("Failed to parse memory option %s\n", option.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800311 return false;
312 }
313 heap_max_free_ = size;
314 } else if (StartsWith(option, "-XX:HeapTargetUtilization=")) {
315 if (!ParseDouble(option, '=', 0.1, 0.9, &heap_target_utilization_)) {
316 return false;
317 }
Mathieu Chartier2f8da3e2014-04-15 15:37:02 -0700318 } else if (StartsWith(option, "-XX:ForegroundHeapGrowthMultiplier=")) {
Mathieu Chartier455820e2014-04-18 12:02:39 -0700319 if (!ParseDouble(option, '=', 0.1, 10.0, &foreground_heap_growth_multiplier_)) {
Mathieu Chartier2f8da3e2014-04-15 15:37:02 -0700320 return false;
321 }
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800322 } else if (StartsWith(option, "-XX:ParallelGCThreads=")) {
323 if (!ParseUnsignedInteger(option, '=', &parallel_gc_threads_)) {
324 return false;
325 }
326 } else if (StartsWith(option, "-XX:ConcGCThreads=")) {
327 if (!ParseUnsignedInteger(option, '=', &conc_gc_threads_)) {
328 return false;
329 }
330 } else if (StartsWith(option, "-Xss")) {
331 size_t size = ParseMemoryOption(option.substr(strlen("-Xss")).c_str(), 1);
332 if (size == 0) {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700333 Usage("Failed to parse memory option %s\n", option.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800334 return false;
335 }
336 stack_size_ = size;
337 } else if (StartsWith(option, "-XX:MaxSpinsBeforeThinLockInflation=")) {
338 if (!ParseUnsignedInteger(option, '=', &max_spins_before_thin_lock_inflation_)) {
339 return false;
340 }
341 } else if (StartsWith(option, "-XX:LongPauseLogThreshold=")) {
Andreas Gampe39d92182014-03-05 16:46:44 -0800342 unsigned int value;
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800343 if (!ParseUnsignedInteger(option, '=', &value)) {
344 return false;
345 }
346 long_pause_log_threshold_ = MsToNs(value);
347 } else if (StartsWith(option, "-XX:LongGCLogThreshold=")) {
Andreas Gampe39d92182014-03-05 16:46:44 -0800348 unsigned int value;
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800349 if (!ParseUnsignedInteger(option, '=', &value)) {
350 return false;
351 }
352 long_gc_log_threshold_ = MsToNs(value);
353 } else if (option == "-XX:DumpGCPerformanceOnShutdown") {
354 dump_gc_performance_on_shutdown_ = true;
355 } else if (option == "-XX:IgnoreMaxFootprint") {
356 ignore_max_footprint_ = true;
357 } else if (option == "-XX:LowMemoryMode") {
358 low_memory_mode_ = true;
359 } else if (option == "-XX:UseTLAB") {
360 use_tlab_ = true;
361 } else if (StartsWith(option, "-D")) {
362 properties_.push_back(option.substr(strlen("-D")));
363 } else if (StartsWith(option, "-Xjnitrace:")) {
364 jni_trace_ = option.substr(strlen("-Xjnitrace:"));
365 } else if (option == "compilercallbacks") {
366 compiler_callbacks_ =
367 reinterpret_cast<CompilerCallbacks*>(const_cast<void*>(options[i].second));
368 } else if (option == "-Xzygote") {
369 is_zygote_ = true;
370 } else if (option == "-Xint") {
371 interpreter_only_ = true;
372 } else if (StartsWith(option, "-Xgc:")) {
373 std::vector<std::string> gc_options;
374 Split(option.substr(strlen("-Xgc:")), ',', gc_options);
375 for (const std::string& gc_option : gc_options) {
376 gc::CollectorType collector_type = ParseCollectorType(gc_option);
377 if (collector_type != gc::kCollectorTypeNone) {
378 collector_type_ = collector_type;
379 } else if (gc_option == "preverify") {
380 verify_pre_gc_heap_ = true;
381 } else if (gc_option == "nopreverify") {
382 verify_pre_gc_heap_ = false;
383 } else if (gc_option == "postverify") {
384 verify_post_gc_heap_ = true;
385 } else if (gc_option == "nopostverify") {
386 verify_post_gc_heap_ = false;
387 } else if (gc_option == "preverify_rosalloc") {
388 verify_pre_gc_rosalloc_ = true;
389 } else if (gc_option == "nopreverify_rosalloc") {
390 verify_pre_gc_rosalloc_ = false;
391 } else if (gc_option == "postverify_rosalloc") {
392 verify_post_gc_rosalloc_ = true;
393 } else if (gc_option == "nopostverify_rosalloc") {
394 verify_post_gc_rosalloc_ = false;
395 } else if ((gc_option == "precise") ||
396 (gc_option == "noprecise") ||
397 (gc_option == "verifycardtable") ||
398 (gc_option == "noverifycardtable")) {
399 // Ignored for backwards compatibility.
400 } else {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700401 Usage("Unknown -Xgc option %s\n", gc_option.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800402 return false;
403 }
404 }
405 } else if (StartsWith(option, "-XX:BackgroundGC=")) {
406 std::string substring;
407 if (!ParseStringAfterChar(option, '=', &substring)) {
408 return false;
409 }
410 gc::CollectorType collector_type = ParseCollectorType(substring);
411 if (collector_type != gc::kCollectorTypeNone) {
412 background_collector_type_ = collector_type;
413 } else {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700414 Usage("Unknown -XX:BackgroundGC option %s\n", substring.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800415 return false;
416 }
417 } else if (option == "-XX:+DisableExplicitGC") {
418 is_explicit_gc_disabled_ = true;
419 } else if (StartsWith(option, "-verbose:")) {
420 std::vector<std::string> verbose_options;
421 Split(option.substr(strlen("-verbose:")), ',', verbose_options);
422 for (size_t i = 0; i < verbose_options.size(); ++i) {
423 if (verbose_options[i] == "class") {
424 gLogVerbosity.class_linker = true;
425 } else if (verbose_options[i] == "verifier") {
426 gLogVerbosity.verifier = true;
427 } else if (verbose_options[i] == "compiler") {
428 gLogVerbosity.compiler = true;
429 } else if (verbose_options[i] == "heap") {
430 gLogVerbosity.heap = true;
431 } else if (verbose_options[i] == "gc") {
432 gLogVerbosity.gc = true;
433 } else if (verbose_options[i] == "jdwp") {
434 gLogVerbosity.jdwp = true;
435 } else if (verbose_options[i] == "jni") {
436 gLogVerbosity.jni = true;
437 } else if (verbose_options[i] == "monitor") {
438 gLogVerbosity.monitor = true;
439 } else if (verbose_options[i] == "startup") {
440 gLogVerbosity.startup = true;
441 } else if (verbose_options[i] == "third-party-jni") {
442 gLogVerbosity.third_party_jni = true;
443 } else if (verbose_options[i] == "threads") {
444 gLogVerbosity.threads = true;
445 } else {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700446 Usage("Unknown -verbose option %s\n", verbose_options[i].c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800447 return false;
448 }
449 }
450 } else if (StartsWith(option, "-Xlockprofthreshold:")) {
451 if (!ParseUnsignedInteger(option, ':', &lock_profiling_threshold_)) {
452 return false;
453 }
454 } else if (StartsWith(option, "-Xstacktracefile:")) {
455 if (!ParseStringAfterChar(option, ':', &stack_trace_file_)) {
456 return false;
457 }
458 } else if (option == "sensitiveThread") {
459 const void* hook = options[i].second;
460 hook_is_sensitive_thread_ = reinterpret_cast<bool (*)()>(const_cast<void*>(hook));
461 } else if (option == "vfprintf") {
462 const void* hook = options[i].second;
463 if (hook == nullptr) {
464 Usage("vfprintf argument was NULL");
465 return false;
466 }
467 hook_vfprintf_ =
468 reinterpret_cast<int (*)(FILE *, const char*, va_list)>(const_cast<void*>(hook));
469 } else if (option == "exit") {
470 const void* hook = options[i].second;
471 if (hook == nullptr) {
472 Usage("exit argument was NULL");
473 return false;
474 }
475 hook_exit_ = reinterpret_cast<void(*)(jint)>(const_cast<void*>(hook));
476 } else if (option == "abort") {
477 const void* hook = options[i].second;
478 if (hook == nullptr) {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700479 Usage("abort was NULL\n");
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800480 return false;
481 }
482 hook_abort_ = reinterpret_cast<void(*)()>(const_cast<void*>(hook));
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800483 } else if (option == "-Xmethod-trace") {
484 method_trace_ = true;
485 } else if (StartsWith(option, "-Xmethod-trace-file:")) {
486 method_trace_file_ = option.substr(strlen("-Xmethod-trace-file:"));
487 } else if (StartsWith(option, "-Xmethod-trace-file-size:")) {
488 if (!ParseUnsignedInteger(option, ':', &method_trace_file_size_)) {
489 return false;
490 }
491 } else if (option == "-Xprofile:threadcpuclock") {
492 Trace::SetDefaultClockSource(kProfilerClockSourceThreadCpu);
493 } else if (option == "-Xprofile:wallclock") {
494 Trace::SetDefaultClockSource(kProfilerClockSourceWall);
495 } else if (option == "-Xprofile:dualclock") {
496 Trace::SetDefaultClockSource(kProfilerClockSourceDual);
497 } else if (StartsWith(option, "-Xprofile:")) {
498 if (!ParseStringAfterChar(option, ';', &profile_output_filename_)) {
499 return false;
500 }
501 profile_ = true;
502 } else if (StartsWith(option, "-Xprofile-period:")) {
503 if (!ParseUnsignedInteger(option, ':', &profile_period_s_)) {
504 return false;
505 }
506 } else if (StartsWith(option, "-Xprofile-duration:")) {
507 if (!ParseUnsignedInteger(option, ':', &profile_duration_s_)) {
508 return false;
509 }
510 } else if (StartsWith(option, "-Xprofile-interval:")) {
511 if (!ParseUnsignedInteger(option, ':', &profile_interval_us_)) {
512 return false;
513 }
514 } else if (StartsWith(option, "-Xprofile-backoff:")) {
515 if (!ParseDouble(option, ':', 1.0, 10.0, &profile_backoff_coefficient_)) {
516 return false;
517 }
Calin Juravle16590062014-04-07 18:07:43 +0300518 } else if (option == "-Xprofile-start-lazy") {
519 profile_start_immediately_ = false;
Dave Allisonb373e092014-02-20 16:06:36 -0800520 } else if (StartsWith(option, "-implicit-checks:")) {
521 std::string checks;
522 if (!ParseStringAfterChar(option, ':', &checks)) {
523 return false;
524 }
525 std::vector<std::string> checkvec;
526 Split(checks, ',', checkvec);
527 for (auto& str : checkvec) {
528 std::string val = Trim(str);
529 if (val == "none") {
530 explicit_checks_ = kExplicitNullCheck | kExplicitSuspendCheck |
531 kExplicitStackOverflowCheck;
532 } else if (val == "null") {
533 explicit_checks_ &= ~kExplicitNullCheck;
534 } else if (val == "suspend") {
535 explicit_checks_ &= ~kExplicitSuspendCheck;
536 } else if (val == "stack") {
537 explicit_checks_ &= ~kExplicitStackOverflowCheck;
538 } else if (val == "all") {
539 explicit_checks_ = 0;
540 } else {
541 return false;
542 }
543 }
544 } else if (StartsWith(option, "-explicit-checks:")) {
545 std::string checks;
546 if (!ParseStringAfterChar(option, ':', &checks)) {
547 return false;
548 }
549 std::vector<std::string> checkvec;
550 Split(checks, ',', checkvec);
551 for (auto& str : checkvec) {
552 std::string val = Trim(str);
553 if (val == "none") {
554 explicit_checks_ = 0;
555 } else if (val == "null") {
556 explicit_checks_ |= kExplicitNullCheck;
557 } else if (val == "suspend") {
558 explicit_checks_ |= kExplicitSuspendCheck;
559 } else if (val == "stack") {
560 explicit_checks_ |= kExplicitStackOverflowCheck;
561 } else if (val == "all") {
562 explicit_checks_ = kExplicitNullCheck | kExplicitSuspendCheck |
563 kExplicitStackOverflowCheck;
564 } else {
565 return false;
566 }
567 }
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800568 } else if (option == "-Xcompiler-option") {
569 i++;
570 if (i == options.size()) {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700571 Usage("Missing required compiler option for %s\n", option.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800572 return false;
573 }
574 compiler_options_.push_back(options[i].first);
575 } else if (option == "-Ximage-compiler-option") {
576 i++;
577 if (i == options.size()) {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700578 Usage("Missing required compiler option for %s\n", option.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800579 return false;
580 }
581 image_compiler_options_.push_back(options[i].first);
Jeff Hao4a200f52014-04-01 14:58:49 -0700582 } else if (StartsWith(option, "-Xverify:")) {
583 std::string verify_mode = option.substr(strlen("-Xverify:"));
584 if (verify_mode == "none") {
585 verify_ = false;
586 } else if (verify_mode == "remote" || verify_mode == "all") {
587 verify_ = true;
588 } else {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700589 Usage("Unknown -Xverify option %s\n", verify_mode.c_str());
Jeff Hao4a200f52014-04-01 14:58:49 -0700590 return false;
591 }
Yevgeny Roubana6119a22014-03-24 11:31:24 +0700592 } else if (StartsWith(option, "-ea") ||
593 StartsWith(option, "-da") ||
594 StartsWith(option, "-enableassertions") ||
595 StartsWith(option, "-disableassertions") ||
Dave Allisonb373e092014-02-20 16:06:36 -0800596 (option == "--runtime-arg") ||
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800597 (option == "-esa") ||
598 (option == "-dsa") ||
599 (option == "-enablesystemassertions") ||
600 (option == "-disablesystemassertions") ||
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800601 (option == "-Xrs") ||
602 StartsWith(option, "-Xint:") ||
603 StartsWith(option, "-Xdexopt:") ||
604 (option == "-Xnoquithandler") ||
605 StartsWith(option, "-Xjniopts:") ||
606 StartsWith(option, "-Xjnigreflimit:") ||
607 (option == "-Xgenregmap") ||
608 (option == "-Xnogenregmap") ||
609 StartsWith(option, "-Xverifyopt:") ||
610 (option == "-Xcheckdexsum") ||
611 (option == "-Xincludeselectedop") ||
612 StartsWith(option, "-Xjitop:") ||
613 (option == "-Xincludeselectedmethod") ||
614 StartsWith(option, "-Xjitthreshold:") ||
615 StartsWith(option, "-Xjitcodecachesize:") ||
616 (option == "-Xjitblocking") ||
617 StartsWith(option, "-Xjitmethod:") ||
618 StartsWith(option, "-Xjitclass:") ||
619 StartsWith(option, "-Xjitoffset:") ||
620 StartsWith(option, "-Xjitconfig:") ||
621 (option == "-Xjitcheckcg") ||
622 (option == "-Xjitverbose") ||
623 (option == "-Xjitprofile") ||
624 (option == "-Xjitdisableopt") ||
625 (option == "-Xjitsuspendpoll") ||
626 StartsWith(option, "-XX:mainThreadStackSize=")) {
627 // Ignored for backwards compatibility.
628 } else if (!ignore_unrecognized) {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700629 Usage("Unrecognized option %s\n", option.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800630 return false;
631 }
632 }
633
634 // If a reference to the dalvik core.jar snuck in, replace it with
635 // the art specific version. This can happen with on device
636 // boot.art/boot.oat generation by GenerateImage which relies on the
637 // value of BOOTCLASSPATH.
638 std::string core_jar("/core.jar");
639 size_t core_jar_pos = boot_class_path_string_.find(core_jar);
640 if (core_jar_pos != std::string::npos) {
641 boot_class_path_string_.replace(core_jar_pos, core_jar.size(), "/core-libart.jar");
642 }
643
644 if (compiler_callbacks_ == nullptr && image_.empty()) {
645 image_ += GetAndroidRoot();
646 image_ += "/framework/boot.art";
647 }
648 if (heap_growth_limit_ == 0) {
649 heap_growth_limit_ = heap_maximum_size_;
650 }
651 if (background_collector_type_ == gc::kCollectorTypeNone) {
652 background_collector_type_ = collector_type_;
653 }
654 return true;
655}
656
657void ParsedOptions::Exit(int status) {
658 hook_exit_(status);
659}
660
661void ParsedOptions::Abort() {
662 hook_abort_();
663}
664
665void ParsedOptions::UsageMessageV(FILE* stream, const char* fmt, va_list ap) {
666 hook_vfprintf_(stderr, fmt, ap);
667}
668
669void ParsedOptions::UsageMessage(FILE* stream, const char* fmt, ...) {
670 va_list ap;
671 va_start(ap, fmt);
672 UsageMessageV(stream, fmt, ap);
673 va_end(ap);
674}
675
676void ParsedOptions::Usage(const char* fmt, ...) {
677 bool error = (fmt != nullptr);
678 FILE* stream = error ? stderr : stdout;
679
680 if (fmt != nullptr) {
681 va_list ap;
682 va_start(ap, fmt);
683 UsageMessageV(stream, fmt, ap);
684 va_end(ap);
685 }
686
687 const char* program = "dalvikvm";
688 UsageMessage(stream, "%s: [options] class [argument ...]\n", program);
689 UsageMessage(stream, "\n");
690 UsageMessage(stream, "The following standard options are supported:\n");
691 UsageMessage(stream, " -classpath classpath (-cp classpath)\n");
692 UsageMessage(stream, " -Dproperty=value\n");
693 UsageMessage(stream, " -verbose:tag ('gc', 'jni', or 'class')\n");
694 UsageMessage(stream, " -showversion\n");
695 UsageMessage(stream, " -help\n");
696 UsageMessage(stream, " -agentlib:jdwp=options\n");
697 UsageMessage(stream, "\n");
698
699 UsageMessage(stream, "The following extended options are supported:\n");
700 UsageMessage(stream, " -Xrunjdwp:<options>\n");
701 UsageMessage(stream, " -Xbootclasspath:bootclasspath\n");
702 UsageMessage(stream, " -Xcheck:tag (e.g. 'jni')\n");
703 UsageMessage(stream, " -XmsN (min heap, must be multiple of 1K, >= 1MB)\n");
704 UsageMessage(stream, " -XmxN (max heap, must be multiple of 1K, >= 2MB)\n");
705 UsageMessage(stream, " -XssN (stack size)\n");
706 UsageMessage(stream, " -Xint\n");
707 UsageMessage(stream, "\n");
708
709 UsageMessage(stream, "The following Dalvik options are supported:\n");
710 UsageMessage(stream, " -Xzygote\n");
711 UsageMessage(stream, " -Xjnitrace:substring (eg NativeClass or nativeMethod)\n");
712 UsageMessage(stream, " -Xstacktracefile:<filename>\n");
713 UsageMessage(stream, " -Xgc:[no]preverify\n");
714 UsageMessage(stream, " -Xgc:[no]postverify\n");
715 UsageMessage(stream, " -XX:+DisableExplicitGC\n");
716 UsageMessage(stream, " -XX:HeapGrowthLimit=N\n");
717 UsageMessage(stream, " -XX:HeapMinFree=N\n");
718 UsageMessage(stream, " -XX:HeapMaxFree=N\n");
719 UsageMessage(stream, " -XX:HeapTargetUtilization=doublevalue\n");
Mathieu Chartier455820e2014-04-18 12:02:39 -0700720 UsageMessage(stream, " -XX:ForegroundHeapGrowthMultiplier=doublevalue\n");
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800721 UsageMessage(stream, " -XX:LowMemoryMode\n");
722 UsageMessage(stream, " -Xprofile:{threadcpuclock,wallclock,dualclock}\n");
723 UsageMessage(stream, "\n");
724
725 UsageMessage(stream, "The following unique to ART options are supported:\n");
726 UsageMessage(stream, " -Xgc:[no]preverify_rosalloc\n");
727 UsageMessage(stream, " -Xgc:[no]postverify_rosalloc\n");
728 UsageMessage(stream, " -Ximage:filename\n");
729 UsageMessage(stream, " -XX:ParallelGCThreads=integervalue\n");
730 UsageMessage(stream, " -XX:ConcGCThreads=integervalue\n");
731 UsageMessage(stream, " -XX:MaxSpinsBeforeThinLockInflation=integervalue\n");
732 UsageMessage(stream, " -XX:LongPauseLogThreshold=integervalue\n");
733 UsageMessage(stream, " -XX:LongGCLogThreshold=integervalue\n");
734 UsageMessage(stream, " -XX:DumpGCPerformanceOnShutdown\n");
735 UsageMessage(stream, " -XX:IgnoreMaxFootprint\n");
736 UsageMessage(stream, " -XX:UseTLAB\n");
737 UsageMessage(stream, " -XX:BackgroundGC=none\n");
738 UsageMessage(stream, " -Xmethod-trace\n");
739 UsageMessage(stream, " -Xmethod-trace-file:filename");
740 UsageMessage(stream, " -Xmethod-trace-file-size:integervalue\n");
741 UsageMessage(stream, " -Xprofile=filename\n");
742 UsageMessage(stream, " -Xprofile-period:integervalue\n");
743 UsageMessage(stream, " -Xprofile-duration:integervalue\n");
744 UsageMessage(stream, " -Xprofile-interval:integervalue\n");
745 UsageMessage(stream, " -Xprofile-backoff:integervalue\n");
746 UsageMessage(stream, " -Xcompiler-option dex2oat-option\n");
747 UsageMessage(stream, " -Ximage-compiler-option dex2oat-option\n");
748 UsageMessage(stream, "\n");
749
750 UsageMessage(stream, "The following previously supported Dalvik options are ignored:\n");
751 UsageMessage(stream, " -ea[:<package name>... |:<class name>]\n");
752 UsageMessage(stream, " -da[:<package name>... |:<class name>]\n");
753 UsageMessage(stream, " (-enableassertions, -disableassertions)\n");
754 UsageMessage(stream, " -esa\n");
755 UsageMessage(stream, " -dsa\n");
756 UsageMessage(stream, " (-enablesystemassertions, -disablesystemassertions)\n");
757 UsageMessage(stream, " -Xverify:{none,remote,all}\n");
758 UsageMessage(stream, " -Xrs\n");
759 UsageMessage(stream, " -Xint:portable, -Xint:fast, -Xint:jit\n");
760 UsageMessage(stream, " -Xdexopt:{none,verified,all,full}\n");
761 UsageMessage(stream, " -Xnoquithandler\n");
762 UsageMessage(stream, " -Xjniopts:{warnonly,forcecopy}\n");
763 UsageMessage(stream, " -Xjnigreflimit:integervalue\n");
764 UsageMessage(stream, " -Xgc:[no]precise\n");
765 UsageMessage(stream, " -Xgc:[no]verifycardtable\n");
766 UsageMessage(stream, " -X[no]genregmap\n");
767 UsageMessage(stream, " -Xverifyopt:[no]checkmon\n");
768 UsageMessage(stream, " -Xcheckdexsum\n");
769 UsageMessage(stream, " -Xincludeselectedop\n");
770 UsageMessage(stream, " -Xjitop:hexopvalue[-endvalue][,hexopvalue[-endvalue]]*\n");
771 UsageMessage(stream, " -Xincludeselectedmethod\n");
772 UsageMessage(stream, " -Xjitthreshold:integervalue\n");
773 UsageMessage(stream, " -Xjitcodecachesize:decimalvalueofkbytes\n");
774 UsageMessage(stream, " -Xjitblocking\n");
775 UsageMessage(stream, " -Xjitmethod:signature[,signature]* (eg Ljava/lang/String\\;replace)\n");
776 UsageMessage(stream, " -Xjitclass:classname[,classname]*\n");
777 UsageMessage(stream, " -Xjitoffset:offset[,offset]\n");
778 UsageMessage(stream, " -Xjitconfig:filename\n");
779 UsageMessage(stream, " -Xjitcheckcg\n");
780 UsageMessage(stream, " -Xjitverbose\n");
781 UsageMessage(stream, " -Xjitprofile\n");
782 UsageMessage(stream, " -Xjitdisableopt\n");
783 UsageMessage(stream, " -Xjitsuspendpoll\n");
784 UsageMessage(stream, " -XX:mainThreadStackSize=N\n");
785 UsageMessage(stream, "\n");
786
787 Exit((error) ? 1 : 0);
788}
789
790bool ParsedOptions::ParseStringAfterChar(const std::string& s, char c, std::string* parsed_value) {
791 std::string::size_type colon = s.find(c);
792 if (colon == std::string::npos) {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700793 Usage("Missing char %c in option %s\n", c, s.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800794 return false;
795 }
796 // Add one to remove the char we were trimming until.
797 *parsed_value = s.substr(colon + 1);
798 return true;
799}
800
801bool ParsedOptions::ParseInteger(const std::string& s, char after_char, int* parsed_value) {
802 std::string::size_type colon = s.find(after_char);
803 if (colon == std::string::npos) {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700804 Usage("Missing char %c in option %s\n", after_char, s.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800805 return false;
806 }
807 const char* begin = &s[colon + 1];
808 char* end;
809 size_t result = strtoul(begin, &end, 10);
810 if (begin == end || *end != '\0') {
Brian Carlstrom4ad33b32014-04-18 14:18:41 -0700811 Usage("Failed to parse integer from %s\n", s.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800812 return false;
813 }
814 *parsed_value = result;
815 return true;
816}
817
818bool ParsedOptions::ParseUnsignedInteger(const std::string& s, char after_char,
819 unsigned int* parsed_value) {
820 int i;
821 if (!ParseInteger(s, after_char, &i)) {
822 return false;
823 }
824 if (i < 0) {
Mathieu Chartier455820e2014-04-18 12:02:39 -0700825 Usage("Negative value %d passed for unsigned option %s\n", i, s.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800826 return false;
827 }
828 *parsed_value = i;
829 return true;
830}
831
832bool ParsedOptions::ParseDouble(const std::string& option, char after_char,
833 double min, double max, double* parsed_value) {
834 std::string substring;
835 if (!ParseStringAfterChar(option, after_char, &substring)) {
836 return false;
837 }
838 std::istringstream iss(substring);
839 double value;
840 iss >> value;
841 // Ensure that we have a value, there was no cruft after it and it satisfies a sensible range.
842 const bool sane_val = iss.eof() && (value >= min) && (value <= max);
843 if (!sane_val) {
Mathieu Chartier455820e2014-04-18 12:02:39 -0700844 Usage("Invalid double value %s for option %s\n", substring.c_str(), option.c_str());
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800845 return false;
846 }
847 *parsed_value = value;
848 return true;
849}
850
851} // namespace art