Browse Source

doc: update v8-options in man page

v0.9.1-release
isaacs 13 years ago
parent
commit
a0a5c4c5af
  1. 207
      doc/node.1

207
doc/node.1

@ -54,30 +54,38 @@ If set to 1 then colors will not be used in the REPL.
.SH V8 OPTIONS .SH V8 OPTIONS
--use_strict (enforce strict mode)
type: bool default: false
--es5_readonly (activate correct semantics for inheriting readonliness)
type: bool default: false
--es52_globals (activate new semantics for global var declarations)
type: bool default: false
--harmony_typeof (enable harmony semantics for typeof) --harmony_typeof (enable harmony semantics for typeof)
type: bool default: false type: bool default: false
--harmony_scoping (enable harmony block scoping)
type: bool default: false
--harmony_modules (enable harmony modules (implies block scoping))
type: bool default: false
--harmony_proxies (enable harmony proxies) --harmony_proxies (enable harmony proxies)
type: bool default: false type: bool default: false
--harmony_weakmaps (enable harmony weak maps) --harmony_collections (enable harmony collections (sets, maps, and weak maps))
type: bool default: false type: bool default: false
--harmony_block_scoping (enable harmony block scoping) --harmony (enable all harmony features (except typeof))
type: bool default: false type: bool default: false
--unbox_double_arrays (automatically unbox arrays of doubles) --packed_arrays (optimizes arrays that have no holes)
type: bool default: true
--string_slices (use string slices)
type: bool default: false type: bool default: false
--crankshaft (use crankshaft) --smi_only_arrays (tracks arrays with only smi values)
type: bool default: true type: bool default: true
--hydrogen_filter (hydrogen use/trace filter) --clever_optimizations (Optimize object size, Array shift, DOM strings and string +)
type: string default:
--use_hydrogen (use generated hydrogen for compilation)
type: bool default: true type: bool default: true
--build_lithium (use lithium chunk builder) --unbox_double_arrays (automatically unbox arrays of doubles)
type: bool default: true type: bool default: true
--alloc_lithium (use lithium register allocator) --string_slices (use string slices)
type: bool default: true type: bool default: true
--use_lithium (use lithium code generator) --crankshaft (use crankshaft)
type: bool default: true type: bool default: true
--hydrogen_filter (optimization filter)
type: string default:
--use_range (use hydrogen range analysis) --use_range (use hydrogen range analysis)
type: bool default: true type: bool default: true
--eliminate_dead_phis (eliminate dead phis) --eliminate_dead_phis (eliminate dead phis)
@ -88,16 +96,22 @@ If set to 1 then colors will not be used in the REPL.
type: bool default: true type: bool default: true
--use_inlining (use function inlining) --use_inlining (use function inlining)
type: bool default: true type: bool default: true
--limit_inlining (limit code size growth from inlining) --max_inlined_source_size (maximum source size in bytes considered for a single inlining)
type: bool default: true type: int default: 600
--eliminate_empty_blocks (eliminate empty blocks) --max_inlined_nodes (maximum number of AST nodes considered for a single inlining)
type: bool default: true type: int default: 196
--max_inlined_nodes_cumulative (maximum cumulative number of AST nodes considered for inlining)
type: int default: 196
--loop_invariant_code_motion (loop invariant code motion) --loop_invariant_code_motion (loop invariant code motion)
type: bool default: true type: bool default: true
--collect_megamorphic_maps_from_stub_cache (crankshaft harvests type feedback from stub cache)
type: bool default: true
--hydrogen_stats (print statistics for hydrogen) --hydrogen_stats (print statistics for hydrogen)
type: bool default: false type: bool default: false
--trace_hydrogen (trace generated hydrogen to file) --trace_hydrogen (trace generated hydrogen to file)
type: bool default: false type: bool default: false
--trace_phase (trace generated IR for specified phases)
type: string default: Z
--trace_inlining (trace inlining decisions) --trace_inlining (trace inlining decisions)
type: bool default: false type: bool default: false
--trace_alloc (trace register allocator) --trace_alloc (trace register allocator)
@ -124,18 +138,54 @@ If set to 1 then colors will not be used in the REPL.
type: bool default: true type: bool default: true
--use_osr (use on-stack replacement) --use_osr (use on-stack replacement)
type: bool default: true type: bool default: true
--array_bounds_checks_elimination (perform array bounds checks elimination)
type: bool default: false
--array_index_dehoisting (perform array index dehoisting)
type: bool default: false
--trace_osr (trace on-stack replacement) --trace_osr (trace on-stack replacement)
type: bool default: false type: bool default: false
--stress_runs (number of stress runs) --stress_runs (number of stress runs)
type: int default: 0 type: int default: 0
--optimize_closures (optimize closures) --optimize_closures (optimize closures)
type: bool default: true type: bool default: true
--inline_construct (inline constructor calls)
type: bool default: true
--inline_arguments (inline functions with arguments object)
type: bool default: true
--loop_weight (loop weight for representation inference)
type: int default: 1
--optimize_for_in (optimize functions containing for-in loops)
type: bool default: true
--experimental_profiler (enable all profiler experiments)
type: bool default: true
--watch_ic_patching (profiler considers IC stability)
type: bool default: false
--frame_count (number of stack frames inspected by the profiler)
type: int default: 1
--self_optimization (primitive functions trigger their own optimization)
type: bool default: false
--direct_self_opt (call recompile stub directly when self-optimizing)
type: bool default: false
--retry_self_opt (re-try self-optimization if it failed)
type: bool default: false
--count_based_interrupts (trigger profiler ticks based on counting instead of timing)
type: bool default: false
--interrupt_at_exit (insert an interrupt check at function exit)
type: bool default: false
--weighted_back_edges (weight back edges by jump distance for interrupt triggering)
type: bool default: false
--interrupt_budget (execution budget before interrupt is triggered)
type: int default: 5900
--type_info_threshold (percentage of ICs that must have type info to allow optimization)
type: int default: 15
--self_opt_count (call count before self-optimization)
type: int default: 130
--trace_opt_verbose (extra verbose compilation tracing)
type: bool default: false
--debug_code (generate extra code (assertions) for debugging) --debug_code (generate extra code (assertions) for debugging)
type: bool default: false type: bool default: false
--code_comments (emit comments in code disassembly) --code_comments (emit comments in code disassembly)
type: bool default: false type: bool default: false
--peephole_optimization (perform peephole optimizations in assembly code)
type: bool default: true
--enable_sse2 (enable use of SSE2 instructions if available) --enable_sse2 (enable use of SSE2 instructions if available)
type: bool default: true type: bool default: true
--enable_sse3 (enable use of SSE3 instructions if available) --enable_sse3 (enable use of SSE3 instructions if available)
@ -164,6 +214,8 @@ If set to 1 then colors will not be used in the REPL.
type: bool default: false type: bool default: false
--stack_trace_limit (number of stack frames to capture) --stack_trace_limit (number of stack frames to capture)
type: int default: 10 type: int default: 10
--builtins_in_stack_traces (show built-in functions in stack traces)
type: bool default: false
--disable_native_files (disable builtin natives files) --disable_native_files (disable builtin natives files)
type: bool default: false type: bool default: false
--inline_new (use fast inline allocation) --inline_new (use fast inline allocation)
@ -182,14 +234,10 @@ If set to 1 then colors will not be used in the REPL.
type: bool default: false type: bool default: false
--opt (use adaptive optimizations) --opt (use adaptive optimizations)
type: bool default: true type: bool default: true
--opt_eagerly (be more eager when adaptively optimizing)
type: bool default: false
--always_opt (always try to optimize functions) --always_opt (always try to optimize functions)
type: bool default: false type: bool default: false
--prepare_always_opt (prepare for turning on always opt) --prepare_always_opt (prepare for turning on always opt)
type: bool default: false type: bool default: false
--deopt (support deoptimization)
type: bool default: true
--trace_deopt (trace deoptimization) --trace_deopt (trace deoptimization)
type: bool default: false type: bool default: false
--min_preparse_length (minimum length for automatic enable preparsing) --min_preparse_length (minimum length for automatic enable preparsing)
@ -208,8 +256,10 @@ If set to 1 then colors will not be used in the REPL.
type: bool default: true type: bool default: true
--enable_liveedit (enable liveedit experimental feature) --enable_liveedit (enable liveedit experimental feature)
type: bool default: true type: bool default: true
--stack_size (default size of stack region v8 is allowed to use (in KkBytes)) --break_on_abort (always cause a debug break before aborting)
type: int default: 1024 type: bool default: true
--stack_size (default size of stack region v8 is allowed to use (in kBytes))
type: int default: 984
--max_stack_trace_source_length (maximum length of function source code printed in a stack trace.) --max_stack_trace_source_length (maximum length of function source code printed in a stack trace.)
type: int default: 300 type: int default: 300
--always_inline_smi_code (always inline smi code in non-opt code) --always_inline_smi_code (always inline smi code in non-opt code)
@ -232,43 +282,45 @@ If set to 1 then colors will not be used in the REPL.
type: bool default: false type: bool default: false
--trace_gc_verbose (print more details following each garbage collection) --trace_gc_verbose (print more details following each garbage collection)
type: bool default: false type: bool default: false
--trace_fragmentation (report fragmentation for old pointer and data pages)
type: bool default: false
--collect_maps (garbage collect maps from which no objects can be reached) --collect_maps (garbage collect maps from which no objects can be reached)
type: bool default: true type: bool default: true
--flush_code (flush code that we expect not to use again before full gc) --flush_code (flush code that we expect not to use again before full gc)
type: bool default: true type: bool default: true
--incremental_marking (use incremental marking)
type: bool default: true
--incremental_marking_steps (do incremental marking steps)
type: bool default: true
--trace_incremental_marking (trace progress of the incremental marking)
type: bool default: false
--use_idle_notification (Use idle notification to reduce memory footprint.) --use_idle_notification (Use idle notification to reduce memory footprint.)
type: bool default: true type: bool default: true
--send_idle_notification (Send idle notifcation between stress runs.)
type: bool default: false
--use_ic (use inline caching) --use_ic (use inline caching)
type: bool default: true type: bool default: true
--native_code_counters (generate extra code for manipulating stats counters) --native_code_counters (generate extra code for manipulating stats counters)
type: bool default: false type: bool default: false
--always_compact (Perform compaction on every full GC) --always_compact (Perform compaction on every full GC)
type: bool default: false type: bool default: false
--lazy_sweeping (Use lazy sweeping for old pointer and data spaces)
type: bool default: true
--never_compact (Never perform compaction on full GC - testing only) --never_compact (Never perform compaction on full GC - testing only)
type: bool default: false type: bool default: false
--compact_code_space (Compact code space on full non-incremental collections)
type: bool default: true
--cleanup_code_caches_at_gc (Flush inline caches prior to mark compact collection and flush code caches in maps during mark compact cycle.) --cleanup_code_caches_at_gc (Flush inline caches prior to mark compact collection and flush code caches in maps during mark compact cycle.)
type: bool default: true type: bool default: true
--random_seed (Default seed for initializing random generator (0, the default, means to use system random).) --random_seed (Default seed for initializing random generator (0, the default, means to use system random).)
type: int default: 0 type: int default: 0
--canonicalize_object_literal_maps (Canonicalize maps for object literals.)
type: bool default: true
--use_big_map_space (Use big map space, but don't compact if it grew too big.)
type: bool default: true
--max_map_space_pages (Maximum number of pages in map space which still allows to encode forwarding pointers. That's actually a constant, but it's useful to control it with a flag for better testing.)
type: int default: 65535
--h (print this message)
type: bool default: false
--new_snapshot (use new snapshot implementation)
type: bool default: true
--use_verbose_printer (allows verbose printing) --use_verbose_printer (allows verbose printing)
type: bool default: true type: bool default: true
--allow_natives_syntax (allow natives syntax) --allow_natives_syntax (allow natives syntax)
type: bool default: false type: bool default: false
--strict_mode (allow strict mode directives)
type: bool default: true
--trace_sim (Trace simulator execution) --trace_sim (Trace simulator execution)
type: bool default: false type: bool default: false
--check_icache (Check icache flushes in ARM simulator) --check_icache (Check icache flushes in ARM and MIPS simulator)
type: bool default: false type: bool default: false
--stop_sim_at (Simulator stop after x number of instructions) --stop_sim_at (Simulator stop after x number of instructions)
type: int default: 0 type: int default: 0
@ -286,8 +338,6 @@ If set to 1 then colors will not be used in the REPL.
type: bool default: false type: bool default: false
--regexp_optimization (generate optimized regexp code) --regexp_optimization (generate optimized regexp code)
type: bool default: true type: bool default: true
--regexp_entry_native (use native code to enter regexp)
type: bool default: true
--testing_bool_flag (testing_bool_flag) --testing_bool_flag (testing_bool_flag)
type: bool default: true type: bool default: true
--testing_int_flag (testing_int_flag) --testing_int_flag (testing_int_flag)
@ -313,9 +363,9 @@ If set to 1 then colors will not be used in the REPL.
--debugger_port (Port to use for remote debugging) --debugger_port (Port to use for remote debugging)
type: int default: 5858 type: int default: 5858
--map_counters (Map counters to a file) --map_counters (Map counters to a file)
type: string default: type: string default:
--js_arguments (Pass all remaining arguments to the script. Alias for "--".) --js_arguments (Pass all remaining arguments to the script. Alias for "--".)
type: arguments default: type: arguments default:
--debug_compile_events (Enable debugger compile events) --debug_compile_events (Enable debugger compile events)
type: bool default: true type: bool default: true
--debug_script_collected_events (Enable debugger script collected events) --debug_script_collected_events (Enable debugger script collected events)
@ -327,66 +377,10 @@ If set to 1 then colors will not be used in the REPL.
--gdbjit_dump (dump elf objects with debug info to disk) --gdbjit_dump (dump elf objects with debug info to disk)
type: bool default: false type: bool default: false
--gdbjit_dump_filter (dump only objects containing this substring) --gdbjit_dump_filter (dump only objects containing this substring)
type: string default: type: string default:
--enable_slow_asserts (enable asserts that are slow to execute) --force_marking_deque_overflows (force overflows of marking deque by reducing it's size to 64 words)
type: bool default: false
--trace_codegen (print name of functions for which code is generated)
type: bool default: false
--print_source (pretty print source code)
type: bool default: false
--print_builtin_source (pretty print source code for builtins)
type: bool default: false
--print_ast (print source AST)
type: bool default: false
--print_builtin_ast (print source AST for builtins)
type: bool default: false
--print_json_ast (print source AST as JSON)
type: bool default: false
--print_builtin_json_ast (print source AST for builtins as JSON)
type: bool default: false
--stop_at (function name where to insert a breakpoint)
type: string default:
--verify_stack_height (verify stack height tracing on ia32)
type: bool default: false
--print_builtin_scopes (print scopes for builtins)
type: bool default: false
--print_scopes (print scopes)
type: bool default: false
--trace_contexts (trace contexts operations)
type: bool default: false
--gc_greedy (perform GC prior to some allocations)
type: bool default: false
--gc_verbose (print stuff during garbage collection)
type: bool default: false
--heap_stats (report heap statistics before and after GC)
type: bool default: false type: bool default: false
--code_stats (report code statistics after GC) --stress_compaction (stress the GC compactor to flush out bugs (implies --force_marking_deque_overflows))
type: bool default: false
--verify_heap (verify heap pointers before and after GC)
type: bool default: false
--print_handles (report handles after GC)
type: bool default: false
--print_global_handles (report global handles after GC)
type: bool default: false
--trace_ic (trace inline cache state transitions)
type: bool default: false
--trace_normalization (prints when objects are turned into dictionaries.)
type: bool default: false
--trace_lazy (trace lazy compilation)
type: bool default: false
--debug_serialization (write debug information into the snapshot.)
type: bool default: false
--collect_heap_spill_statistics (report heap spill statistics along with heap_stats (requires heap_stats))
type: bool default: false
--trace_isolates (trace isolate state changes)
type: bool default: false
--log_state_changes (Log state changes.)
type: bool default: false
--regexp_possessive_quantifier (enable possessive quantifier syntax for testing)
type: bool default: false
--trace_regexp_bytecodes (trace regexp bytecode execution)
type: bool default: false
--trace_regexp_assembler (trace regexp macro assembler calls.)
type: bool default: false type: bool default: false
--log (Minimal logging (no API, code, GC, suspect, or handles samples).) --log (Minimal logging (no API, code, GC, suspect, or handles samples).)
type: bool default: false type: bool default: false
@ -422,19 +416,6 @@ If set to 1 then colors will not be used in the REPL.
type: string default: v8.log type: string default: v8.log
--ll_prof (Enable low-level linux profiler.) --ll_prof (Enable low-level linux profiler.)
type: bool default: false type: bool default: false
--print_code_stubs (print code stubs)
type: bool default: false
--print_code (print generated code)
type: bool default: false
--print_opt_code (print optimized code)
type: bool default: false
--print_unopt_code (print unoptimized code before printing optimized code based on it)
type: bool default: false
--print_code_verbose (print more information for code)
type: bool default: false
--print_builtin_code (print generated code for builtins)
type: bool default: false
.SH RESOURCES AND DOCUMENTATION .SH RESOURCES AND DOCUMENTATION

Loading…
Cancel
Save