diff --git a/doc/node.1 b/doc/node.1 index f17ccdae1a..2621b94d57 100644 --- a/doc/node.1 +++ b/doc/node.1 @@ -54,30 +54,38 @@ If set to 1 then colors will not be used in the REPL. .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) 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) type: bool default: false - --harmony_weakmaps (enable harmony weak maps) + --harmony_collections (enable harmony collections (sets, maps, and weak maps)) type: bool default: false - --harmony_block_scoping (enable harmony block scoping) + --harmony (enable all harmony features (except typeof)) type: bool default: false - --unbox_double_arrays (automatically unbox arrays of doubles) - type: bool default: true - --string_slices (use string slices) + --packed_arrays (optimizes arrays that have no holes) type: bool default: false - --crankshaft (use crankshaft) + --smi_only_arrays (tracks arrays with only smi values) type: bool default: true - --hydrogen_filter (hydrogen use/trace filter) - type: string default: - --use_hydrogen (use generated hydrogen for compilation) + --clever_optimizations (Optimize object size, Array shift, DOM strings and string +) type: bool default: true - --build_lithium (use lithium chunk builder) + --unbox_double_arrays (automatically unbox arrays of doubles) type: bool default: true - --alloc_lithium (use lithium register allocator) + --string_slices (use string slices) type: bool default: true - --use_lithium (use lithium code generator) + --crankshaft (use crankshaft) type: bool default: true + --hydrogen_filter (optimization filter) + type: string default: --use_range (use hydrogen range analysis) type: bool default: true --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 --use_inlining (use function inlining) type: bool default: true - --limit_inlining (limit code size growth from inlining) - type: bool default: true - --eliminate_empty_blocks (eliminate empty blocks) - type: bool default: true + --max_inlined_source_size (maximum source size in bytes considered for a single inlining) + type: int default: 600 + --max_inlined_nodes (maximum number of AST nodes considered for a single inlining) + 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) 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) type: bool default: false --trace_hydrogen (trace generated hydrogen to file) type: bool default: false + --trace_phase (trace generated IR for specified phases) + type: string default: Z --trace_inlining (trace inlining decisions) type: bool default: false --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 --use_osr (use on-stack replacement) 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) type: bool default: false --stress_runs (number of stress runs) type: int default: 0 --optimize_closures (optimize closures) 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) type: bool default: false --code_comments (emit comments in code disassembly) 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) type: bool default: true --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 --stack_trace_limit (number of stack frames to capture) 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) type: bool default: false --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 --opt (use adaptive optimizations) type: bool default: true - --opt_eagerly (be more eager when adaptively optimizing) - type: bool default: false --always_opt (always try to optimize functions) type: bool default: false --prepare_always_opt (prepare for turning on always opt) type: bool default: false - --deopt (support deoptimization) - type: bool default: true --trace_deopt (trace deoptimization) type: bool default: false --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 --enable_liveedit (enable liveedit experimental feature) type: bool default: true - --stack_size (default size of stack region v8 is allowed to use (in KkBytes)) - type: int default: 1024 + --break_on_abort (always cause a debug break before aborting) + 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.) type: int default: 300 --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 --trace_gc_verbose (print more details following each garbage collection) 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) type: bool default: true --flush_code (flush code that we expect not to use again before full gc) 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.) type: bool default: true + --send_idle_notification (Send idle notifcation between stress runs.) + type: bool default: false --use_ic (use inline caching) type: bool default: true --native_code_counters (generate extra code for manipulating stats counters) type: bool default: false --always_compact (Perform compaction on every full GC) 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) 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.) type: bool default: true --random_seed (Default seed for initializing random generator (0, the default, means to use system random).) 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) type: bool default: true --allow_natives_syntax (allow natives syntax) type: bool default: false - --strict_mode (allow strict mode directives) - type: bool default: true --trace_sim (Trace simulator execution) 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 --stop_sim_at (Simulator stop after x number of instructions) 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 --regexp_optimization (generate optimized regexp code) type: bool default: true - --regexp_entry_native (use native code to enter regexp) - type: bool default: true --testing_bool_flag (testing_bool_flag) type: bool default: true --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) type: int default: 5858 --map_counters (Map counters to a file) - type: string default: + type: string default: --js_arguments (Pass all remaining arguments to the script. Alias for "--".) - type: arguments default: + type: arguments default: --debug_compile_events (Enable debugger compile events) type: bool default: true --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) type: bool default: false --gdbjit_dump_filter (dump only objects containing this substring) - type: string default: - --enable_slow_asserts (enable asserts that are slow to execute) - 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: string default: + --force_marking_deque_overflows (force overflows of marking deque by reducing it's size to 64 words) type: bool default: false - --code_stats (report code statistics after GC) - 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.) + --stress_compaction (stress the GC compactor to flush out bugs (implies --force_marking_deque_overflows)) type: bool default: false --log (Minimal logging (no API, code, GC, suspect, or handles samples).) 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 --ll_prof (Enable low-level linux profiler.) 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