2018-02-03 14:16:50 +01:00
|
|
|
.\"
|
|
|
|
.\" This manpage is written in mdoc(7).
|
|
|
|
.\"
|
|
|
|
.\" * Language reference:
|
|
|
|
.\" https://man.openbsd.org/mdoc.7
|
|
|
|
.\"
|
|
|
|
.\" * Atom editor support:
|
|
|
|
.\" https://atom.io/packages/language-roff
|
|
|
|
.\"
|
|
|
|
.\" * Linting changes:
|
|
|
|
.\" mandoc -Wall -Tlint /path/to/this.file # BSD
|
|
|
|
.\" groff -w all -z /path/to/this.file # GNU/Linux, macOS
|
|
|
|
.\"
|
|
|
|
.\"
|
|
|
|
.\" Before making changes, please note the following:
|
|
|
|
.\"
|
|
|
|
.\" * In Roff, each new sentence should begin on a new line. This gives
|
|
|
|
.\" the Roff formatter better control over text-spacing, line-wrapping,
|
|
|
|
.\" and paragraph justification.
|
|
|
|
.\"
|
|
|
|
.\" * Do not leave blank lines in the markup. If whitespace is desired
|
|
|
|
.\" for readability, put a dot in the first column to indicate a null/empty
|
|
|
|
.\" command. Comments and horizontal whitespace may optionally follow: each
|
|
|
|
.\" of these lines are an example of a null command immediately followed by
|
|
|
|
.\" a comment.
|
|
|
|
.\"
|
|
|
|
.\"======================================================================
|
|
|
|
.
|
|
|
|
.Dd 2018
|
|
|
|
.Dt NODE 1
|
|
|
|
.
|
|
|
|
.Sh NAME
|
|
|
|
.Nm node
|
|
|
|
.Nd server-side JavaScript runtime
|
|
|
|
.
|
|
|
|
.\"======================================================================
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Nm node
|
|
|
|
.Op Ar options
|
|
|
|
.Op Ar v8-options
|
|
|
|
.Op Fl e Ar string | Ar script.js | Fl
|
|
|
|
.Op Fl \-
|
|
|
|
.Op Ar arguments ...
|
|
|
|
.
|
|
|
|
.Nm node
|
|
|
|
.Cm debug
|
|
|
|
.Op Fl e Ar string | Ar script.js | Fl | Ar <host>:<port>
|
|
|
|
.Ar ...
|
|
|
|
.
|
|
|
|
.Nm node
|
|
|
|
.Op Fl -v8-options
|
|
|
|
.
|
|
|
|
.\"======================================================================
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
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.
|
|
|
|
.Pp
|
|
|
|
Execute
|
|
|
|
.Nm
|
|
|
|
without arguments to start a REPL.
|
|
|
|
.
|
|
|
|
.Sh OPTIONS
|
|
|
|
.Bl -tag -width 6n
|
|
|
|
.It Fl v , Fl -version
|
2016-02-29 22:49:30 +01:00
|
|
|
Print node's version.
|
2018-02-03 14:16:50 +01:00
|
|
|
.
|
|
|
|
.It Fl h , Fl -help
|
2016-02-29 22:49:30 +01:00
|
|
|
Print node command line options.
|
|
|
|
The output of this option is less detailed than this document.
|
2018-02-03 14:16:50 +01:00
|
|
|
.
|
|
|
|
.It Fl e , Fl -eval Ar string
|
|
|
|
Evaluate
|
|
|
|
.Ar string
|
|
|
|
as JavaScript.
|
|
|
|
.
|
|
|
|
.It Fl p , Fl -print Ar string
|
|
|
|
Identical to
|
|
|
|
.Fl e ,
|
|
|
|
but prints the result.
|
|
|
|
.
|
|
|
|
.It Fl c , Fl -check
|
|
|
|
Check the script's syntax without executing it.
|
|
|
|
Exits with an error code if script is invalid.
|
|
|
|
.
|
|
|
|
.It Fl i , Fl -interactive
|
2016-04-27 19:25:11 +02:00
|
|
|
Open the REPL even if stdin does not appear to be a terminal.
|
2018-02-03 14:16:50 +01:00
|
|
|
.
|
|
|
|
.It Fl r , Fl -require Ar module
|
|
|
|
Preload the specified
|
|
|
|
.Ar module
|
|
|
|
at startup.
|
|
|
|
Follows `require()`'s module resolution rules.
|
|
|
|
.Ar module
|
|
|
|
may be either a path to a file, or a node module name.
|
|
|
|
.
|
|
|
|
.It Fl -inspect Ns = Ns Ar [host:]port
|
|
|
|
Activate inspector on
|
|
|
|
.Ar host:port .
|
|
|
|
Default is
|
|
|
|
.Sy 127.0.0.1:9229 .
|
|
|
|
.Pp
|
|
|
|
V8 Inspector integration allows attaching Chrome DevTools and IDEs to Node.js instances for debugging and profiling.
|
|
|
|
It uses the Chrome Debugging Protocol.
|
|
|
|
.
|
|
|
|
.It Fl -inspect-brk Ns = Ns Ar [host:]port
|
|
|
|
Activate inspector on
|
|
|
|
.Ar host:port
|
|
|
|
and break at start of user script.
|
|
|
|
.
|
|
|
|
.It Fl -inspect-port Ns = Ns Ar [host:]port
|
|
|
|
Set the
|
|
|
|
.Ar host:port
|
|
|
|
to be used when the inspector is activated.
|
|
|
|
.
|
|
|
|
.It Fl -no-deprecation
|
2016-02-29 22:49:30 +01:00
|
|
|
Silence deprecation warnings.
|
2018-02-03 14:16:50 +01:00
|
|
|
.
|
|
|
|
.It Fl -trace-deprecation
|
2016-02-29 22:49:30 +01:00
|
|
|
Print stack traces for deprecations.
|
2018-02-03 14:16:50 +01:00
|
|
|
.
|
|
|
|
.It Fl -throw-deprecation
|
2016-02-29 22:49:30 +01:00
|
|
|
Throw errors for deprecations.
|
2018-02-03 14:16:50 +01:00
|
|
|
.
|
|
|
|
.It Fl -pending-deprecation
|
2017-03-11 21:18:53 +01:00
|
|
|
Emit pending deprecation warnings.
|
2018-02-03 14:16:50 +01:00
|
|
|
.
|
|
|
|
.It Fl -no-warnings
|
2016-01-20 20:38:35 +01:00
|
|
|
Silence all process warnings (including deprecations).
|
2018-02-03 14:16:50 +01:00
|
|
|
.
|
|
|
|
.It Fl -napi-modules
|
2017-03-20 22:55:26 +01:00
|
|
|
Enable loading native modules compiled with the ABI-stable Node.js API (N-API)
|
|
|
|
(experimental).
|
2018-02-03 14:16:50 +01:00
|
|
|
.
|
|
|
|
.It Fl -abort-on-uncaught-exception
|
2017-06-26 20:00:34 +02:00
|
|
|
Aborting instead of exiting causes a core file to be generated for analysis.
|
2018-02-03 14:16:50 +01:00
|
|
|
.
|
|
|
|
.It Fl -trace-warnings
|
2016-01-20 20:38:35 +01:00
|
|
|
Print stack traces for process warnings (including deprecations).
|
2018-02-03 14:16:50 +01:00
|
|
|
.
|
|
|
|
.It Fl -redirect-warnings Ns = Ns Ar file
|
|
|
|
Write process warnings to the given
|
|
|
|
.Ar file
|
|
|
|
instead of printing to stderr.
|
|
|
|
.
|
|
|
|
.It Fl -trace-sync-io
|
|
|
|
Print a stack trace whenever synchronous I/O is detected after the first turn of the event loop.
|
|
|
|
.
|
|
|
|
.It Fl -no-force-async-hooks-checks
|
|
|
|
Disable runtime checks for `async_hooks`.
|
|
|
|
These will still be enabled dynamically when `async_hooks` is enabled.
|
|
|
|
.
|
|
|
|
.It Fl -trace-events-enabled
|
|
|
|
Enable the collection of trace event tracing information.
|
|
|
|
.
|
|
|
|
.It Fl -trace-event-categories Ar categories
|
|
|
|
A comma-separated list of categories that should be traced when trace event tracing is enabled using
|
|
|
|
.Fl -trace-events-enabled .
|
|
|
|
.
|
|
|
|
.It Fl -zero-fill-buffers
|
2016-02-29 22:49:30 +01:00
|
|
|
Automatically zero-fills all newly allocated Buffer and SlowBuffer instances.
|
2018-02-03 14:16:50 +01:00
|
|
|
.
|
|
|
|
.It Fl -preserve-symlinks
|
|
|
|
Instructs the module loader to preserve symbolic links when resolving and caching modules.
|
|
|
|
.
|
|
|
|
.It Fl -track-heap-objects
|
2016-02-29 22:49:30 +01:00
|
|
|
Track heap object allocations for heap snapshots.
|
2018-02-03 14:16:50 +01:00
|
|
|
.
|
|
|
|
.It Fl -prof-process
|
|
|
|
Process V8 profiler output generated using the V8 option
|
|
|
|
.Fl -prof .
|
|
|
|
.
|
|
|
|
.It Fl -v8-options
|
|
|
|
Print V8 command-line options.
|
|
|
|
.Pp
|
|
|
|
Note: V8 options allow words to be separated by both dashes (\fB-\fR) or underscores (\fB_\fR).
|
|
|
|
.Pp
|
|
|
|
For example,
|
|
|
|
.Fl -stack-trace-limit
|
|
|
|
is equivalent to
|
|
|
|
.Fl -stack_trace_limit .
|
|
|
|
.
|
|
|
|
.It Fl -v8-pool-size Ns = Ns Ar num
|
|
|
|
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 maximum, then the largest value will be chosen.
|
|
|
|
.
|
|
|
|
.It Fl -tls-cipher-list Ns = Ns Ar list
|
|
|
|
Specify an alternative default TLS cipher list.
|
|
|
|
Requires Node.js to be built with crypto support. (Default)
|
|
|
|
.
|
|
|
|
.It Fl -enable-fips
|
|
|
|
Enable FIPS-compliant crypto at startup.
|
|
|
|
Requires Node.js to be built with
|
|
|
|
.Sy ./configure --openssl-fips .
|
|
|
|
.
|
|
|
|
.It Fl -force-fips
|
|
|
|
Force FIPS-compliant crypto on startup
|
|
|
|
(Cannot be disabled from script code).
|
|
|
|
Same requirements as
|
|
|
|
.Fl -enable-fips .
|
|
|
|
.
|
|
|
|
.It Fl -openssl-config Ns = Ns Ar file
|
|
|
|
Load an OpenSSL configuration file on startup.
|
|
|
|
Among other uses, this can be used to enable FIPS-compliant crypto if Node.js is built with
|
|
|
|
.Sy ./configure --openssl-fips .
|
|
|
|
.
|
|
|
|
.It Fl -use-openssl-ca , Fl -use-bundled\-ca
|
|
|
|
Use OpenSSL's default CA store or use bundled Mozilla CA store as supplied by current Node.js version.
|
|
|
|
The default store is selectable at build-time.
|
|
|
|
.Pp
|
|
|
|
Using OpenSSL store allows for external modifications of the store.
|
|
|
|
For most Linux and BSD distributions, this store is maintained by the distribution maintainers and system administrators.
|
|
|
|
OpenSSL CA store location is dependent on configuration of the OpenSSL library but this can be altered at runtime using environment variables.
|
|
|
|
.Pp
|
|
|
|
The bundled CA store, as supplied by Node.js, is a snapshot of Mozilla CA store that is fixed at release time.
|
|
|
|
It is identical on all supported platforms.
|
|
|
|
.Pp
|
|
|
|
See
|
|
|
|
.Ev SSL_CERT_DIR
|
|
|
|
and
|
|
|
|
.Ev SSL_CERT_FILE .
|
|
|
|
.
|
|
|
|
.It Fl -icu-data-dir Ns = Ns Ar file
|
|
|
|
Specify ICU data load path.
|
|
|
|
Overrides
|
|
|
|
.Ev NODE_ICU_DATA .
|
|
|
|
.
|
|
|
|
.It Fl \-experimental-modules
|
|
|
|
Enable experimental ES module support and caching modules.
|
|
|
|
.
|
|
|
|
.It Fl \-experimental-vm-modules
|
|
|
|
Enable experimental ES module support in VM module.
|
|
|
|
.
|
|
|
|
.It Sy \-
|
|
|
|
Alias for stdin, analogous to the use of - in other command-line utilities.
|
|
|
|
The executed script is read from stdin, and remaining arguments are passed to the script.
|
|
|
|
.
|
|
|
|
.It Fl \-
|
|
|
|
Indicate the end of node options.
|
|
|
|
Pass the rest of the arguments to the script.
|
|
|
|
.Pp
|
2016-12-30 06:28:38 +01:00
|
|
|
If no script filename or eval/print script is supplied prior to this, then
|
|
|
|
the next argument will be used as a script filename.
|
2018-02-03 14:16:50 +01:00
|
|
|
.El
|
|
|
|
.
|
|
|
|
.\" =====================================================================
|
|
|
|
.Sh ENVIRONMENT
|
|
|
|
.Bl -tag -width 6n
|
|
|
|
.It Ev NODE_DEBUG Ar modules...
|
|
|
|
Comma-separated list of core modules that should print debug information.
|
|
|
|
.
|
|
|
|
.It Ev NODE_DISABLE_COLORS
|
|
|
|
When set to
|
|
|
|
.Ar 1 ,
|
|
|
|
colors will not be used in the REPL.
|
|
|
|
.
|
|
|
|
.It Ev NODE_EXTRA_CA_CERTS Ar file
|
|
|
|
When set, the well-known
|
|
|
|
.Dq root
|
|
|
|
CAs (like VeriSign) will be extended with the extra certificates in
|
|
|
|
.Ar file .
|
|
|
|
The file should consist of one or more trusted certificates in PEM format.
|
|
|
|
.Pp
|
|
|
|
If
|
|
|
|
.Ar file
|
|
|
|
is missing or misformatted, a message will be emitted once using
|
|
|
|
.Sy process.emitWarning() ,
|
|
|
|
but any errors are otherwise ignored.
|
|
|
|
.
|
|
|
|
.It Ev NODE_ICU_DATA Ar file
|
|
|
|
Data path for ICU (Intl object) data.
|
|
|
|
Will extend linked-in data when compiled with small-icu support.
|
|
|
|
.
|
|
|
|
.It Ev NODE_NO_WARNINGS
|
|
|
|
When set to
|
|
|
|
.Ar 1 ,
|
|
|
|
process warnings are silenced.
|
|
|
|
.
|
|
|
|
.It Ev NODE_OPTIONS Ar options...
|
|
|
|
A space-separated list of command-line
|
|
|
|
.Ar options ,
|
|
|
|
which are interpreted as if they had been specified on the command-line before the actual command (so they can be overridden).
|
|
|
|
Node will exit with an error if an option that is not allowed in the environment is used, such as
|
|
|
|
.Fl -print
|
|
|
|
or a script file.
|
|
|
|
.
|
|
|
|
.It Ev NODE_PATH Ar directories...
|
|
|
|
A colon-separated list of
|
|
|
|
.Ar directories
|
|
|
|
prefixed to the module search path.
|
|
|
|
.
|
|
|
|
.It Ev NODE_PENDING_DEPRECATION
|
|
|
|
When set to
|
|
|
|
.Ar 1 ,
|
|
|
|
emit pending deprecation warnings.
|
|
|
|
.
|
|
|
|
.It Ev NODE_REPL_HISTORY Ar file
|
|
|
|
Path to the
|
|
|
|
.Ar file
|
|
|
|
used to store persistent REPL history.
|
|
|
|
The default path is
|
|
|
|
.Sy ~/.node_repl_history ,
|
|
|
|
which is overridden by this variable.
|
|
|
|
Setting the value to an empty string ("" or " ") will disable persistent REPL history.
|
|
|
|
.
|
|
|
|
.It Ev OPENSSL_CONF Ar file
|
|
|
|
Load an OpenSSL configuration file on startup.
|
|
|
|
Among other uses, this can be used to enable FIPS-compliant crypto if Node.js is built with
|
|
|
|
.Sy ./configure --openssl-fips .
|
|
|
|
.Pp
|
2017-01-25 23:13:34 +01:00
|
|
|
If the
|
2018-02-03 14:16:50 +01:00
|
|
|
.Fl -openssl-config
|
|
|
|
command-line option is used, this environment variable is ignored.
|
|
|
|
.
|
|
|
|
.It Ev SSL_CERT_DIR Ar dir
|
|
|
|
If
|
|
|
|
.Fl -use-openssl-ca
|
|
|
|
is enabled, this overrides and sets OpenSSL's directory containing trusted certificates.
|
|
|
|
.
|
|
|
|
.It Ev SSL_CERT_FILE Ar file
|
|
|
|
If
|
|
|
|
.Fl -use-openssl-ca
|
|
|
|
is enabled, this overrides and sets OpenSSL's file containing trusted certificates.
|
|
|
|
.
|
|
|
|
.It Ev NODE_REDIRECT_WARNINGS Ar file
|
|
|
|
Write process warnings to the given
|
|
|
|
.Ar file
|
|
|
|
instead of printing to stderr.
|
|
|
|
Equivalent to passing
|
|
|
|
.Fl -redirect-warnings Ar file
|
|
|
|
on command-line.
|
|
|
|
.El
|
|
|
|
.
|
|
|
|
.\"=====================================================================
|
|
|
|
.Sh BUGS
|
2016-10-08 09:51:28 +02:00
|
|
|
Bugs are tracked in GitHub Issues:
|
2018-02-03 14:16:50 +01:00
|
|
|
.Sy https://github.com/nodejs/node/issues
|
|
|
|
.
|
|
|
|
.\"======================================================================
|
|
|
|
.Sh COPYRIGHT
|
|
|
|
Copyright Node.js contributors.
|
|
|
|
Node.js is available under the MIT license.
|
|
|
|
.
|
|
|
|
.Pp
|
|
|
|
Node.js also includes external libraries that are available under a variety of licenses.
|
|
|
|
See
|
|
|
|
.Sy https://github.com/nodejs/node/blob/master/LICENSE
|
2016-10-08 09:51:28 +02:00
|
|
|
for the full license text.
|
2018-02-03 14:16:50 +01:00
|
|
|
.
|
|
|
|
.\"======================================================================
|
|
|
|
.Sh SEE ALSO
|
2016-07-21 14:12:16 +02:00
|
|
|
Website:
|
2018-02-03 14:16:50 +01:00
|
|
|
.Sy https://nodejs.org/
|
|
|
|
.
|
|
|
|
.Pp
|
2016-07-21 14:12:16 +02:00
|
|
|
Documentation:
|
2018-02-03 14:16:50 +01:00
|
|
|
.Sy https://nodejs.org/api/
|
|
|
|
.
|
|
|
|
.Pp
|
2016-07-21 14:12:16 +02:00
|
|
|
GitHub repository & Issue Tracker:
|
2018-02-03 14:16:50 +01:00
|
|
|
.Sy https://github.com/nodejs/node
|
|
|
|
.
|
|
|
|
.Pp
|
2016-07-21 14:12:16 +02:00
|
|
|
Mailing list:
|
2018-02-03 14:16:50 +01:00
|
|
|
.Sy http://groups.google.com/group/nodejs
|
|
|
|
.
|
|
|
|
.Pp
|
2016-07-21 14:12:16 +02:00
|
|
|
IRC (general questions):
|
2018-02-03 14:16:50 +01:00
|
|
|
.Sy "chat.freenode.net #node.js"
|
2016-10-08 09:51:28 +02:00
|
|
|
(unofficial)
|
2018-02-03 14:16:50 +01:00
|
|
|
.
|
|
|
|
.Pp
|
2016-10-08 09:51:28 +02:00
|
|
|
IRC (Node.js core development):
|
2018-02-03 14:16:50 +01:00
|
|
|
.Sy "chat.freenode.net #node-dev"
|
|
|
|
.
|
|
|
|
.\"======================================================================
|
|
|
|
.Sh AUTHORS
|
|
|
|
Written and maintained by 1000+ contributors:
|
|
|
|
.Sy https://github.com/nodejs/node/blob/master/AUTHORS
|
|
|
|
.
|