1 // Copyright 2012 the V8 project authors. All rights reserved. 2 // Use of this source code is governed by a BSD-style license that can be 3 // found in the LICENSE file. 4 5 // This file defines all of the flags. It is separated into different section, 6 // for Debug, Release, Logging and Profiling, etc. To add a new flag, find the 7 // correct section, and use one of the DEFINE_ macros, without a trailing ';'. 8 // 9 // This include does not have a guard, because it is a template-style include, 10 // which can be included multiple times in different modes. It expects to have 11 // a mode defined before it's included. The modes are FLAG_MODE_... below: 12 13 #define DEFINE_IMPLICATION(whenflag, thenflag) \ 14 DEFINE_VALUE_IMPLICATION(whenflag, thenflag, true) 15 16 #define DEFINE_NEG_IMPLICATION(whenflag, thenflag) \ 17 DEFINE_VALUE_IMPLICATION(whenflag, thenflag, false) 18 19 #define DEFINE_NEG_NEG_IMPLICATION(whenflag, thenflag) \ 20 DEFINE_NEG_VALUE_IMPLICATION(whenflag, thenflag, false) 21 22 // We want to declare the names of the variables for the header file. Normally 23 // this will just be an extern declaration, but for a readonly flag we let the 24 // compiler make better optimizations by giving it the value. 25 #if defined(FLAG_MODE_DECLARE) 26 #define FLAG_FULL(ftype, ctype, nam, def, cmt) \ 27 V8_EXPORT_PRIVATE extern ctype FLAG_##nam; 28 #define FLAG_READONLY(ftype, ctype, nam, def, cmt) \ 29 static ctype const FLAG_##nam = def; 30 31 // We want to supply the actual storage and value for the flag variable in the 32 // .cc file. We only do this for writable flags. 33 #elif defined(FLAG_MODE_DEFINE) 34 #ifdef USING_V8_SHARED 35 #define FLAG_FULL(ftype, ctype, nam, def, cmt) \ 36 V8_EXPORT_PRIVATE extern ctype FLAG_##nam; 37 #else 38 #define FLAG_FULL(ftype, ctype, nam, def, cmt) \ 39 V8_EXPORT_PRIVATE ctype FLAG_##nam = def; 40 #endif 41 42 // We need to define all of our default values so that the Flag structure can 43 // access them by pointer. These are just used internally inside of one .cc, 44 // for MODE_META, so there is no impact on the flags interface. 45 #elif defined(FLAG_MODE_DEFINE_DEFAULTS) 46 #define FLAG_FULL(ftype, ctype, nam, def, cmt) \ 47 static ctype const FLAGDEFAULT_##nam = def; 48 49 // We want to write entries into our meta data table, for internal parsing and 50 // printing / etc in the flag parser code. We only do this for writable flags. 51 #elif defined(FLAG_MODE_META) 52 #define FLAG_FULL(ftype, ctype, nam, def, cmt) \ 53 { Flag::TYPE_##ftype, #nam, &FLAG_##nam, &FLAGDEFAULT_##nam, cmt, false } \ 54 , 55 #define FLAG_ALIAS(ftype, ctype, alias, nam) \ 56 { \ 57 Flag::TYPE_##ftype, #alias, &FLAG_##nam, &FLAGDEFAULT_##nam, \ 58 "alias for --" #nam, false \ 59 } \ 60 , 61 62 // We produce the code to set flags when it is implied by another flag. 63 #elif defined(FLAG_MODE_DEFINE_IMPLICATIONS) 64 #define DEFINE_VALUE_IMPLICATION(whenflag, thenflag, value) \ 65 if (FLAG_##whenflag) FLAG_##thenflag = value; 66 67 #define DEFINE_NEG_VALUE_IMPLICATION(whenflag, thenflag, value) \ 68 if (!FLAG_##whenflag) FLAG_##thenflag = value; 69 70 #else 71 #error No mode supplied when including flags.defs 72 #endif 73 74 // Dummy defines for modes where it is not relevant. 75 #ifndef FLAG_FULL 76 #define FLAG_FULL(ftype, ctype, nam, def, cmt) 77 #endif 78 79 #ifndef FLAG_READONLY 80 #define FLAG_READONLY(ftype, ctype, nam, def, cmt) 81 #endif 82 83 #ifndef FLAG_ALIAS 84 #define FLAG_ALIAS(ftype, ctype, alias, nam) 85 #endif 86 87 #ifndef DEFINE_VALUE_IMPLICATION 88 #define DEFINE_VALUE_IMPLICATION(whenflag, thenflag, value) 89 #endif 90 91 #ifndef DEFINE_NEG_VALUE_IMPLICATION 92 #define DEFINE_NEG_VALUE_IMPLICATION(whenflag, thenflag, value) 93 #endif 94 95 #define COMMA , 96 97 #ifdef FLAG_MODE_DECLARE 98 // Structure used to hold a collection of arguments to the JavaScript code. 99 struct JSArguments { 100 public: 101 inline const char*& operator[](int idx) const { return argv[idx]; } 102 static JSArguments Create(int argc, const char** argv) { 103 JSArguments args; 104 args.argc = argc; 105 args.argv = argv; 106 return args; 107 } 108 int argc; 109 const char** argv; 110 }; 111 112 struct MaybeBoolFlag { 113 static MaybeBoolFlag Create(bool has_value, bool value) { 114 MaybeBoolFlag flag; 115 flag.has_value = has_value; 116 flag.value = value; 117 return flag; 118 } 119 bool has_value; 120 bool value; 121 }; 122 #endif 123 124 #ifdef DEBUG 125 #define DEBUG_BOOL true 126 #else 127 #define DEBUG_BOOL false 128 #endif 129 130 // Supported ARM configurations are: 131 // "armv6": ARMv6 + VFPv2 132 // "armv7": ARMv7 + VFPv3-D32 + NEON 133 // "armv7+sudiv": ARMv7 + VFPv4-D32 + NEON + SUDIV 134 // "armv8": ARMv8 (including all of the above) 135 #if !defined(ARM_TEST_NO_FEATURE_PROBE) || \ 136 (defined(CAN_USE_ARMV8_INSTRUCTIONS) && \ 137 defined(CAN_USE_ARMV7_INSTRUCTIONS) && defined(CAN_USE_SUDIV) && \ 138 defined(CAN_USE_NEON) && defined(CAN_USE_VFP3_INSTRUCTIONS)) 139 #define ARM_ARCH_DEFAULT "armv8" 140 #elif defined(CAN_USE_ARMV7_INSTRUCTIONS) && defined(CAN_USE_SUDIV) && \ 141 defined(CAN_USE_NEON) && defined(CAN_USE_VFP3_INSTRUCTIONS) 142 #define ARM_ARCH_DEFAULT "armv7+sudiv" 143 #elif defined(CAN_USE_ARMV7_INSTRUCTIONS) && defined(CAN_USE_NEON) && \ 144 defined(CAN_USE_VFP3_INSTRUCTIONS) 145 #define ARM_ARCH_DEFAULT "armv7" 146 #else 147 #define ARM_ARCH_DEFAULT "armv6" 148 #endif 149 150 #ifdef V8_OS_WIN 151 # define ENABLE_LOG_COLOUR false 152 #else 153 # define ENABLE_LOG_COLOUR true 154 #endif 155 156 #define DEFINE_BOOL(nam, def, cmt) FLAG(BOOL, bool, nam, def, cmt) 157 #define DEFINE_BOOL_READONLY(nam, def, cmt) \ 158 FLAG_READONLY(BOOL, bool, nam, def, cmt) 159 #define DEFINE_MAYBE_BOOL(nam, cmt) \ 160 FLAG(MAYBE_BOOL, MaybeBoolFlag, nam, {false COMMA false}, cmt) 161 #define DEFINE_INT(nam, def, cmt) FLAG(INT, int, nam, def, cmt) 162 #define DEFINE_UINT(nam, def, cmt) FLAG(UINT, unsigned int, nam, def, cmt) 163 #define DEFINE_FLOAT(nam, def, cmt) FLAG(FLOAT, double, nam, def, cmt) 164 #define DEFINE_STRING(nam, def, cmt) FLAG(STRING, const char*, nam, def, cmt) 165 #define DEFINE_ARGS(nam, cmt) FLAG(ARGS, JSArguments, nam, {0 COMMA NULL}, cmt) 166 167 #define DEFINE_ALIAS_BOOL(alias, nam) FLAG_ALIAS(BOOL, bool, alias, nam) 168 #define DEFINE_ALIAS_INT(alias, nam) FLAG_ALIAS(INT, int, alias, nam) 169 #define DEFINE_ALIAS_FLOAT(alias, nam) FLAG_ALIAS(FLOAT, double, alias, nam) 170 #define DEFINE_ALIAS_STRING(alias, nam) \ 171 FLAG_ALIAS(STRING, const char*, alias, nam) 172 #define DEFINE_ALIAS_ARGS(alias, nam) FLAG_ALIAS(ARGS, JSArguments, alias, nam) 173 174 // 175 // Flags in all modes. 176 // 177 #define FLAG FLAG_FULL 178 179 DEFINE_BOOL(experimental_extras, false, 180 "enable code compiled in via v8_experimental_extra_library_files") 181 182 // Flags for language modes and experimental language features. 183 DEFINE_BOOL(use_strict, false, "enforce strict mode") 184 185 DEFINE_BOOL(es_staging, false, 186 "enable test-worthy harmony features (for internal use only)") 187 DEFINE_BOOL(harmony, false, "enable all completed harmony features") 188 DEFINE_BOOL(harmony_shipping, true, "enable all shipped harmony features") 189 DEFINE_IMPLICATION(es_staging, harmony) 190 191 192 // Activate on ClusterFuzz. 193 DEFINE_IMPLICATION(es_staging, harmony_regexp_lookbehind) 194 DEFINE_IMPLICATION(es_staging, move_object_start) 195 196 // Features that are still work in progress (behind individual flags). 197 #define HARMONY_INPROGRESS(V) \ 198 V(harmony_array_prototype_values, "harmony Array.prototype.values") \ 199 V(harmony_function_sent, "harmony function.sent") \ 200 V(harmony_tailcalls, "harmony tail calls") \ 201 V(harmony_sharedarraybuffer, "harmony sharedarraybuffer") \ 202 V(harmony_do_expressions, "harmony do-expressions") \ 203 V(harmony_regexp_named_captures, "harmony regexp named captures") \ 204 V(harmony_regexp_property, "harmony unicode regexp property classes") \ 205 V(harmony_function_tostring, "harmony Function.prototype.toString") \ 206 V(harmony_class_fields, "harmony public fields in class literals") \ 207 V(harmony_async_iteration, "harmony async iteration") \ 208 V(harmony_dynamic_import, "harmony dynamic import") \ 209 V(harmony_promise_finally, "harmony Promise.prototype.finally") 210 211 // Features that are complete (but still behind --harmony/es-staging flag). 212 #define HARMONY_STAGED(V) \ 213 V(harmony_regexp_lookbehind, "harmony regexp lookbehind") \ 214 V(harmony_restrictive_generators, \ 215 "harmony restrictions on generator declarations") \ 216 V(harmony_object_rest_spread, "harmony object rest spread properties") \ 217 V(harmony_template_escapes, \ 218 "harmony invalid escapes in tagged template literals") 219 220 // Features that are shipping (turned on by default, but internal flag remains). 221 #define HARMONY_SHIPPING_BASE(V) \ 222 V(harmony_trailing_commas, \ 223 "harmony trailing commas in function parameter lists") 224 225 #ifdef V8_I18N_SUPPORT 226 #define HARMONY_SHIPPING(V) \ 227 HARMONY_SHIPPING_BASE(V) \ 228 V(datetime_format_to_parts, "Intl.DateTimeFormat.formatToParts") \ 229 V(icu_case_mapping, "case mapping with ICU rather than Unibrow") 230 #else 231 #define HARMONY_SHIPPING(V) HARMONY_SHIPPING_BASE(V) 232 #endif 233 234 // Once a shipping feature has proved stable in the wild, it will be dropped 235 // from HARMONY_SHIPPING, all occurrences of the FLAG_ variable are removed, 236 // and associated tests are moved from the harmony directory to the appropriate 237 // esN directory. 238 239 240 #define FLAG_INPROGRESS_FEATURES(id, description) \ 241 DEFINE_BOOL(id, false, "enable " #description " (in progress)") 242 HARMONY_INPROGRESS(FLAG_INPROGRESS_FEATURES) 243 #undef FLAG_INPROGRESS_FEATURES 244 245 #define FLAG_STAGED_FEATURES(id, description) \ 246 DEFINE_BOOL(id, false, "enable " #description) \ 247 DEFINE_IMPLICATION(harmony, id) 248 HARMONY_STAGED(FLAG_STAGED_FEATURES) 249 #undef FLAG_STAGED_FEATURES 250 251 #define FLAG_SHIPPING_FEATURES(id, description) \ 252 DEFINE_BOOL(id, true, "enable " #description) \ 253 DEFINE_NEG_NEG_IMPLICATION(harmony_shipping, id) 254 HARMONY_SHIPPING(FLAG_SHIPPING_FEATURES) 255 #undef FLAG_SHIPPING_FEATURES 256 257 DEFINE_BOOL(future, false, 258 "Implies all staged features that we want to ship in the " 259 "not-too-far future") 260 DEFINE_IMPLICATION(future, turbo) 261 262 DEFINE_IMPLICATION(turbo, ignition_staging) 263 DEFINE_IMPLICATION(turbo, enable_fast_array_builtins) 264 DEFINE_IMPLICATION(turbo, thin_strings) 265 266 // TODO(rmcilroy): Remove ignition-staging and set these implications directly 267 // with the turbo flag. 268 DEFINE_BOOL(ignition_staging, false, "use ignition with all staged features") 269 DEFINE_IMPLICATION(ignition_staging, ignition) 270 DEFINE_IMPLICATION(ignition_staging, compiler_dispatcher) 271 272 // Flags for experimental implementation features. 273 DEFINE_BOOL(allocation_site_pretenuring, true, 274 "pretenure with allocation sites") 275 DEFINE_BOOL(mark_shared_functions_for_tier_up, true, 276 "mark shared functions for tier up") 277 DEFINE_BOOL(page_promotion, true, "promote pages based on utilization") 278 DEFINE_INT(page_promotion_threshold, 70, 279 "min percentage of live bytes on a page to enable fast evacuation") 280 DEFINE_BOOL(smi_binop, true, "support smi representation in binary operations") 281 DEFINE_BOOL(trace_pretenuring, false, 282 "trace pretenuring decisions of HAllocate instructions") 283 DEFINE_BOOL(trace_pretenuring_statistics, false, 284 "trace allocation site pretenuring statistics") 285 DEFINE_BOOL(track_fields, true, "track fields with only smi values") 286 DEFINE_BOOL(track_double_fields, true, "track fields with double values") 287 DEFINE_BOOL(track_heap_object_fields, true, "track fields with heap values") 288 DEFINE_BOOL(track_computed_fields, true, "track computed boilerplate fields") 289 DEFINE_IMPLICATION(track_double_fields, track_fields) 290 DEFINE_IMPLICATION(track_heap_object_fields, track_fields) 291 DEFINE_IMPLICATION(track_computed_fields, track_fields) 292 DEFINE_BOOL(track_field_types, true, "track field types") 293 DEFINE_IMPLICATION(track_field_types, track_fields) 294 DEFINE_IMPLICATION(track_field_types, track_heap_object_fields) 295 DEFINE_BOOL(type_profile, false, "collect type information") 296 297 // Flags for optimization types. 298 DEFINE_BOOL(optimize_for_size, false, 299 "Enables optimizations which favor memory size over execution " 300 "speed") 301 302 DEFINE_VALUE_IMPLICATION(optimize_for_size, max_semi_space_size, 1) 303 304 // Flags for data representation optimizations 305 DEFINE_BOOL(unbox_double_arrays, true, "automatically unbox arrays of doubles") 306 DEFINE_BOOL(string_slices, true, "use string slices") 307 308 // Flags for Ignition. 309 DEFINE_BOOL(ignition, false, "use ignition interpreter") 310 DEFINE_BOOL(ignition_deadcode, true, 311 "use ignition dead code elimination optimizer") 312 DEFINE_BOOL(ignition_osr, true, "enable support for OSR from ignition code") 313 DEFINE_BOOL(ignition_peephole, true, "use ignition peephole optimizer") 314 DEFINE_BOOL(ignition_reo, true, "use ignition register equivalence optimizer") 315 DEFINE_BOOL(ignition_filter_expression_positions, true, 316 "filter expression positions before the bytecode pipeline") 317 DEFINE_BOOL(print_bytecode, false, 318 "print bytecode generated by ignition interpreter") 319 DEFINE_STRING(print_bytecode_filter, "*", 320 "filter for selecting which functions to print bytecode") 321 DEFINE_BOOL(trace_ignition, false, 322 "trace the bytecodes executed by the ignition interpreter") 323 DEFINE_BOOL(trace_ignition_codegen, false, 324 "trace the codegen of ignition interpreter bytecode handlers") 325 DEFINE_BOOL(trace_ignition_dispatches, false, 326 "traces the dispatches to bytecode handlers by the ignition " 327 "interpreter") 328 DEFINE_STRING(trace_ignition_dispatches_output_file, nullptr, 329 "the file to which the bytecode handler dispatch table is " 330 "written (by default, the table is not written to a file)") 331 332 // Flags for Crankshaft. 333 DEFINE_BOOL(crankshaft, true, "use crankshaft") 334 DEFINE_STRING(hydrogen_filter, "*", "optimization filter") 335 DEFINE_BOOL(use_gvn, true, "use hydrogen global value numbering") 336 DEFINE_INT(gvn_iterations, 3, "maximum number of GVN fix-point iterations") 337 DEFINE_BOOL(use_canonicalizing, true, "use hydrogen instruction canonicalizing") 338 DEFINE_BOOL(use_inlining, true, "use function inlining") 339 DEFINE_BOOL(use_escape_analysis, true, "use hydrogen escape analysis") 340 DEFINE_BOOL(use_allocation_folding, true, "use allocation folding") 341 DEFINE_BOOL(use_local_allocation_folding, false, "only fold in basic blocks") 342 DEFINE_BOOL(use_write_barrier_elimination, true, 343 "eliminate write barriers targeting allocations in optimized code") 344 DEFINE_INT(max_inlining_levels, 5, "maximum number of inlining levels") 345 DEFINE_INT(max_inlined_source_size, 600, 346 "maximum source size in bytes considered for a single inlining") 347 DEFINE_INT(max_inlined_nodes, 200, 348 "maximum number of AST nodes considered for a single inlining") 349 DEFINE_INT(max_inlined_nodes_cumulative, 400, 350 "maximum cumulative number of AST nodes considered for inlining") 351 DEFINE_BOOL(loop_invariant_code_motion, true, "loop invariant code motion") 352 DEFINE_BOOL(fast_math, true, "faster (but maybe less accurate) math functions") 353 DEFINE_BOOL(collect_megamorphic_maps_from_stub_cache, false, 354 "crankshaft harvests type feedback from stub cache") 355 DEFINE_BOOL(hydrogen_stats, false, "print statistics for hydrogen") 356 DEFINE_BOOL(trace_check_elimination, false, "trace check elimination phase") 357 DEFINE_BOOL(trace_environment_liveness, false, 358 "trace liveness of local variable slots") 359 DEFINE_BOOL(trace_hydrogen, false, "trace generated hydrogen to file") 360 DEFINE_STRING(trace_hydrogen_filter, "*", "hydrogen tracing filter") 361 DEFINE_BOOL(trace_hydrogen_stubs, false, "trace generated hydrogen for stubs") 362 DEFINE_STRING(trace_hydrogen_file, NULL, "trace hydrogen to given file name") 363 DEFINE_STRING(trace_phase, "HLZ", "trace generated IR for specified phases") 364 DEFINE_BOOL(trace_inlining, false, "trace inlining decisions") 365 DEFINE_BOOL(trace_load_elimination, false, "trace load elimination") 366 DEFINE_BOOL(trace_store_elimination, false, "trace store elimination") 367 DEFINE_BOOL(turbo_verify_store_elimination, false, 368 "verify store elimination more rigorously") 369 DEFINE_BOOL(trace_alloc, false, "trace register allocator") 370 DEFINE_BOOL(trace_all_uses, false, "trace all use positions") 371 DEFINE_BOOL(trace_range, false, "trace range analysis") 372 DEFINE_BOOL(trace_gvn, false, "trace global value numbering") 373 DEFINE_BOOL(trace_representation, false, "trace representation types") 374 DEFINE_BOOL(trace_removable_simulates, false, "trace removable simulates") 375 DEFINE_BOOL(trace_escape_analysis, false, "trace hydrogen escape analysis") 376 DEFINE_BOOL(trace_allocation_folding, false, "trace allocation folding") 377 DEFINE_BOOL(trace_track_allocation_sites, false, 378 "trace the tracking of allocation sites") 379 DEFINE_BOOL(trace_migration, false, "trace object migration") 380 DEFINE_BOOL(trace_generalization, false, "trace map generalization") 381 DEFINE_BOOL(stress_pointer_maps, false, "pointer map for every instruction") 382 DEFINE_BOOL(stress_environments, false, "environment for every instruction") 383 DEFINE_INT(deopt_every_n_times, 0, 384 "deoptimize every n times a deopt point is passed") 385 DEFINE_INT(deopt_every_n_garbage_collections, 0, 386 "deoptimize every n garbage collections") 387 DEFINE_BOOL(print_deopt_stress, false, "print number of possible deopt points") 388 DEFINE_BOOL(trap_on_deopt, false, "put a break point before deoptimizing") 389 DEFINE_BOOL(trap_on_stub_deopt, false, 390 "put a break point before deoptimizing a stub") 391 DEFINE_BOOL(deoptimize_uncommon_cases, true, "deoptimize uncommon cases") 392 DEFINE_BOOL(polymorphic_inlining, true, "polymorphic inlining") 393 DEFINE_BOOL(use_osr, true, "use on-stack replacement") 394 DEFINE_BOOL(array_bounds_checks_elimination, true, 395 "perform array bounds checks elimination") 396 DEFINE_BOOL(trace_bce, false, "trace array bounds check elimination") 397 DEFINE_BOOL(array_index_dehoisting, true, "perform array index dehoisting") 398 DEFINE_BOOL(analyze_environment_liveness, true, 399 "analyze liveness of environment slots and zap dead values") 400 DEFINE_BOOL(load_elimination, true, "use load elimination") 401 DEFINE_BOOL(check_elimination, true, "use check elimination") 402 DEFINE_BOOL(store_elimination, false, "use store elimination") 403 DEFINE_BOOL(dead_code_elimination, true, "use dead code elimination") 404 DEFINE_BOOL(fold_constants, true, "use constant folding") 405 DEFINE_BOOL(trace_dead_code_elimination, false, "trace dead code elimination") 406 DEFINE_BOOL(unreachable_code_elimination, true, "eliminate unreachable code") 407 DEFINE_BOOL(trace_osr, false, "trace on-stack replacement") 408 DEFINE_INT(stress_runs, 0, "number of stress runs") 409 DEFINE_BOOL(lookup_sample_by_shared, true, 410 "when picking a function to optimize, watch for shared function " 411 "info, not JSFunction itself") 412 DEFINE_BOOL(flush_optimized_code_cache, false, 413 "flushes the cache of optimized code for closures on every GC") 414 DEFINE_BOOL(inline_construct, true, "inline constructor calls") 415 DEFINE_BOOL(inline_arguments, true, "inline functions with arguments object") 416 DEFINE_BOOL(inline_accessors, true, "inline JavaScript accessors") 417 DEFINE_BOOL(inline_into_try, true, "inline into try blocks") 418 DEFINE_INT(escape_analysis_iterations, 1, 419 "maximum number of escape analysis fix-point iterations") 420 421 DEFINE_BOOL(concurrent_recompilation, true, 422 "optimizing hot functions asynchronously on a separate thread") 423 DEFINE_BOOL(trace_concurrent_recompilation, false, 424 "track concurrent recompilation") 425 DEFINE_INT(concurrent_recompilation_queue_length, 8, 426 "the length of the concurrent compilation queue") 427 DEFINE_INT(concurrent_recompilation_delay, 0, 428 "artificial compilation delay in ms") 429 DEFINE_BOOL(block_concurrent_recompilation, false, 430 "block queued jobs until released") 431 432 DEFINE_BOOL(omit_map_checks_for_leaf_maps, true, 433 "do not emit check maps for constant values that have a leaf map, " 434 "deoptimize the optimized code if the layout of the maps changes.") 435 436 // Flags for TurboFan. 437 DEFINE_BOOL(turbo, false, "enable TurboFan compiler") 438 DEFINE_BOOL(turbo_sp_frame_access, false, 439 "use stack pointer-relative access to frame wherever possible") 440 DEFINE_BOOL(turbo_preprocess_ranges, true, 441 "run pre-register allocation heuristics") 442 DEFINE_STRING(turbo_filter, "~~", "optimization filter for TurboFan compiler") 443 DEFINE_BOOL(trace_turbo, false, "trace generated TurboFan IR") 444 DEFINE_BOOL(trace_turbo_graph, false, "trace generated TurboFan graphs") 445 DEFINE_IMPLICATION(trace_turbo_graph, trace_turbo) 446 DEFINE_STRING(trace_turbo_cfg_file, NULL, 447 "trace turbo cfg graph (for C1 visualizer) to a given file name") 448 DEFINE_BOOL(trace_turbo_types, true, "trace TurboFan's types") 449 DEFINE_BOOL(trace_turbo_scheduler, false, "trace TurboFan's scheduler") 450 DEFINE_BOOL(trace_turbo_reduction, false, "trace TurboFan's various reducers") 451 DEFINE_BOOL(trace_turbo_trimming, false, "trace TurboFan's graph trimmer") 452 DEFINE_BOOL(trace_turbo_jt, false, "trace TurboFan's jump threading") 453 DEFINE_BOOL(trace_turbo_ceq, false, "trace TurboFan's control equivalence") 454 DEFINE_BOOL(trace_turbo_loop, false, "trace TurboFan's loop optimizations") 455 DEFINE_BOOL(turbo_asm, true, "enable TurboFan for asm.js code") 456 DEFINE_BOOL(turbo_verify, DEBUG_BOOL, "verify TurboFan graphs at each phase") 457 DEFINE_STRING(turbo_verify_machine_graph, nullptr, 458 "verify TurboFan machine graph before instruction selection") 459 #ifdef ENABLE_VERIFY_CSA 460 DEFINE_BOOL(verify_csa, DEBUG_BOOL, 461 "verify TurboFan machine graph of code stubs") 462 #else 463 // Define the flag as read-only-false so that code still compiles even in the 464 // non-ENABLE_VERIFY_CSA configuration. 465 DEFINE_BOOL_READONLY(verify_csa, false, 466 "verify TurboFan machine graph of code stubs") 467 #endif 468 DEFINE_BOOL(trace_verify_csa, false, "trace code stubs verification") 469 DEFINE_STRING(csa_trap_on_node, nullptr, 470 "trigger break point when a node with given id is created in " 471 "given stub. The format is: StubName,NodeId") 472 DEFINE_BOOL(turbo_stats, false, "print TurboFan statistics") 473 DEFINE_BOOL(turbo_stats_nvp, false, 474 "print TurboFan statistics in machine-readable format") 475 DEFINE_BOOL(turbo_splitting, true, "split nodes during scheduling in TurboFan") 476 DEFINE_BOOL(function_context_specialization, false, 477 "enable function context specialization in TurboFan") 478 DEFINE_BOOL(turbo_inlining, true, "enable inlining in TurboFan") 479 DEFINE_BOOL(trace_turbo_inlining, false, "trace TurboFan inlining") 480 DEFINE_BOOL(turbo_load_elimination, true, "enable load elimination in TurboFan") 481 DEFINE_BOOL(trace_turbo_load_elimination, false, 482 "trace TurboFan load elimination") 483 DEFINE_BOOL(loop_assignment_analysis, true, "perform loop assignment analysis") 484 DEFINE_BOOL(turbo_profiling, false, "enable profiling in TurboFan") 485 DEFINE_BOOL(turbo_verify_allocation, DEBUG_BOOL, 486 "verify register allocation in TurboFan") 487 DEFINE_BOOL(turbo_move_optimization, true, "optimize gap moves in TurboFan") 488 DEFINE_BOOL(turbo_jt, true, "enable jump threading in TurboFan") 489 DEFINE_BOOL(turbo_loop_peeling, true, "Turbofan loop peeling") 490 DEFINE_BOOL(turbo_loop_variable, true, "Turbofan loop variable optimization") 491 DEFINE_BOOL(turbo_cf_optimization, true, "optimize control flow in TurboFan") 492 DEFINE_BOOL(turbo_frame_elision, true, "elide frames in TurboFan") 493 DEFINE_BOOL(turbo_escape, true, "enable escape analysis") 494 DEFINE_BOOL(turbo_instruction_scheduling, false, 495 "enable instruction scheduling in TurboFan") 496 DEFINE_BOOL(turbo_stress_instruction_scheduling, false, 497 "randomly schedule instructions to stress dependency tracking") 498 DEFINE_BOOL(turbo_store_elimination, true, 499 "enable store-store elimination in TurboFan") 500 // TODO(turbofan): Rename --crankshaft to --optimize eventually. 501 DEFINE_IMPLICATION(turbo, crankshaft) 502 503 // Flags to help platform porters 504 DEFINE_BOOL(minimal, false, 505 "simplifies execution model to make porting " 506 "easier (e.g. always use Ignition, never use Crankshaft") 507 DEFINE_IMPLICATION(minimal, ignition) 508 DEFINE_NEG_IMPLICATION(minimal, crankshaft) 509 DEFINE_NEG_IMPLICATION(minimal, use_ic) 510 511 // Flags for native WebAssembly. 512 DEFINE_BOOL(expose_wasm, true, "expose WASM interface to JavaScript") 513 DEFINE_BOOL(assume_asmjs_origin, false, 514 "force wasm decoder to assume input is internal asm-wasm format") 515 DEFINE_BOOL(wasm_disable_structured_cloning, false, 516 "disable WASM structured cloning") 517 DEFINE_INT(wasm_num_compilation_tasks, 10, 518 "number of parallel compilation tasks for wasm") 519 DEFINE_UINT(wasm_max_mem_pages, v8::internal::wasm::kV8MaxWasmMemoryPages, 520 "maximum memory size of a wasm instance") 521 DEFINE_UINT(wasm_max_table_size, v8::internal::wasm::kV8MaxWasmTableSize, 522 "maximum table size of a wasm instance") 523 DEFINE_BOOL(trace_wasm_encoder, false, "trace encoding of wasm code") 524 DEFINE_BOOL(trace_wasm_decoder, false, "trace decoding of wasm code") 525 DEFINE_BOOL(trace_wasm_decode_time, false, "trace decoding time of wasm code") 526 DEFINE_BOOL(trace_wasm_compiler, false, "trace compiling of wasm code") 527 DEFINE_BOOL(trace_wasm_interpreter, false, "trace interpretation of wasm code") 528 DEFINE_INT(trace_wasm_ast_start, 0, 529 "start function for WASM AST trace (inclusive)") 530 DEFINE_INT(trace_wasm_ast_end, 0, "end function for WASM AST trace (exclusive)") 531 DEFINE_INT(trace_wasm_text_start, 0, 532 "start function for WASM text generation (inclusive)") 533 DEFINE_INT(trace_wasm_text_end, 0, 534 "end function for WASM text generation (exclusive)") 535 DEFINE_INT(skip_compiling_wasm_funcs, 0, "start compiling at function N") 536 DEFINE_BOOL(wasm_break_on_decoder_error, false, 537 "debug break when wasm decoder encounters an error") 538 DEFINE_BOOL(wasm_loop_assignment_analysis, true, 539 "perform loop assignment analysis for WASM") 540 541 DEFINE_BOOL(validate_asm, false, "validate asm.js modules before compiling") 542 DEFINE_BOOL(suppress_asm_messages, false, 543 "don't emit asm.js related messages (for golden file testing)") 544 DEFINE_BOOL(trace_asm_time, false, "log asm.js timing info to the console") 545 546 DEFINE_BOOL(dump_wasm_module, false, "dump WASM module bytes") 547 DEFINE_STRING(dump_wasm_module_path, NULL, "directory to dump wasm modules to") 548 549 DEFINE_INT(typed_array_max_size_in_heap, 64, 550 "threshold for in-heap typed array") 551 552 DEFINE_BOOL(wasm_simd_prototype, false, 553 "enable prototype simd opcodes for wasm") 554 DEFINE_BOOL(wasm_eh_prototype, false, 555 "enable prototype exception handling opcodes for wasm") 556 DEFINE_BOOL(wasm_mv_prototype, false, 557 "enable prototype multi-value support for wasm") 558 DEFINE_BOOL(wasm_atomics_prototype, false, 559 "enable prototype atomic opcodes for wasm") 560 561 DEFINE_BOOL(wasm_opt, true, "enable wasm optimization") 562 DEFINE_BOOL(wasm_no_bounds_checks, false, 563 "disable bounds checks (performance testing only)") 564 DEFINE_BOOL(wasm_no_stack_checks, false, 565 "disable stack checks (performance testing only)") 566 567 DEFINE_BOOL(wasm_trap_handler, false, 568 "use signal handlers to catch out of bounds memory access in wasm" 569 " (experimental, currently Linux x86_64 only)") 570 DEFINE_BOOL(wasm_guard_pages, false, 571 "add guard pages to the end of WebWassembly memory" 572 " (experimental, no effect on 32-bit)") 573 DEFINE_IMPLICATION(wasm_trap_handler, wasm_guard_pages) 574 DEFINE_BOOL(wasm_trap_if, true, 575 "enable the use of the trap_if operator for traps") 576 DEFINE_BOOL(wasm_code_fuzzer_gen_test, false, 577 "Generate a test case when running the wasm-code fuzzer") 578 DEFINE_BOOL(print_wasm_code, false, "Print WebAssembly code") 579 580 // Profiler flags. 581 DEFINE_INT(frame_count, 1, "number of stack frames inspected by the profiler") 582 // 0x1800 fits in the immediate field of an ARM instruction. 583 DEFINE_INT(interrupt_budget, 0x1800, 584 "execution budget before interrupt is triggered") 585 DEFINE_INT(type_info_threshold, 25, 586 "percentage of ICs that must have type info to allow optimization") 587 DEFINE_INT(generic_ic_threshold, 30, 588 "max percentage of megamorphic/generic ICs to allow optimization") 589 DEFINE_INT(self_opt_count, 130, "call count before self-optimization") 590 591 DEFINE_BOOL(trace_opt_verbose, false, "extra verbose compilation tracing") 592 DEFINE_IMPLICATION(trace_opt_verbose, trace_opt) 593 594 // Garbage collections flags. 595 DEFINE_INT(min_semi_space_size, 0, 596 "min size of a semi-space (in MBytes), the new space consists of two" 597 "semi-spaces") 598 DEFINE_INT(max_semi_space_size, 0, 599 "max size of a semi-space (in MBytes), the new space consists of two" 600 "semi-spaces") 601 DEFINE_INT(semi_space_growth_factor, 2, "factor by which to grow the new space") 602 DEFINE_BOOL(experimental_new_space_growth_heuristic, false, 603 "Grow the new space based on the percentage of survivors instead " 604 "of their absolute value.") 605 DEFINE_INT(max_old_space_size, 0, "max size of the old space (in Mbytes)") 606 DEFINE_INT(initial_old_space_size, 0, "initial old space size (in Mbytes)") 607 DEFINE_INT(max_executable_size, 0, "max size of executable memory (in Mbytes)") 608 DEFINE_BOOL(gc_global, false, "always perform global GCs") 609 DEFINE_INT(gc_interval, -1, "garbage collect after <n> allocations") 610 DEFINE_INT(retain_maps_for_n_gc, 2, 611 "keeps maps alive for <n> old space garbage collections") 612 DEFINE_BOOL(trace_gc, false, 613 "print one trace line following each garbage collection") 614 DEFINE_BOOL(trace_gc_nvp, false, 615 "print one detailed trace line in name=value format " 616 "after each garbage collection") 617 DEFINE_BOOL(trace_gc_ignore_scavenger, false, 618 "do not print trace line after scavenger collection") 619 DEFINE_BOOL(trace_idle_notification, false, 620 "print one trace line following each idle notification") 621 DEFINE_BOOL(trace_idle_notification_verbose, false, 622 "prints the heap state used by the idle notification") 623 DEFINE_BOOL(trace_gc_verbose, false, 624 "print more details following each garbage collection") 625 DEFINE_INT(trace_allocation_stack_interval, -1, 626 "print stack trace after <n> free-list allocations") 627 DEFINE_BOOL(trace_fragmentation, false, "report fragmentation for old space") 628 DEFINE_BOOL(trace_fragmentation_verbose, false, 629 "report fragmentation for old space (detailed)") 630 DEFINE_BOOL(trace_evacuation, false, "report evacuation statistics") 631 DEFINE_BOOL(trace_mutator_utilization, false, 632 "print mutator utilization, allocation speed, gc speed") 633 DEFINE_BOOL(flush_code, true, "flush code that we expect not to use again") 634 DEFINE_BOOL(trace_code_flushing, false, "trace code flushing progress") 635 DEFINE_BOOL(age_code, true, 636 "track un-executed functions to age code and flush only " 637 "old code (required for code flushing)") 638 DEFINE_BOOL(incremental_marking, true, "use incremental marking") 639 DEFINE_BOOL(incremental_marking_wrappers, true, 640 "use incremental marking for marking wrappers") 641 DEFINE_INT(min_progress_during_incremental_marking_finalization, 32, 642 "keep finalizing incremental marking as long as we discover at " 643 "least this many unmarked objects") 644 DEFINE_INT(max_incremental_marking_finalization_rounds, 3, 645 "at most try this many times to finalize incremental marking") 646 DEFINE_BOOL(minor_mc, false, "perform young generation mark compact GCs") 647 DEFINE_NEG_IMPLICATION(minor_mc, incremental_marking) 648 DEFINE_BOOL(black_allocation, true, "use black allocation") 649 DEFINE_BOOL(concurrent_sweeping, true, "use concurrent sweeping") 650 DEFINE_BOOL(parallel_compaction, true, "use parallel compaction") 651 DEFINE_BOOL(parallel_pointer_update, true, 652 "use parallel pointer update during compaction") 653 DEFINE_BOOL(trace_incremental_marking, false, 654 "trace progress of the incremental marking") 655 DEFINE_BOOL(track_gc_object_stats, false, 656 "track object counts and memory usage") 657 DEFINE_BOOL(trace_gc_object_stats, false, 658 "trace object counts and memory usage") 659 DEFINE_INT(gc_stats, 0, "Used by tracing internally to enable gc statistics") 660 DEFINE_IMPLICATION(trace_gc_object_stats, track_gc_object_stats) 661 DEFINE_VALUE_IMPLICATION(track_gc_object_stats, gc_stats, 1) 662 DEFINE_VALUE_IMPLICATION(trace_gc_object_stats, gc_stats, 1) 663 DEFINE_NEG_IMPLICATION(trace_gc_object_stats, incremental_marking) 664 DEFINE_BOOL(track_detached_contexts, true, 665 "track native contexts that are expected to be garbage collected") 666 DEFINE_BOOL(trace_detached_contexts, false, 667 "trace native contexts that are expected to be garbage collected") 668 DEFINE_IMPLICATION(trace_detached_contexts, track_detached_contexts) 669 #ifdef VERIFY_HEAP 670 DEFINE_BOOL(verify_heap, false, "verify heap pointers before and after GC") 671 #endif 672 DEFINE_BOOL(move_object_start, true, "enable moving of object starts") 673 DEFINE_BOOL(memory_reducer, true, "use memory reducer") 674 DEFINE_INT(heap_growing_percent, 0, 675 "specifies heap growing factor as (1 + heap_growing_percent/100)") 676 DEFINE_INT(v8_os_page_size, 0, "override OS page size (in KBytes)") 677 DEFINE_BOOL(always_compact, false, "Perform compaction on every full GC") 678 DEFINE_BOOL(never_compact, false, 679 "Never perform compaction on full GC - testing only") 680 DEFINE_BOOL(compact_code_space, true, "Compact code space on full collections") 681 DEFINE_BOOL(cleanup_code_caches_at_gc, true, 682 "Flush code caches in maps during mark compact cycle.") 683 DEFINE_BOOL(use_marking_progress_bar, true, 684 "Use a progress bar to scan large objects in increments when " 685 "incremental marking is active.") 686 DEFINE_BOOL(zap_code_space, DEBUG_BOOL, 687 "Zap free memory in code space with 0xCC while sweeping.") 688 DEFINE_BOOL(force_marking_deque_overflows, false, 689 "force overflows of marking deque by reducing it's size " 690 "to 64 words") 691 DEFINE_BOOL(stress_compaction, false, 692 "stress the GC compactor to flush out bugs (implies " 693 "--force_marking_deque_overflows)") 694 DEFINE_BOOL(manual_evacuation_candidates_selection, false, 695 "Test mode only flag. It allows an unit test to select evacuation " 696 "candidates pages (requires --stress_compaction).") 697 DEFINE_BOOL(fast_promotion_new_space, false, 698 "fast promote new space on high survival rates") 699 700 // assembler-ia32.cc / assembler-arm.cc / assembler-x64.cc 701 DEFINE_BOOL(debug_code, DEBUG_BOOL, 702 "generate extra code (assertions) for debugging") 703 DEFINE_BOOL(code_comments, false, "emit comments in code disassembly") 704 DEFINE_BOOL(enable_sse3, true, "enable use of SSE3 instructions if available") 705 DEFINE_BOOL(enable_ssse3, true, "enable use of SSSE3 instructions if available") 706 DEFINE_BOOL(enable_sse4_1, true, 707 "enable use of SSE4.1 instructions if available") 708 DEFINE_BOOL(enable_sahf, true, 709 "enable use of SAHF instruction if available (X64 only)") 710 DEFINE_BOOL(enable_avx, true, "enable use of AVX instructions if available") 711 DEFINE_BOOL(enable_fma3, true, "enable use of FMA3 instructions if available") 712 DEFINE_BOOL(enable_bmi1, true, "enable use of BMI1 instructions if available") 713 DEFINE_BOOL(enable_bmi2, true, "enable use of BMI2 instructions if available") 714 DEFINE_BOOL(enable_lzcnt, true, "enable use of LZCNT instruction if available") 715 DEFINE_BOOL(enable_popcnt, true, 716 "enable use of POPCNT instruction if available") 717 DEFINE_STRING(arm_arch, ARM_ARCH_DEFAULT, 718 "generate instructions for the selected ARM architecture if " 719 "available: armv6, armv7, armv7+sudiv or armv8") 720 DEFINE_BOOL(enable_vldr_imm, false, 721 "enable use of constant pools for double immediate (ARM only)") 722 DEFINE_BOOL(force_long_branches, false, 723 "force all emitted branches to be in long mode (MIPS/PPC only)") 724 DEFINE_STRING(mcpu, "auto", "enable optimization for specific cpu") 725 726 // Deprecated ARM flags (replaced by arm_arch). 727 DEFINE_MAYBE_BOOL(enable_armv7, "deprecated (use --arm_arch instead)") 728 DEFINE_MAYBE_BOOL(enable_vfp3, "deprecated (use --arm_arch instead)") 729 DEFINE_MAYBE_BOOL(enable_32dregs, "deprecated (use --arm_arch instead)") 730 DEFINE_MAYBE_BOOL(enable_neon, "deprecated (use --arm_arch instead)") 731 DEFINE_MAYBE_BOOL(enable_sudiv, "deprecated (use --arm_arch instead)") 732 DEFINE_MAYBE_BOOL(enable_armv8, "deprecated (use --arm_arch instead)") 733 734 // regexp-macro-assembler-*.cc 735 DEFINE_BOOL(enable_regexp_unaligned_accesses, true, 736 "enable unaligned accesses for the regexp engine") 737 738 // api.cc 739 DEFINE_BOOL(script_streaming, true, "enable parsing on background") 740 DEFINE_BOOL(disable_old_api_accessors, false, 741 "Disable old-style API accessors whose setters trigger through the " 742 "prototype chain") 743 744 // bootstrapper.cc 745 DEFINE_STRING(expose_natives_as, NULL, "expose natives in global object") 746 DEFINE_BOOL(expose_free_buffer, false, "expose freeBuffer extension") 747 DEFINE_BOOL(expose_gc, false, "expose gc extension") 748 DEFINE_STRING(expose_gc_as, NULL, 749 "expose gc extension under the specified name") 750 DEFINE_IMPLICATION(expose_gc_as, expose_gc) 751 DEFINE_BOOL(expose_externalize_string, false, 752 "expose externalize string extension") 753 DEFINE_BOOL(expose_trigger_failure, false, "expose trigger-failure extension") 754 DEFINE_INT(stack_trace_limit, 10, "number of stack frames to capture") 755 DEFINE_BOOL(builtins_in_stack_traces, false, 756 "show built-in functions in stack traces") 757 758 // builtins.cc 759 DEFINE_BOOL(enable_fast_array_builtins, false, "use optimized builtins") 760 DEFINE_BOOL(allow_unsafe_function_constructor, false, 761 "allow invoking the function constructor without security checks") 762 763 // builtins-ia32.cc 764 DEFINE_BOOL(inline_new, true, "use fast inline allocation") 765 766 // codegen-ia32.cc / codegen-arm.cc 767 DEFINE_BOOL(trace_codegen, false, 768 "print name of functions for which code is generated") 769 DEFINE_BOOL(trace, false, "trace function calls") 770 DEFINE_BOOL(mask_constants_with_cookie, true, 771 "use random jit cookie to mask large constants") 772 773 // codegen.cc 774 DEFINE_BOOL(lazy, true, "use lazy compilation") 775 DEFINE_BOOL(trace_opt, false, "trace lazy optimization") 776 DEFINE_BOOL(trace_opt_stats, false, "trace lazy optimization statistics") 777 DEFINE_BOOL(trace_file_names, false, 778 "include file names in trace-opt/trace-deopt output") 779 DEFINE_BOOL(opt, true, "use adaptive optimizations") 780 DEFINE_BOOL(always_opt, false, "always try to optimize functions") 781 DEFINE_BOOL(always_osr, false, "always try to OSR functions") 782 DEFINE_BOOL(prepare_always_opt, false, "prepare for turning on always opt") 783 DEFINE_BOOL(trace_deopt, false, "trace optimize function deoptimization") 784 DEFINE_BOOL(trace_stub_failures, false, 785 "trace deoptimization of generated code stubs") 786 787 DEFINE_BOOL(serialize_toplevel, true, "enable caching of toplevel scripts") 788 DEFINE_BOOL(serialize_eager, false, "compile eagerly when caching scripts") 789 DEFINE_BOOL(serialize_age_code, false, "pre age code in the code cache") 790 DEFINE_BOOL(trace_serializer, false, "print code serializer trace") 791 #ifdef DEBUG 792 DEFINE_BOOL(external_reference_stats, false, 793 "print statistics on external references used during serialization") 794 #endif // DEBUG 795 796 // compiler.cc 797 DEFINE_INT(max_opt_count, 10, 798 "maximum number of optimization attempts before giving up.") 799 800 // compilation-cache.cc 801 DEFINE_BOOL(compilation_cache, true, "enable compilation cache") 802 803 DEFINE_BOOL(cache_prototype_transitions, true, "cache prototype transitions") 804 805 // compiler-dispatcher.cc 806 DEFINE_BOOL(compiler_dispatcher, false, "enable compiler dispatcher") 807 DEFINE_BOOL(compiler_dispatcher_eager_inner, false, 808 "enable background compilation of eager inner functions") 809 DEFINE_BOOL(trace_compiler_dispatcher, false, 810 "trace compiler dispatcher activity") 811 812 // compiler-dispatcher-job.cc 813 DEFINE_BOOL( 814 trace_compiler_dispatcher_jobs, false, 815 "trace progress of individual jobs managed by the compiler dispatcher") 816 817 // cpu-profiler.cc 818 DEFINE_INT(cpu_profiler_sampling_interval, 1000, 819 "CPU profiler sampling interval in microseconds") 820 821 // Array abuse tracing 822 DEFINE_BOOL(trace_js_array_abuse, false, 823 "trace out-of-bounds accesses to JS arrays") 824 DEFINE_BOOL(trace_external_array_abuse, false, 825 "trace out-of-bounds-accesses to external arrays") 826 DEFINE_BOOL(trace_array_abuse, false, 827 "trace out-of-bounds accesses to all arrays") 828 DEFINE_IMPLICATION(trace_array_abuse, trace_js_array_abuse) 829 DEFINE_IMPLICATION(trace_array_abuse, trace_external_array_abuse) 830 831 // debugger 832 DEFINE_BOOL(trace_debug_json, false, "trace debugging JSON request/response") 833 DEFINE_BOOL(enable_liveedit, true, "enable liveedit experimental feature") 834 DEFINE_BOOL( 835 trace_side_effect_free_debug_evaluate, false, 836 "print debug messages for side-effect-free debug-evaluate for testing") 837 DEFINE_BOOL(hard_abort, true, "abort by crashing") 838 839 // execution.cc 840 DEFINE_INT(stack_size, V8_DEFAULT_STACK_SIZE_KB, 841 "default size of stack region v8 is allowed to use (in kBytes)") 842 843 // frames.cc 844 DEFINE_INT(max_stack_trace_source_length, 300, 845 "maximum length of function source code printed in a stack trace.") 846 847 // full-codegen.cc 848 DEFINE_BOOL(always_inline_smi_code, false, 849 "always inline smi code in non-opt code") 850 DEFINE_BOOL(verify_operand_stack_depth, false, 851 "emit debug code that verifies the static tracking of the operand " 852 "stack depth") 853 854 // execution.cc, messages.cc 855 DEFINE_BOOL(clear_exceptions_on_js_entry, false, 856 "clear pending exceptions when entering JavaScript") 857 858 // counters.cc 859 DEFINE_INT(histogram_interval, 600000, 860 "time interval in ms for aggregating memory histograms") 861 862 // global-handles.cc 863 DEFINE_BOOL(trace_object_groups, false, 864 "print object groups detected during each garbage collection") 865 866 // heap-snapshot-generator.cc 867 DEFINE_BOOL(heap_profiler_trace_objects, false, 868 "Dump heap object allocations/movements/size_updates") 869 870 871 // sampling-heap-profiler.cc 872 DEFINE_BOOL(sampling_heap_profiler_suppress_randomness, false, 873 "Use constant sample intervals to eliminate test flakiness") 874 875 876 // v8.cc 877 DEFINE_BOOL(use_idle_notification, true, 878 "Use idle notification to reduce memory footprint.") 879 // ic.cc 880 DEFINE_BOOL(use_ic, true, "use inline caching") 881 DEFINE_BOOL(trace_ic, false, "trace inline cache state transitions") 882 DEFINE_IMPLICATION(trace_ic, log_code) 883 DEFINE_INT(ic_stats, 0, "inline cache state transitions statistics") 884 DEFINE_VALUE_IMPLICATION(trace_ic, ic_stats, 1) 885 DEFINE_BOOL_READONLY(track_constant_fields, false, 886 "enable constant field tracking") 887 888 // macro-assembler-ia32.cc 889 DEFINE_BOOL(native_code_counters, false, 890 "generate extra code for manipulating stats counters") 891 892 // objects.cc 893 DEFINE_BOOL(thin_strings, false, "Enable ThinString support") 894 DEFINE_BOOL(trace_weak_arrays, false, "Trace WeakFixedArray usage") 895 DEFINE_BOOL(trace_prototype_users, false, 896 "Trace updates to prototype user tracking") 897 DEFINE_BOOL(use_verbose_printer, true, "allows verbose printing") 898 DEFINE_BOOL(trace_for_in_enumerate, false, "Trace for-in enumerate slow-paths") 899 #if TRACE_MAPS 900 DEFINE_BOOL(trace_maps, false, "trace map creation") 901 #endif 902 903 // parser.cc 904 DEFINE_BOOL(allow_natives_syntax, false, "allow natives syntax") 905 DEFINE_BOOL(trace_parse, false, "trace parsing and preparsing") 906 DEFINE_BOOL(trace_preparse, false, "trace preparsing decisions") 907 DEFINE_BOOL(lazy_inner_functions, true, "enable lazy parsing inner functions") 908 DEFINE_BOOL(aggressive_lazy_inner_functions, false, 909 "even lazier inner function parsing") 910 DEFINE_IMPLICATION(aggressive_lazy_inner_functions, lazy_inner_functions) 911 DEFINE_BOOL(preparser_scope_analysis, false, 912 "perform scope analysis for preparsed inner functions") 913 DEFINE_IMPLICATION(preparser_scope_analysis, lazy_inner_functions) 914 915 // simulator-arm.cc, simulator-arm64.cc and simulator-mips.cc 916 DEFINE_BOOL(trace_sim, false, "Trace simulator execution") 917 DEFINE_BOOL(debug_sim, false, "Enable debugging the simulator") 918 DEFINE_BOOL(check_icache, false, 919 "Check icache flushes in ARM and MIPS simulator") 920 DEFINE_INT(stop_sim_at, 0, "Simulator stop after x number of instructions") 921 #if defined(V8_TARGET_ARCH_ARM64) || defined(V8_TARGET_ARCH_MIPS64) || \ 922 defined(V8_TARGET_ARCH_PPC64) 923 DEFINE_INT(sim_stack_alignment, 16, 924 "Stack alignment in bytes in simulator. This must be a power of two " 925 "and it must be at least 16. 16 is default.") 926 #else 927 DEFINE_INT(sim_stack_alignment, 8, 928 "Stack alingment in bytes in simulator (4 or 8, 8 is default)") 929 #endif 930 DEFINE_INT(sim_stack_size, 2 * MB / KB, 931 "Stack size of the ARM64, MIPS64 and PPC64 simulator " 932 "in kBytes (default is 2 MB)") 933 DEFINE_BOOL(log_regs_modified, true, 934 "When logging register values, only print modified registers.") 935 DEFINE_BOOL(log_colour, ENABLE_LOG_COLOUR, 936 "When logging, try to use coloured output.") 937 DEFINE_BOOL(ignore_asm_unimplemented_break, false, 938 "Don't break for ASM_UNIMPLEMENTED_BREAK macros.") 939 DEFINE_BOOL(trace_sim_messages, false, 940 "Trace simulator debug messages. Implied by --trace-sim.") 941 942 // isolate.cc 943 DEFINE_BOOL(stack_trace_on_illegal, false, 944 "print stack trace when an illegal exception is thrown") 945 DEFINE_BOOL(abort_on_uncaught_exception, false, 946 "abort program (dump core) when an uncaught exception is thrown") 947 DEFINE_BOOL(abort_on_stack_overflow, false, 948 "Abort program when stack overflow (as opposed to throwing " 949 "RangeError). This is useful for fuzzing where the spec behaviour " 950 "would introduce nondeterminism.") 951 DEFINE_BOOL(randomize_hashes, true, 952 "randomize hashes to avoid predictable hash collisions " 953 "(with snapshots this option cannot override the baked-in seed)") 954 DEFINE_INT(hash_seed, 0, 955 "Fixed seed to use to hash property keys (0 means random)" 956 "(with snapshots this option cannot override the baked-in seed)") 957 DEFINE_INT(random_seed, 0, 958 "Default seed for initializing random generator " 959 "(0, the default, means to use system random).") 960 DEFINE_BOOL(trace_rail, false, "trace RAIL mode") 961 DEFINE_BOOL(print_all_exceptions, false, 962 "print exception object and stack trace on each thrown exception") 963 964 // runtime.cc 965 DEFINE_BOOL(runtime_call_stats, false, "report runtime call counts and times") 966 DEFINE_INT(runtime_stats, 0, 967 "internal usage only for controlling runtime statistics") 968 DEFINE_VALUE_IMPLICATION(runtime_call_stats, runtime_stats, 1) 969 970 // snapshot-common.cc 971 DEFINE_BOOL(profile_deserialization, false, 972 "Print the time it takes to deserialize the snapshot.") 973 DEFINE_BOOL(serialization_statistics, false, 974 "Collect statistics on serialized objects.") 975 976 // Regexp 977 DEFINE_BOOL(regexp_optimization, true, "generate optimized regexp code") 978 979 // Testing flags test/cctest/test-{flags,api,serialization}.cc 980 DEFINE_BOOL(testing_bool_flag, true, "testing_bool_flag") 981 DEFINE_MAYBE_BOOL(testing_maybe_bool_flag, "testing_maybe_bool_flag") 982 DEFINE_INT(testing_int_flag, 13, "testing_int_flag") 983 DEFINE_FLOAT(testing_float_flag, 2.5, "float-flag") 984 DEFINE_STRING(testing_string_flag, "Hello, world!", "string-flag") 985 DEFINE_INT(testing_prng_seed, 42, "Seed used for threading test randomness") 986 987 // mksnapshot.cc 988 DEFINE_STRING(startup_src, NULL, 989 "Write V8 startup as C++ src. (mksnapshot only)") 990 DEFINE_STRING(startup_blob, NULL, 991 "Write V8 startup blob file. (mksnapshot only)") 992 993 // code-stubs-hydrogen.cc 994 DEFINE_BOOL(profile_hydrogen_code_stub_compilation, false, 995 "Print the time it takes to lazily compile hydrogen code stubs.") 996 997 // 998 // Dev shell flags 999 // 1000 1001 DEFINE_BOOL(help, false, "Print usage message, including flags, on console") 1002 DEFINE_BOOL(dump_counters, false, "Dump counters on exit") 1003 DEFINE_BOOL(dump_counters_nvp, false, 1004 "Dump counters as name-value pairs on exit") 1005 1006 DEFINE_STRING(map_counters, "", "Map counters to a file") 1007 DEFINE_ARGS(js_arguments, 1008 "Pass all remaining arguments to the script. Alias for \"--\".") 1009 1010 // 1011 // GDB JIT integration flags. 1012 // 1013 #undef FLAG 1014 #ifdef ENABLE_GDB_JIT_INTERFACE 1015 #define FLAG FLAG_FULL 1016 #else 1017 #define FLAG FLAG_READONLY 1018 #endif 1019 1020 DEFINE_BOOL(gdbjit, false, "enable GDBJIT interface") 1021 DEFINE_BOOL(gdbjit_full, false, "enable GDBJIT interface for all code objects") 1022 DEFINE_BOOL(gdbjit_dump, false, "dump elf objects with debug info to disk") 1023 DEFINE_STRING(gdbjit_dump_filter, "", 1024 "dump only objects containing this substring") 1025 1026 #ifdef ENABLE_GDB_JIT_INTERFACE 1027 DEFINE_IMPLICATION(gdbjit_full, gdbjit) 1028 DEFINE_IMPLICATION(gdbjit_dump, gdbjit) 1029 #endif 1030 DEFINE_NEG_IMPLICATION(gdbjit, compact_code_space) 1031 1032 // 1033 // Debug only flags 1034 // 1035 #undef FLAG 1036 #ifdef DEBUG 1037 #define FLAG FLAG_FULL 1038 #else 1039 #define FLAG FLAG_READONLY 1040 #endif 1041 1042 // checks.cc 1043 #ifdef ENABLE_SLOW_DCHECKS 1044 DEFINE_BOOL(enable_slow_asserts, false, 1045 "enable asserts that are slow to execute") 1046 #endif 1047 1048 // codegen-ia32.cc / codegen-arm.cc / macro-assembler-*.cc 1049 DEFINE_BOOL(print_ast, false, "print source AST") 1050 DEFINE_BOOL(print_builtin_ast, false, "print source AST for builtins") 1051 DEFINE_BOOL(trap_on_abort, false, "replace aborts by breakpoints") 1052 1053 // compiler.cc 1054 DEFINE_BOOL(print_builtin_scopes, false, "print scopes for builtins") 1055 DEFINE_BOOL(print_scopes, false, "print scopes") 1056 1057 // contexts.cc 1058 DEFINE_BOOL(trace_contexts, false, "trace contexts operations") 1059 1060 // heap.cc 1061 DEFINE_BOOL(gc_verbose, false, "print stuff during garbage collection") 1062 DEFINE_BOOL(heap_stats, false, "report heap statistics before and after GC") 1063 DEFINE_BOOL(code_stats, false, "report code statistics after GC") 1064 DEFINE_BOOL(print_handles, false, "report handles after GC") 1065 DEFINE_BOOL(check_handle_count, false, 1066 "Check that there are not too many handles at GC") 1067 DEFINE_BOOL(print_global_handles, false, "report global handles after GC") 1068 1069 // TurboFan debug-only flags. 1070 DEFINE_BOOL(print_turbo_replay, false, 1071 "print C++ code to recreate TurboFan graphs") 1072 DEFINE_BOOL(trace_turbo_escape, false, "enable tracing in escape analysis") 1073 1074 // objects.cc 1075 DEFINE_BOOL(trace_normalization, false, 1076 "prints when objects are turned into dictionaries.") 1077 1078 // runtime.cc 1079 DEFINE_BOOL(trace_lazy, false, "trace lazy compilation") 1080 1081 // spaces.cc 1082 DEFINE_BOOL(collect_heap_spill_statistics, false, 1083 "report heap spill statistics along with heap_stats " 1084 "(requires heap_stats)") 1085 DEFINE_BOOL(trace_live_bytes, false, 1086 "trace incrementing and resetting of live bytes") 1087 DEFINE_BOOL(trace_isolates, false, "trace isolate state changes") 1088 1089 // Regexp 1090 DEFINE_BOOL(regexp_possessive_quantifier, false, 1091 "enable possessive quantifier syntax for testing") 1092 DEFINE_BOOL(trace_regexp_bytecodes, false, "trace regexp bytecode execution") 1093 DEFINE_BOOL(trace_regexp_assembler, false, 1094 "trace regexp macro assembler calls.") 1095 DEFINE_BOOL(trace_regexp_parser, false, "trace regexp parsing") 1096 1097 // Debugger 1098 DEFINE_BOOL(print_break_location, false, "print source location on debug break") 1099 1100 // wasm instance management 1101 DEFINE_BOOL(trace_wasm_instances, false, 1102 "trace creation and collection of wasm instances") 1103 1104 // 1105 // Logging and profiling flags 1106 // 1107 #undef FLAG 1108 #define FLAG FLAG_FULL 1109 1110 // log.cc 1111 DEFINE_BOOL(log, false, 1112 "Minimal logging (no API, code, GC, suspect, or handles samples).") 1113 DEFINE_BOOL(log_all, false, "Log all events to the log file.") 1114 DEFINE_BOOL(log_api, false, "Log API events to the log file.") 1115 DEFINE_BOOL(log_code, false, 1116 "Log code events to the log file without profiling.") 1117 DEFINE_BOOL(log_gc, false, 1118 "Log heap samples on garbage collection for the hp2ps tool.") 1119 DEFINE_BOOL(log_handles, false, "Log global handle events.") 1120 DEFINE_BOOL(log_suspect, false, "Log suspect operations.") 1121 DEFINE_BOOL(prof, false, 1122 "Log statistical profiling information (implies --log-code).") 1123 DEFINE_BOOL(prof_cpp, false, "Like --prof, but ignore generated code.") 1124 DEFINE_IMPLICATION(prof, prof_cpp) 1125 DEFINE_BOOL(prof_browser_mode, true, 1126 "Used with --prof, turns on browser-compatible mode for profiling.") 1127 DEFINE_STRING(logfile, "v8.log", "Specify the name of the log file.") 1128 DEFINE_BOOL(logfile_per_isolate, true, "Separate log files for each isolate.") 1129 DEFINE_BOOL(ll_prof, false, "Enable low-level linux profiler.") 1130 DEFINE_BOOL(perf_basic_prof, false, 1131 "Enable perf linux profiler (basic support).") 1132 DEFINE_NEG_IMPLICATION(perf_basic_prof, compact_code_space) 1133 DEFINE_BOOL(perf_basic_prof_only_functions, false, 1134 "Only report function code ranges to perf (i.e. no stubs).") 1135 DEFINE_IMPLICATION(perf_basic_prof_only_functions, perf_basic_prof) 1136 DEFINE_BOOL(perf_prof, false, 1137 "Enable perf linux profiler (experimental annotate support).") 1138 DEFINE_NEG_IMPLICATION(perf_prof, compact_code_space) 1139 DEFINE_BOOL(perf_prof_unwinding_info, false, 1140 "Enable unwinding info for perf linux profiler (experimental).") 1141 DEFINE_IMPLICATION(perf_prof, perf_prof_unwinding_info) 1142 DEFINE_STRING(gc_fake_mmap, "/tmp/__v8_gc__", 1143 "Specify the name of the file for fake gc mmap used in ll_prof") 1144 DEFINE_BOOL(log_internal_timer_events, false, "Time internal events.") 1145 DEFINE_BOOL(log_timer_events, false, 1146 "Time events including external callbacks.") 1147 DEFINE_IMPLICATION(log_timer_events, log_internal_timer_events) 1148 DEFINE_IMPLICATION(log_internal_timer_events, prof) 1149 DEFINE_BOOL(log_instruction_stats, false, "Log AArch64 instruction statistics.") 1150 DEFINE_STRING(log_instruction_file, "arm64_inst.csv", 1151 "AArch64 instruction statistics log file.") 1152 DEFINE_INT(log_instruction_period, 1 << 22, 1153 "AArch64 instruction statistics logging period.") 1154 1155 DEFINE_BOOL(redirect_code_traces, false, 1156 "output deopt information and disassembly into file " 1157 "code-<pid>-<isolate id>.asm") 1158 DEFINE_STRING(redirect_code_traces_to, NULL, 1159 "output deopt information and disassembly into the given file") 1160 1161 DEFINE_BOOL(hydrogen_track_positions, false, 1162 "track source code positions when building IR") 1163 1164 DEFINE_BOOL(print_opt_source, false, 1165 "print source code of optimized and inlined functions") 1166 DEFINE_IMPLICATION(hydrogen_track_positions, print_opt_source) 1167 1168 // 1169 // Disassembler only flags 1170 // 1171 #undef FLAG 1172 #ifdef ENABLE_DISASSEMBLER 1173 #define FLAG FLAG_FULL 1174 #else 1175 #define FLAG FLAG_READONLY 1176 #endif 1177 1178 // elements.cc 1179 DEFINE_BOOL(trace_elements_transitions, false, "trace elements transitions") 1180 1181 DEFINE_BOOL(trace_creation_allocation_sites, false, 1182 "trace the creation of allocation sites") 1183 1184 // code-stubs.cc 1185 DEFINE_BOOL(print_code_stubs, false, "print code stubs") 1186 DEFINE_BOOL(test_secondary_stub_cache, false, 1187 "test secondary stub cache by disabling the primary one") 1188 1189 DEFINE_BOOL(test_primary_stub_cache, false, 1190 "test primary stub cache by disabling the secondary one") 1191 1192 DEFINE_BOOL(test_small_max_function_context_stub_size, false, 1193 "enable testing the function context size overflow path " 1194 "by making the maximum size smaller") 1195 1196 // codegen-ia32.cc / codegen-arm.cc 1197 DEFINE_BOOL(print_code, false, "print generated code") 1198 DEFINE_BOOL(print_opt_code, false, "print optimized code") 1199 DEFINE_STRING(print_opt_code_filter, "*", "filter for printing optimized code") 1200 DEFINE_BOOL(print_unopt_code, false, 1201 "print unoptimized code before " 1202 "printing optimized code based on it") 1203 DEFINE_BOOL(print_code_verbose, false, "print more information for code") 1204 DEFINE_BOOL(print_builtin_code, false, "print generated code for builtins") 1205 1206 #ifdef ENABLE_DISASSEMBLER 1207 DEFINE_BOOL(sodium, false, 1208 "print generated code output suitable for use with " 1209 "the Sodium code viewer") 1210 1211 DEFINE_IMPLICATION(sodium, print_code_stubs) 1212 DEFINE_IMPLICATION(sodium, print_code) 1213 DEFINE_IMPLICATION(sodium, print_opt_code) 1214 DEFINE_IMPLICATION(sodium, hydrogen_track_positions) 1215 DEFINE_IMPLICATION(sodium, code_comments) 1216 1217 DEFINE_BOOL(print_all_code, false, "enable all flags related to printing code") 1218 DEFINE_IMPLICATION(print_all_code, print_code) 1219 DEFINE_IMPLICATION(print_all_code, print_opt_code) 1220 DEFINE_IMPLICATION(print_all_code, print_unopt_code) 1221 DEFINE_IMPLICATION(print_all_code, print_code_verbose) 1222 DEFINE_IMPLICATION(print_all_code, print_builtin_code) 1223 DEFINE_IMPLICATION(print_all_code, print_code_stubs) 1224 DEFINE_IMPLICATION(print_all_code, code_comments) 1225 #ifdef DEBUG 1226 DEFINE_IMPLICATION(print_all_code, trace_codegen) 1227 #endif 1228 #endif 1229 1230 #undef FLAG 1231 #define FLAG FLAG_FULL 1232 1233 // 1234 // Predictable mode related flags. 1235 // 1236 1237 DEFINE_BOOL(predictable, false, "enable predictable mode") 1238 DEFINE_IMPLICATION(predictable, single_threaded) 1239 DEFINE_NEG_IMPLICATION(predictable, memory_reducer) 1240 DEFINE_VALUE_IMPLICATION(single_threaded, wasm_num_compilation_tasks, 0) 1241 1242 // 1243 // Threading related flags. 1244 // 1245 1246 DEFINE_BOOL(single_threaded, false, "disable the use of background tasks") 1247 DEFINE_NEG_IMPLICATION(single_threaded, concurrent_recompilation) 1248 DEFINE_NEG_IMPLICATION(single_threaded, concurrent_sweeping) 1249 DEFINE_NEG_IMPLICATION(single_threaded, parallel_compaction) 1250 1251 1252 #undef FLAG 1253 1254 #ifdef VERIFY_PREDICTABLE 1255 #define FLAG FLAG_FULL 1256 #else 1257 #define FLAG FLAG_READONLY 1258 #endif 1259 1260 DEFINE_BOOL(verify_predictable, false, 1261 "this mode is used for checking that V8 behaves predictably") 1262 DEFINE_INT(dump_allocations_digest_at_alloc, -1, 1263 "dump allocations digest each n-th allocation") 1264 1265 // 1266 // Read-only flags 1267 // 1268 #undef FLAG 1269 #define FLAG FLAG_READONLY 1270 1271 // assembler.h 1272 DEFINE_BOOL(enable_embedded_constant_pool, V8_EMBEDDED_CONSTANT_POOL, 1273 "enable use of embedded constant pools (ARM/PPC only)") 1274 1275 DEFINE_BOOL(unbox_double_fields, V8_DOUBLE_FIELDS_UNBOXING, 1276 "enable in-object double fields unboxing (64-bit only)") 1277 DEFINE_IMPLICATION(unbox_double_fields, track_double_fields) 1278 1279 // Cleanup... 1280 #undef FLAG_FULL 1281 #undef FLAG_READONLY 1282 #undef FLAG 1283 #undef FLAG_ALIAS 1284 1285 #undef DEFINE_BOOL 1286 #undef DEFINE_MAYBE_BOOL 1287 #undef DEFINE_INT 1288 #undef DEFINE_STRING 1289 #undef DEFINE_FLOAT 1290 #undef DEFINE_ARGS 1291 #undef DEFINE_IMPLICATION 1292 #undef DEFINE_NEG_IMPLICATION 1293 #undef DEFINE_NEG_VALUE_IMPLICATION 1294 #undef DEFINE_VALUE_IMPLICATION 1295 #undef DEFINE_ALIAS_BOOL 1296 #undef DEFINE_ALIAS_INT 1297 #undef DEFINE_ALIAS_STRING 1298 #undef DEFINE_ALIAS_FLOAT 1299 #undef DEFINE_ALIAS_ARGS 1300 1301 #undef FLAG_MODE_DECLARE 1302 #undef FLAG_MODE_DEFINE 1303 #undef FLAG_MODE_DEFINE_DEFAULTS 1304 #undef FLAG_MODE_META 1305 #undef FLAG_MODE_DEFINE_IMPLICATIONS 1306 1307 #undef COMMA 1308
