Skip to content

Commit c21731b

Browse files
jasnelltargos
authored andcommitted
doc: document that NODE_EXTRA_CA_CERTS is read only once
Fixes: #20432 PR-URL: #37562 Reviewed-By: Michael Dawson <midawson@redhat.com> Reviewed-By: Richard Lau <rlau@redhat.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
1 parent 77eb45a commit c21731b

File tree

3 files changed

+12
-1
lines changed

3 files changed

+12
-1
lines changed

doc/api/cli.md

+4
Original file line numberDiff line numberDiff line change
@@ -1175,6 +1175,10 @@ options property is explicitly specified for a TLS or HTTPS client or server.
11751175
This environment variable is ignored when `node` runs as setuid root or
11761176
has Linux file capabilities set.
11771177

1178+
The `NODE_EXTRA_CA_CERTS` environment variable is only read when the Node.js
1179+
process is first launched. Changing the value at runtime using
1180+
`process.env.NODE_EXTRA_CA_CERTS` has no effect on the current process.
1181+
11781182
### `NODE_ICU_DATA=file`
11791183
<!-- YAML
11801184
added: v0.11.15

doc/node.1

+7
Original file line numberDiff line numberDiff line change
@@ -544,6 +544,13 @@ but any errors are otherwise ignored.
544544
.Pp
545545
This environment variable is ignored when `node` runs as setuid root or
546546
has Linux file capabilities set.
547+
.Pp
548+
The
549+
.Ar NODE_EXTRA_CA_CERTS
550+
environment variable is only read when the Node.js process is first launched.
551+
Changing the value at runtime using
552+
.Ar process.env.NODE_EXTRA_CA_CERTS
553+
has no effect on the current process.
547554
.
548555
.It Ev NODE_ICU_DATA Ar file
549556
Data path for ICU (Intl object) data.

lib/internal/main/print_help.js

+1-1
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ const envVars = new Map([
2424
['NODE_DISABLE_COLORS', { helpText: 'set to 1 to disable colors in ' +
2525
'the REPL' }],
2626
['NODE_EXTRA_CA_CERTS', { helpText: 'path to additional CA certificates ' +
27-
'file' }],
27+
'file. Only read once during process startup.' }],
2828
['NODE_NO_WARNINGS', { helpText: 'set to 1 to silence process warnings' }],
2929
['NODE_PATH', { helpText: `'${require('path').delimiter}'-separated list ` +
3030
'of directories prefixed to the module search path' }],

0 commit comments

Comments
 (0)