comparison xml/ru/docs/ngx_core_module.xml @ 2142:ca7568f67dee

Sorted directives alphabetically.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 10 Apr 2018 18:39:34 +0300
parents 8f885a69374d
children eeed494bba51
comparison
equal deleted inserted replaced
2141:10751277a8ad 2142:ca7568f67dee
139 В случае обнаружения внутренней ошибки, например, утечки сокетов в момент 139 В случае обнаружения внутренней ошибки, например, утечки сокетов в момент
140 перезапуска рабочих процессов, включение <literal>debug_points</literal> 140 перезапуска рабочих процессов, включение <literal>debug_points</literal>
141 приводит к созданию core-файла (<literal>abort</literal>) 141 приводит к созданию core-файла (<literal>abort</literal>)
142 или остановке процесса (<literal>stop</literal>) с целью последующей 142 или остановке процесса (<literal>stop</literal>) с целью последующей
143 диагностики с помощью системного отладчика. 143 диагностики с помощью системного отладчика.
144 </para>
145
146 </directive>
147
148
149 <directive name="env">
150 <syntax><value>переменная</value>[=<value>значение</value>]</syntax>
151 <default>TZ</default>
152 <context>main</context>
153
154 <para>
155 По умолчанию nginx удаляет все переменные окружения, унаследованные
156 от своего родительского процесса, кроме переменной TZ.
157 Эта директива позволяет сохранить часть унаследованных переменных,
158 поменять им значения или же создать новые переменные окружения.
159 Эти переменные затем:
160 <list type="bullet">
161
162 <listitem>
163 наследуются во время
164 <link doc="control.xml" id="upgrade">обновления исполняемого файла на лету</link>;
165 </listitem>
166
167 <listitem>
168 используются модулем
169 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>;
170 </listitem>
171
172 <listitem>
173 используются рабочими процессами.
174 Следует иметь в виду, что управление поведением системных библиотек
175 подобным образом возможно не всегда, поскольку зачастую библиотеки используют
176 переменные только во время инициализации, то есть ещё до того, как их
177 можно задать с помощью данной директивы.
178 Исключением из этого является упомянутое выше
179 <link doc="control.xml" id="upgrade">обновление исполняемого файла на лету</link>.
180 </listitem>
181
182 </list>
183 </para>
184
185 <para>
186 Если переменная TZ не описана явно, то она всегда наследуется
187 и всегда доступна модулю
188 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>.
189 </para>
190
191 <para>
192 Пример использования:
193 <example>
194 env MALLOC_OPTIONS;
195 env PERL5LIB=/data/site/modules;
196 env OPENSSL_ALLOW_PROXY_CERTS=1;
197 </example>
198 </para>
199
200 <para>
201 <note>
202 Переменная окружения NGINX используется для внутренних целей nginx
203 и не должна устанавливаться непосредственно самим пользователем.
204 </note>
144 </para> 205 </para>
145 206
146 </directive> 207 </directive>
147 208
148 209
206 </para> 267 </para>
207 268
208 </directive> 269 </directive>
209 270
210 271
211 <directive name="env">
212 <syntax><value>переменная</value>[=<value>значение</value>]</syntax>
213 <default>TZ</default>
214 <context>main</context>
215
216 <para>
217 По умолчанию nginx удаляет все переменные окружения, унаследованные
218 от своего родительского процесса, кроме переменной TZ.
219 Эта директива позволяет сохранить часть унаследованных переменных,
220 поменять им значения или же создать новые переменные окружения.
221 Эти переменные затем:
222 <list type="bullet">
223
224 <listitem>
225 наследуются во время
226 <link doc="control.xml" id="upgrade">обновления исполняемого файла на лету</link>;
227 </listitem>
228
229 <listitem>
230 используются модулем
231 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>;
232 </listitem>
233
234 <listitem>
235 используются рабочими процессами.
236 Следует иметь в виду, что управление поведением системных библиотек
237 подобным образом возможно не всегда, поскольку зачастую библиотеки используют
238 переменные только во время инициализации, то есть ещё до того, как их
239 можно задать с помощью данной директивы.
240 Исключением из этого является упомянутое выше
241 <link doc="control.xml" id="upgrade">обновление исполняемого файла на лету</link>.
242 </listitem>
243
244 </list>
245 </para>
246
247 <para>
248 Если переменная TZ не описана явно, то она всегда наследуется
249 и всегда доступна модулю
250 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>.
251 </para>
252
253 <para>
254 Пример использования:
255 <example>
256 env MALLOC_OPTIONS;
257 env PERL5LIB=/data/site/modules;
258 env OPENSSL_ALLOW_PROXY_CERTS=1;
259 </example>
260 </para>
261
262 <para>
263 <note>
264 Переменная окружения NGINX используется для внутренних целей nginx
265 и не должна устанавливаться непосредственно самим пользователем.
266 </note>
267 </para>
268
269 </directive>
270
271
272 <directive name="events"> 272 <directive name="events">
273 <syntax block="yes"/> 273 <syntax block="yes"/>
274 <default/> 274 <default/>
275 <context>main</context> 275 <context>main</context>
276 276