comparison xml/en/docs/ngx_core_module.xml @ 804:d22421dc5d00

Clarified the effects of the "env" directive.
author Ruslan Ermilov <ru@nginx.com>
date Fri, 28 Dec 2012 13:51:56 +0000
parents f8434fdd3cd9
children 9a65d437da42
comparison
equal deleted inserted replaced
803:6c3349baa1d3 804:d22421dc5d00
8 <!DOCTYPE module SYSTEM "../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../dtd/module.dtd">
9 9
10 <module name="Core functionality" 10 <module name="Core functionality"
11 link="/en/docs/ngx_core_module.html" 11 link="/en/docs/ngx_core_module.html"
12 lang="en" 12 lang="en"
13 rev="5"> 13 rev="6">
14 14
15 <section id="example" name="Example Configuration"> 15 <section id="example" name="Example Configuration">
16 16
17 <para> 17 <para>
18 <example> 18 <example>
193 <syntax><value>variable</value>[=<value>value</value>]</syntax> 193 <syntax><value>variable</value>[=<value>value</value>]</syntax>
194 <default>TZ</default> 194 <default>TZ</default>
195 <context>main</context> 195 <context>main</context>
196 196
197 <para> 197 <para>
198 Allows to limit a set of environment variables, change their values, 198 By default, nginx removes all environment variables inherited
199 or create new environment variables, for the following cases: 199 from its parent process except the TZ variable.
200 This directive allows to preserve some of the inherited variables,
201 change their values, or create new environment variables.
202 These variables are then:
200 <list type="bullet"> 203 <list type="bullet">
201 204
202 <listitem> 205 <listitem>
203 variable inheritance during a 206 inherited during a <link doc="control.xml" id="upgrade">live upgrade</link>
204 <link doc="control.xml" id="upgrade">live upgrade</link>
205 of an executable file; 207 of an executable file;
206 </listitem> 208 </listitem>
207 209
208 <listitem> 210 <listitem>
209 use of variables by the module 211 used by the module
210 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>; 212 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>;
211 </listitem> 213 </listitem>
212 214
213 <listitem> 215 <listitem>
214 use of variables by worker processes. 216 used by worker processes.
215 Please bear in mind that controlling system libraries in this way 217 Please bear in mind that controlling system libraries in this way
216 is not always possible as it is not uncommon for libraries to check 218 is not always possible as it is not uncommon for libraries to check
217 variables only during initialization, well before they can be set 219 variables only during initialization, well before they can be set
218 using this directive. 220 using this directive.
219 An exception from this is an above mentioned 221 An exception from this is an above mentioned