2016-02-29 22:49:30 +01:00
|
|
|
.TH NODE 1 2016 Node.js Node.js
|
2014-02-14 20:01:49 +01:00
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.\ This is a man page comment.
|
|
|
|
.\ Man page syntax (actually troff syntax) is somewhat obscure, but the
|
|
|
|
.\ important part is is that .<letter> specifies <letter>'s syntax for that
|
|
|
|
.\ line, and \f<letter> specifies it for the characters that follow.
|
|
|
|
.\ See http://liw.fi/manpages/ for more info.
|
2014-02-14 20:01:49 +01:00
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.SH NAME
|
|
|
|
|
|
|
|
node \- Server-side JavaScript runtime
|
2014-02-14 20:01:49 +01:00
|
|
|
|
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.SH SYNOPSIS
|
2014-02-14 20:01:49 +01:00
|
|
|
|
2015-08-13 18:14:34 +02:00
|
|
|
.B node
|
2016-02-29 22:49:30 +01:00
|
|
|
[\fIoptions\fR] [\fIv8 options\fR]
|
|
|
|
[\fIscript.js\fR | \fB\-e \fR"\fIscript\fR"]
|
|
|
|
[\fIarguments\fR]
|
2014-02-14 20:01:49 +01:00
|
|
|
.br
|
2016-02-29 22:49:30 +01:00
|
|
|
.B node debug
|
|
|
|
[\fIscript.js\fR | \fB\-e \fR"\fIscript\fR" | \fI<host>:<port>\fR] \fI...
|
|
|
|
.br
|
|
|
|
.B node
|
|
|
|
[\fB\-\-v8-options\fR]
|
2014-02-14 20:01:49 +01:00
|
|
|
|
|
|
|
Execute without arguments to start the REPL.
|
|
|
|
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
Node.js 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.
|
2014-02-14 20:01:49 +01:00
|
|
|
|
|
|
|
|
|
|
|
.SH OPTIONS
|
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.TP
|
|
|
|
.BR \-v ", " \-\-version
|
|
|
|
Print node's version.
|
|
|
|
|
|
|
|
.TP
|
|
|
|
.BR \-h ", " \-\-help
|
|
|
|
Print node command line options.
|
|
|
|
The output of this option is less detailed than this document.
|
|
|
|
|
|
|
|
.TP
|
|
|
|
.BR \-e ", " \-\-eval " " \fR"\fIscript\fR"
|
|
|
|
Evaluate the following argument as JavaScript.
|
|
|
|
|
|
|
|
.TP
|
|
|
|
.BR \-p ", " \-\-print " " \fR"\fIscript\fR"
|
|
|
|
Identical to \fB-e\fR but prints the result.
|
|
|
|
|
|
|
|
.TP
|
|
|
|
.BR \-c ", " \-\-check
|
|
|
|
Syntax check the script without executing.
|
2014-02-14 20:01:49 +01:00
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.TP
|
|
|
|
.BR \-i ", " \-\-interactive
|
2016-04-27 19:25:11 +02:00
|
|
|
Open the REPL even if stdin does not appear to be a terminal.
|
2014-02-14 20:01:49 +01:00
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.TP
|
|
|
|
.BR \-r ", " \-\-require " " \fImodule\fR
|
|
|
|
Preload the specified module at startup. Follows `require()`'s module resolution
|
|
|
|
rules. \fImodule\fR may be either a path to a file, or a node module name.
|
2014-02-14 20:01:49 +01:00
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.TP
|
|
|
|
.BR \-\-no\-deprecation
|
|
|
|
Silence deprecation warnings.
|
2015-08-17 23:33:13 +02:00
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.TP
|
|
|
|
.BR \-\-trace\-deprecation
|
|
|
|
Print stack traces for deprecations.
|
2014-02-14 20:01:49 +01:00
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.TP
|
|
|
|
.BR \-\-throw\-deprecation
|
|
|
|
Throw errors for deprecations.
|
2015-02-17 23:37:37 +01:00
|
|
|
|
2016-01-20 20:38:35 +01:00
|
|
|
.TP
|
|
|
|
.BR \-\-no\-warnings
|
|
|
|
Silence all process warnings (including deprecations).
|
|
|
|
|
|
|
|
.TP
|
|
|
|
.BR \-\-trace\-warnings
|
|
|
|
Print stack traces for process warnings (including deprecations).
|
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.TP
|
|
|
|
.BR \-\-trace\-sync\-io
|
2016-04-27 19:25:11 +02:00
|
|
|
Print a stack trace whenever synchronous I/O is detected after the first turn
|
2016-02-29 22:49:30 +01:00
|
|
|
of the event loop.
|
2014-02-14 20:01:49 +01:00
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.TP
|
|
|
|
.BR \-\-zero\-fill\-buffers
|
|
|
|
Automatically zero-fills all newly allocated Buffer and SlowBuffer instances.
|
2014-02-14 20:01:49 +01:00
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.TP
|
|
|
|
.BR \-\-track\-heap-objects
|
|
|
|
Track heap object allocations for heap snapshots.
|
2014-02-14 20:01:49 +01:00
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.TP
|
|
|
|
.BR \-\-prof\-process
|
|
|
|
Process v8 profiler output generated using the v8 option \fB\-\-prof\fR
|
2015-07-09 18:15:26 +02:00
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.TP
|
|
|
|
.BR \-\-v8\-options
|
|
|
|
Print v8 command line options.
|
2015-11-25 15:08:58 +01:00
|
|
|
|
2016-05-02 23:02:31 +02:00
|
|
|
Note: v8 options allow words to be separated by both dashes (\fB-\fR) or
|
|
|
|
underscores (\fB_\fR).
|
|
|
|
|
|
|
|
For example, \fB\-\-stack\-trace\-limit\fR is equivalent to
|
|
|
|
\fB\-\-stack\_trace\_limit\fR
|
|
|
|
|
2015-12-18 13:24:56 +01:00
|
|
|
.TP
|
|
|
|
.BR \-\-v8\-pool\-size =\fInum\fR
|
|
|
|
Set v8's thread pool size which will be used to allocate background jobs.
|
|
|
|
If set to 0 then v8 will choose an appropriate size of the thread pool based
|
|
|
|
on the number of online processors. If the value provided is larger than v8's
|
|
|
|
max then the largest value will be chosen.
|
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.TP
|
|
|
|
.BR \-\-tls\-cipher\-list =\fIlist\fR
|
2016-05-09 17:15:45 +02:00
|
|
|
Specify an alternative default TLS cipher list. (Requires Node.js to be built
|
|
|
|
with crypto support. (Default))
|
2016-01-26 00:00:06 +01:00
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.TP
|
|
|
|
.BR \-\-enable\-fips
|
2016-05-09 17:15:45 +02:00
|
|
|
Enable FIPS-compliant crypto at startup. (Requires Node.js to be built with
|
|
|
|
\fB./configure \-\-openssl\-fips\fR)
|
2016-02-29 22:49:30 +01:00
|
|
|
|
|
|
|
.TP
|
|
|
|
.BR \-\-force\-fips
|
2016-05-09 17:15:45 +02:00
|
|
|
Force FIPS-compliant crypto on startup. (Cannot be disabled from script code.)
|
|
|
|
(Same requirements as \fB\-\-enable\-fips\fR)
|
2016-02-29 22:49:30 +01:00
|
|
|
|
|
|
|
.TP
|
|
|
|
.BR \-\-icu\-data\-dir =\fIfile\fR
|
|
|
|
Specify ICU data load path. (overrides \fBNODE_ICU_DATA\fR)
|
2014-02-14 20:01:49 +01:00
|
|
|
|
|
|
|
.SH ENVIRONMENT VARIABLES
|
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
.TP
|
|
|
|
.BR NODE_DEBUG =\fImodule\fR[,\fI...\fR]
|
|
|
|
\',\'\-separated list of core modules that should print debug information.
|
|
|
|
|
|
|
|
.TP
|
|
|
|
.BR NODE_PATH =\fIpath\fR[:\fI...\fR]
|
2014-02-14 20:01:49 +01:00
|
|
|
\':\'\-separated list of directories prefixed to the module search path.
|
2016-02-29 22:49:30 +01:00
|
|
|
|
|
|
|
.TP
|
|
|
|
.BR NODE_DISABLE_COLORS=1
|
|
|
|
When set to 1 colors will not be used in the REPL.
|
|
|
|
|
|
|
|
.TP
|
|
|
|
.BR NODE_ICU_DATA =\fIfile\fR
|
2015-09-04 12:48:20 +02:00
|
|
|
Data path for ICU (Intl object) data. Will extend linked-in data when compiled
|
2016-02-29 22:49:30 +01:00
|
|
|
with small\-icu support.
|
|
|
|
|
|
|
|
.TP
|
|
|
|
.BR NODE_REPL_HISTORY =\fIfile\fR
|
2015-09-04 12:48:20 +02:00
|
|
|
Path to the file used to store the persistent REPL history. The default path
|
|
|
|
is ~/.node_repl_history, which is overridden by this variable. Setting the
|
2016-02-29 22:49:30 +01:00
|
|
|
value to an empty string ("" or " ") disables persistent REPL history.
|
|
|
|
|
2014-02-14 20:01:49 +01:00
|
|
|
|
|
|
|
.SH RESOURCES AND DOCUMENTATION
|
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
Website: \fBhttps://nodejs.org/\fR
|
|
|
|
|
|
|
|
Documentation: \fBhttps://nodejs.org/api/\fR
|
|
|
|
|
|
|
|
GitHub repository & Issue Tracker: \fBhttps://github.com/nodejs/node\fR
|
2014-02-14 20:01:49 +01:00
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
Mailing list: \fBhttp://groups.google.com/group/nodejs\fR
|
2014-02-14 20:01:49 +01:00
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
IRC (general questions): \fBchat.freenode.net #node.js\fR
|
2015-09-08 22:25:57 +02:00
|
|
|
|
2016-02-29 22:49:30 +01:00
|
|
|
IRC (node core development): \fBchat.freenode.net #node-dev\fR
|