annotate xml/ru/docs/ngx_core_module.xml @ 556:345012910707

Documented the "events" and "use" directives.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 27 Jun 2012 11:39:27 +0000
parents ccb7451af1d8
children 71d775bef043
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
222
bfe3eff81d04 Removed redundant encoding specification.
Ruslan Ermilov <ru@nginx.com>
parents: 104
diff changeset
1 <?xml version="1.0"?>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3 <!DOCTYPE module SYSTEM "../../../dtd/module.dtd">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
4
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
5 <module name="Основная функциональность"
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
6 link="/ru/docs/ngx_core_module.html"
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
7 lang="ru">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
8
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
9 <section id="example" name="Пример конфигурации">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
10
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
11 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
12 <example>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
13 user www www;
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
14 worker_processes 2;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
15
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
16 error_log /var/log/nginx-error.log info;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
17
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
18 events {
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
19 use kqueue;
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
20 worker_connections 2048;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
21 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
22
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
23 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
24 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
25 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
26
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
27 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
28
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
29
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
30 <section id="directives" name="Директивы">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
31
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
32 <directive name="daemon">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
33 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
34 <default>on</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
35 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
36
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
37 <para>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
38 Определяет, будет ли nginx запускаться в режиме демона.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
39 Используется в основном для разработки.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
40 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
41
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
42 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
43
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
44
516
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
45 <directive name="debug_connection">
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
46 <syntax>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
47 <value>адрес</value> |
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
48 <value>CIDR</value> |
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
49 <literal>unix:</literal></syntax>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
50 <default/>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
51 <context>events</context>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
52
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
53 <para>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
54 Включает отладочный лог для отдельных клиентских соединений.
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
55 Для остальных соединений используется уровень лога, заданный директивой
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
56 <link id="error_log"/>.
523
a8daad8e83bb Documented 1.2.1 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 516
diff changeset
57 Отлаживаемые соединения задаются IPv4 или IPv6 (1.3.0, 1.2.1)
a8daad8e83bb Documented 1.2.1 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 516
diff changeset
58 адресом или сетью.
516
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
59 Соединение может быть также задано при помощи имени хоста, в этом случае
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
60 используется первый IPv4-адрес, соответствующий имени.
523
a8daad8e83bb Documented 1.2.1 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 516
diff changeset
61 Отладочный лог для соединений через UNIX-сокеты (1.3.0, 1.2.1)
a8daad8e83bb Documented 1.2.1 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 516
diff changeset
62 включается параметром “<literal>unix:</literal>”.
516
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
63 <example>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
64 events {
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
65 debug_connection 127.0.0.1;
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
66 debug_connection localhost;
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
67 debug_connection 192.0.2.0/24;
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
68 debug_connection ::1;
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
69 debug_connection 2001:0db8::/32;
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
70 debug_connection unix:;
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
71 ...
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
72 }
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
73 </example>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
74 <note>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
75 Для работы директивы необходимо сконфигурировать nginx с параметром
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
76 <literal>--with-debug</literal>.
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
77 </note>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
78 </para>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
79
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
80 </directive>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
81
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
82
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
83 <directive name="error_log">
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
84 <syntax>
455
571b790ddf9e error_log: documented the special value "stderr" and default logging level.
Ruslan Ermilov <ru@nginx.com>
parents: 444
diff changeset
85 <value>файл</value> | <literal>stderr</literal>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
86 [<literal>debug</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
87 <literal>info</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
88 <literal>notice</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
89 <literal>warn</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
90 <literal>error</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
91 <literal>crit</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
92 <literal>alert</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
93 <literal>emerg</literal>]</syntax>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
94 <default>logs/error.log error</default>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
95 <context>main</context>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
96 <context>http</context>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
97 <context>server</context>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
98 <context>location</context>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
99
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
100 <para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
101 Конфигурирует запись в лог.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
102 </para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
103
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
104 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
105 Первый параметр задаёт файл, который будет хранить лог.
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
106 <!--
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
107 Если имя файла не абсолютное, к нему добавляется в начало путь префикса.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
108 -->
455
571b790ddf9e error_log: documented the special value "stderr" and default logging level.
Ruslan Ermilov <ru@nginx.com>
parents: 444
diff changeset
109 Специальное значение <literal>stderr</literal> выбирает стандартный файл ошибок.
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
110 </para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
111
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
112 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
113 Второй параметр определяет уровень лога.
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
114 Уровни лога, указанные выше, перечислены в порядке возрастания их серьёзности.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
115 При установке определённого уровня в лог попадают все сообщения
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
116 указанного и более серьёзных уровней.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
117 Например, при стандартном уровне <literal>error</literal> в лог попадают
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
118 сообщения уровней <literal>error</literal>, <literal>crit</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
119 <literal>alert</literal> и <literal>emerg</literal>.
455
571b790ddf9e error_log: documented the special value "stderr" and default logging level.
Ruslan Ermilov <ru@nginx.com>
parents: 444
diff changeset
120 Если этот параметр не задан, используется <literal>error</literal>.
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
121 <note>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
122 Для работы уровня лога <literal>debug</literal> необходимо сконфигурировать
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
123 nginx с <literal>--with-debug</literal>.
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
124 </note>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
125 </para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
126
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
127 </directive>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
128
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
129
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
130 <directive name="env">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
131 <syntax><value>переменная</value>[=<value>значение</value>]</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
132 <default>TZ</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
133 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
134
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
135 <para>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
136 Позволяет ограничить набор переменных окружения, поменять им значения
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
137 или же создать новые переменные окружения для следующих случаев:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
138 <list type="bullet">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
139
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
140 <listitem>
79
0a45870d0160 Fixed cross-document links to use doc and id.
Maxim Dounin <mdounin@mdounin.ru>
parents: 76
diff changeset
141 наследование переменных во время
0a45870d0160 Fixed cross-document links to use doc and id.
Maxim Dounin <mdounin@mdounin.ru>
parents: 76
diff changeset
142 <link doc="control.xml" id="upgrade">обновления исполняемого файла на лету</link>;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
143 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
144
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
145 <listitem>
79
0a45870d0160 Fixed cross-document links to use doc and id.
Maxim Dounin <mdounin@mdounin.ru>
parents: 76
diff changeset
146 использование переменных модулем
0a45870d0160 Fixed cross-document links to use doc and id.
Maxim Dounin <mdounin@mdounin.ru>
parents: 76
diff changeset
147 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
148 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
149
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
150 <listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
151 использование переменных рабочими процессами.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
152 Однако нужно иметь в виду, что управление поведением системных библиотек
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
153 подобным образом возможно не всегда, поскольку зачастую библиотеки используют
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
154 переменные только во время инициализации, то есть ещё до того, как их
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
155 можно задать с помощью данной директивы.
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
156 Исключением из этого является вышеописанное
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
157 <link doc="control.xml" id="upgrade">обновление исполняемого файла на лету</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
158 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
159
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
160 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
161 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
162
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
163 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
164 Если переменная TZ не описана явно, то она всегда наследуется
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
165 и всегда доступна модулю
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
166 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
167 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
168
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
169 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
170 Пример использования:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
171 <example>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
172 env MALLOC_OPTIONS;
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
173 env PERL5LIB=/data/site/modules;
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
174 env OPENSSL_ALLOW_PROXY_CERTS=1;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
175 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
176 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
177
444
43c84d19bf92 Added a note about the NGINX environment variable.
Ruslan Ermilov <ru@nginx.com>
parents: 289
diff changeset
178 <para>
43c84d19bf92 Added a note about the NGINX environment variable.
Ruslan Ermilov <ru@nginx.com>
parents: 289
diff changeset
179 <note>
43c84d19bf92 Added a note about the NGINX environment variable.
Ruslan Ermilov <ru@nginx.com>
parents: 289
diff changeset
180 Переменная окружения NGINX используется для внутренних целей nginx
43c84d19bf92 Added a note about the NGINX environment variable.
Ruslan Ermilov <ru@nginx.com>
parents: 289
diff changeset
181 и не должна устанавливаться непосредственно самим пользователем.
43c84d19bf92 Added a note about the NGINX environment variable.
Ruslan Ermilov <ru@nginx.com>
parents: 289
diff changeset
182 </note>
43c84d19bf92 Added a note about the NGINX environment variable.
Ruslan Ermilov <ru@nginx.com>
parents: 289
diff changeset
183 </para>
43c84d19bf92 Added a note about the NGINX environment variable.
Ruslan Ermilov <ru@nginx.com>
parents: 289
diff changeset
184
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
185 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
186
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
187
556
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
188 <directive name="events">
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
189 <syntax block="yes"/>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
190 <default/>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
191 <context>main</context>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
192
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
193 <para>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
194 Предоставляет контекст конфигурационного файла, в котором указываются
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
195 директивы, влияющие на обработку соединений.
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
196 </para>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
197
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
198 </directive>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
199
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
200
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
201 <directive name="include">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
202 <syntax><value>файл</value> | <value>маска</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
203 <default/>
104
3ae68fe2e938 A nicer look for the directive's synopsis section, including i18n
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
204 <context/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
205
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
206 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
207 Включает в конфигурацию другой <value>файл</value> или файлы,
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
208 подходящие под заданную маску.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
209 Включаемые файлы должны содержать синтаксически верные директивы и блоки.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
210 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
211
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
212 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
213 Пример использования:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
214 <example>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
215 include mime.types;
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
216 include vhosts/*.conf;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
217 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
218 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
219
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
220 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
221
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
222
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
223 <directive name="master_process">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
224 <syntax><literal>on</literal> | <literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
225 <default>on</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
226 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
227
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
228 <para>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
229 Определяет, будут ли запускаться рабочие процессы.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
230 Эта директива предназначена для разработчиков nginx.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
231 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
232
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
233 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
234
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
235
289
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
236 <directive name="pcre_jit">
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
237 <syntax><literal>on</literal> | <literal>off</literal></syntax>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
238 <default>off</default>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
239 <context>main</context>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
240 <appeared-in>1.1.12</appeared-in>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
241
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
242 <para>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
243 Разрешает или запрещает использование JIT-компиляции (PCRE JIT)
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
244 для регулярных выражений, известных на момент парсинга конфигурации.
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
245 </para>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
246
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
247 <para>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
248 Использование PCRE JIT способно существенно ускорить обработку
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
249 регулярных выражений.
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
250 <note>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
251 Для работы JIT необходима библиотека PCRE версии 8.20 или выше,
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
252 собранная с параметром конфигурации <literal>--enable-jit</literal>.
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
253 При сборке библиотеки PCRE вместе с nginx (<literal>--with-pcre=</literal>),
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
254 для включения поддержки JIT необходимо использовать параметр
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
255 конфигурации <literal>--with-pcre-jit</literal>.
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
256 </note>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
257 </para>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
258
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
259 </directive>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
260
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
261
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
262 <directive name="pid">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
263 <syntax><value>файл</value></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
264 <default>nginx.pid</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
265 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
266
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
267 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
268 Задаёт <value>файл</value>, в котором будет храниться номер (PID) основного процесса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
269 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
270
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
271 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
272
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
273
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
274 <directive name="ssl_engine">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
275 <syntax><value>устройство</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
276 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
277 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
278
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
279 <para>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
280 Задаёт название аппаратного SSL-акселератора.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
281 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
282
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
283 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
284
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
285
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
286 <directive name="timer_resolution">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
287 <syntax><value>интервал</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
288 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
289 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
290
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
291 <para>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
292 Уменьшает разрешение таймеров времени в рабочих процессах, за счёт
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
293 чего уменьшается число системных вызовов <c-func>gettimeofday</c-func>.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
294 По умолчанию <c-func>gettimeofday</c-func> вызывается после каждой
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
295 операции получения событий из ядра.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
296 C уменьшенным разрешением <c-func>gettimeofday</c-func> вызывается только
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
297 один раз за указанный <value>интервал</value>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
298 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
299
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
300 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
301 Пример использования:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
302 <example>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
303 timer_resolution 100ms;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
304 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
305 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
306
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
307 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
308 Внутренняя реализация интервала зависит от используемого метода:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
309 <list type="bullet">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
310
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
311 <listitem>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
312 фильтр <c-def>EVFILT_TIMER</c-def> при использовании <literal>kqueue</literal>;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
313 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
314
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
315 <listitem>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
316 <c-func>timer_create</c-func> при использовании <literal>eventport</literal>;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
317 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
318
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
319 <listitem>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
320 и <c-func>setitimer</c-func> во всех остальных случаях.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
321 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
322
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
323 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
324 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
325
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
326 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
327
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
328
556
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
329 <directive name="use">
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
330 <syntax><value>метод</value></syntax>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
331 <default/>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
332 <context>events</context>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
333
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
334 <para>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
335 Задаёт <value>метод</value>, используемый для
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
336 <link doc="events.xml">обработки соединений</link>.
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
337 Обычно нет необходимости задавать его явно, поскольку по умолчанию
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
338 nginx сам выбирает наиболее эффективный метод.
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
339 </para>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
340
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
341 </directive>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
342
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
343
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
344 <directive name="user">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
345 <syntax><value>пользователь</value> [<value>группа</value>]</syntax>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
346 <default>nobody nobody</default>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
347 <context>main</context>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
348
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
349 <para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
350 Задаёт пользователя и группу, с правами которого будут работать
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
351 рабочие процессы.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
352 Если <value>группа</value> не задана, то используется группа, имя
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
353 которой совпадает с именем пользователя.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
354 </para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
355
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
356 </directive>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
357
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
358
545
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
359 <directive name="worker_connections">
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
360 <syntax><value>число</value></syntax>
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
361 <default>512</default>
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
362 <context>events</context>
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
363
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
364 <para>
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
365 Задаёт максимальное число соединений, которое одновременно
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
366 может открыть рабочий процесс.
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
367 </para>
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
368
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
369 <para>
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
370 Следует иметь в виду, что в это число входят все соединения
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
371 (в том числе, например, соединения с проксируемыми серверами),
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
372 а не только соединения с клиентами.
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
373 Стоит также учитывать, что фактическое число одновременных
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
374 соединений не может превышать действующего ограничения на
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
375 максимальное число открытых файлов,
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
376 см. <link id="worker_rlimit_nofile"/>.
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
377 </para>
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
378
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
379 </directive>
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
380
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
381
469
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
382 <directive name="worker_cpu_affinity">
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
383 <syntax><value>маска_CPU</value> ...</syntax>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
384 <default/>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
385 <context>main</context>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
386
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
387 <para>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
388 Привязывает рабочие процессы к группам процессоров.
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
389 Каждая группа процессоров задаётся битовой маской
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
390 разрешённых к использованию процессоров.
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
391 Для каждого рабочего процесса должна быть задана отдельная группа.
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
392 По умолчанию рабочие процессы не привязаны к конкретным процессорам.
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
393 </para>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
394
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
395 <para>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
396 Например,
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
397 <example>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
398 worker_processes 4;
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
399 worker_cpu_affinity 0001 0010 0100 1000;
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
400 </example>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
401 привязывает каждый рабочий процесс к отдельному процессору, тогда как
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
402 <example>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
403 worker_processes 2;
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
404 worker_cpu_affinity 0101 1010;
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
405 </example>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
406 привязывает первый рабочий процесс к CPU0/CPU2,
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
407 а второй — к CPU1/CPU3.
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
408 Второй пример пригоден для hyper-threading.
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
409 </para>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
410
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
411 <para>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
412 <note>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
413 Директива доступна только на FreeBSD и Linux.
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
414 </note>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
415 </para>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
416
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
417 </directive>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
418
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
419
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
420 <directive name="worker_priority">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
421 <syntax><value>число</value></syntax>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
422 <default>0</default>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
423 <context>main</context>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
424
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
425 <para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
426 Задаёт приоритет планирования рабочих процессов подобно тому,
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
427 как это делается командой <command>nice</command>: отрицательное
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
428 <value>число</value>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
429 означает более высокий приоритет.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
430 Диапазон возможных значений, как правило, варьируется от -20 до 20.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
431 </para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
432
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
433 <para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
434 Пример использования:
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
435 <example>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
436 worker_priority -10;
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
437 </example>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
438 </para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
439
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
440 </directive>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
441
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
442
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
443 <directive name="worker_processes">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
444 <syntax><value>число</value></syntax>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
445 <default>1</default>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
446 <context>main</context>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
447
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
448 <para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
449 Задаёт число рабочих процессов.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
450 </para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
451
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
452 <para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
453 Оптимальное значение зависит от множества факторов, включая
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
454 (но не ограничиваясь ими) число процессорных ядер, число
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
455 жёстких дисков с данными и картину нагрузок.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
456 Если затрудняетесь в выборе правильного значения, можно начать
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
457 с установки его равным числу процессорных ядер.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
458 </para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
459
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
460 </directive>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
461
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
462
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
463 <directive name="worker_rlimit_core">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
464 <syntax><value>размер</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
465 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
466 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
467
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
468 <para>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
469 Изменяет ограничение на наибольший размер core-файла
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
470 (<c-def>RLIMIT_CORE</c-def>) для рабочих процессов.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
471 Используется для увеличения ограничения без перезапуска основного процесса.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
472 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
473
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
474 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
475
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
476
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
477 <directive name="worker_rlimit_nofile">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
478 <syntax><value>число</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
479 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
480 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
481
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
482 <para>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
483 Изменяет ограничение на максимальное число открытых файлов
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
484 (<c-def>RLIMIT_NOFILE</c-def>) для рабочих процессов.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
485 Используется для увеличения ограничения без перезапуска основного процесса.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
486 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
487
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
488 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
489
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
490
554
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
491 <directive name="worker_rlimit_sigpending">
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
492 <syntax><value>число</value></syntax>
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
493 <default/>
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
494 <context>main</context>
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
495
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
496 <para>
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
497 На системах с поддержкой метода обработки соединений
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
498 <link doc="events.xml" id="rtsig"/>,
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
499 изменяет ограничение на размер очереди сигналов
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
500 (<c-def>RLIMIT_SIGPENDING</c-def>) для рабочих процессов.
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
501 Используется для увеличения ограничения без перезапуска основного процесса.
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
502 </para>
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
503
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
504 </directive>
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
505
ccb7451af1d8 Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 545
diff changeset
506
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
507 <directive name="working_directory">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
508 <syntax><value>каталог</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
509 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
510 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
511
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
512 <para>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
513 Задаёт каталог, который будет текущим для рабочего процесса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
514 Основное применение — запись core-файла, в этом случае рабочий
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
515 процесс должен иметь права на запись в этот каталог.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
516 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
517
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
518 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
519
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
520 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
521
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
522 </module>