Mercurial > hg > nginx-site
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 |