mirror of
https://github.com/nodejs/node.git
synced 2024-11-29 23:16:30 +01:00
447 lines
19 KiB
Groff
447 lines
19 KiB
Groff
.TH NODE.JS "1" "2010" "" ""
|
|
|
|
|
|
.SH "NAME"
|
|
node \- Server-side JavaScript
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
|
.B node
|
|
[
|
|
.B \-v
|
|
]
|
|
[
|
|
.B \-\-debug
|
|
|
|
|
.B \-\-debug-brk
|
|
]
|
|
[
|
|
.B \-\-v8-options
|
|
]
|
|
.br
|
|
[
|
|
.B \-e
|
|
.I command
|
|
|
|
|
.I script.js
|
|
]
|
|
[
|
|
.I arguments
|
|
]
|
|
|
|
Execute without arguments to start the REPL.
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
Node is a set of libraries for javascript which allows
|
|
it to be used outside of the browser. It is primarily
|
|
focused on creating simple, easy to build network clients
|
|
and servers.
|
|
|
|
|
|
.SH OPTIONS
|
|
|
|
-v, --version print node's version
|
|
|
|
-e, --eval script evaluate script
|
|
|
|
-p, --print print result of --eval
|
|
|
|
-i, --interactive always enter the REPL even if stdin
|
|
does not appear to be a terminal
|
|
|
|
--no-deprecation silence deprecation warnings
|
|
|
|
--trace-deprecation show stack traces on deprecations
|
|
|
|
--v8-options print v8 command line options
|
|
|
|
--max-stack-size=val set max v8 stack size (bytes)
|
|
|
|
|
|
.SH ENVIRONMENT VARIABLES
|
|
|
|
.IP NODE_PATH
|
|
\':\'\-separated list of directories prefixed to the module search path.
|
|
|
|
.IP NODE_MODULE_CONTEXTS
|
|
If set to 1 then modules will load in their own global contexts.
|
|
|
|
.IP NODE_DISABLE_COLORS
|
|
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_collections (enable harmony collections (sets, maps, and weak maps))
|
|
type: bool default: false
|
|
--harmony (enable all harmony features (except typeof))
|
|
type: bool default: false
|
|
--packed_arrays (optimizes arrays that have no holes)
|
|
type: bool default: false
|
|
--smi_only_arrays (tracks arrays with only smi values)
|
|
type: bool default: true
|
|
--clever_optimizations (Optimize object size, Array shift, DOM strings and string +)
|
|
type: bool default: true
|
|
--unbox_double_arrays (automatically unbox arrays of doubles)
|
|
type: bool default: true
|
|
--string_slices (use string slices)
|
|
type: bool default: true
|
|
--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)
|
|
type: bool default: true
|
|
--use_gvn (use hydrogen global value numbering)
|
|
type: bool default: true
|
|
--use_canonicalizing (use hydrogen instruction canonicalizing)
|
|
type: bool default: true
|
|
--use_inlining (use function inlining)
|
|
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)
|
|
type: bool default: false
|
|
--trace_all_uses (trace all use positions)
|
|
type: bool default: false
|
|
--trace_range (trace range analysis)
|
|
type: bool default: false
|
|
--trace_gvn (trace global value numbering)
|
|
type: bool default: false
|
|
--trace_representation (trace representation types)
|
|
type: bool default: false
|
|
--stress_pointer_maps (pointer map for every instruction)
|
|
type: bool default: false
|
|
--stress_environments (environment for every instruction)
|
|
type: bool default: false
|
|
--deopt_every_n_times (deoptimize every n times a deopt point is passed)
|
|
type: int default: 0
|
|
--trap_on_deopt (put a break point before deoptimizing)
|
|
type: bool default: false
|
|
--deoptimize_uncommon_cases (deoptimize uncommon cases)
|
|
type: bool default: true
|
|
--polymorphic_inlining (polymorphic inlining)
|
|
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
|
|
--enable_sse2 (enable use of SSE2 instructions if available)
|
|
type: bool default: true
|
|
--enable_sse3 (enable use of SSE3 instructions if available)
|
|
type: bool default: true
|
|
--enable_sse4_1 (enable use of SSE4.1 instructions if available)
|
|
type: bool default: true
|
|
--enable_cmov (enable use of CMOV instruction if available)
|
|
type: bool default: true
|
|
--enable_rdtsc (enable use of RDTSC instruction if available)
|
|
type: bool default: true
|
|
--enable_sahf (enable use of SAHF instruction if available (X64 only))
|
|
type: bool default: true
|
|
--enable_vfp3 (enable use of VFP3 instructions if available - this implies enabling ARMv7 instructions (ARM only))
|
|
type: bool default: true
|
|
--enable_armv7 (enable use of ARMv7 instructions if available (ARM only))
|
|
type: bool default: true
|
|
--enable_fpu (enable use of MIPS FPU instructions if available (MIPS only))
|
|
type: bool default: true
|
|
--expose_natives_as (expose natives in global object)
|
|
type: string default: NULL
|
|
--expose_debug_as (expose debug in global object)
|
|
type: string default: NULL
|
|
--expose_gc (expose gc extension)
|
|
type: bool default: false
|
|
--expose_externalize_string (expose externalize string extension)
|
|
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)
|
|
type: bool default: true
|
|
--stack_trace_on_abort (print a stack trace if an assertion failure occurs)
|
|
type: bool default: true
|
|
--trace (trace function calls)
|
|
type: bool default: false
|
|
--mask_constants_with_cookie (use random jit cookie to mask large constants)
|
|
type: bool default: true
|
|
--lazy (use lazy compilation)
|
|
type: bool default: true
|
|
--trace_opt (trace lazy optimization)
|
|
type: bool default: false
|
|
--trace_opt_stats (trace lazy optimization statistics)
|
|
type: bool default: false
|
|
--opt (use adaptive optimizations)
|
|
type: bool default: true
|
|
--always_opt (always try to optimize functions)
|
|
type: bool default: false
|
|
--prepare_always_opt (prepare for turning on always opt)
|
|
type: bool default: false
|
|
--trace_deopt (trace deoptimization)
|
|
type: bool default: false
|
|
--min_preparse_length (minimum length for automatic enable preparsing)
|
|
type: int default: 1024
|
|
--always_full_compiler (try to use the dedicated run-once backend for all code)
|
|
type: bool default: false
|
|
--trace_bailout (print reasons for falling back to using the classic V8 backend)
|
|
type: bool default: false
|
|
--compilation_cache (enable compilation cache)
|
|
type: bool default: true
|
|
--cache_prototype_transitions (cache prototype transitions)
|
|
type: bool default: true
|
|
--trace_debug_json (trace debugging JSON request/response)
|
|
type: bool default: false
|
|
--debugger_auto_break (automatically set the debug break flag when debugger commands are in the queue)
|
|
type: bool default: true
|
|
--enable_liveedit (enable liveedit experimental feature)
|
|
type: bool default: true
|
|
--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)
|
|
type: bool default: false
|
|
--max_new_space_size (max size of the new generation (in kBytes))
|
|
type: int default: 0
|
|
--max_old_space_size (max size of the old generation (in Mbytes))
|
|
type: int default: 0
|
|
--max_executable_size (max size of executable memory (in Mbytes))
|
|
type: int default: 0
|
|
--gc_global (always perform global GCs)
|
|
type: bool default: false
|
|
--gc_interval (garbage collect after <n> allocations)
|
|
type: int default: -1
|
|
--trace_gc (print one trace line following each garbage collection)
|
|
type: bool default: false
|
|
--trace_gc_nvp (print one detailed trace line in name=value format after each garbage collection)
|
|
type: bool default: false
|
|
--print_cumulative_gc_stat (print cumulative GC statistics in name=value format on exit)
|
|
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
|
|
--use_verbose_printer (allows verbose printing)
|
|
type: bool default: true
|
|
--allow_natives_syntax (allow natives syntax)
|
|
type: bool default: false
|
|
--trace_sim (Trace simulator execution)
|
|
type: bool default: false
|
|
--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
|
|
--sim_stack_alignment (Stack alingment in bytes in simulator (4 or 8, 8 is default))
|
|
type: int default: 8
|
|
--trace_exception (print stack trace when throwing exceptions)
|
|
type: bool default: false
|
|
--preallocate_message_memory (preallocate some memory to build stack traces.)
|
|
type: bool default: false
|
|
--randomize_hashes (randomize hashes to avoid predictable hash collisions (with snapshots this option cannot override the baked-in seed))
|
|
type: bool default: true
|
|
--hash_seed (Fixed seed to use to hash property keys (0 means random)(with snapshots this option cannot override the baked-in seed))
|
|
type: int default: 0
|
|
--preemption (activate a 100ms timer that switches between V8 threads)
|
|
type: bool default: false
|
|
--regexp_optimization (generate optimized regexp code)
|
|
type: bool default: true
|
|
--testing_bool_flag (testing_bool_flag)
|
|
type: bool default: true
|
|
--testing_int_flag (testing_int_flag)
|
|
type: int default: 13
|
|
--testing_float_flag (float-flag)
|
|
type: float default: 2.500000
|
|
--testing_string_flag (string-flag)
|
|
type: string default: Hello, world!
|
|
--testing_prng_seed (Seed used for threading test randomness)
|
|
type: int default: 42
|
|
--testing_serialization_file (file in which to serialize heap)
|
|
type: string default: /tmp/serdes
|
|
--help (Print usage message, including flags, on console)
|
|
type: bool default: true
|
|
--dump_counters (Dump counters on exit)
|
|
type: bool default: false
|
|
--debugger (Enable JavaScript debugger)
|
|
type: bool default: false
|
|
--remote_debugger (Connect JavaScript debugger to the debugger agent in another process)
|
|
type: bool default: false
|
|
--debugger_agent (Enable debugger agent)
|
|
type: bool default: false
|
|
--debugger_port (Port to use for remote debugging)
|
|
type: int default: 5858
|
|
--map_counters (Map counters to a file)
|
|
type: string default:
|
|
--js_arguments (Pass all remaining arguments to the script. Alias for "--".)
|
|
type: arguments default:
|
|
--debug_compile_events (Enable debugger compile events)
|
|
type: bool default: true
|
|
--debug_script_collected_events (Enable debugger script collected events)
|
|
type: bool default: true
|
|
--gdbjit (enable GDBJIT interface (disables compacting GC))
|
|
type: bool default: false
|
|
--gdbjit_full (enable GDBJIT interface for all code objects)
|
|
type: bool default: false
|
|
--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:
|
|
--force_marking_deque_overflows (force overflows of marking deque by reducing it's size to 64 words)
|
|
type: bool default: false
|
|
--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
|
|
--log_all (Log all events to the log file.)
|
|
type: bool default: false
|
|
--log_runtime (Activate runtime system %Log call.)
|
|
type: bool default: false
|
|
--log_api (Log API events to the log file.)
|
|
type: bool default: false
|
|
--log_code (Log code events to the log file without profiling.)
|
|
type: bool default: false
|
|
--log_gc (Log heap samples on garbage collection for the hp2ps tool.)
|
|
type: bool default: false
|
|
--log_handles (Log global handle events.)
|
|
type: bool default: false
|
|
--log_snapshot_positions (log positions of (de)serialized objects in the snapshot.)
|
|
type: bool default: false
|
|
--log_suspect (Log suspect operations.)
|
|
type: bool default: false
|
|
--prof (Log statistical profiling information (implies --log-code).)
|
|
type: bool default: false
|
|
--prof_auto (Used with --prof, starts profiling automatically)
|
|
type: bool default: true
|
|
--prof_lazy (Used with --prof, only does sampling and logging when profiler is active (implies --noprof_auto).)
|
|
type: bool default: false
|
|
--prof_browser_mode (Used with --prof, turns on browser-compatible mode for profiling.)
|
|
type: bool default: true
|
|
--log_regexp (Log regular expression execution.)
|
|
type: bool default: false
|
|
--sliding_state_window (Update sliding state window counters.)
|
|
type: bool default: false
|
|
--logfile (Specify the name of the log file.)
|
|
type: string default: v8.log
|
|
--ll_prof (Enable low-level linux profiler.)
|
|
type: bool default: false
|
|
|
|
.SH RESOURCES AND DOCUMENTATION
|
|
|
|
See the website for documentation http://nodejs.org/
|
|
|
|
Mailing list: http://groups.google.com/group/nodejs
|
|
|
|
IRC: irc.freenode.net #node.js
|