nginx-site: xml/ru/docs/ngx_core

annotate xml/ru/docs/ngx_core_module.xml @ 523:a8daad8e83bb

Documented 1.2.1 changes.

author	Ruslan Ermilov <ru@nginx.com>
date	Mon, 04 Jun 2012 14:41:28 +0000
parents	8e1356bd281a
children	e97b46d1842d

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

Mercurial > hg > nginx-site

annotate xml/ru/docs/ngx_core_module.xml @ 523:a8daad8e83bb