comparison xml/ru/docs/ngx_core_module.xml @ 571:71d775bef043

Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 05 Jul 2012 13:13:45 +0000
parents 345012910707
children 5e9ff979eac8
comparison
equal deleted inserted replaced
570:9a5b1a63f654 571:71d775bef043
26 26
27 </section> 27 </section>
28 28
29 29
30 <section id="directives" name="Директивы"> 30 <section id="directives" name="Директивы">
31
32 <directive name="accept_mutex">
33 <syntax><literal>on</literal> | <literal>off</literal></syntax>
34 <default>on</default>
35 <context>events</context>
36
37 <para>
38 Если <literal>accept_mutex</literal> включён,
39 рабочие процессы будут принимать новые соединения по очереди.
40 В противном случае о новых соединениях будет сообщаться сразу всем рабочим
41 процессам, и при низкой интенсивности поступления новых соединений
42 часть рабочих процессов может работать вхолостую.
43 <note>
44 Использование метода обработки соединений
45 <link doc="events.xml" id="rtsig"/>
46 требует обязательного включения <literal>accept_mutex</literal>.
47 </note>
48 </para>
49
50 </directive>
51
52
53 <directive name="accept_mutex_delay">
54 <syntax><value>время</value></syntax>
55 <default>500ms</default>
56 <context>events</context>
57
58 <para>
59 При включённом <link id="accept_mutex"/> задаёт максимальное время,
60 в течение которого рабочий процесс вновь попытается начать принимать
61 новые соединения, если в настоящий момент этим уже занимается другой
62 рабочий процесс.
63 </para>
64
65 </directive>
66
31 67
32 <directive name="daemon"> 68 <directive name="daemon">
33 <syntax><literal>on</literal> | <literal>off</literal></syntax> 69 <syntax><literal>on</literal> | <literal>off</literal></syntax>
34 <default>on</default> 70 <default>on</default>
35 <context>main</context> 71 <context>main</context>
218 </para> 254 </para>
219 255
220 </directive> 256 </directive>
221 257
222 258
259 <directive name="lock_file">
260 <syntax><value>файл</value></syntax>
261 <default>logs/nginx.lock</default>
262 <context>main</context>
263
264 <para>
265 Для реализации <link id="accept_mutex"/> и сериализации доступа к
266 разделяемой памяти nginx использует механизм блокировок.
267 На большинстве систем блокировки реализованы с помощью атомарных
268 операций, и эта директива игнорируется.
269 Для остальных систем применяется механизм файлов блокировок.
270 Эта директива задаёт префикс имён файлов блокировок.
271 </para>
272
273 </directive>
274
275
223 <directive name="master_process"> 276 <directive name="master_process">
224 <syntax><literal>on</literal> | <literal>off</literal></syntax> 277 <syntax><literal>on</literal> | <literal>off</literal></syntax>
225 <default>on</default> 278 <default>on</default>
226 <context>main</context> 279 <context>main</context>
227 280
228 <para> 281 <para>
229 Определяет, будут ли запускаться рабочие процессы. 282 Определяет, будут ли запускаться рабочие процессы.
230 Эта директива предназначена для разработчиков nginx. 283 Эта директива предназначена для разработчиков nginx.
284 </para>
285
286 </directive>
287
288
289 <directive name="multi_accept">
290 <syntax><literal>on</literal> | <literal>off</literal></syntax>
291 <default>off</default>
292 <context>events</context>
293
294 <para>
295 Если <literal>multi_accept</literal> выключен, рабочий процесс
296 за один раз будет принимать только одно новое соединение.
297 В противном случае рабочий процесс
298 за один раз будет принимать сразу все новые соединения.
299 <note>
300 Директива игнорируется в случае использования метода обработки соединений
301 <link doc="events.xml" id="kqueue"/>, т.к. данный метод сам сообщает
302 число новых соединений, ожидающих приёма.
303 </note>
304 <note>
305 Использование метода обработки соединений
306 <link doc="events.xml" id="rtsig"/>
307 автоматически включает <literal>multi_accept</literal>.
308 </note>
231 </para> 309 </para>
232 310
233 </directive> 311 </directive>
234 312
235 313