xref: /aosp_15_r20/art/cmdline/cmdline_parser_test.cc (revision 795d594fd825385562da6b089ea9b2033f3abf5a)
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 #include "cmdline_parser.h"
18 
19 #include <numeric>
20 
21 #include "gtest/gtest.h"
22 
23 #include "base/utils.h"
24 #include "jdwp_provider.h"
25 #include "experimental_flags.h"
26 #include "parsed_options.h"
27 #include "runtime.h"
28 #include "runtime_options.h"
29 
30 #define EXPECT_NULL(expected) EXPECT_EQ(reinterpret_cast<const void*>(expected), \
31                                         reinterpret_cast<void*>(nullptr));
32 
33 namespace art {
34   bool UsuallyEquals(double expected, double actual);
35 
36   // This has a gtest dependency, which is why it's in the gtest only.
operator ==(const ProfileSaverOptions & lhs,const ProfileSaverOptions & rhs)37   bool operator==(const ProfileSaverOptions& lhs, const ProfileSaverOptions& rhs) {
38     return lhs.enabled_ == rhs.enabled_ &&
39            lhs.min_save_period_ms_ == rhs.min_save_period_ms_ &&
40            lhs.min_methods_to_save_ == rhs.min_methods_to_save_ &&
41            lhs.min_classes_to_save_ == rhs.min_classes_to_save_ &&
42            lhs.min_notification_before_wake_ == rhs.min_notification_before_wake_ &&
43            lhs.max_notification_before_wake_ == rhs.max_notification_before_wake_;
44   }
45 
UsuallyEquals(double expected,double actual)46   bool UsuallyEquals(double expected, double actual) {
47     using FloatingPoint = ::testing::internal::FloatingPoint<double>;
48 
49     FloatingPoint exp(expected);
50     FloatingPoint act(actual);
51 
52     // Compare with ULPs instead of comparing with ==
53     return exp.AlmostEquals(act);
54   }
55 
56   template <typename T>
UsuallyEquals(const T & expected,const T & actual,typename std::enable_if<detail::SupportsEqualityOperator<T>::value>::type * =nullptr)57   bool UsuallyEquals(const T& expected, const T& actual,
58                      typename std::enable_if<
59                          detail::SupportsEqualityOperator<T>::value>::type* = nullptr) {
60     return expected == actual;
61   }
62 
63   template <char Separator>
UsuallyEquals(const std::vector<std::string> & expected,const ParseStringList<Separator> & actual)64   bool UsuallyEquals(const std::vector<std::string>& expected,
65                      const ParseStringList<Separator>& actual) {
66     return expected == static_cast<std::vector<std::string>>(actual);
67   }
68 
69   // Try to use memcmp to compare simple plain-old-data structs.
70   //
71   // This should *not* generate false positives, but it can generate false negatives.
72   // This will mostly work except for fields like float which can have different bit patterns
73   // that are nevertheless equal.
74   // If a test is failing because the structs aren't "equal" when they really are
75   // then it's recommended to implement operator== for it instead.
76   template <typename T, typename... Ignore>
UsuallyEquals(const T & expected,const T & actual,const Ignore &...more,typename std::enable_if<std::is_pod<T>::value>::type * =nullptr,typename std::enable_if<!detail::SupportsEqualityOperator<T>::value>::type * =nullptr)77   bool UsuallyEquals(
78       const T& expected,
79       const T& actual,
80       [[maybe_unused]] const Ignore&... more,
81       typename std::enable_if<std::is_pod<T>::value>::type* = nullptr,
82       typename std::enable_if<!detail::SupportsEqualityOperator<T>::value>::type* = nullptr) {
83     return memcmp(std::addressof(expected), std::addressof(actual), sizeof(T)) == 0;
84   }
85 
UsuallyEquals(const XGcOption & expected,const XGcOption & actual)86   bool UsuallyEquals(const XGcOption& expected, const XGcOption& actual) {
87     return memcmp(std::addressof(expected), std::addressof(actual), sizeof(expected)) == 0;
88   }
89 
UsuallyEquals(const char * expected,const std::string & actual)90   bool UsuallyEquals(const char* expected, const std::string& actual) {
91     return std::string(expected) == actual;
92   }
93 
94   template <typename TMap, typename TKey, typename T>
IsExpectedKeyValue(const T & expected,const TMap & map,const TKey & key)95   ::testing::AssertionResult IsExpectedKeyValue(const T& expected,
96                                                 const TMap& map,
97                                                 const TKey& key) {
98     auto* actual = map.Get(key);
99     if (actual != nullptr) {
100       if (!UsuallyEquals(expected, *actual)) {
101         return ::testing::AssertionFailure()
102           << "expected " << detail::ToStringAny(expected) << " but got "
103           << detail::ToStringAny(*actual);
104       }
105       return ::testing::AssertionSuccess();
106     }
107 
108     return ::testing::AssertionFailure() << "key was not in the map";
109   }
110 
111   template <typename TMap, typename TKey, typename T>
IsExpectedDefaultKeyValue(const T & expected,const TMap & map,const TKey & key)112   ::testing::AssertionResult IsExpectedDefaultKeyValue(const T& expected,
113                                                        const TMap& map,
114                                                        const TKey& key) {
115     const T& actual = map.GetOrDefault(key);
116     if (!UsuallyEquals(expected, actual)) {
117       return ::testing::AssertionFailure()
118           << "expected " << detail::ToStringAny(expected) << " but got "
119           << detail::ToStringAny(actual);
120      }
121     return ::testing::AssertionSuccess();
122   }
123 
124 class CmdlineParserTest : public ::testing::Test {
125  public:
126   CmdlineParserTest() = default;
127   ~CmdlineParserTest() = default;
128 
129  protected:
130   using M = RuntimeArgumentMap;
131   using RuntimeParser = ParsedOptions::RuntimeParser;
132 
SetUpTestCase()133   static void SetUpTestCase() {
134     art::Locks::Init();
135     art::InitLogging(nullptr, art::Runtime::Abort);  // argv = null
136   }
137 
SetUp()138   void SetUp() override {
139     parser_ = ParsedOptions::MakeParser(false);  // do not ignore unrecognized options
140   }
141 
IsResultSuccessful(const CmdlineResult & result)142   static ::testing::AssertionResult IsResultSuccessful(const CmdlineResult& result) {
143     if (result.IsSuccess()) {
144       return ::testing::AssertionSuccess();
145     } else {
146       return ::testing::AssertionFailure()
147         << result.GetStatus() << " with: " << result.GetMessage();
148     }
149   }
150 
IsResultFailure(const CmdlineResult & result,CmdlineResult::Status failure_status)151   static ::testing::AssertionResult IsResultFailure(const CmdlineResult& result,
152                                                     CmdlineResult::Status failure_status) {
153     if (result.IsSuccess()) {
154       return ::testing::AssertionFailure() << " got success but expected failure: "
155           << failure_status;
156     } else if (result.GetStatus() == failure_status) {
157       return ::testing::AssertionSuccess();
158     }
159 
160     return ::testing::AssertionFailure() << " expected failure " << failure_status
161         << " but got " << result.GetStatus();
162   }
163 
164   std::unique_ptr<RuntimeParser> parser_;
165 };
166 
167 #define EXPECT_KEY_EXISTS(map, key) EXPECT_TRUE((map).Exists(key))
168 #define EXPECT_KEY_VALUE(map, key, expected) EXPECT_TRUE(IsExpectedKeyValue(expected, map, key))
169 #define EXPECT_DEFAULT_KEY_VALUE(map, key, expected) EXPECT_TRUE(IsExpectedDefaultKeyValue(expected, map, key))
170 
171 #define _EXPECT_SINGLE_PARSE_EMPTY_SUCCESS(argv)              \
172   do {                                                        \
173     EXPECT_TRUE(IsResultSuccessful(parser_->Parse(argv)));    \
174     EXPECT_EQ(0u, parser_->GetArgumentsMap().Size());         \
175 
176 #define EXPECT_SINGLE_PARSE_EMPTY_SUCCESS(argv)               \
177   _EXPECT_SINGLE_PARSE_EMPTY_SUCCESS(argv);                   \
178   } while (false)
179 
180 #define EXPECT_SINGLE_PARSE_DEFAULT_VALUE(expected, argv, key)\
181   _EXPECT_SINGLE_PARSE_EMPTY_SUCCESS(argv);                   \
182     RuntimeArgumentMap args = parser_->ReleaseArgumentsMap(); \
183     EXPECT_DEFAULT_KEY_VALUE(args, key, expected);            \
184   } while (false)                                             // NOLINT [readability/namespace] [5]
185 
186 #define _EXPECT_SINGLE_PARSE_EXISTS(argv, key)                \
187   do {                                                        \
188     EXPECT_TRUE(IsResultSuccessful(parser_->Parse(argv)));    \
189     RuntimeArgumentMap args = parser_->ReleaseArgumentsMap(); \
190     EXPECT_EQ(1u, args.Size());                               \
191     EXPECT_KEY_EXISTS(args, key);                             \
192 
193 #define EXPECT_SINGLE_PARSE_EXISTS(argv, key)                 \
194     _EXPECT_SINGLE_PARSE_EXISTS(argv, key);                   \
195   } while (false)
196 
197 #define EXPECT_SINGLE_PARSE_VALUE(expected, argv, key)        \
198     _EXPECT_SINGLE_PARSE_EXISTS(argv, key);                   \
199     EXPECT_KEY_VALUE(args, key, expected);                    \
200   } while (false)
201 
202 #define EXPECT_SINGLE_PARSE_VALUE_STR(expected, argv, key)    \
203   EXPECT_SINGLE_PARSE_VALUE(std::string(expected), argv, key)
204 
205 #define EXPECT_SINGLE_PARSE_FAIL(argv, failure_status)         \
206     do {                                                       \
207       EXPECT_TRUE(IsResultFailure(parser_->Parse(argv), failure_status));\
208       RuntimeArgumentMap args = parser_->ReleaseArgumentsMap();\
209       EXPECT_EQ(0u, args.Size());                              \
210     } while (false)
211 
TEST_F(CmdlineParserTest,TestSimpleSuccesses)212 TEST_F(CmdlineParserTest, TestSimpleSuccesses) {
213   auto& parser = *parser_;
214 
215   EXPECT_LT(0u, parser.CountDefinedArguments());
216 
217   {
218     // Test case 1: No command line arguments
219     EXPECT_TRUE(IsResultSuccessful(parser.Parse("")));
220     RuntimeArgumentMap args = parser.ReleaseArgumentsMap();
221     EXPECT_EQ(0u, args.Size());
222   }
223 
224   EXPECT_SINGLE_PARSE_EXISTS("-Xzygote", M::Zygote);
225   EXPECT_SINGLE_PARSE_VALUE(std::vector<std::string>({"/hello/world"}),
226                             "-Xbootclasspath:/hello/world",
227                             M::BootClassPath);
228   EXPECT_SINGLE_PARSE_VALUE(std::vector<std::string>({"/hello", "/world"}),
229                             "-Xbootclasspath:/hello:/world",
230                             M::BootClassPath);
231   EXPECT_SINGLE_PARSE_VALUE_STR("/hello/world", "-classpath /hello/world", M::ClassPath);
232   EXPECT_SINGLE_PARSE_VALUE(Memory<1>(234), "-Xss234", M::StackSize);
233   EXPECT_SINGLE_PARSE_VALUE(MemoryKiB(1234*MB), "-Xms1234m", M::MemoryInitialSize);
234   EXPECT_SINGLE_PARSE_VALUE(true, "-XX:EnableHSpaceCompactForOOM", M::EnableHSpaceCompactForOOM);
235   EXPECT_SINGLE_PARSE_VALUE(false, "-XX:DisableHSpaceCompactForOOM", M::EnableHSpaceCompactForOOM);
236   EXPECT_SINGLE_PARSE_VALUE(0.5, "-XX:HeapTargetUtilization=0.5", M::HeapTargetUtilization);
237   EXPECT_SINGLE_PARSE_VALUE(5u, "-XX:ParallelGCThreads=5", M::ParallelGCThreads);
238   EXPECT_SINGLE_PARSE_VALUE(10u,
239                             "-XX:ParallelGCThreads=5 -XX:ParallelGCThreads=10",
240                             M::ParallelGCThreads);
241 }  // TEST_F
242 
TEST_F(CmdlineParserTest,TestSimpleFailures)243 TEST_F(CmdlineParserTest, TestSimpleFailures) {
244   // Test argument is unknown to the parser
245   EXPECT_SINGLE_PARSE_FAIL("abcdefg^%@#*(@#", CmdlineResult::kUnknown);
246   // Test value map substitution fails
247   EXPECT_SINGLE_PARSE_FAIL("-Xverify:whatever", CmdlineResult::kFailure);
248   // Test value type parsing failures
249   EXPECT_SINGLE_PARSE_FAIL("-Xsswhatever", CmdlineResult::kFailure);  // invalid memory value
250   EXPECT_SINGLE_PARSE_FAIL("-Xms123", CmdlineResult::kFailure);       // memory value too small
251   EXPECT_SINGLE_PARSE_FAIL("-XX:HeapTargetUtilization=0.0", CmdlineResult::kOutOfRange);  // toosmal
252   EXPECT_SINGLE_PARSE_FAIL("-XX:HeapTargetUtilization=2.0", CmdlineResult::kOutOfRange);  // toolarg
253   EXPECT_SINGLE_PARSE_FAIL("-XX:ParallelGCThreads=-5", CmdlineResult::kOutOfRange);  // too small
254   EXPECT_SINGLE_PARSE_FAIL("-Xgc:blablabla", CmdlineResult::kUsage);  // not a valid suboption
255 }  // TEST_F
256 
TEST_F(CmdlineParserTest,TestLogVerbosity)257 TEST_F(CmdlineParserTest, TestLogVerbosity) {
258   {
259     const char* log_args = "-verbose:"
260         "class,compiler,gc,heap,interpreter,jdwp,jni,monitor,profiler,signals,simulator,startup,"
261         "third-party-jni,threads,verifier,verifier-debug";
262 
263     LogVerbosity log_verbosity = LogVerbosity();
264     log_verbosity.class_linker = true;
265     log_verbosity.compiler = true;
266     log_verbosity.gc = true;
267     log_verbosity.heap = true;
268     log_verbosity.interpreter = true;
269     log_verbosity.jdwp = true;
270     log_verbosity.jni = true;
271     log_verbosity.monitor = true;
272     log_verbosity.profiler = true;
273     log_verbosity.signals = true;
274     log_verbosity.simulator = true;
275     log_verbosity.startup = true;
276     log_verbosity.third_party_jni = true;
277     log_verbosity.threads = true;
278     log_verbosity.verifier = true;
279     log_verbosity.verifier_debug = true;
280 
281     EXPECT_SINGLE_PARSE_VALUE(log_verbosity, log_args, M::Verbose);
282   }
283 
284   {
285     const char* log_args = "-verbose:"
286         "class,compiler,gc,heap,jdwp,jni,monitor";
287 
288     LogVerbosity log_verbosity = LogVerbosity();
289     log_verbosity.class_linker = true;
290     log_verbosity.compiler = true;
291     log_verbosity.gc = true;
292     log_verbosity.heap = true;
293     log_verbosity.jdwp = true;
294     log_verbosity.jni = true;
295     log_verbosity.monitor = true;
296 
297     EXPECT_SINGLE_PARSE_VALUE(log_verbosity, log_args, M::Verbose);
298   }
299 
300   EXPECT_SINGLE_PARSE_FAIL("-verbose:blablabla", CmdlineResult::kUsage);  // invalid verbose opt
301 
302   {
303     const char* log_args = "-verbose:deopt";
304     LogVerbosity log_verbosity = LogVerbosity();
305     log_verbosity.deopt = true;
306     EXPECT_SINGLE_PARSE_VALUE(log_verbosity, log_args, M::Verbose);
307   }
308 
309   {
310     const char* log_args = "-verbose:collector";
311     LogVerbosity log_verbosity = LogVerbosity();
312     log_verbosity.collector = true;
313     EXPECT_SINGLE_PARSE_VALUE(log_verbosity, log_args, M::Verbose);
314   }
315 
316   {
317     const char* log_args = "-verbose:oat";
318     LogVerbosity log_verbosity = LogVerbosity();
319     log_verbosity.oat = true;
320     EXPECT_SINGLE_PARSE_VALUE(log_verbosity, log_args, M::Verbose);
321   }
322 
323   {
324     const char* log_args = "-verbose:dex";
325     LogVerbosity log_verbosity = LogVerbosity();
326     log_verbosity.dex = true;
327     EXPECT_SINGLE_PARSE_VALUE(log_verbosity, log_args, M::Verbose);
328   }
329 }  // TEST_F
330 
TEST_F(CmdlineParserTest,TestXGcOption)331 TEST_F(CmdlineParserTest, TestXGcOption) {
332   /*
333    * Test success
334    */
335   {
336     XGcOption option_all_true{};
337     option_all_true.collector_type_ = gc::CollectorType::kCollectorTypeCMS;
338     option_all_true.verify_pre_gc_heap_ = true;
339     option_all_true.verify_pre_sweeping_heap_ = true;
340     option_all_true.verify_post_gc_heap_ = true;
341     option_all_true.verify_pre_gc_rosalloc_ = true;
342     option_all_true.verify_pre_sweeping_rosalloc_ = true;
343     option_all_true.verify_post_gc_rosalloc_ = true;
344 
345     const char * xgc_args_all_true = "-Xgc:concurrent,"
346         "preverify,presweepingverify,postverify,"
347         "preverify_rosalloc,presweepingverify_rosalloc,"
348         "postverify_rosalloc,precise,"
349         "verifycardtable";
350 
351     EXPECT_SINGLE_PARSE_VALUE(option_all_true, xgc_args_all_true, M::GcOption);
352 
353     XGcOption option_all_false{};
354     option_all_false.collector_type_ = gc::CollectorType::kCollectorTypeMS;
355     option_all_false.verify_pre_gc_heap_ = false;
356     option_all_false.verify_pre_sweeping_heap_ = false;
357     option_all_false.verify_post_gc_heap_ = false;
358     option_all_false.verify_pre_gc_rosalloc_ = false;
359     option_all_false.verify_pre_sweeping_rosalloc_ = false;
360     option_all_false.verify_post_gc_rosalloc_ = false;
361 
362     const char* xgc_args_all_false = "-Xgc:nonconcurrent,"
363         "nopreverify,nopresweepingverify,nopostverify,nopreverify_rosalloc,"
364         "nopresweepingverify_rosalloc,nopostverify_rosalloc,noprecise,noverifycardtable";
365 
366     EXPECT_SINGLE_PARSE_VALUE(option_all_false, xgc_args_all_false, M::GcOption);
367 
368     XGcOption option_all_default{};
369 
370     const char* xgc_args_blank = "-Xgc:";
371     EXPECT_SINGLE_PARSE_VALUE(option_all_default, xgc_args_blank, M::GcOption);
372   }
373 
374   /*
375    * Test failures
376    */
377   EXPECT_SINGLE_PARSE_FAIL("-Xgc:blablabla", CmdlineResult::kUsage);  // invalid Xgc opt
378 }  // TEST_F
379 
380 /*
381  * { "-XjdwpProvider:_" }
382  */
TEST_F(CmdlineParserTest,TestJdwpProviderEmpty)383 TEST_F(CmdlineParserTest, TestJdwpProviderEmpty) {
384   {
385     EXPECT_SINGLE_PARSE_DEFAULT_VALUE(JdwpProvider::kUnset, "", M::JdwpProvider);
386   }
387 }  // TEST_F
388 
TEST_F(CmdlineParserTest,TestJdwpProviderDefault)389 TEST_F(CmdlineParserTest, TestJdwpProviderDefault) {
390   const char* opt_args = "-XjdwpProvider:default";
391   EXPECT_SINGLE_PARSE_VALUE(JdwpProvider::kDefaultJdwpProvider, opt_args, M::JdwpProvider);
392 }  // TEST_F
393 
TEST_F(CmdlineParserTest,TestJdwpProviderNone)394 TEST_F(CmdlineParserTest, TestJdwpProviderNone) {
395   const char* opt_args = "-XjdwpProvider:none";
396   EXPECT_SINGLE_PARSE_VALUE(JdwpProvider::kNone, opt_args, M::JdwpProvider);
397 }  // TEST_F
398 
TEST_F(CmdlineParserTest,TestJdwpProviderAdbconnection)399 TEST_F(CmdlineParserTest, TestJdwpProviderAdbconnection) {
400   const char* opt_args = "-XjdwpProvider:adbconnection";
401   EXPECT_SINGLE_PARSE_VALUE(JdwpProvider::kAdbConnection, opt_args, M::JdwpProvider);
402 }  // TEST_F
403 
TEST_F(CmdlineParserTest,TestJdwpProviderHelp)404 TEST_F(CmdlineParserTest, TestJdwpProviderHelp) {
405   EXPECT_SINGLE_PARSE_FAIL("-XjdwpProvider:help", CmdlineResult::kUsage);
406 }  // TEST_F
407 
TEST_F(CmdlineParserTest,TestJdwpProviderFail)408 TEST_F(CmdlineParserTest, TestJdwpProviderFail) {
409   EXPECT_SINGLE_PARSE_FAIL("-XjdwpProvider:blablabla", CmdlineResult::kFailure);
410 }  // TEST_F
411 
412 /*
413  * -D_ -D_ -D_ ...
414  */
TEST_F(CmdlineParserTest,TestPropertiesList)415 TEST_F(CmdlineParserTest, TestPropertiesList) {
416   /*
417    * Test successes
418    */
419   {
420     std::vector<std::string> opt = {"hello"};
421 
422     EXPECT_SINGLE_PARSE_VALUE(opt, "-Dhello", M::PropertiesList);
423   }
424 
425   {
426     std::vector<std::string> opt = {"hello", "world"};
427 
428     EXPECT_SINGLE_PARSE_VALUE(opt, "-Dhello -Dworld", M::PropertiesList);
429   }
430 
431   {
432     std::vector<std::string> opt = {"one", "two", "three"};
433 
434     EXPECT_SINGLE_PARSE_VALUE(opt, "-Done -Dtwo -Dthree", M::PropertiesList);
435   }
436 }  // TEST_F
437 
438 /*
439 * -Xcompiler-option foo -Xcompiler-option bar ...
440 */
TEST_F(CmdlineParserTest,TestCompilerOption)441 TEST_F(CmdlineParserTest, TestCompilerOption) {
442  /*
443   * Test successes
444   */
445   {
446     std::vector<std::string> opt = {"hello"};
447     EXPECT_SINGLE_PARSE_VALUE(opt, "-Xcompiler-option hello", M::CompilerOptions);
448   }
449 
450   {
451     std::vector<std::string> opt = {"hello", "world"};
452     EXPECT_SINGLE_PARSE_VALUE(opt,
453                               "-Xcompiler-option hello -Xcompiler-option world",
454                               M::CompilerOptions);
455   }
456 
457   {
458     std::vector<std::string> opt = {"one", "two", "three"};
459     EXPECT_SINGLE_PARSE_VALUE(opt,
460                               "-Xcompiler-option one -Xcompiler-option two -Xcompiler-option three",
461                               M::CompilerOptions);
462   }
463 }  // TEST_F
464 
465 /*
466 * -Xjit, -Xnojit, -Xjitcodecachesize, Xjitcompilethreshold
467 */
TEST_F(CmdlineParserTest,TestJitOptions)468 TEST_F(CmdlineParserTest, TestJitOptions) {
469  /*
470   * Test successes
471   */
472   {
473     EXPECT_SINGLE_PARSE_VALUE(true, "-Xusejit:true", M::UseJitCompilation);
474     EXPECT_SINGLE_PARSE_VALUE(false, "-Xusejit:false", M::UseJitCompilation);
475   }
476   {
477     EXPECT_SINGLE_PARSE_VALUE(
478         MemoryKiB(16 * KB), "-Xjitinitialsize:16K", M::JITCodeCacheInitialCapacity);
479     EXPECT_SINGLE_PARSE_VALUE(
480         MemoryKiB(16 * MB), "-Xjitmaxsize:16M", M::JITCodeCacheMaxCapacity);
481   }
482   {
483     EXPECT_SINGLE_PARSE_VALUE(12345u, "-Xjitthreshold:12345", M::JITOptimizeThreshold);
484   }
485 }  // TEST_F
486 
487 /*
488 * -Xps-*
489 */
TEST_F(CmdlineParserTest,ProfileSaverOptions)490 TEST_F(CmdlineParserTest, ProfileSaverOptions) {
491   ProfileSaverOptions opt = ProfileSaverOptions(true, 1, 2, 3, 4, 5, 6, 7, "abc", true);
492 
493   EXPECT_SINGLE_PARSE_VALUE(opt,
494                             "-Xjitsaveprofilinginfo "
495                             "-Xps-min-save-period-ms:1 "
496                             "-Xps-min-first-save-ms:2 "
497                             "-Xps-min-methods-to-save:3 "
498                             "-Xps-min-classes-to-save:4 "
499                             "-Xps-min-notification-before-wake:5 "
500                             "-Xps-max-notification-before-wake:6 "
501                             "-Xps-inline-cache-threshold:7 "
502                             "-Xps-profile-path:abc "
503                             "-Xps-profile-boot-class-path",
504                             M::ProfileSaverOpts);
505 }  // TEST_F
506 
507 /* -Xexperimental:_ */
TEST_F(CmdlineParserTest,TestExperimentalFlags)508 TEST_F(CmdlineParserTest, TestExperimentalFlags) {
509   // Default
510   EXPECT_SINGLE_PARSE_DEFAULT_VALUE(ExperimentalFlags::kNone,
511                                     "",
512                                     M::Experimental);
513 
514   // Disabled explicitly
515   EXPECT_SINGLE_PARSE_VALUE(ExperimentalFlags::kNone,
516                             "-Xexperimental:none",
517                             M::Experimental);
518 }
519 
520 // -Xverify:_
TEST_F(CmdlineParserTest,TestVerify)521 TEST_F(CmdlineParserTest, TestVerify) {
522   EXPECT_SINGLE_PARSE_VALUE(verifier::VerifyMode::kNone,     "-Xverify:none",     M::Verify);
523   EXPECT_SINGLE_PARSE_VALUE(verifier::VerifyMode::kEnable,   "-Xverify:remote",   M::Verify);
524   EXPECT_SINGLE_PARSE_VALUE(verifier::VerifyMode::kEnable,   "-Xverify:all",      M::Verify);
525   EXPECT_SINGLE_PARSE_VALUE(verifier::VerifyMode::kSoftFail, "-Xverify:softfail", M::Verify);
526 }
527 
TEST_F(CmdlineParserTest,TestIgnoreUnrecognized)528 TEST_F(CmdlineParserTest, TestIgnoreUnrecognized) {
529   RuntimeParser::Builder parserBuilder;
530 
531   // clang-format off
532   parserBuilder
533       .Define("-help")
534           .IntoKey(M::Help)
535       .IgnoreUnrecognized(true);
536   // clang-format on
537 
538   parser_.reset(new RuntimeParser(parserBuilder.Build()));
539 
540   EXPECT_SINGLE_PARSE_EMPTY_SUCCESS("-non-existent-option");
541   EXPECT_SINGLE_PARSE_EMPTY_SUCCESS("-non-existent-option1 --non-existent-option-2");
542 }  //  TEST_F
543 
TEST_F(CmdlineParserTest,TestIgnoredArguments)544 TEST_F(CmdlineParserTest, TestIgnoredArguments) {
545   std::initializer_list<const char*> ignored_args = {
546       "-ea", "-da", "-enableassertions", "-disableassertions", "--runtime-arg", "-esa",
547       "-dsa", "-enablesystemassertions", "-disablesystemassertions", "-Xrs", "-Xint:abdef",
548       "-Xdexopt:foobar", "-Xnoquithandler", "-Xjnigreflimit:ixnay", "-Xgenregmap", "-Xnogenregmap",
549       "-Xverifyopt:never", "-Xcheckdexsum", "-Xincludeselectedop", "-Xjitop:noop",
550       "-Xincludeselectedmethod", "-Xjitblocking", "-Xjitmethod:_", "-Xjitclass:nosuchluck",
551       "-Xjitoffset:none", "-Xjitconfig:yes", "-Xjitcheckcg", "-Xjitverbose", "-Xjitprofile",
552       "-Xjitdisableopt", "-Xjitsuspendpoll", "-XX:mainThreadStackSize=1337"
553   };
554 
555   // Check they are ignored when parsed one at a time
556   for (auto&& arg : ignored_args) {
557     SCOPED_TRACE(arg);
558     EXPECT_SINGLE_PARSE_EMPTY_SUCCESS(arg);
559   }
560 
561   // Check they are ignored when we pass it all together at once
562   std::vector<const char*> argv = ignored_args;
563   EXPECT_SINGLE_PARSE_EMPTY_SUCCESS(argv);
564 }  //  TEST_F
565 
TEST_F(CmdlineParserTest,MultipleArguments)566 TEST_F(CmdlineParserTest, MultipleArguments) {
567   EXPECT_TRUE(IsResultSuccessful(parser_->Parse(
568       "-help -XX:ForegroundHeapGrowthMultiplier=0.5 "
569       "-Xmethod-trace -XX:LargeObjectSpace=map")));
570 
571   auto&& map = parser_->ReleaseArgumentsMap();
572   EXPECT_EQ(4u, map.Size());
573   EXPECT_KEY_VALUE(map, M::Help, Unit{});
574   EXPECT_KEY_VALUE(map, M::ForegroundHeapGrowthMultiplier, 0.5);
575   EXPECT_KEY_VALUE(map, M::MethodTrace, Unit{});
576   EXPECT_KEY_VALUE(map, M::LargeObjectSpace, gc::space::LargeObjectSpaceType::kMap);
577 }  //  TEST_F
578 
TEST_F(CmdlineParserTest,TypesNotInRuntime)579 TEST_F(CmdlineParserTest, TypesNotInRuntime) {
580   using ParseCommaSeparatedIntList = ParseIntList<','>;
581   CmdlineType<ParseCommaSeparatedIntList> ct;
582   auto success0 =
583       CmdlineParseResult<ParseCommaSeparatedIntList>::Success(ParseCommaSeparatedIntList({1, 2, 3, 4}));
584   EXPECT_EQ(success0, ct.Parse("1,2,3,4"));
585   auto success1 =
586       CmdlineParseResult<ParseCommaSeparatedIntList>::Success(ParseCommaSeparatedIntList({0}));
587   EXPECT_EQ(success1, ct.Parse("1"));
588 
589   EXPECT_FALSE(ct.Parse("").IsSuccess());
590   EXPECT_FALSE(ct.Parse(",").IsSuccess());
591   EXPECT_FALSE(ct.Parse("1,").IsSuccess());
592   EXPECT_FALSE(ct.Parse(",1").IsSuccess());
593   EXPECT_FALSE(ct.Parse("1a2").IsSuccess());
594   EXPECT_EQ(CmdlineResult::kOutOfRange, ct.Parse("1,10000000000000").GetStatus());
595   EXPECT_EQ(CmdlineResult::kOutOfRange, ct.Parse("-10000000000000,123").GetStatus());
596 }  // TEST_F
597 }  // namespace art
598