Mercurial > hg > nginx-site

annotate xml/ru/docs/ngx_core_module.xml @ 3090:27532d42102b default tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented the "rate" parameter of the "error_log" directive.
author Maxim Dounin <mdounin@mdounin.ru>
date Sun, 16 Jun 2024 06:55:30 +0300
parents eb5950986b11
children
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
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 574
diff changeset
3 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 574
diff changeset
4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 574
diff changeset
5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 574
diff changeset
6 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 574
diff changeset
7
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../dtd/module.dtd">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
9
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
10 <module name="Основная функциональность"
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
11 link="/ru/docs/ngx_core_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="ru"
3090
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
13 rev="29">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
14
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
15 <section id="example" name="Пример конфигурации">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
16
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
17 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
18 <example>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
19 user www www;
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
20 worker_processes 2;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
21
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
22 error_log /var/log/nginx-error.log info;
76
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 events {
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
25 use kqueue;
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
26 worker_connections 2048;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
27 }
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 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
30 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
31 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
32
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
33 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
34
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
35
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
36 <section id="directives" name="Директивы">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
37
571
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
38 <directive name="accept_mutex">
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
39 <syntax><literal>on</literal> | <literal>off</literal></syntax>
1755
bde044a0bd90 Documented that accept_mutex is off by default.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1697
diff changeset
40 <default>off</default>
571
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
41 <context>events</context>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
42
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
43 <para>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
44 Если <literal>accept_mutex</literal> включён,
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
45 рабочие процессы будут принимать новые соединения по очереди.
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
46 В противном случае о новых соединениях будет сообщаться сразу всем рабочим
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
47 процессам, и при низкой интенсивности поступления новых соединений
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
48 часть рабочих процессов может работать вхолостую.
1755
bde044a0bd90 Documented that accept_mutex is off by default.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1697
diff changeset
49 <note>
1784
68928f8d31d9 Updated accept_mutex with info about reuseport and epollexclusive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1755
diff changeset
50 Нет необходимости включать <literal>accept_mutex</literal>
68928f8d31d9 Updated accept_mutex with info about reuseport and epollexclusive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1755
diff changeset
51 на системах, поддерживающих
68928f8d31d9 Updated accept_mutex with info about reuseport and epollexclusive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1755
diff changeset
52 флаг <link doc="events.xml" id="epoll">EPOLLEXCLUSIVE</link> (1.11.3), или
68928f8d31d9 Updated accept_mutex with info about reuseport and epollexclusive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1755
diff changeset
53 при использовании <link doc="http/ngx_http_core_module.xml" id="reuseport"/>.
68928f8d31d9 Updated accept_mutex with info about reuseport and epollexclusive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1755
diff changeset
54 </note>
68928f8d31d9 Updated accept_mutex with info about reuseport and epollexclusive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1755
diff changeset
55 <note>
1755
bde044a0bd90 Documented that accept_mutex is off by default.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1697
diff changeset
56 До версии 1.11.3 по умолчанию использовалось значение <literal>on</literal>.
bde044a0bd90 Documented that accept_mutex is off by default.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1697
diff changeset
57 </note>
571
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
58 </para>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
59
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
60 </directive>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
61
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
62
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
63 <directive name="accept_mutex_delay">
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
64 <syntax><value>время</value></syntax>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
65 <default>500ms</default>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
66 <context>events</context>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
67
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
68 <para>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
69 При включённом <link id="accept_mutex"/> задаёт максимальное время,
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
70 в течение которого рабочий процесс вновь попытается начать принимать
957
6d9d4bb571a9 Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 935
diff changeset
71 новые соединения, если в настоящий момент новые соединения принимает
6d9d4bb571a9 Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 935
diff changeset
72 другой рабочий процесс.
571
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
73 </para>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
74
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
75 </directive>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
76
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
77
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
78 <directive name="daemon">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
79 <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
80 <default>on</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
81 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
82
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
83 <para>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
84 Определяет, будет ли nginx запускаться в режиме демона.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
85 Используется в основном для разработки.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
86 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
87
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
88 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
89
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
90
516
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
91 <directive name="debug_connection">
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
92 <syntax>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
93 <value>адрес</value> |
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
94 <value>CIDR</value> |
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
95 <literal>unix:</literal></syntax>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
96 <default/>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
97 <context>events</context>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
98
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
99 <para>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
100 Включает отладочный лог для отдельных клиентских соединений.
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
101 Для остальных соединений используется уровень лога, заданный директивой
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
102 <link id="error_log"/>.
523
a8daad8e83bb Documented 1.2.1 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 516
diff changeset
103 Отлаживаемые соединения задаются IPv4 или IPv6 (1.3.0, 1.2.1)
a8daad8e83bb Documented 1.2.1 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 516
diff changeset
104 адресом или сетью.
614
0526cac4637e Removed intimate details of the "debug_connection" directive's
Ruslan Ermilov <ru@nginx.com>
parents: 610
diff changeset
105 Соединение может быть также задано при помощи имени хоста.
523
a8daad8e83bb Documented 1.2.1 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 516
diff changeset
106 Отладочный лог для соединений через UNIX-сокеты (1.3.0, 1.2.1)
a8daad8e83bb Documented 1.2.1 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 516
diff changeset
107 включается параметром “<literal>unix:</literal>”.
516
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
108 <example>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
109 events {
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
110 debug_connection 127.0.0.1;
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
111 debug_connection localhost;
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
112 debug_connection 192.0.2.0/24;
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
113 debug_connection ::1;
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
114 debug_connection 2001:0db8::/32;
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
115 debug_connection unix:;
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
116 ...
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
117 }
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
118 </example>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
119 <note>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
120 Для работы директивы необходимо сконфигурировать nginx с параметром
913
9a65d437da42 Link to "A debugging log" from "debug_connection" and "error_log".
Ruslan Ermilov <ru@nginx.com>
parents: 804
diff changeset
121 <literal>--with-debug</literal>,
9a65d437da42 Link to "A debugging log" from "debug_connection" and "error_log".
Ruslan Ermilov <ru@nginx.com>
parents: 804
diff changeset
122 см. “<link doc="debugging_log.xml"/>”.
516
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
123 </note>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
124 </para>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
125
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
126 </directive>
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
127
8e1356bd281a Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 469
diff changeset
128
574
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
129 <directive name="debug_points">
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
130 <syntax><literal>abort</literal> | <literal>stop</literal></syntax>
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
131 <default/>
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
132 <context>main</context>
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
133
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
134 <para>
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
135 Эта директива используется для отладки.
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
136 </para>
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
137
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
138 <para>
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
139 В случае обнаружения внутренней ошибки, например, утечки сокетов в момент
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
140 перезапуска рабочих процессов, включение <literal>debug_points</literal>
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
141 приводит к созданию core-файла (<literal>abort</literal>)
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
142 или остановке процесса (<literal>stop</literal>) с целью последующей
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
143 диагностики с помощью системного отладчика.
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
144 </para>
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
145
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
146 </directive>
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
147
5e9ff979eac8 Documented debug_points.
Ruslan Ermilov <ru@nginx.com>
parents: 571
diff changeset
148
2142
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
149 <directive name="env">
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
150 <syntax><value>переменная</value>[=<value>значение</value>]</syntax>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
151 <default>TZ</default>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
152 <context>main</context>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
153
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
154 <para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
155 По умолчанию nginx удаляет все переменные окружения, унаследованные
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
156 от своего родительского процесса, кроме переменной TZ.
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
157 Эта директива позволяет сохранить часть унаследованных переменных,
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
158 поменять им значения или же создать новые переменные окружения.
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
159 Эти переменные затем:
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
160 <list type="bullet">
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
161
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
162 <listitem>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
163 наследуются во время
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
164 <link doc="control.xml" id="upgrade">обновления исполняемого файла на лету</link>;
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
165 </listitem>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
166
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
167 <listitem>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
168 используются модулем
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
169 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>;
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
170 </listitem>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
171
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
172 <listitem>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
173 используются рабочими процессами.
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
174 Следует иметь в виду, что управление поведением системных библиотек
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
175 подобным образом возможно не всегда, поскольку зачастую библиотеки используют
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
176 переменные только во время инициализации, то есть ещё до того, как их
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
177 можно задать с помощью данной директивы.
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
178 Исключением из этого является упомянутое выше
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
179 <link doc="control.xml" id="upgrade">обновление исполняемого файла на лету</link>.
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
180 </listitem>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
181
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
182 </list>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
183 </para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
184
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
185 <para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
186 Если переменная TZ не описана явно, то она всегда наследуется
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
187 и всегда доступна модулю
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
188 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>.
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
189 </para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
190
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
191 <para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
192 Пример использования:
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
193 <example>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
194 env MALLOC_OPTIONS;
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
195 env PERL5LIB=/data/site/modules;
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
196 env OPENSSL_ALLOW_PROXY_CERTS=1;
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
197 </example>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
198 </para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
199
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
200 <para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
201 <note>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
202 Переменная окружения NGINX используется для внутренних целей nginx
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
203 и не должна устанавливаться непосредственно самим пользователем.
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
204 </note>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
205 </para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
206
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
207 </directive>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
208
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2080
diff changeset
209
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
210 <directive name="error_log">
3090
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
211 <syntax>
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
212 <value>файл</value>
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
213 [<value>уровень</value>]
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
214 [<literal>rate</literal>=<value>скорость</value>]</syntax>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
215 <default>logs/error.log error</default>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
216 <context>main</context>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
217 <context>http</context>
1480
d1e1a8d34bce Documented mail support in error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1465
diff changeset
218 <context>mail</context>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1449
diff changeset
219 <context>stream</context>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
220 <context>server</context>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
221 <context>location</context>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
222
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
223 <para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
224 Конфигурирует запись в лог.
2593
eeed494bba51 Unified phrases about configuration levels and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 2142
diff changeset
225 На одном уровне конфигурации может использоваться несколько логов (1.5.2).
1893
f1c18acbe785 Added info about default log file to error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1888
diff changeset
226 Если на уровне конфигурации <literal>main</literal> запись лога в файл
f1c18acbe785 Added info about default log file to error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1888
diff changeset
227 явно не задана, то используется файл по умолчанию.
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
228 </para>
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 <para>
1697
147e3d0339e8 Reduced syntax clutter in the error_log directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1695
diff changeset
231 Первый параметр задаёт <value>файл</value>, который будет хранить лог.
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
232 <!--
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
233 Если имя файла не абсолютное, к нему добавляется в начало путь префикса.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
234 -->
455
571b790ddf9e error_log: documented the special value "stderr" and default logging level.
Ruslan Ermilov <ru@nginx.com>
parents: 444
diff changeset
235 Специальное значение <literal>stderr</literal> выбирает стандартный файл ошибок.
1285
4e89518a5999 Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents: 1205
diff changeset
236 Запись в <link doc="syslog.xml">syslog</link> настраивается указанием префикса
1175
a05d9fa73ce2 Documented the syslog support in "error_log" and "access_log".
Yaroslav Zhuravlev <yar@nginx.com>
parents: 957
diff changeset
237 “<literal>syslog:</literal>”.
1449
c79501e16e26 Documented cyclic memory buffer support for error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1436
diff changeset
238 Запись в
c79501e16e26 Documented cyclic memory buffer support for error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1436
diff changeset
239 <link doc="debugging_log.xml" id="memory">кольцевой буфер в памяти</link>
c79501e16e26 Documented cyclic memory buffer support for error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1436
diff changeset
240 настраивается указанием префикса “<literal>memory:</literal>” и
c79501e16e26 Documented cyclic memory buffer support for error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1436
diff changeset
241 <value>размера</value> буфера и как правило используется для отладки (1.7.11).
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
242 </para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
243
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
244 <para>
1695
aa95174efa80 Moved levels from error_log syntax to description.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1650
diff changeset
245 Второй параметр определяет <value>уровень</value> лога
aa95174efa80 Moved levels from error_log syntax to description.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1650
diff changeset
246 и может принимать одно из следующих значений:
aa95174efa80 Moved levels from error_log syntax to description.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1650
diff changeset
247 <literal>debug</literal>, <literal>info</literal>, <literal>notice</literal>,
aa95174efa80 Moved levels from error_log syntax to description.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1650
diff changeset
248 <literal>warn</literal>, <literal>error</literal>, <literal>crit</literal>,
aa95174efa80 Moved levels from error_log syntax to description.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1650
diff changeset
249 <literal>alert</literal> или <literal>emerg</literal>.
957
6d9d4bb571a9 Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 935
diff changeset
250 Уровни лога, указанные выше, перечислены в порядке возрастания важности.
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
251 При установке определённого уровня в лог попадают все сообщения
957
6d9d4bb571a9 Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 935
diff changeset
252 указанного уровня и уровней большей важности.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
253 Например, при стандартном уровне <literal>error</literal> в лог попадают
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
254 сообщения уровней <literal>error</literal>, <literal>crit</literal>,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
255 <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
256 Если этот параметр не задан, используется <literal>error</literal>.
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
257 <note>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
258 Для работы уровня лога <literal>debug</literal> необходимо сконфигурировать
913
9a65d437da42 Link to "A debugging log" from "debug_connection" and "error_log".
Ruslan Ermilov <ru@nginx.com>
parents: 804
diff changeset
259 nginx с <literal>--with-debug</literal>,
9a65d437da42 Link to "A debugging log" from "debug_connection" and "error_log".
Ruslan Ermilov <ru@nginx.com>
parents: 804
diff changeset
260 см. “<link doc="debugging_log.xml"/>”.
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
261 </note>
3090
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
262 </para>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1449
diff changeset
263
3090
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
264 <para>
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
265 Параметр <literal>rate</literal> (1.27.2) задаёт
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
266 максимально допустимую скорость записи в лог в сообщениях в секунду (m/s)
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
267 для каждого рабочего процесса.
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
268 По умолчанию используется <literal>rate=1000m/s</literal>.
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
269 Установка <literal>скорости</literal> в 0 отключает ограничение скорости.
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
270 Кроме того, ограничение скорости не используется,
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
271 если уровень лога установлен в <literal>debug</literal> или
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
272 отладочный лог включён для <link id="debug_connection">соединения</link>.
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
273 </para>
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
274
27532d42102b Documented the "rate" parameter of the "error_log" directive.
Maxim Dounin <mdounin@mdounin.ru>
parents: 3081
diff changeset
275 <para>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1449
diff changeset
276 <note>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1449
diff changeset
277 Директива может быть указана на
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1449
diff changeset
278 уровне <literal>stream</literal>
1888
3ed02f21146b Merged notes about versions in error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1842
diff changeset
279 начиная с версии 1.7.11
3ed02f21146b Merged notes about versions in error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1842
diff changeset
280 и на уровне <literal>mail</literal>
1480
d1e1a8d34bce Documented mail support in error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1465
diff changeset
281 начиная с версии 1.9.0.
d1e1a8d34bce Documented mail support in error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1465
diff changeset
282 </note>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
283 </para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
284
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
285 </directive>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
286
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
287
556
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
288 <directive name="events">
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
289 <syntax block="yes"/>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
290 <default/>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
291 <context>main</context>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
292
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
293 <para>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
294 Предоставляет контекст конфигурационного файла, в котором указываются
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
295 директивы, влияющие на обработку соединений.
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
296 </para>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
297
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
298 </directive>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
299
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
300
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
301 <directive name="include">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
302 <syntax><value>файл</value> | <value>маска</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
303 <default/>
104
3ae68fe2e938 A nicer look for the directive's synopsis section, including i18n
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
304 <context/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
305
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
306 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
307 Включает в конфигурацию другой <value>файл</value> или файлы,
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
308 подходящие под заданную маску.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
309 Включаемые файлы должны содержать синтаксически верные директивы и блоки.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
310 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
311
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
312 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
313 Пример использования:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
314 <example>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
315 include mime.types;
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
316 include vhosts/*.conf;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
317 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
318 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
319
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
320 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
321
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
322
1650
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
323 <directive name="load_module">
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
324 <syntax><value>файл</value></syntax>
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
325 <default/>
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
326 <context>main</context>
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
327 <appeared-in>1.9.11</appeared-in>
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
328
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
329 <para>
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
330 Загружает динамический модуль.
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
331 </para>
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
332
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
333 <para>
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
334 Пример:
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
335 <example>
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
336 load_module modules/ngx_mail_module.so;
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
337 </example>
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
338 </para>
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
339
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
340 </directive>
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
341
6b4cb951cf83 Documented the load_module directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1641
diff changeset
342
571
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
343 <directive name="lock_file">
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
344 <syntax><value>файл</value></syntax>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
345 <default>logs/nginx.lock</default>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
346 <context>main</context>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
347
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
348 <para>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
349 Для реализации <link id="accept_mutex"/> и сериализации доступа к
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
350 разделяемой памяти nginx использует механизм блокировок.
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
351 На большинстве систем блокировки реализованы с помощью атомарных
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
352 операций, и эта директива игнорируется.
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
353 Для остальных систем применяется механизм файлов блокировок.
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
354 Эта директива задаёт префикс имён файлов блокировок.
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
355 </para>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
356
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
357 </directive>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
358
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
359
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
360 <directive name="master_process">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
361 <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
362 <default>on</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
363 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
364
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
365 <para>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
366 Определяет, будут ли запускаться рабочие процессы.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
367 Эта директива предназначена для разработчиков nginx.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
368 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
369
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
370 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
371
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
372
571
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
373 <directive name="multi_accept">
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
374 <syntax><literal>on</literal> | <literal>off</literal></syntax>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
375 <default>off</default>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
376 <context>events</context>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
377
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
378 <para>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
379 Если <literal>multi_accept</literal> выключен, рабочий процесс
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
380 за один раз будет принимать только одно новое соединение.
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
381 В противном случае рабочий процесс
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
382 за один раз будет принимать сразу все новые соединения.
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
383 <note>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
384 Директива игнорируется в случае использования метода обработки соединений
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
385 <link doc="events.xml" id="kqueue"/>, т.к. данный метод сам сообщает
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
386 число новых соединений, ожидающих приёма.
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
387 </note>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
388 </para>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
389
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
390 </directive>
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
391
71d775bef043 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents: 556
diff changeset
392
289
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
393 <directive name="pcre_jit">
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
394 <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
395 <default>off</default>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
396 <context>main</context>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
397 <appeared-in>1.1.12</appeared-in>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
398
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
399 <para>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
400 Разрешает или запрещает использование JIT-компиляции (PCRE JIT)
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
401 для регулярных выражений, известных на момент парсинга конфигурации.
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
402 </para>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
403
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
404 <para>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
405 Использование PCRE JIT способно существенно ускорить обработку
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
406 регулярных выражений.
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
407 <note>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
408 Для работы JIT необходима библиотека PCRE версии 8.20 или выше,
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
409 собранная с параметром конфигурации <literal>--enable-jit</literal>.
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
410 При сборке библиотеки PCRE вместе с nginx (<literal>--with-pcre=</literal>),
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
411 для включения поддержки JIT необходимо использовать параметр
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
412 конфигурации <literal>--with-pcre-jit</literal>.
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
413 </note>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
414 </para>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
415
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
416 </directive>
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
417
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
418
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
419 <directive name="pid">
3081
eb5950986b11 Documented "pid off".
Maxim Dounin <mdounin@mdounin.ru>
parents: 2634
diff changeset
420 <syntax><value>файл</value> | <literal>off</literal></syntax>
2080
8f885a69374d Fixed the "pid" directive default value.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1927
diff changeset
421 <default>logs/nginx.pid</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
422 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
423
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
424 <para>
1842
db848aaa123a Corrected Russian translation of "master process".
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1784
diff changeset
425 Задаёт <value>файл</value>, в котором будет храниться номер (PID) главного процесса.
3081
eb5950986b11 Documented "pid off".
Maxim Dounin <mdounin@mdounin.ru>
parents: 2634
diff changeset
426 Параметр <literal>off</literal> (1.27.0) отключает запись PID-файла.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
427 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
428
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
429 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
430
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
431
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
432 <directive name="ssl_engine">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
433 <syntax><value>устройство</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
434 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
435 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
436
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
437 <para>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
438 Задаёт название аппаратного SSL-акселератора.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
439 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
440
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
441 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
442
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
443
1436
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
444 <directive name="thread_pool">
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
445 <syntax>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
446 <value>имя</value>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
447 <literal>threads</literal>=<value>число</value>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
448 [<literal>max_queue</literal>=<value>число</value>]</syntax>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
449 <default>default threads=32 max_queue=65536</default>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
450 <context>main</context>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
451 <appeared-in>1.7.11</appeared-in>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
452
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
453 <para>
2634
0722b485010c Improved wording in the thread_pool directive description.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2593
diff changeset
454 Задаёт <value>имя</value> и параметры пула потоков,
0722b485010c Improved wording in the thread_pool directive description.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2593
diff changeset
455 используемого для многопоточной обработки операций чтения и отправки файлов
1436
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
456 <link doc="http/ngx_http_core_module.xml" id="aio">без блокирования</link>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
457 рабочего процесса.
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
458 </para>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
459
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
460 <para>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
461 Параметр <literal>threads</literal>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
462 задаёт число потоков в пуле.
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
463 </para>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
464
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
465 <para>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
466 Если все потоки из пула заняты выполнением заданий,
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
467 новое задание будет ожидать своего выполнения в очереди.
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
468 Параметр <literal>max_queue</literal> ограничивает число заданий,
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
469 ожидающих своего выполнения в очереди.
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
470 По умолчанию в очереди может находиться до 65536 заданий.
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
471 При переполнении очереди задание завершается с ошибкой.
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
472 </para>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
473
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
474 </directive>
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
475
2333e08e277d Documented thread pools.
Ruslan Ermilov <ru@nginx.com>
parents: 1285
diff changeset
476
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
477 <directive name="timer_resolution">
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-func>gettimeofday</c-func>.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
485 По умолчанию <c-func>gettimeofday</c-func> вызывается после каждой
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
486 операции получения событий из ядра.
957
6d9d4bb571a9 Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 935
diff changeset
487 При уменьшении разрешения <c-func>gettimeofday</c-func> вызывается только
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
488 один раз за указанный <value>интервал</value>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
489 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
490
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
491 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
492 Пример использования:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
493 <example>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
494 timer_resolution 100ms;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
495 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
496 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
497
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
498 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
499 Внутренняя реализация интервала зависит от используемого метода:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
500 <list type="bullet">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
501
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
502 <listitem>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
503 фильтр <c-def>EVFILT_TIMER</c-def> при использовании <literal>kqueue</literal>;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
504 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
505
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
506 <listitem>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
507 <c-func>timer_create</c-func> при использовании <literal>eventport</literal>;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
508 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
509
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
510 <listitem>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
511 и <c-func>setitimer</c-func> во всех остальных случаях.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
512 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
513
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
514 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
515 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
516
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
517 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
518
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
519
556
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
520 <directive name="use">
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
521 <syntax><value>метод</value></syntax>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
522 <default/>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
523 <context>events</context>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
524
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
525 <para>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
526 Задаёт <value>метод</value>, используемый для
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
527 <link doc="events.xml">обработки соединений</link>.
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
528 Обычно нет необходимости задавать его явно, поскольку по умолчанию
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
529 nginx сам выбирает наиболее эффективный метод.
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
530 </para>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
531
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
532 </directive>
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
533
345012910707 Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 554
diff changeset
534
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
535 <directive name="user">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
536 <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
537 <default>nobody nobody</default>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
538 <context>main</context>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
539
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
540 <para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
541 Задаёт пользователя и группу, с правами которого будут работать
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
542 рабочие процессы.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
543 Если <value>группа</value> не задана, то используется группа, имя
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
544 которой совпадает с именем пользователя.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
545 </para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
546
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
547 </directive>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
548
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
549
749
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
550 <directive name="worker_aio_requests">
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
551 <syntax><value>число</value></syntax>
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
552 <default>32</default>
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
553 <context>events</context>
750
6a1b1ba62cab Documented history of "worker_aio_requests" directive.
Vladimir Homutov <vl@nginx.com>
parents: 749
diff changeset
554 <appeared-in>1.1.4</appeared-in>
6a1b1ba62cab Documented history of "worker_aio_requests" directive.
Vladimir Homutov <vl@nginx.com>
parents: 749
diff changeset
555 <appeared-in>1.0.7</appeared-in>
749
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
556
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
557 <para>
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
558 При использовании <link doc="http/ngx_http_core_module.xml" id="aio"/>
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
559 совместно с методом обработки соединений
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
560 <link doc="../docs/events.xml" id="epoll"/>,
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
561 задаёт максимальное <value>число</value> ожидающих обработки операций
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
562 асинхронного ввода-вывода для одного рабочего процесса.
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
563 </para>
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
564
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
565 </directive>
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
566
2abb92a19101 Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents: 742
diff changeset
567
545
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
568 <directive name="worker_connections">
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
569 <syntax><value>число</value></syntax>
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
570 <default>512</default>
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
571 <context>events</context>
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
572
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
573 <para>
957
6d9d4bb571a9 Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 935
diff changeset
574 Задаёт максимальное число соединений, которые одновременно
545
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
575 может открыть рабочий процесс.
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
576 </para>
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
577
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
578 <para>
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
579 Следует иметь в виду, что в это число входят все соединения
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
580 (в том числе, например, соединения с проксируемыми серверами),
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
581 а не только соединения с клиентами.
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
582 Стоит также учитывать, что фактическое число одновременных
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
583 соединений не может превышать действующего ограничения на
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
584 максимальное число открытых файлов,
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 614
diff changeset
585 которое можно изменить с помощью <link id="worker_rlimit_nofile"/>.
545
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
586 </para>
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
587
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
588 </directive>
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
589
e97b46d1842d Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
590
469
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
591 <directive name="worker_cpu_affinity">
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
592 <syntax><value>маска_CPU</value> ...</syntax>
1641
c0d1026e7e7b Documented the "auto" parameter in worker_cpu_affinity.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1480
diff changeset
593 <syntax><literal>auto</literal> [<value>маска_CPU</value>]</syntax>
469
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
594 <default/>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
595 <context>main</context>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
596
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
597 <para>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
598 Привязывает рабочие процессы к группам процессоров.
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
599 Каждая группа процессоров задаётся битовой маской
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
600 разрешённых к использованию процессоров.
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
601 Для каждого рабочего процесса должна быть задана отдельная группа.
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
602 По умолчанию рабочие процессы не привязаны к конкретным процессорам.
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
603 </para>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
604
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
605 <para>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
606 Например,
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
607 <example>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
608 worker_processes 4;
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
609 worker_cpu_affinity 0001 0010 0100 1000;
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
610 </example>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
611 привязывает каждый рабочий процесс к отдельному процессору, тогда как
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
612 <example>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
613 worker_processes 2;
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
614 worker_cpu_affinity 0101 1010;
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
615 </example>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
616 привязывает первый рабочий процесс к CPU0/CPU2,
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
617 а второй — к CPU1/CPU3.
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
618 Второй пример пригоден для hyper-threading.
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
619 </para>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
620
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
621 <para>
1641
c0d1026e7e7b Documented the "auto" parameter in worker_cpu_affinity.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1480
diff changeset
622 Специальное значение <literal>auto</literal> (1.9.10) позволяет
c0d1026e7e7b Documented the "auto" parameter in worker_cpu_affinity.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1480
diff changeset
623 автоматически привязать рабочие процессы к доступным процессорам:
c0d1026e7e7b Documented the "auto" parameter in worker_cpu_affinity.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1480
diff changeset
624 <example>
c0d1026e7e7b Documented the "auto" parameter in worker_cpu_affinity.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1480
diff changeset
625 worker_processes auto;
c0d1026e7e7b Documented the "auto" parameter in worker_cpu_affinity.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1480
diff changeset
626 worker_cpu_affinity auto;
c0d1026e7e7b Documented the "auto" parameter in worker_cpu_affinity.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1480
diff changeset
627 </example>
c0d1026e7e7b Documented the "auto" parameter in worker_cpu_affinity.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1480
diff changeset
628 С помощью необязательной маски можно ограничить процессоры,
c0d1026e7e7b Documented the "auto" parameter in worker_cpu_affinity.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1480
diff changeset
629 доступные для автоматической привязки:
c0d1026e7e7b Documented the "auto" parameter in worker_cpu_affinity.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1480
diff changeset
630 <example>
c0d1026e7e7b Documented the "auto" parameter in worker_cpu_affinity.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1480
diff changeset
631 worker_cpu_affinity auto 01010101;
c0d1026e7e7b Documented the "auto" parameter in worker_cpu_affinity.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1480
diff changeset
632 </example>
c0d1026e7e7b Documented the "auto" parameter in worker_cpu_affinity.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1480
diff changeset
633 </para>
c0d1026e7e7b Documented the "auto" parameter in worker_cpu_affinity.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1480
diff changeset
634
c0d1026e7e7b Documented the "auto" parameter in worker_cpu_affinity.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1480
diff changeset
635 <para>
469
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
636 <note>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
637 Директива доступна только на FreeBSD и Linux.
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
638 </note>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
639 </para>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
640
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
641 </directive>
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
642
8275e169f77b Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents: 455
diff changeset
643
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
644 <directive name="worker_priority">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
645 <syntax><value>число</value></syntax>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
646 <default>0</default>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
647 <context>main</context>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
648
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
649 <para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
650 Задаёт приоритет планирования рабочих процессов подобно тому,
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
651 как это делается командой <command>nice</command>: отрицательное
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
652 <value>число</value>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
653 означает более высокий приоритет.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
654 Диапазон возможных значений, как правило, варьируется от -20 до 20.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
655 </para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
656
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
657 <para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
658 Пример использования:
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
659 <example>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
660 worker_priority -10;
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
661 </example>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
662 </para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
663
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
664 </directive>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
665
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
666
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
667 <directive name="worker_processes">
740
46d70031bea9 Documented the recently added "auto" parameter of the
Andrey Belov <defan@nginx.com>
parents: 659
diff changeset
668 <syntax><value>число</value> | <literal>auto</literal></syntax>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
669 <default>1</default>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
670 <context>main</context>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
671
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
672 <para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
673 Задаёт число рабочих процессов.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
674 </para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
675
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
676 <para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
677 Оптимальное значение зависит от множества факторов, включая
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
678 (но не ограничиваясь ими) число процессорных ядер, число
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
679 жёстких дисков с данными и картину нагрузок.
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
680 Если затрудняетесь в выборе правильного значения, можно начать
740
46d70031bea9 Documented the recently added "auto" parameter of the
Andrey Belov <defan@nginx.com>
parents: 659
diff changeset
681 с установки его равным числу процессорных ядер
46d70031bea9 Documented the recently added "auto" parameter of the
Andrey Belov <defan@nginx.com>
parents: 659
diff changeset
682 (значение “<literal>auto</literal>” пытается определить его
46d70031bea9 Documented the recently added "auto" parameter of the
Andrey Belov <defan@nginx.com>
parents: 659
diff changeset
683 автоматически).
742
3a2e35f4c279 Documented that "worker_processes auto" appeared in version 1.3.8.
Ruslan Ermilov <ru@nginx.com>
parents: 740
diff changeset
684 <note>
3a2e35f4c279 Documented that "worker_processes auto" appeared in version 1.3.8.
Ruslan Ermilov <ru@nginx.com>
parents: 740
diff changeset
685 Параметр <literal>auto</literal> поддерживается только начиная
764
f8434fdd3cd9 The "auto" parameter of the ""worker_processes" directive
Ruslan Ermilov <ru@nginx.com>
parents: 750
diff changeset
686 с версий 1.3.8 и 1.2.5.
742
3a2e35f4c279 Documented that "worker_processes auto" appeared in version 1.3.8.
Ruslan Ermilov <ru@nginx.com>
parents: 740
diff changeset
687 </note>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
688 </para>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
689
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
690 </directive>
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
691
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
692
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
693 <directive name="worker_rlimit_core">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
694 <syntax><value>размер</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
695 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
696 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
697
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
698 <para>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
699 Изменяет ограничение на наибольший размер core-файла
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
700 (<c-def>RLIMIT_CORE</c-def>) для рабочих процессов.
1842
db848aaa123a Corrected Russian translation of "master process".
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1784
diff changeset
701 Используется для увеличения ограничения без перезапуска главного процесса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
702 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
703
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
704 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
705
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
706
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
707 <directive name="worker_rlimit_nofile">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
708 <syntax><value>число</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
709 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
710 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
711
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
712 <para>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
713 Изменяет ограничение на максимальное число открытых файлов
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
714 (<c-def>RLIMIT_NOFILE</c-def>) для рабочих процессов.
1842
db848aaa123a Corrected Russian translation of "master process".
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1784
diff changeset
715 Используется для увеличения ограничения без перезапуска главного процесса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
716 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
717
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
718 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
719
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
720
1927
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
721 <directive name="worker_shutdown_timeout">
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
722 <syntax><value>время</value></syntax>
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
723 <default/>
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
724 <context>main</context>
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
725 <appeared-in>1.11.11</appeared-in>
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
726
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
727 <para>
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
728 Задаёт таймаут в секундах для плавного завершения рабочих процессов.
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
729 По истечении указанного <value>времени</value>
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
730 nginx попытается закрыть все открытые соединения
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
731 для ускорения завершения.
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
732 </para>
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
733
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
734 </directive>
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
735
75d2478260f4 Documented the "worker_shutdown_timeout" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1893
diff changeset
736
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
737 <directive name="working_directory">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
738 <syntax><value>каталог</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 79
diff changeset
739 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
740 <context>main</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
741
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
742 <para>
255
e2718c7f9040 Sync ngx_core_module documentation with English version.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
743 Задаёт каталог, который будет текущим для рабочего процесса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
744 Основное применение — запись core-файла, в этом случае рабочий
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
745 процесс должен иметь права на запись в этот каталог.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
746 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
747
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
748 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
749
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
750 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
751
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
752 </module>