flag-definitions.h 64.4 KB
Newer Older
1
// Copyright 2012 the V8 project authors. All rights reserved.
2 3
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
4 5 6 7 8 9 10 11

// This file defines all of the flags.  It is separated into different section,
// for Debug, Release, Logging and Profiling, etc.  To add a new flag, find the
// correct section, and use one of the DEFINE_ macros, without a trailing ';'.
//
// This include does not have a guard, because it is a template-style include,
// which can be included multiple times in different modes.  It expects to have
// a mode defined before it's included.  The modes are FLAG_MODE_... below:
12 13
//
// PRESUBMIT_INTENTIONALLY_MISSING_INCLUDE_GUARD
14

15 16 17 18 19 20
#define DEFINE_IMPLICATION(whenflag, thenflag)              \
  DEFINE_VALUE_IMPLICATION(whenflag, thenflag, true)

#define DEFINE_NEG_IMPLICATION(whenflag, thenflag)          \
  DEFINE_VALUE_IMPLICATION(whenflag, thenflag, false)

21 22 23
#define DEFINE_NEG_NEG_IMPLICATION(whenflag, thenflag) \
  DEFINE_NEG_VALUE_IMPLICATION(whenflag, thenflag, false)

24 25 26 27
// We want to declare the names of the variables for the header file.  Normally
// this will just be an extern declaration, but for a readonly flag we let the
// compiler make better optimizations by giving it the value.
#if defined(FLAG_MODE_DECLARE)
28 29
#define FLAG_FULL(ftype, ctype, nam, def, cmt) \
  V8_EXPORT_PRIVATE extern ctype FLAG_##nam;
30
#define FLAG_READONLY(ftype, ctype, nam, def, cmt) \
31
  static constexpr ctype FLAG_##nam = def;
32 33 34 35

// We want to supply the actual storage and value for the flag variable in the
// .cc file.  We only do this for writable flags.
#elif defined(FLAG_MODE_DEFINE)
36 37 38 39 40 41 42
#ifdef USING_V8_SHARED
#define FLAG_FULL(ftype, ctype, nam, def, cmt) \
  V8_EXPORT_PRIVATE extern ctype FLAG_##nam;
#else
#define FLAG_FULL(ftype, ctype, nam, def, cmt) \
  V8_EXPORT_PRIVATE ctype FLAG_##nam = def;
#endif
43 44 45 46 47 48

// We need to define all of our default values so that the Flag structure can
// access them by pointer.  These are just used internally inside of one .cc,
// for MODE_META, so there is no impact on the flags interface.
#elif defined(FLAG_MODE_DEFINE_DEFAULTS)
#define FLAG_FULL(ftype, ctype, nam, def, cmt) \
49
  static constexpr ctype FLAGDEFAULT_##nam = def;
50 51 52 53

// We want to write entries into our meta data table, for internal parsing and
// printing / etc in the flag parser code.  We only do this for writable flags.
#elif defined(FLAG_MODE_META)
54 55 56 57 58 59 60 61 62
#define FLAG_FULL(ftype, ctype, nam, def, cmt)                              \
  { Flag::TYPE_##ftype, #nam, &FLAG_##nam, &FLAGDEFAULT_##nam, cmt, false } \
  ,
#define FLAG_ALIAS(ftype, ctype, alias, nam)                     \
  {                                                              \
    Flag::TYPE_##ftype, #alias, &FLAG_##nam, &FLAGDEFAULT_##nam, \
        "alias for --" #nam, false                               \
  }                                                              \
  ,
63 64 65

// We produce the code to set flags when it is implied by another flag.
#elif defined(FLAG_MODE_DEFINE_IMPLICATIONS)
66 67
#define DEFINE_VALUE_IMPLICATION(whenflag, thenflag, value) \
  if (FLAG_##whenflag) FLAG_##thenflag = value;
68

69 70 71
#define DEFINE_NEG_VALUE_IMPLICATION(whenflag, thenflag, value) \
  if (!FLAG_##whenflag) FLAG_##thenflag = value;

72 73 74 75
#else
#error No mode supplied when including flags.defs
#endif

76 77 78 79 80 81 82 83 84 85 86 87 88
// Dummy defines for modes where it is not relevant.
#ifndef FLAG_FULL
#define FLAG_FULL(ftype, ctype, nam, def, cmt)
#endif

#ifndef FLAG_READONLY
#define FLAG_READONLY(ftype, ctype, nam, def, cmt)
#endif

#ifndef FLAG_ALIAS
#define FLAG_ALIAS(ftype, ctype, alias, nam)
#endif

89 90
#ifndef DEFINE_VALUE_IMPLICATION
#define DEFINE_VALUE_IMPLICATION(whenflag, thenflag, value)
91 92
#endif

93 94 95 96
#ifndef DEFINE_NEG_VALUE_IMPLICATION
#define DEFINE_NEG_VALUE_IMPLICATION(whenflag, thenflag, value)
#endif

97
#define COMMA ,
98

99
#ifdef FLAG_MODE_DECLARE
100 101 102 103 104 105 106

struct MaybeBoolFlag {
  static MaybeBoolFlag Create(bool has_value, bool value) {
    MaybeBoolFlag flag;
    flag.has_value = has_value;
    flag.value = value;
    return flag;
107
  }
108 109
  bool has_value;
  bool value;
110 111 112
};
#endif

113 114 115 116 117
#ifdef DEBUG
#define DEBUG_BOOL true
#else
#define DEBUG_BOOL false
#endif
118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134

// Supported ARM configurations are:
//  "armv6":       ARMv6 + VFPv2
//  "armv7":       ARMv7 + VFPv3-D32 + NEON
//  "armv7+sudiv": ARMv7 + VFPv4-D32 + NEON + SUDIV
//  "armv8":       ARMv8 (including all of the above)
#if !defined(ARM_TEST_NO_FEATURE_PROBE) ||                            \
    (defined(CAN_USE_ARMV8_INSTRUCTIONS) &&                           \
     defined(CAN_USE_ARMV7_INSTRUCTIONS) && defined(CAN_USE_SUDIV) && \
     defined(CAN_USE_NEON) && defined(CAN_USE_VFP3_INSTRUCTIONS))
#define ARM_ARCH_DEFAULT "armv8"
#elif defined(CAN_USE_ARMV7_INSTRUCTIONS) && defined(CAN_USE_SUDIV) && \
    defined(CAN_USE_NEON) && defined(CAN_USE_VFP3_INSTRUCTIONS)
#define ARM_ARCH_DEFAULT "armv7+sudiv"
#elif defined(CAN_USE_ARMV7_INSTRUCTIONS) && defined(CAN_USE_NEON) && \
    defined(CAN_USE_VFP3_INSTRUCTIONS)
#define ARM_ARCH_DEFAULT "armv7"
135
#else
136
#define ARM_ARCH_DEFAULT "armv6"
137
#endif
138

139 140 141 142 143
#ifdef V8_OS_WIN
# define ENABLE_LOG_COLOUR false
#else
# define ENABLE_LOG_COLOUR true
#endif
144

145
#define DEFINE_BOOL(nam, def, cmt) FLAG(BOOL, bool, nam, def, cmt)
146 147
#define DEFINE_BOOL_READONLY(nam, def, cmt) \
  FLAG_READONLY(BOOL, bool, nam, def, cmt)
148 149 150
#define DEFINE_MAYBE_BOOL(nam, cmt) \
  FLAG(MAYBE_BOOL, MaybeBoolFlag, nam, {false COMMA false}, cmt)
#define DEFINE_INT(nam, def, cmt) FLAG(INT, int, nam, def, cmt)
151
#define DEFINE_UINT(nam, def, cmt) FLAG(UINT, unsigned int, nam, def, cmt)
Yang Guo's avatar
Yang Guo committed
152
#define DEFINE_UINT64(nam, def, cmt) FLAG(UINT64, uint64_t, nam, def, cmt)
153
#define DEFINE_FLOAT(nam, def, cmt) FLAG(FLOAT, double, nam, def, cmt)
154
#define DEFINE_SIZE_T(nam, def, cmt) FLAG(SIZE_T, size_t, nam, def, cmt)
155 156 157 158
#define DEFINE_STRING(nam, def, cmt) FLAG(STRING, const char*, nam, def, cmt)
#define DEFINE_ALIAS_BOOL(alias, nam) FLAG_ALIAS(BOOL, bool, alias, nam)
#define DEFINE_ALIAS_INT(alias, nam) FLAG_ALIAS(INT, int, alias, nam)
#define DEFINE_ALIAS_FLOAT(alias, nam) FLAG_ALIAS(FLOAT, double, alias, nam)
159
#define DEFINE_ALIAS_SIZE_T(alias, nam) FLAG_ALIAS(SIZE_T, size_t, alias, nam)
160
#define DEFINE_ALIAS_STRING(alias, nam) \
161
  FLAG_ALIAS(STRING, const char*, alias, nam)
162

163 164 165 166 167 168
#ifdef DEBUG
#define DEFINE_DEBUG_BOOL DEFINE_BOOL
#else
#define DEFINE_DEBUG_BOOL DEFINE_BOOL_READONLY
#endif

169 170 171 172 173
//
// Flags in all modes.
//
#define FLAG FLAG_FULL

174 175 176
DEFINE_BOOL(experimental_extras, false,
            "enable code compiled in via v8_experimental_extra_library_files")

177
// Flags for language modes and experimental language features.
178
DEFINE_BOOL(use_strict, false, "enforce strict mode")
179

180 181
DEFINE_BOOL(es_staging, false,
            "enable test-worthy harmony features (for internal use only)")
182
DEFINE_BOOL(harmony, false, "enable all completed harmony features")
183
DEFINE_BOOL(harmony_shipping, true, "enable all shipped harmony features")
dslomov's avatar
dslomov committed
184
DEFINE_IMPLICATION(es_staging, harmony)
185 186
// Enabling import.meta requires to also enable import()
DEFINE_IMPLICATION(harmony_import_meta, harmony_dynamic_import)
187

188
DEFINE_IMPLICATION(harmony_class_fields, harmony_public_fields)
189
DEFINE_IMPLICATION(harmony_class_fields, harmony_static_fields)
190
DEFINE_IMPLICATION(harmony_class_fields, harmony_private_fields)
191

192 193
// Update bootstrapper.cc whenever adding a new feature flag.

194
// Features that are still work in progress (behind individual flags).
195 196 197 198 199 200
#define HARMONY_INPROGRESS_BASE(V)                                 \
  V(harmony_do_expressions, "harmony do-expressions")              \
  V(harmony_class_fields, "harmony fields in class literals")      \
  V(harmony_await_optimization, "harmony await taking 1 tick")     \
  V(harmony_regexp_sequence, "RegExp Unicode sequence properties") \
  V(harmony_weak_refs, "harmony weak references")
201

202
#ifdef V8_INTL_SUPPORT
203 204 205
#define HARMONY_INPROGRESS(V)                    \
  HARMONY_INPROGRESS_BASE(V)                     \
  V(harmony_locale, "Intl.Locale")               \
206
  V(harmony_intl_list_format, "Intl.ListFormat")
207 208 209 210
#else
#define HARMONY_INPROGRESS(V) HARMONY_INPROGRESS_BASE(V)
#endif

211
// Features that are complete (but still behind --harmony/es-staging flag).
212
#define HARMONY_STAGED_BASE(V)                                             \
jgruber's avatar
jgruber committed
213 214
  V(harmony_private_fields, "harmony private fields in class literals")    \
  V(harmony_numeric_separator, "harmony numeric separator between digits") \
215
  V(harmony_string_matchall, "harmony String.prototype.matchAll")
216

217 218 219 220 221 222 223 224
#ifdef V8_INTL_SUPPORT
#define HARMONY_STAGED(V) \
  HARMONY_STAGED_BASE(V)  \
  V(harmony_intl_segmenter, "Intl.Segmenter")
#else
#define HARMONY_STAGED(V) HARMONY_STAGED_BASE(V)
#endif

225
// Features that are shipping (turned on by default, but internal flag remains).
226 227 228 229 230 231 232 233 234 235 236 237 238
#define HARMONY_SHIPPING_BASE(V)                                               \
  V(harmony_namespace_exports,                                                 \
    "harmony namespace exports (export * as foo from 'bar')")                  \
  V(harmony_sharedarraybuffer, "harmony sharedarraybuffer")                    \
  V(harmony_import_meta, "harmony import.meta property")                       \
  V(harmony_dynamic_import, "harmony dynamic import")                          \
  V(harmony_array_prototype_values, "harmony Array.prototype.values")          \
  V(harmony_array_flat, "harmony Array.prototype.{flat,flatMap}")              \
  V(harmony_symbol_description, "harmony Symbol.prototype.description")        \
  V(harmony_global, "harmony global")                                          \
  V(harmony_json_stringify, "well-formed JSON.stringify")                      \
  V(harmony_public_fields, "harmony public instance fields in class literals") \
  V(harmony_static_fields, "harmony static fields in class literals")
239

240 241 242 243 244 245 246 247
#ifdef V8_INTL_SUPPORT
#define HARMONY_SHIPPING(V) \
  HARMONY_SHIPPING_BASE(V)  \
  V(harmony_intl_relative_time_format, "Intl.RelativeTimeFormat")
#else
#define HARMONY_SHIPPING(V) HARMONY_SHIPPING_BASE(V)
#endif

248 249 250 251
// Once a shipping feature has proved stable in the wild, it will be dropped
// from HARMONY_SHIPPING, all occurrences of the FLAG_ variable are removed,
// and associated tests are moved from the harmony directory to the appropriate
// esN directory.
252 253


254 255 256 257
#define FLAG_INPROGRESS_FEATURES(id, description) \
  DEFINE_BOOL(id, false, "enable " #description " (in progress)")
HARMONY_INPROGRESS(FLAG_INPROGRESS_FEATURES)
#undef FLAG_INPROGRESS_FEATURES
258

259 260
#define FLAG_STAGED_FEATURES(id, description) \
  DEFINE_BOOL(id, false, "enable " #description) \
261
  DEFINE_IMPLICATION(harmony, id)
262
HARMONY_STAGED(FLAG_STAGED_FEATURES)
263 264
#undef FLAG_STAGED_FEATURES

265 266 267
#define FLAG_SHIPPING_FEATURES(id, description) \
  DEFINE_BOOL(id, true, "enable " #description) \
  DEFINE_NEG_NEG_IMPLICATION(harmony_shipping, id)
268
HARMONY_SHIPPING(FLAG_SHIPPING_FEATURES)
269 270
#undef FLAG_SHIPPING_FEATURES

271
#ifdef V8_INTL_SUPPORT
272
DEFINE_BOOL(icu_timezone_data, true, "get information about timezones from ICU")
273 274
#endif

275 276 277 278 279 280
#ifdef V8_ENABLE_FUTURE
#define FUTURE_BOOL true
#else
#define FUTURE_BOOL false
#endif
DEFINE_BOOL(future, FUTURE_BOOL,
281 282
            "Implies all staged features that we want to ship in the "
            "not-too-far future")
283

284
DEFINE_IMPLICATION(future, write_protect_code_memory)
285

286
// Flags for experimental implementation features.
287
DEFINE_BOOL(allocation_site_pretenuring, true,
288
            "pretenure with allocation sites")
289 290 291
DEFINE_BOOL(page_promotion, true, "promote pages based on utilization")
DEFINE_INT(page_promotion_threshold, 70,
           "min percentage of live bytes on a page to enable fast evacuation")
292
DEFINE_BOOL(trace_pretenuring, false,
293
            "trace pretenuring decisions of HAllocate instructions")
294
DEFINE_BOOL(trace_pretenuring_statistics, false,
295
            "trace allocation site pretenuring statistics")
296 297 298 299 300 301 302 303 304 305
DEFINE_BOOL(track_fields, true, "track fields with only smi values")
DEFINE_BOOL(track_double_fields, true, "track fields with double values")
DEFINE_BOOL(track_heap_object_fields, true, "track fields with heap values")
DEFINE_BOOL(track_computed_fields, true, "track computed boilerplate fields")
DEFINE_IMPLICATION(track_double_fields, track_fields)
DEFINE_IMPLICATION(track_heap_object_fields, track_fields)
DEFINE_IMPLICATION(track_computed_fields, track_fields)
DEFINE_BOOL(track_field_types, true, "track field types")
DEFINE_IMPLICATION(track_field_types, track_fields)
DEFINE_IMPLICATION(track_field_types, track_heap_object_fields)
306 307
DEFINE_BOOL(trace_block_coverage, false,
            "trace collected block coverage information")
308 309
DEFINE_BOOL(feedback_normalization, false,
            "feed back normalization to constructors")
310
// TODO(jkummerow): This currently adds too much load on the stub cache.
311
DEFINE_BOOL_READONLY(internalize_on_the_fly, true,
312
                     "internalize string keys for generic keyed ICs on the fly")
313

314
// Flag for one shot optimiztions.
315
DEFINE_BOOL(enable_one_shot_optimization, true,
316 317 318
            "Enable size optimizations for the code that will "
            "only be executed once")

319

320
// Flags for data representation optimizations
321
DEFINE_BOOL(unbox_double_arrays, true, "automatically unbox arrays of doubles")
322
DEFINE_BOOL_READONLY(string_slices, true, "use string slices")
323

324 325 326 327 328
// Flag to stress different interleavings of tasks.
DEFINE_BOOL(
    stress_delay_tasks, false,
    "delay execution of tasks by 0-100ms randomly (based on --random-seed)")

329 330 331 332 333 334 335 336 337 338 339 340
// Flags for Ignition for no-snapshot builds.
#undef FLAG
#ifndef V8_USE_SNAPSHOT
#define FLAG FLAG_FULL
#else
#define FLAG FLAG_READONLY
#endif
DEFINE_INT(interrupt_budget, 144 * KB,
           "interrupt budget which should be used for the profiler counter")
#undef FLAG
#define FLAG FLAG_FULL

341
// Flags for Ignition.
342 343
DEFINE_BOOL(ignition_elide_noneffectful_bytecodes, true,
            "elide bytecodes which won't have any external effect")
344
DEFINE_BOOL(ignition_reo, true, "use ignition register equivalence optimizer")
345 346
DEFINE_BOOL(ignition_filter_expression_positions, true,
            "filter expression positions before the bytecode pipeline")
347
DEFINE_BOOL(ignition_share_named_property_feedback, true,
348 349
            "share feedback slots when loading the same named property from "
            "the same object")
350 351
DEFINE_BOOL(print_bytecode, false,
            "print bytecode generated by ignition interpreter")
352 353
DEFINE_STRING(print_bytecode_filter, "*",
              "filter for selecting which functions to print bytecode")
354
#ifdef V8_TRACE_IGNITION
355 356
DEFINE_BOOL(trace_ignition, false,
            "trace the bytecodes executed by the ignition interpreter")
357
#endif
358 359 360 361 362
#ifdef V8_TRACE_FEEDBACK_UPDATES
DEFINE_BOOL(
    trace_feedback_updates, false,
    "trace updates to feedback vectors during ignition interpreter execution.")
#endif
363 364
DEFINE_BOOL(trace_ignition_codegen, false,
            "trace the codegen of ignition interpreter bytecode handlers")
365 366 367
DEFINE_BOOL(trace_ignition_dispatches, false,
            "traces the dispatches to bytecode handlers by the ignition "
            "interpreter")
368
DEFINE_STRING(trace_ignition_dispatches_output_file, nullptr,
369
              "the file to which the bytecode handler dispatch table is "
370
              "written (by default, the table is not written to a file)")
371

372 373
DEFINE_BOOL(fast_math, true, "faster (but maybe less accurate) math functions")
DEFINE_BOOL(trace_track_allocation_sites, false,
374
            "trace the tracking of allocation sites")
375 376
DEFINE_BOOL(trace_migration, false, "trace object migration")
DEFINE_BOOL(trace_generalization, false, "trace map generalization")
377

378
// Flags for concurrent recompilation.
379
DEFINE_BOOL(concurrent_recompilation, true,
380
            "optimizing hot functions asynchronously on a separate thread")
381
DEFINE_BOOL(trace_concurrent_recompilation, false,
382
            "track concurrent recompilation")
383
DEFINE_INT(concurrent_recompilation_queue_length, 8,
384
           "the length of the concurrent compilation queue")
385
DEFINE_INT(concurrent_recompilation_delay, 0,
386
           "artificial compilation delay in ms")
387
DEFINE_BOOL(block_concurrent_recompilation, false,
388
            "block queued jobs until released")
389 390
DEFINE_BOOL(concurrent_inlining, false,
            "run optimizing compiler's inlining phase on a separate thread")
391 392
DEFINE_IMPLICATION(future, concurrent_inlining)
DEFINE_BOOL(strict_heap_broker, true, "fail on incomplete serialization")
393
DEFINE_BOOL(trace_heap_broker, false, "trace the heap broker")
394

395 396 397 398 399
// Flags for stress-testing the compiler.
DEFINE_INT(stress_runs, 0, "number of stress runs")
DEFINE_INT(deopt_every_n_times, 0,
           "deoptimize every n times a deopt point is passed")
DEFINE_BOOL(print_deopt_stress, false, "print number of possible deopt points")
400

401
// Flags for TurboFan.
402 403
DEFINE_BOOL(turbo_sp_frame_access, false,
            "use stack pointer-relative access to frame wherever possible")
404
DEFINE_BOOL(turbo_preprocess_ranges, true,
405
            "run pre-register allocation heuristics")
406
DEFINE_STRING(turbo_filter, "*", "optimization filter for TurboFan compiler")
407
DEFINE_BOOL(trace_turbo, false, "trace generated TurboFan IR")
408 409
DEFINE_STRING(trace_turbo_path, nullptr,
              "directory to dump generated TurboFan IR to")
410 411
DEFINE_STRING(trace_turbo_filter, "*",
              "filter for tracing turbofan compilation")
412
DEFINE_BOOL(trace_turbo_graph, false, "trace generated TurboFan graphs")
413 414
DEFINE_BOOL(trace_turbo_scheduled, false, "trace TurboFan IR with schedule")
DEFINE_IMPLICATION(trace_turbo_scheduled, trace_turbo_graph)
415
DEFINE_STRING(trace_turbo_cfg_file, nullptr,
416
              "trace turbo cfg graph (for C1 visualizer) to a given file name")
417 418 419
DEFINE_BOOL(trace_turbo_types, true, "trace TurboFan's types")
DEFINE_BOOL(trace_turbo_scheduler, false, "trace TurboFan's scheduler")
DEFINE_BOOL(trace_turbo_reduction, false, "trace TurboFan's various reducers")
420
DEFINE_BOOL(trace_turbo_trimming, false, "trace TurboFan's graph trimmer")
421
DEFINE_BOOL(trace_turbo_jt, false, "trace TurboFan's jump threading")
422
DEFINE_BOOL(trace_turbo_ceq, false, "trace TurboFan's control equivalence")
423
DEFINE_BOOL(trace_turbo_loop, false, "trace TurboFan's loop optimizations")
424 425 426
DEFINE_BOOL(trace_alloc, false, "trace register allocator")
DEFINE_BOOL(trace_all_uses, false, "trace all use positions")
DEFINE_BOOL(trace_representation, false, "trace representation types")
427
DEFINE_BOOL(turbo_verify, DEBUG_BOOL, "verify TurboFan graphs at each phase")
428 429
DEFINE_STRING(turbo_verify_machine_graph, nullptr,
              "verify TurboFan machine graph before instruction selection")
430 431
#ifdef ENABLE_VERIFY_CSA
DEFINE_BOOL(verify_csa, DEBUG_BOOL,
432
            "verify TurboFan machine graph of code stubs")
433 434 435 436 437 438 439
#else
// Define the flag as read-only-false so that code still compiles even in the
// non-ENABLE_VERIFY_CSA configuration.
DEFINE_BOOL_READONLY(verify_csa, false,
                     "verify TurboFan machine graph of code stubs")
#endif
DEFINE_BOOL(trace_verify_csa, false, "trace code stubs verification")
440 441 442
DEFINE_STRING(csa_trap_on_node, nullptr,
              "trigger break point when a node with given id is created in "
              "given stub. The format is: StubName,NodeId")
443 444
DEFINE_BOOL_READONLY(fixed_array_bounds_checks, DEBUG_BOOL,
                     "enable FixedArray bounds checks")
445
DEFINE_BOOL(turbo_stats, false, "print TurboFan statistics")
446 447
DEFINE_BOOL(turbo_stats_nvp, false,
            "print TurboFan statistics in machine-readable format")
448 449
DEFINE_BOOL(turbo_stats_wasm, false,
            "print TurboFan statistics of wasm compilations")
450
DEFINE_BOOL(turbo_splitting, true, "split nodes during scheduling in TurboFan")
451 452
DEFINE_BOOL(function_context_specialization, false,
            "enable function context specialization in TurboFan")
453
DEFINE_BOOL(turbo_inlining, true, "enable inlining in TurboFan")
454 455 456 457
DEFINE_INT(max_inlined_bytecode_size, 500,
           "maximum size of bytecode for a single inlining")
DEFINE_INT(max_inlined_bytecode_size_cumulative, 1000,
           "maximum cumulative size of bytecode considered for inlining")
458 459
DEFINE_INT(max_inlined_bytecode_size_absolute, 5000,
           "maximum cumulative size of bytecode considered for inlining")
460 461 462 463 464 465
DEFINE_FLOAT(reserve_inline_budget_scale_factor, 1.2,
             "maximum cumulative size of bytecode considered for inlining")
DEFINE_INT(max_inlined_bytecode_size_small, 30,
           "maximum size of bytecode considered for small function inlining")
DEFINE_FLOAT(min_inlining_frequency, 0.15, "minimum frequency for inlining")
DEFINE_BOOL(polymorphic_inlining, true, "polymorphic inlining")
466 467 468 469 470
DEFINE_BOOL(stress_inline, false,
            "set high thresholds for inlining to inline as much as possible")
DEFINE_VALUE_IMPLICATION(stress_inline, max_inlined_bytecode_size, 999999)
DEFINE_VALUE_IMPLICATION(stress_inline, max_inlined_bytecode_size_cumulative,
                         999999)
471 472
DEFINE_VALUE_IMPLICATION(stress_inline, max_inlined_bytecode_size_absolute,
                         999999)
473 474
DEFINE_VALUE_IMPLICATION(stress_inline, min_inlining_frequency, 0)
DEFINE_VALUE_IMPLICATION(stress_inline, polymorphic_inlining, true)
475
DEFINE_BOOL(trace_turbo_inlining, false, "trace TurboFan inlining")
476 477
DEFINE_BOOL(inline_accessors, true, "inline JavaScript accessors")
DEFINE_BOOL(inline_into_try, true, "inline into try blocks")
478
DEFINE_BOOL(turbo_inline_array_builtins, true,
479
            "inline array builtins in TurboFan code")
480 481 482 483 484 485
DEFINE_BOOL(use_osr, true, "use on-stack replacement")
DEFINE_BOOL(trace_osr, false, "trace on-stack replacement")
DEFINE_BOOL(analyze_environment_liveness, true,
            "analyze liveness of environment slots and zap dead values")
DEFINE_BOOL(trace_environment_liveness, false,
            "trace liveness of local variable slots")
486 487 488
DEFINE_BOOL(turbo_load_elimination, true, "enable load elimination in TurboFan")
DEFINE_BOOL(trace_turbo_load_elimination, false,
            "trace TurboFan load elimination")
489
DEFINE_BOOL(turbo_profiling, false, "enable profiling in TurboFan")
490 491
DEFINE_BOOL(turbo_verify_allocation, DEBUG_BOOL,
            "verify register allocation in TurboFan")
492
DEFINE_BOOL(turbo_move_optimization, true, "optimize gap moves in TurboFan")
493
DEFINE_BOOL(turbo_jt, true, "enable jump threading in TurboFan")
494
DEFINE_BOOL(turbo_loop_peeling, true, "Turbofan loop peeling")
495
DEFINE_BOOL(turbo_loop_variable, true, "Turbofan loop variable optimization")
496
DEFINE_BOOL(turbo_cf_optimization, true, "optimize control flow in TurboFan")
497
DEFINE_BOOL(turbo_escape, true, "enable escape analysis")
498
DEFINE_BOOL(turbo_allocation_folding, true, "Turbofan allocation folding")
499 500
DEFINE_BOOL(turbo_instruction_scheduling, false,
            "enable instruction scheduling in TurboFan")
501 502
DEFINE_BOOL(turbo_stress_instruction_scheduling, false,
            "randomly schedule instructions to stress dependency tracking")
503
DEFINE_BOOL(turbo_store_elimination, true,
504
            "enable store-store elimination in TurboFan")
505
DEFINE_BOOL(trace_store_elimination, false, "trace store elimination")
506 507
DEFINE_BOOL(turbo_rewrite_far_jumps, true,
            "rewrite far to near jumps (ia32,x64)")
508
DEFINE_BOOL(experimental_inline_promise_constructor, true,
509
            "inline the Promise constructor in TurboFan")
510 511 512 513 514 515 516

#ifdef DISABLE_UNTRUSTED_CODE_MITIGATIONS
#define V8_DEFAULT_UNTRUSTED_CODE_MITIGATIONS false
#else
#define V8_DEFAULT_UNTRUSTED_CODE_MITIGATIONS true
#endif
DEFINE_BOOL(untrusted_code_mitigations, V8_DEFAULT_UNTRUSTED_CODE_MITIGATIONS,
517
            "Enable mitigations for executing untrusted code")
518
#undef V8_DEFAULT_UNTRUSTED_CODE_MITIGATIONS
519

520
// Flags for native WebAssembly.
521
DEFINE_BOOL(expose_wasm, true, "expose wasm interface to JavaScript")
522 523
DEFINE_BOOL(assume_asmjs_origin, false,
            "force wasm decoder to assume input is internal asm-wasm format")
524
DEFINE_BOOL(wasm_disable_structured_cloning, false,
525
            "disable wasm structured cloning")
526
DEFINE_INT(wasm_num_compilation_tasks, 10,
527
           "number of parallel compilation tasks for wasm")
528
DEFINE_DEBUG_BOOL(trace_wasm_native_heap, false,
529
                  "trace wasm native heap events")
530
DEFINE_BOOL(wasm_write_protect_code_memory, false,
531
            "write protect code memory on the wasm native heap")
532
DEFINE_BOOL(trace_wasm_serialization, false,
533
            "trace serialization/deserialization")
534
DEFINE_BOOL(wasm_async_compilation, true,
535
            "enable actual asynchronous compilation for WebAssembly.compile")
536 537
DEFINE_BOOL(wasm_test_streaming, false,
            "use streaming compilation instead of async compilation for tests")
538
DEFINE_UINT(wasm_max_mem_pages, v8::internal::wasm::kV8MaxWasmMemoryPages,
539
            "maximum number of 64KiB memory pages of a wasm instance")
540 541
DEFINE_UINT(wasm_max_table_size, v8::internal::wasm::kV8MaxWasmTableSize,
            "maximum table size of a wasm instance")
542
// Enable Liftoff by default on ia32 and x64. More architectures will follow
543 544 545 546 547 548 549 550 551
// once they are implemented and sufficiently tested.
#if V8_TARGET_ARCH_IA32 || V8_TARGET_ARCH_X64
DEFINE_BOOL(
    wasm_tier_up, true,
    "enable wasm baseline compilation and tier up to the optimizing compiler")
#else
DEFINE_BOOL(
    wasm_tier_up, false,
    "enable wasm baseline compilation and tier up to the optimizing compiler")
552
DEFINE_IMPLICATION(future, wasm_tier_up)
553
#endif
554
DEFINE_IMPLICATION(wasm_tier_up, liftoff)
555 556 557 558 559 560 561 562
DEFINE_DEBUG_BOOL(trace_wasm_decoder, false, "trace decoding of wasm code")
DEFINE_DEBUG_BOOL(trace_wasm_decode_time, false,
                  "trace decoding time of wasm code")
DEFINE_DEBUG_BOOL(trace_wasm_compiler, false, "trace compiling of wasm code")
DEFINE_DEBUG_BOOL(trace_wasm_interpreter, false,
                  "trace interpretation of wasm code")
DEFINE_DEBUG_BOOL(trace_wasm_streaming, false,
                  "trace streaming compilation of wasm code")
563
DEFINE_INT(trace_wasm_ast_start, 0,
564 565
           "start function for wasm AST trace (inclusive)")
DEFINE_INT(trace_wasm_ast_end, 0, "end function for wasm AST trace (exclusive)")
566
DEFINE_BOOL(liftoff, false,
567
            "enable Liftoff, the baseline compiler for WebAssembly")
568
DEFINE_DEBUG_BOOL(trace_liftoff, false,
569
                  "trace Liftoff, the baseline compiler for WebAssembly")
570 571
DEFINE_DEBUG_BOOL(wasm_break_on_decoder_error, false,
                  "debug break when wasm decoder encounters an error")
572
DEFINE_BOOL(trace_wasm_memory, false,
573
            "print all memory updates performed in wasm code")
574 575 576 577
// Fuzzers use {wasm_tier_mask_for_testing} together with {liftoff} and
// {no_wasm_tier_up} to force some functions to be compiled with Turbofan.
DEFINE_INT(wasm_tier_mask_for_testing, 0,
           "bitmask of functions to compile with TurboFan instead of Liftoff")
578

579
DEFINE_BOOL(validate_asm, true, "validate asm.js modules before compiling")
580 581
DEFINE_BOOL(suppress_asm_messages, false,
            "don't emit asm.js related messages (for golden file testing)")
582
DEFINE_BOOL(trace_asm_time, false, "log asm.js timing info to the console")
583 584
DEFINE_BOOL(trace_asm_scanner, false,
            "log tokens encountered by asm.js scanner")
585
DEFINE_BOOL(trace_asm_parser, false, "verbose logging of asm.js parse failures")
586
DEFINE_BOOL(stress_validate_asm, false, "try to validate everything as asm.js")
587

588
DEFINE_DEBUG_BOOL(dump_wasm_module, false, "dump wasm module bytes")
589 590
DEFINE_STRING(dump_wasm_module_path, nullptr,
              "directory to dump wasm modules to")
591

592 593 594 595 596 597 598 599 600 601 602 603
// Declare command-line flags for WASM features. Warning: avoid using these
// flags directly in the implementation. Instead accept wasm::WasmFeatures
// for configurability.
#include "src/wasm/wasm-feature-flags.h"

#define SPACE
#define DECL_WASM_FLAG(feat, desc, val)      \
  DEFINE_BOOL(experimental_wasm_##feat, val, \
              "enable prototype " desc " for wasm")
FOREACH_WASM_FEATURE_FLAG(DECL_WASM_FLAG, SPACE)
#undef DECL_WASM_FLAG
#undef SPACE
604

605
DEFINE_BOOL(wasm_opt, false, "enable wasm optimization")
606 607 608 609 610
DEFINE_BOOL(wasm_no_bounds_checks, false,
            "disable bounds checks (performance testing only)")
DEFINE_BOOL(wasm_no_stack_checks, false,
            "disable stack checks (performance testing only)")

611
DEFINE_BOOL(wasm_shared_engine, true,
612
            "shares one wasm engine between all isolates within a process")
613
DEFINE_IMPLICATION(future, wasm_shared_engine)
614
DEFINE_BOOL(wasm_shared_code, true,
615
            "shares code underlying a wasm module when it is transferred")
616
DEFINE_IMPLICATION(future, wasm_shared_code)
617
DEFINE_BOOL(wasm_trap_handler, true,
618
            "use signal handlers to catch out of bounds memory access in wasm"
619
            " (currently Linux x86_64 only)")
620 621
DEFINE_BOOL(wasm_trap_handler_fallback, false,
            "Use bounds checks if guarded memory is not available")
622 623 624
DEFINE_BOOL(wasm_fuzzer_gen_test, false,
            "Generate a test case when running a wasm fuzzer")
DEFINE_IMPLICATION(wasm_fuzzer_gen_test, single_threaded)
625
DEFINE_BOOL(print_wasm_code, false, "Print WebAssembly code")
626 627
DEFINE_BOOL(wasm_interpret_all, false,
            "Execute all wasm code in the wasm interpreter")
628 629
DEFINE_BOOL(asm_wasm_lazy_compilation, false,
            "enable lazy compilation for asm-wasm modules")
630
DEFINE_IMPLICATION(validate_asm, asm_wasm_lazy_compilation)
631 632
DEFINE_BOOL(wasm_lazy_compilation, false,
            "enable lazy compilation for all wasm modules")
633 634
DEFINE_DEBUG_BOOL(trace_wasm_lazy_compilation, false,
                  "trace lazy compilation of wasm functions")
635 636 637
// wasm-interpret-all resets {asm-,}wasm-lazy-compilation.
DEFINE_NEG_IMPLICATION(wasm_interpret_all, asm_wasm_lazy_compilation)
DEFINE_NEG_IMPLICATION(wasm_interpret_all, wasm_lazy_compilation)
638

639
// Profiler flags.
640
DEFINE_INT(frame_count, 1, "number of stack frames inspected by the profiler")
641
DEFINE_INT(type_info_threshold, 25,
642
           "percentage of ICs that must have type info to allow optimization")
643

644 645 646
DEFINE_INT(stress_sampling_allocation_profiler, 0,
           "Enables sampling allocation profiler with X as a sample interval")

647
// Garbage collections flags.
648 649 650 651 652 653
DEFINE_SIZE_T(min_semi_space_size, 0,
              "min size of a semi-space (in MBytes), the new space consists of "
              "two semi-spaces")
DEFINE_SIZE_T(max_semi_space_size, 0,
              "max size of a semi-space (in MBytes), the new space consists of "
              "two semi-spaces")
654 655 656 657
DEFINE_INT(semi_space_growth_factor, 2, "factor by which to grow the new space")
DEFINE_BOOL(experimental_new_space_growth_heuristic, false,
            "Grow the new space based on the percentage of survivors instead "
            "of their absolute value.")
658 659
DEFINE_SIZE_T(max_old_space_size, 0, "max size of the old space (in Mbytes)")
DEFINE_SIZE_T(initial_old_space_size, 0, "initial old space size (in Mbytes)")
660
DEFINE_BOOL(gc_global, false, "always perform global GCs")
661 662 663
DEFINE_INT(random_gc_interval, 0,
           "Collect garbage after random(0, X) allocations. It overrides "
           "gc_interval.")
664
DEFINE_INT(gc_interval, -1, "garbage collect after <n> allocations")
665
DEFINE_INT(retain_maps_for_n_gc, 2,
666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681
           "keeps maps alive for <n> old space garbage collections")
DEFINE_BOOL(trace_gc, false,
            "print one trace line following each garbage collection")
DEFINE_BOOL(trace_gc_nvp, false,
            "print one detailed trace line in name=value format "
            "after each garbage collection")
DEFINE_BOOL(trace_gc_ignore_scavenger, false,
            "do not print trace line after scavenger collection")
DEFINE_BOOL(trace_idle_notification, false,
            "print one trace line following each idle notification")
DEFINE_BOOL(trace_idle_notification_verbose, false,
            "prints the heap state used by the idle notification")
DEFINE_BOOL(trace_gc_verbose, false,
            "print more details following each garbage collection")
DEFINE_INT(trace_allocation_stack_interval, -1,
           "print stack trace after <n> free-list allocations")
682 683 684
DEFINE_INT(trace_duplicate_threshold_kb, 0,
           "print duplicate objects in the heap if their size is more than "
           "given threshold")
685 686 687 688 689 690 691 692 693
DEFINE_BOOL(trace_fragmentation, false, "report fragmentation for old space")
DEFINE_BOOL(trace_fragmentation_verbose, false,
            "report fragmentation for old space (detailed)")
DEFINE_BOOL(trace_evacuation, false, "report evacuation statistics")
DEFINE_BOOL(trace_mutator_utilization, false,
            "print mutator utilization, allocation speed, gc speed")
DEFINE_BOOL(incremental_marking, true, "use incremental marking")
DEFINE_BOOL(incremental_marking_wrappers, true,
            "use incremental marking for marking wrappers")
694
DEFINE_BOOL(trace_unmapper, false, "Trace the unmapping")
695
DEFINE_BOOL(parallel_scavenge, true, "parallel scavenge")
696
DEFINE_BOOL(trace_parallel_scavenge, false, "trace parallel scavenge")
697 698 699 700 701 702 703
#if defined(V8_TARGET_ARCH_ARM) || defined(V8_TARGET_ARCH_ARM64)
#define V8_WRITE_PROTECT_CODE_MEMORY_BOOL false
#else
#define V8_WRITE_PROTECT_CODE_MEMORY_BOOL true
#endif
DEFINE_BOOL(write_protect_code_memory, V8_WRITE_PROTECT_CODE_MEMORY_BOOL,
            "write protect code memory")
704 705 706 707 708 709 710
#ifdef V8_CONCURRENT_MARKING
#define V8_CONCURRENT_MARKING_BOOL true
#else
#define V8_CONCURRENT_MARKING_BOOL false
#endif
DEFINE_BOOL(concurrent_marking, V8_CONCURRENT_MARKING_BOOL,
            "use concurrent marking")
711
DEFINE_BOOL(parallel_marking, true, "use parallel marking in atomic pause")
712
DEFINE_INT(ephemeron_fixpoint_iterations, 10,
713 714
           "number of fixpoint iterations it takes to switch to linear "
           "ephemeron algorithm")
715
DEFINE_BOOL(trace_concurrent_marking, false, "trace concurrent marking")
716
DEFINE_BOOL(black_allocation, true, "use black allocation")
717 718
DEFINE_BOOL(concurrent_store_buffer, true,
            "use concurrent store buffer processing")
719 720 721 722
DEFINE_BOOL(concurrent_sweeping, true, "use concurrent sweeping")
DEFINE_BOOL(parallel_compaction, true, "use parallel compaction")
DEFINE_BOOL(parallel_pointer_update, true,
            "use parallel pointer update during compaction")
723 724
DEFINE_BOOL(detect_ineffective_gcs_near_heap_limit, true,
            "trigger out-of-memory failure to avoid GC storm near heap limit")
725 726
DEFINE_BOOL(trace_incremental_marking, false,
            "trace progress of the incremental marking")
727 728
DEFINE_BOOL(trace_stress_marking, false, "trace stress marking progress")
DEFINE_BOOL(trace_stress_scavenge, false, "trace stress scavenge progress")
729 730 731 732
DEFINE_BOOL(track_gc_object_stats, false,
            "track object counts and memory usage")
DEFINE_BOOL(trace_gc_object_stats, false,
            "trace object counts and memory usage")
733
DEFINE_BOOL(trace_zone_stats, false, "trace zone memory usage")
734 735
DEFINE_BOOL(track_retaining_path, false,
            "enable support for tracking retaining path")
736 737
DEFINE_BOOL(concurrent_array_buffer_freeing, true,
            "free array buffer allocations on a background thread")
738 739 740 741 742
DEFINE_INT(gc_stats, 0, "Used by tracing internally to enable gc statistics")
DEFINE_IMPLICATION(trace_gc_object_stats, track_gc_object_stats)
DEFINE_VALUE_IMPLICATION(track_gc_object_stats, gc_stats, 1)
DEFINE_VALUE_IMPLICATION(trace_gc_object_stats, gc_stats, 1)
DEFINE_NEG_IMPLICATION(trace_gc_object_stats, incremental_marking)
743
DEFINE_NEG_IMPLICATION(track_retaining_path, incremental_marking)
744
DEFINE_NEG_IMPLICATION(track_retaining_path, parallel_marking)
745
DEFINE_NEG_IMPLICATION(track_retaining_path, concurrent_marking)
746 747 748 749 750 751 752
DEFINE_BOOL(track_detached_contexts, true,
            "track native contexts that are expected to be garbage collected")
DEFINE_BOOL(trace_detached_contexts, false,
            "trace native contexts that are expected to be garbage collected")
DEFINE_IMPLICATION(trace_detached_contexts, track_detached_contexts)
#ifdef VERIFY_HEAP
DEFINE_BOOL(verify_heap, false, "verify heap pointers before and after GC")
753 754
DEFINE_BOOL(verify_heap_skip_remembered_set, false,
            "disable remembered set verification")
755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773
#endif
DEFINE_BOOL(move_object_start, true, "enable moving of object starts")
DEFINE_BOOL(memory_reducer, true, "use memory reducer")
DEFINE_INT(heap_growing_percent, 0,
           "specifies heap growing factor as (1 + heap_growing_percent/100)")
DEFINE_INT(v8_os_page_size, 0, "override OS page size (in KBytes)")
DEFINE_BOOL(always_compact, false, "Perform compaction on every full GC")
DEFINE_BOOL(never_compact, false,
            "Never perform compaction on full GC - testing only")
DEFINE_BOOL(compact_code_space, true, "Compact code space on full collections")
DEFINE_BOOL(use_marking_progress_bar, true,
            "Use a progress bar to scan large objects in increments when "
            "incremental marking is active.")
DEFINE_BOOL(force_marking_deque_overflows, false,
            "force overflows of marking deque by reducing it's size "
            "to 64 words")
DEFINE_BOOL(stress_compaction, false,
            "stress the GC compactor to flush out bugs (implies "
            "--force_marking_deque_overflows)")
774 775 776
DEFINE_BOOL(stress_compaction_random, false,
            "Stress GC compaction by selecting random percent of pages as "
            "evacuation candidates. It overrides stress_compaction.")
777
DEFINE_BOOL(stress_incremental_marking, false,
778
            "force incremental marking for small heaps and run it more often")
779 780

DEFINE_BOOL(fuzzer_gc_analysis, false,
781 782
            "prints number of allocations and enables analysis mode for gc "
            "fuzz testing, e.g. --stress-marking, --stress-scavenge")
783 784 785
DEFINE_INT(stress_marking, 0,
           "force marking at random points between 0 and X (inclusive) percent "
           "of the regular marking start limit")
786 787 788
DEFINE_INT(stress_scavenge, 0,
           "force scavenge at random points between 0 and X (inclusive) "
           "percent of the new space capacity")
789 790
DEFINE_IMPLICATION(fuzzer_gc_analysis, stress_marking)
DEFINE_IMPLICATION(fuzzer_gc_analysis, stress_scavenge)
791

792 793
DEFINE_BOOL(disable_abortjs, false, "disables AbortJS runtime function")

794 795 796 797 798 799
DEFINE_BOOL(manual_evacuation_candidates_selection, false,
            "Test mode only flag. It allows an unit test to select evacuation "
            "candidates pages (requires --stress_compaction).")
DEFINE_BOOL(fast_promotion_new_space, false,
            "fast promote new space on high survival rates")

800
DEFINE_BOOL(clear_free_memory, false, "initialize free memory with 0")
801

802 803 804 805
DEFINE_BOOL(young_generation_large_objects, false,
            "allocates large objects by default in the young generation large "
            "object space")

806 807
DEFINE_BOOL(idle_time_scavenge, true, "Perform scavenges in idle time.")

808
// assembler-ia32.cc / assembler-arm.cc / assembler-x64.cc
809 810
DEFINE_BOOL(debug_code, DEBUG_BOOL,
            "generate extra code (assertions) for debugging")
811 812 813
DEFINE_BOOL(code_comments, false,
            "emit comments in code disassembly; for more readable source "
            "positions you should add --no-concurrent_recompilation")
814
DEFINE_BOOL(enable_sse3, true, "enable use of SSE3 instructions if available")
815
DEFINE_BOOL(enable_ssse3, true, "enable use of SSSE3 instructions if available")
816
DEFINE_BOOL(enable_sse4_1, true,
817
            "enable use of SSE4.1 instructions if available")
818
DEFINE_BOOL(enable_sahf, true,
819
            "enable use of SAHF instruction if available (X64 only)")
820 821
DEFINE_BOOL(enable_avx, true, "enable use of AVX instructions if available")
DEFINE_BOOL(enable_fma3, true, "enable use of FMA3 instructions if available")
822 823 824 825 826
DEFINE_BOOL(enable_bmi1, true, "enable use of BMI1 instructions if available")
DEFINE_BOOL(enable_bmi2, true, "enable use of BMI2 instructions if available")
DEFINE_BOOL(enable_lzcnt, true, "enable use of LZCNT instruction if available")
DEFINE_BOOL(enable_popcnt, true,
            "enable use of POPCNT instruction if available")
827 828 829
DEFINE_STRING(arm_arch, ARM_ARCH_DEFAULT,
              "generate instructions for the selected ARM architecture if "
              "available: armv6, armv7, armv7+sudiv or armv8")
830
DEFINE_BOOL(force_long_branches, false,
831
            "force all emitted branches to be in long mode (MIPS/PPC only)")
832
DEFINE_STRING(mcpu, "auto", "enable optimization for specific cpu")
833 834
DEFINE_BOOL(partial_constant_pool, true,
            "enable use of partial constant pools (X64 only)")
835

836 837 838 839 840 841 842 843
// Deprecated ARM flags (replaced by arm_arch).
DEFINE_MAYBE_BOOL(enable_armv7, "deprecated (use --arm_arch instead)")
DEFINE_MAYBE_BOOL(enable_vfp3, "deprecated (use --arm_arch instead)")
DEFINE_MAYBE_BOOL(enable_32dregs, "deprecated (use --arm_arch instead)")
DEFINE_MAYBE_BOOL(enable_neon, "deprecated (use --arm_arch instead)")
DEFINE_MAYBE_BOOL(enable_sudiv, "deprecated (use --arm_arch instead)")
DEFINE_MAYBE_BOOL(enable_armv8, "deprecated (use --arm_arch instead)")

844 845 846 847
// regexp-macro-assembler-*.cc
DEFINE_BOOL(enable_regexp_unaligned_accesses, true,
            "enable unaligned accesses for the regexp engine")

848 849
// api.cc
DEFINE_BOOL(script_streaming, true, "enable parsing on background")
850 851 852
DEFINE_BOOL(disable_old_api_accessors, false,
            "Disable old-style API accessors whose setters trigger through the "
            "prototype chain")
853

854
// bootstrapper.cc
855
DEFINE_STRING(expose_natives_as, nullptr, "expose natives in global object")
856 857
DEFINE_BOOL(expose_free_buffer, false, "expose freeBuffer extension")
DEFINE_BOOL(expose_gc, false, "expose gc extension")
858
DEFINE_STRING(expose_gc_as, nullptr,
859
              "expose gc extension under the specified name")
860 861
DEFINE_IMPLICATION(expose_gc_as, expose_gc)
DEFINE_BOOL(expose_externalize_string, false,
862
            "expose externalize string extension")
863 864 865
DEFINE_BOOL(expose_trigger_failure, false, "expose trigger-failure extension")
DEFINE_INT(stack_trace_limit, 10, "number of stack frames to capture")
DEFINE_BOOL(builtins_in_stack_traces, false,
866
            "show built-in functions in stack traces")
867 868
DEFINE_BOOL(disallow_code_generation_from_strings, false,
            "disallow eval and friends")
869
DEFINE_BOOL(expose_async_hooks, false, "expose async_hooks object")
870

871 872 873
// builtins.cc
DEFINE_BOOL(allow_unsafe_function_constructor, false,
            "allow invoking the function constructor without security checks")
874
DEFINE_BOOL(force_slow_path, false, "always take the slow path for builtins")
875

876
// builtins-ia32.cc
877
DEFINE_BOOL(inline_new, true, "use fast inline allocation")
878 879

// codegen-ia32.cc / codegen-arm.cc
880
DEFINE_BOOL(trace, false, "trace function calls")
881 882

// codegen.cc
883 884
DEFINE_BOOL(lazy, true, "use lazy compilation")
DEFINE_BOOL(trace_opt, false, "trace lazy optimization")
885 886
DEFINE_BOOL(trace_opt_verbose, false, "extra verbose compilation tracing")
DEFINE_IMPLICATION(trace_opt_verbose, trace_opt)
887
DEFINE_BOOL(trace_opt_stats, false, "trace lazy optimization statistics")
888
DEFINE_BOOL(trace_deopt, false, "trace optimize function deoptimization")
889 890
DEFINE_BOOL(trace_file_names, false,
            "include file names in trace-opt/trace-deopt output")
891
DEFINE_BOOL(trace_interrupts, false, "trace interrupts when they are handled")
892 893 894
DEFINE_BOOL(always_opt, false, "always try to optimize functions")
DEFINE_BOOL(always_osr, false, "always try to OSR functions")
DEFINE_BOOL(prepare_always_opt, false, "prepare for turning on always opt")
895

896
DEFINE_BOOL(trace_serializer, false, "print code serializer trace")
897 898 899 900
#ifdef DEBUG
DEFINE_BOOL(external_reference_stats, false,
            "print statistics on external references used during serialization")
#endif  // DEBUG
901

902
// compilation-cache.cc
903
DEFINE_BOOL(compilation_cache, true, "enable compilation cache")
904

905
DEFINE_BOOL(cache_prototype_transitions, true, "cache prototype transitions")
906

907
// compiler-dispatcher.cc
908
DEFINE_BOOL(parallel_compile_tasks, false, "enable parallel compile tasks")
909
DEFINE_BOOL(compiler_dispatcher, false, "enable compiler dispatcher")
910
DEFINE_IMPLICATION(parallel_compile_tasks, compiler_dispatcher)
911 912 913
DEFINE_BOOL(trace_compiler_dispatcher, false,
            "trace compiler dispatcher activity")

914
// cpu-profiler.cc
915
DEFINE_INT(cpu_profiler_sampling_interval, 1000,
916 917
           "CPU profiler sampling interval in microseconds")

918
// Array abuse tracing
919
DEFINE_BOOL(trace_js_array_abuse, false,
920
            "trace out-of-bounds accesses to JS arrays")
921
DEFINE_BOOL(trace_external_array_abuse, false,
922
            "trace out-of-bounds-accesses to external arrays")
923
DEFINE_BOOL(trace_array_abuse, false,
924
            "trace out-of-bounds accesses to all arrays")
925 926
DEFINE_IMPLICATION(trace_array_abuse, trace_js_array_abuse)
DEFINE_IMPLICATION(trace_array_abuse, trace_external_array_abuse)
927 928

// debugger
929 930 931
DEFINE_BOOL(
    trace_side_effect_free_debug_evaluate, false,
    "print debug messages for side-effect-free debug-evaluate for testing")
932
DEFINE_BOOL(hard_abort, true, "abort by crashing")
933

934 935 936 937
// inspector
DEFINE_BOOL(expose_inspector_scripts, false,
            "expose injected-script-source.js for debugging")

938
// execution.cc
939 940
DEFINE_INT(stack_size, V8_DEFAULT_STACK_SIZE_KB,
           "default size of stack region v8 is allowed to use (in kBytes)")
941

942
// frames.cc
943
DEFINE_INT(max_stack_trace_source_length, 300,
944 945
           "maximum length of function source code printed in a stack trace.")

946
// execution.cc, messages.cc
947
DEFINE_BOOL(clear_exceptions_on_js_entry, false,
948 949
            "clear pending exceptions when entering JavaScript")

950 951 952 953
// counters.cc
DEFINE_INT(histogram_interval, 600000,
           "time interval in ms for aggregating memory histograms")

954
// heap-snapshot-generator.cc
955
DEFINE_BOOL(heap_profiler_trace_objects, false,
956
            "Dump heap object allocations/movements/size_updates")
957 958
DEFINE_BOOL(heap_profiler_use_embedder_graph, true,
            "Use the new EmbedderGraph API to get embedder nodes")
959 960
DEFINE_INT(heap_snapshot_string_limit, 1024,
           "truncate strings to this length in the heap snapshot")
961

962 963 964 965
// sampling-heap-profiler.cc
DEFINE_BOOL(sampling_heap_profiler_suppress_randomness, false,
            "Use constant sample intervals to eliminate test flakiness")

966
// v8.cc
967
DEFINE_BOOL(use_idle_notification, true,
968
            "Use idle notification to reduce memory footprint.")
969
// ic.cc
970 971
DEFINE_BOOL(trace_ic, false,
            "trace inline cache state transitions for tools/ic-processor")
972
DEFINE_IMPLICATION(trace_ic, log_code)
973 974
DEFINE_INT(ic_stats, 0, "inline cache state transitions statistics")
DEFINE_VALUE_IMPLICATION(trace_ic, ic_stats, 1)
975 976
DEFINE_BOOL_READONLY(track_constant_fields, false,
                     "enable constant field tracking")
977
DEFINE_BOOL_READONLY(modify_map_inplace, false, "enable in-place map updates")
978 979

// macro-assembler-ia32.cc
980
DEFINE_BOOL(native_code_counters, false,
981 982
            "generate extra code for manipulating stats counters")

983
// objects.cc
984
DEFINE_BOOL(thin_strings, true, "Enable ThinString support")
985 986
DEFINE_BOOL(trace_prototype_users, false,
            "Trace updates to prototype user tracking")
987
DEFINE_BOOL(use_verbose_printer, true, "allows verbose printing")
988
DEFINE_BOOL(trace_for_in_enumerate, false, "Trace for-in enumerate slow-paths")
989
DEFINE_BOOL(trace_maps, false, "trace map creation")
Camillo Bruni's avatar
Camillo Bruni committed
990
DEFINE_BOOL(trace_maps_details, true, "also log map details")
991
DEFINE_IMPLICATION(trace_maps, log_code)
992

993
// parser.cc
994
DEFINE_BOOL(allow_natives_syntax, false, "allow natives syntax")
995

996
// simulator-arm.cc, simulator-arm64.cc and simulator-mips.cc
997 998 999
DEFINE_BOOL(trace_sim, false, "Trace simulator execution")
DEFINE_BOOL(debug_sim, false, "Enable debugging the simulator")
DEFINE_BOOL(check_icache, false,
1000
            "Check icache flushes in ARM and MIPS simulator")
1001
DEFINE_INT(stop_sim_at, 0, "Simulator stop after x number of instructions")
1002 1003
#if defined(V8_TARGET_ARCH_ARM64) || defined(V8_TARGET_ARCH_MIPS64) || \
    defined(V8_TARGET_ARCH_PPC64)
1004
DEFINE_INT(sim_stack_alignment, 16,
1005 1006 1007
           "Stack alignment in bytes in simulator. This must be a power of two "
           "and it must be at least 16. 16 is default.")
#else
1008
DEFINE_INT(sim_stack_alignment, 8,
1009
           "Stack alingment in bytes in simulator (4 or 8, 8 is default)")
1010
#endif
1011
DEFINE_INT(sim_stack_size, 2 * MB / KB,
1012
           "Stack size of the ARM64, MIPS64 and PPC64 simulator "
1013
           "in kBytes (default is 2 MB)")
1014 1015
DEFINE_BOOL(log_colour, ENABLE_LOG_COLOUR,
            "When logging, try to use coloured output.")
1016
DEFINE_BOOL(ignore_asm_unimplemented_break, false,
1017
            "Don't break for ASM_UNIMPLEMENTED_BREAK macros.")
1018
DEFINE_BOOL(trace_sim_messages, false,
1019
            "Trace simulator debug messages. Implied by --trace-sim.")
1020

1021
// isolate.cc
1022 1023 1024
DEFINE_BOOL(async_stack_traces, false,
            "include async stack traces in Error.stack")
DEFINE_IMPLICATION(async_stack_traces, harmony_await_optimization)
1025
DEFINE_BOOL(stack_trace_on_illegal, false,
1026
            "print stack trace when an illegal exception is thrown")
1027
DEFINE_BOOL(abort_on_uncaught_exception, false,
1028
            "abort program (dump core) when an uncaught exception is thrown")
1029 1030 1031 1032 1033
DEFINE_BOOL(abort_on_stack_or_string_length_overflow, false,
            "Abort program when the stack overflows or a string exceeds "
            "maximum length (as opposed to throwing RangeError). This is "
            "useful for fuzzing where the spec behaviour would introduce "
            "nondeterminism.")
1034
DEFINE_BOOL(randomize_hashes, true,
1035
            "randomize hashes to avoid predictable hash collisions "
1036
            "(with snapshots this option cannot override the baked-in seed)")
1037 1038
DEFINE_BOOL(rehash_snapshot, true,
            "rehash strings from the snapshot to override the baked-in seed")
Yang Guo's avatar
Yang Guo committed
1039 1040 1041
DEFINE_UINT64(hash_seed, 0,
              "Fixed seed to use to hash property keys (0 means random)"
              "(with snapshots this option cannot override the baked-in seed)")
1042 1043 1044
DEFINE_INT(random_seed, 0,
           "Default seed for initializing random generator "
           "(0, the default, means to use system random).")
1045 1046
DEFINE_INT(fuzzer_random_seed, 0,
           "Default seed for initializing fuzzer random generator "
1047
           "(0, the default, means to use v8's random number generator seed).")
hpayer's avatar
hpayer committed
1048
DEFINE_BOOL(trace_rail, false, "trace RAIL mode")
1049 1050
DEFINE_BOOL(print_all_exceptions, false,
            "print exception object and stack trace on each thrown exception")
1051

1052 1053
// runtime.cc
DEFINE_BOOL(runtime_call_stats, false, "report runtime call counts and times")
1054 1055 1056
DEFINE_INT(runtime_stats, 0,
           "internal usage only for controlling runtime statistics")
DEFINE_VALUE_IMPLICATION(runtime_call_stats, runtime_stats, 1)
1057

1058
// snapshot-common.cc
1059 1060 1061 1062 1063 1064 1065
#ifdef V8_EMBEDDED_BUILTINS
#define V8_EMBEDDED_BUILTINS_BOOL true
#else
#define V8_EMBEDDED_BUILTINS_BOOL false
#endif
DEFINE_BOOL_READONLY(embedded_builtins, V8_EMBEDDED_BUILTINS_BOOL,
                     "Embed builtin code into the binary.")
1066
// TODO(jgruber,v8:6666): Remove once ia32 has full embedded builtin support.
1067
DEFINE_BOOL_READONLY(
1068
    ia32_verify_root_register, false,
1069
    "Check that the value of the root register was not clobbered.")
1070
DEFINE_BOOL(profile_deserialization, false,
1071
            "Print the time it takes to deserialize the snapshot.")
1072 1073
DEFINE_BOOL(serialization_statistics, false,
            "Collect statistics on serialized objects.")
1074 1075
DEFINE_UINT(serialization_chunk_size, 4096,
            "Custom size for serialization chunks")
1076

erik.corry@gmail.com's avatar
erik.corry@gmail.com committed
1077
// Regexp
1078
DEFINE_BOOL(regexp_optimization, true, "generate optimized regexp code")
1079
DEFINE_BOOL(regexp_mode_modifiers, false, "enable inline flags in regexp.")
1080

1081
// Testing flags test/cctest/test-{flags,api,serialization}.cc
1082 1083 1084 1085 1086 1087
DEFINE_BOOL(testing_bool_flag, true, "testing_bool_flag")
DEFINE_MAYBE_BOOL(testing_maybe_bool_flag, "testing_maybe_bool_flag")
DEFINE_INT(testing_int_flag, 13, "testing_int_flag")
DEFINE_FLOAT(testing_float_flag, 2.5, "float-flag")
DEFINE_STRING(testing_string_flag, "Hello, world!", "string-flag")
DEFINE_INT(testing_prng_seed, 42, "Seed used for threading test randomness")
1088

1089
// mksnapshot.cc
1090 1091
DEFINE_STRING(embedded_src, nullptr,
              "Path for the generated embedded data file. (mksnapshot only)")
1092 1093 1094
DEFINE_STRING(
    embedded_variant, nullptr,
    "Label to disambiguate symbols in embedded data file. (mksnapshot only)")
1095
DEFINE_STRING(startup_src, nullptr,
1096
              "Write V8 startup as C++ src. (mksnapshot only)")
1097
DEFINE_STRING(startup_blob, nullptr,
1098
              "Write V8 startup blob file. (mksnapshot only)")
1099

1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110
//
// Minor mark compact collector flags.
//
#ifdef ENABLE_MINOR_MC
DEFINE_BOOL(minor_mc_parallel_marking, true,
            "use parallel marking for the young generation")
DEFINE_BOOL(trace_minor_mc_parallel_marking, false,
            "trace parallel marking for the young generation")
DEFINE_BOOL(minor_mc, false, "perform young generation mark compact GCs")
#endif  // ENABLE_MINOR_MC

1111 1112 1113
//
// Dev shell flags
//
1114

1115 1116
DEFINE_BOOL(help, false, "Print usage message, including flags, on console")
DEFINE_BOOL(dump_counters, false, "Dump counters on exit")
1117 1118
DEFINE_BOOL(dump_counters_nvp, false,
            "Dump counters as name-value pairs on exit")
1119
DEFINE_BOOL(use_external_strings, false, "Use external strings for source code")
1120

1121
DEFINE_STRING(map_counters, "", "Map counters to a file")
1122 1123
DEFINE_BOOL(mock_arraybuffer_allocator, false,
            "Use a mock ArrayBuffer allocator for testing.")
1124 1125 1126
DEFINE_SIZE_T(mock_arraybuffer_allocator_limit, 0,
              "Memory limit for mock ArrayBuffer allocator used to simulate "
              "OOM for testing.")
1127

1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139
//
// Flags only available in non-Lite modes.
//
#undef FLAG
#ifdef V8_LITE_MODE
#define FLAG FLAG_READONLY
#define V8_LITE_BOOL true
#else
#define FLAG FLAG_FULL
#define V8_LITE_BOOL false
#endif

1140 1141 1142
// Enable recompilation of function with optimized code.
DEFINE_BOOL(opt, !V8_LITE_BOOL, "use adaptive optimizations")

1143 1144 1145
// Enable use of inline caches to optimize object access operations.
DEFINE_BOOL(use_ic, !V8_LITE_BOOL, "use inline caching")

1146 1147 1148 1149 1150 1151
// Favor memory over execution speed.
DEFINE_BOOL(optimize_for_size, V8_LITE_BOOL,
            "Enables optimizations which favor memory size over execution "
            "speed")
DEFINE_VALUE_IMPLICATION(optimize_for_size, max_semi_space_size, 1)

1152 1153 1154
//
// GDB JIT integration flags.
//
1155 1156 1157 1158 1159 1160
#undef FLAG
#ifdef ENABLE_GDB_JIT_INTERFACE
#define FLAG FLAG_FULL
#else
#define FLAG FLAG_READONLY
#endif
1161

1162
DEFINE_BOOL(gdbjit, false, "enable GDBJIT interface")
1163 1164 1165
DEFINE_BOOL(gdbjit_full, false, "enable GDBJIT interface for all code objects")
DEFINE_BOOL(gdbjit_dump, false, "dump elf objects with debug info to disk")
DEFINE_STRING(gdbjit_dump_filter, "",
1166
              "dump only objects containing this substring")
1167

1168 1169 1170 1171 1172
#ifdef ENABLE_GDB_JIT_INTERFACE
DEFINE_IMPLICATION(gdbjit_full, gdbjit)
DEFINE_IMPLICATION(gdbjit_dump, gdbjit)
#endif
DEFINE_NEG_IMPLICATION(gdbjit, compact_code_space)
1173

1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184
//
// Debug only flags
//
#undef FLAG
#ifdef DEBUG
#define FLAG FLAG_FULL
#else
#define FLAG FLAG_READONLY
#endif

// checks.cc
1185
#ifdef ENABLE_SLOW_DCHECKS
1186
DEFINE_BOOL(enable_slow_asserts, true,
1187
            "enable asserts that are slow to execute")
1188
#endif
1189

1190
// codegen-ia32.cc / codegen-arm.cc / macro-assembler-*.cc
1191 1192
DEFINE_BOOL(print_ast, false, "print source AST")
DEFINE_BOOL(trap_on_abort, false, "replace aborts by breakpoints")
1193 1194

// compiler.cc
1195 1196
DEFINE_BOOL(print_builtin_scopes, false, "print scopes for builtins")
DEFINE_BOOL(print_scopes, false, "print scopes")
1197 1198

// contexts.cc
1199
DEFINE_BOOL(trace_contexts, false, "trace contexts operations")
1200 1201

// heap.cc
1202 1203 1204
DEFINE_BOOL(gc_verbose, false, "print stuff during garbage collection")
DEFINE_BOOL(code_stats, false, "report code statistics after GC")
DEFINE_BOOL(print_handles, false, "report handles after GC")
1205 1206
DEFINE_BOOL(check_handle_count, false,
            "Check that there are not too many handles at GC")
1207
DEFINE_BOOL(print_global_handles, false, "report global handles after GC")
1208

1209
// TurboFan debug-only flags.
1210
DEFINE_BOOL(trace_turbo_escape, false, "enable tracing in escape analysis")
1211

1212
// objects.cc
1213 1214
DEFINE_BOOL(trace_module_status, false,
            "Trace status transitions of ECMAScript modules")
1215
DEFINE_BOOL(trace_normalization, false,
1216 1217 1218
            "prints when objects are turned into dictionaries.")

// runtime.cc
1219
DEFINE_BOOL(trace_lazy, false, "trace lazy compilation")
1220 1221

// spaces.cc
1222
DEFINE_BOOL(collect_heap_spill_statistics, false,
1223 1224
            "report heap spill statistics along with heap_stats "
            "(requires heap_stats)")
1225
DEFINE_BOOL(trace_isolates, false, "trace isolate state changes")
1226

erik.corry@gmail.com's avatar
erik.corry@gmail.com committed
1227
// Regexp
1228
DEFINE_BOOL(regexp_possessive_quantifier, false,
1229
            "enable possessive quantifier syntax for testing")
1230 1231
DEFINE_BOOL(trace_regexp_bytecodes, false, "trace regexp bytecode execution")
DEFINE_BOOL(trace_regexp_assembler, false,
erik.corry@gmail.com's avatar
erik.corry@gmail.com committed
1232
            "trace regexp macro assembler calls.")
1233
DEFINE_BOOL(trace_regexp_parser, false, "trace regexp parsing")
1234

1235 1236 1237
// Debugger
DEFINE_BOOL(print_break_location, false, "print source location on debug break")

1238
// wasm instance management
1239 1240
DEFINE_DEBUG_BOOL(trace_wasm_instances, false,
                  "trace creation and collection of wasm instances")
1241

1242
//
1243
// Logging and profiling flags
1244 1245 1246 1247 1248
//
#undef FLAG
#define FLAG FLAG_FULL

// log.cc
1249
DEFINE_BOOL(log, false,
1250
            "Minimal logging (no API, code, GC, suspect, or handles samples).")
1251 1252 1253
DEFINE_BOOL(log_all, false, "Log all events to the log file.")
DEFINE_BOOL(log_api, false, "Log API events to the log file.")
DEFINE_BOOL(log_code, false,
1254
            "Log code events to the log file without profiling.")
1255 1256
DEFINE_BOOL(log_handles, false, "Log global handle events.")
DEFINE_BOOL(log_suspect, false, "Log suspect operations.")
1257
DEFINE_BOOL(log_source_code, false, "Log source code.")
1258 1259 1260
DEFINE_BOOL(log_function_events, false,
            "Log function events "
            "(parse, compile, execute) separately.")
1261
DEFINE_BOOL(prof, false,
1262
            "Log statistical profiling information (implies --log-code).")
1263

1264
DEFINE_BOOL(detailed_line_info, false,
1265 1266
            "Always generate detailed line information for CPU profiling.")

1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277
#if defined(ANDROID)
// Phones and tablets have processors that are much slower than desktop
// and laptop computers for which current heuristics are tuned.
#define DEFAULT_PROF_SAMPLING_INTERVAL 5000
#else
#define DEFAULT_PROF_SAMPLING_INTERVAL 1000
#endif
DEFINE_INT(prof_sampling_interval, DEFAULT_PROF_SAMPLING_INTERVAL,
           "Interval for --prof samples (in microseconds).")
#undef DEFAULT_PROF_SAMPLING_INTERVAL

jkummerow's avatar
jkummerow committed
1278 1279
DEFINE_BOOL(prof_cpp, false, "Like --prof, but ignore generated code.")
DEFINE_IMPLICATION(prof, prof_cpp)
1280
DEFINE_BOOL(prof_browser_mode, true,
1281
            "Used with --prof, turns on browser-compatible mode for profiling.")
1282 1283 1284
DEFINE_STRING(logfile, "v8.log", "Specify the name of the log file.")
DEFINE_BOOL(logfile_per_isolate, true, "Separate log files for each isolate.")
DEFINE_BOOL(ll_prof, false, "Enable low-level linux profiler.")
1285 1286 1287
DEFINE_BOOL(interpreted_frames_native_stack, false,
            "Show interpreted frames on the native stack (useful for external "
            "profilers).")
1288
DEFINE_BOOL(perf_basic_prof, false,
1289
            "Enable perf linux profiler (basic support).")
1290
DEFINE_NEG_IMPLICATION(perf_basic_prof, compact_code_space)
1291 1292 1293
DEFINE_BOOL(perf_basic_prof_only_functions, false,
            "Only report function code ranges to perf (i.e. no stubs).")
DEFINE_IMPLICATION(perf_basic_prof_only_functions, perf_basic_prof)
1294 1295 1296
DEFINE_BOOL(perf_prof, false,
            "Enable perf linux profiler (experimental annotate support).")
DEFINE_NEG_IMPLICATION(perf_prof, compact_code_space)
1297 1298
DEFINE_BOOL(perf_prof_unwinding_info, false,
            "Enable unwinding info for perf linux profiler (experimental).")
1299
DEFINE_IMPLICATION(perf_prof, perf_prof_unwinding_info)
1300
DEFINE_STRING(gc_fake_mmap, "/tmp/__v8_gc__",
1301
              "Specify the name of the file for fake gc mmap used in ll_prof")
1302 1303
DEFINE_BOOL(log_internal_timer_events, false, "Time internal events.")
DEFINE_BOOL(log_timer_events, false,
1304
            "Time events including external callbacks.")
1305 1306 1307 1308
DEFINE_IMPLICATION(log_timer_events, log_internal_timer_events)
DEFINE_IMPLICATION(log_internal_timer_events, prof)
DEFINE_BOOL(log_instruction_stats, false, "Log AArch64 instruction statistics.")
DEFINE_STRING(log_instruction_file, "arm64_inst.csv",
1309
              "AArch64 instruction statistics log file.")
1310
DEFINE_INT(log_instruction_period, 1 << 22,
1311
           "AArch64 instruction statistics logging period.")
1312

1313
DEFINE_BOOL(redirect_code_traces, false,
1314 1315
            "output deopt information and disassembly into file "
            "code-<pid>-<isolate id>.asm")
1316
DEFINE_STRING(redirect_code_traces_to, nullptr,
1317
              "output deopt information and disassembly into the given file")
1318

1319 1320 1321
DEFINE_BOOL(print_opt_source, false,
            "print source code of optimized and inlined functions")

1322 1323 1324 1325 1326 1327 1328 1329 1330 1331
//
// Disassembler only flags
//
#undef FLAG
#ifdef ENABLE_DISASSEMBLER
#define FLAG FLAG_FULL
#else
#define FLAG FLAG_READONLY
#endif

1332
// elements.cc
1333
DEFINE_BOOL(trace_elements_transitions, false, "trace elements transitions")
1334

1335
DEFINE_BOOL(trace_creation_allocation_sites, false,
1336 1337
            "trace the creation of allocation sites")

1338
// code-stubs.cc
1339 1340
DEFINE_BOOL(print_code_stubs, false, "print code stubs")
DEFINE_BOOL(test_secondary_stub_cache, false,
1341 1342
            "test secondary stub cache by disabling the primary one")

1343
DEFINE_BOOL(test_primary_stub_cache, false,
1344
            "test primary stub cache by disabling the secondary one")
1345

1346 1347 1348
DEFINE_BOOL(test_small_max_function_context_stub_size, false,
            "enable testing the function context size overflow path "
            "by making the maximum size smaller")
1349

1350
// codegen-ia32.cc / codegen-arm.cc
1351 1352
DEFINE_BOOL(print_code, false, "print generated code")
DEFINE_BOOL(print_opt_code, false, "print optimized code")
1353
DEFINE_STRING(print_opt_code_filter, "*", "filter for printing optimized code")
1354 1355
DEFINE_BOOL(print_code_verbose, false, "print more information for code")
DEFINE_BOOL(print_builtin_code, false, "print generated code for builtins")
1356 1357
DEFINE_STRING(print_builtin_code_filter, "*",
              "filter for printing builtin code")
1358
DEFINE_BOOL(print_builtin_size, false, "print code size for builtins")
1359

1360
#ifdef ENABLE_DISASSEMBLER
1361 1362
DEFINE_BOOL(sodium, false,
            "print generated code output suitable for use with "
1363 1364
            "the Sodium code viewer")

1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376
DEFINE_IMPLICATION(sodium, print_code_stubs)
DEFINE_IMPLICATION(sodium, print_code)
DEFINE_IMPLICATION(sodium, print_opt_code)
DEFINE_IMPLICATION(sodium, code_comments)

DEFINE_BOOL(print_all_code, false, "enable all flags related to printing code")
DEFINE_IMPLICATION(print_all_code, print_code)
DEFINE_IMPLICATION(print_all_code, print_opt_code)
DEFINE_IMPLICATION(print_all_code, print_code_verbose)
DEFINE_IMPLICATION(print_all_code, print_builtin_code)
DEFINE_IMPLICATION(print_all_code, print_code_stubs)
DEFINE_IMPLICATION(print_all_code, code_comments)
1377 1378
#endif

mlippautz's avatar
mlippautz committed
1379 1380
#undef FLAG
#define FLAG FLAG_FULL
1381

1382 1383 1384 1385 1386 1387 1388
//
// Predictable mode related flags.
//

DEFINE_BOOL(predictable, false, "enable predictable mode")
DEFINE_IMPLICATION(predictable, single_threaded)
DEFINE_NEG_IMPLICATION(predictable, memory_reducer)
1389
DEFINE_VALUE_IMPLICATION(single_threaded, wasm_num_compilation_tasks, 0)
1390
DEFINE_NEG_IMPLICATION(single_threaded, wasm_async_compilation)
1391

1392 1393 1394 1395 1396 1397 1398 1399 1400
DEFINE_BOOL(predictable_gc_schedule, false,
            "Predictable garbage collection schedule. Fixes heap growing, "
            "idle, and memory reducing behavior.")
DEFINE_VALUE_IMPLICATION(predictable_gc_schedule, min_semi_space_size, 4)
DEFINE_VALUE_IMPLICATION(predictable_gc_schedule, max_semi_space_size, 4)
DEFINE_VALUE_IMPLICATION(predictable_gc_schedule, heap_growing_percent, 30)
DEFINE_NEG_IMPLICATION(predictable_gc_schedule, idle_time_scavenge)
DEFINE_NEG_IMPLICATION(predictable_gc_schedule, memory_reducer)

1401
//
mlippautz's avatar
mlippautz committed
1402 1403 1404 1405
// Threading related flags.
//

DEFINE_BOOL(single_threaded, false, "disable the use of background tasks")
1406
DEFINE_IMPLICATION(single_threaded, single_threaded_gc)
mlippautz's avatar
mlippautz committed
1407
DEFINE_NEG_IMPLICATION(single_threaded, concurrent_recompilation)
1408
DEFINE_NEG_IMPLICATION(single_threaded, compiler_dispatcher)
mlippautz's avatar
mlippautz committed
1409

1410 1411 1412 1413 1414 1415 1416
//
// Parallel and concurrent GC (Orinoco) related flags.
//
DEFINE_BOOL(single_threaded_gc, false, "disable the use of background gc tasks")
DEFINE_NEG_IMPLICATION(single_threaded_gc, concurrent_marking)
DEFINE_NEG_IMPLICATION(single_threaded_gc, concurrent_sweeping)
DEFINE_NEG_IMPLICATION(single_threaded_gc, parallel_compaction)
1417
DEFINE_NEG_IMPLICATION(single_threaded_gc, parallel_marking)
1418 1419 1420
DEFINE_NEG_IMPLICATION(single_threaded_gc, parallel_pointer_update)
DEFINE_NEG_IMPLICATION(single_threaded_gc, parallel_scavenge)
DEFINE_NEG_IMPLICATION(single_threaded_gc, concurrent_store_buffer)
1421
#ifdef ENABLE_MINOR_MC
1422
DEFINE_NEG_IMPLICATION(single_threaded_gc, minor_mc_parallel_marking)
1423
#endif  // ENABLE_MINOR_MC
1424
DEFINE_NEG_IMPLICATION(single_threaded_gc, concurrent_array_buffer_freeing)
1425

1426 1427 1428 1429 1430 1431 1432 1433
#undef FLAG

#ifdef VERIFY_PREDICTABLE
#define FLAG FLAG_FULL
#else
#define FLAG FLAG_READONLY
#endif

1434
DEFINE_BOOL(verify_predictable, false,
1435
            "this mode is used for checking that V8 behaves predictably")
1436
DEFINE_INT(dump_allocations_digest_at_alloc, -1,
1437
           "dump allocations digest each n-th allocation")
1438

1439 1440 1441 1442 1443 1444
//
// Read-only flags
//
#undef FLAG
#define FLAG FLAG_READONLY

1445
// assembler.h
1446
DEFINE_BOOL(enable_embedded_constant_pool, V8_EMBEDDED_CONSTANT_POOL,
1447
            "enable use of embedded constant pools (PPC only)")
1448

1449 1450 1451 1452
DEFINE_BOOL(unbox_double_fields, V8_DOUBLE_FIELDS_UNBOXING,
            "enable in-object double fields unboxing (64-bit only)")
DEFINE_IMPLICATION(unbox_double_fields, track_double_fields)

1453 1454 1455 1456
DEFINE_BOOL(lite_mode, V8_LITE_BOOL,
            "enables trade-off of performance for memory savings "
            "(Lite mode only)")

1457 1458 1459 1460
// Cleanup...
#undef FLAG_FULL
#undef FLAG_READONLY
#undef FLAG
1461
#undef FLAG_ALIAS
1462

1463 1464
#undef DEFINE_BOOL
#undef DEFINE_MAYBE_BOOL
1465
#undef DEFINE_DEBUG_BOOL
1466 1467 1468 1469 1470
#undef DEFINE_INT
#undef DEFINE_STRING
#undef DEFINE_FLOAT
#undef DEFINE_IMPLICATION
#undef DEFINE_NEG_IMPLICATION
1471
#undef DEFINE_NEG_VALUE_IMPLICATION
1472
#undef DEFINE_VALUE_IMPLICATION
1473 1474 1475 1476
#undef DEFINE_ALIAS_BOOL
#undef DEFINE_ALIAS_INT
#undef DEFINE_ALIAS_STRING
#undef DEFINE_ALIAS_FLOAT
1477 1478 1479 1480 1481

#undef FLAG_MODE_DECLARE
#undef FLAG_MODE_DEFINE
#undef FLAG_MODE_DEFINE_DEFAULTS
#undef FLAG_MODE_META
1482
#undef FLAG_MODE_DEFINE_IMPLICATIONS
1483 1484

#undef COMMA