comparison xml/ru/docs/http/ngx_http_core_module.xml @ 1493:9faa78768252

Documented the "reuseport" option of the "listen" directive.
author Yaroslav Zhuravlev <yar@nginx.com>
date Mon, 25 May 2015 20:48:34 +0300
parents 002216d96931
children 99ce48c8cce3
comparison
equal deleted inserted replaced
1492:9b8df6c3cf3e 1493:9faa78768252
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Модуль ngx_http_core_module" 10 <module name="Модуль ngx_http_core_module"
11 link="/ru/docs/http/ngx_http_core_module.html" 11 link="/ru/docs/http/ngx_http_core_module.html"
12 lang="ru" 12 lang="ru"
13 rev="39"> 13 rev="40">
14 14
15 <section id="directives" name="Директивы"> 15 <section id="directives" name="Директивы">
16 16
17 <directive name="aio"> 17 <directive name="aio">
18 <syntax> 18 <syntax>
1122 [<literal>sndbuf</literal>=<value>размер</value>] 1122 [<literal>sndbuf</literal>=<value>размер</value>]
1123 [<literal>accept_filter</literal>=<value>фильтр</value>] 1123 [<literal>accept_filter</literal>=<value>фильтр</value>]
1124 [<literal>deferred</literal>] 1124 [<literal>deferred</literal>]
1125 [<literal>bind</literal>] 1125 [<literal>bind</literal>]
1126 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] 1126 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
1127 [<literal>reuseport</literal>]
1127 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> 1128 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
1128 <syntax> 1129 <syntax>
1129 <value>порт</value> 1130 <value>порт</value>
1130 [<literal>default_server</literal>] 1131 [<literal>default_server</literal>]
1131 [<literal>ssl</literal>] 1132 [<literal>ssl</literal>]
1138 [<literal>sndbuf</literal>=<value>размер</value>] 1139 [<literal>sndbuf</literal>=<value>размер</value>]
1139 [<literal>accept_filter</literal>=<value>фильтр</value>] 1140 [<literal>accept_filter</literal>=<value>фильтр</value>]
1140 [<literal>deferred</literal>] 1141 [<literal>deferred</literal>]
1141 [<literal>bind</literal>] 1142 [<literal>bind</literal>]
1142 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] 1143 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
1144 [<literal>reuseport</literal>]
1143 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> 1145 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
1144 <syntax> 1146 <syntax>
1145 <literal>unix:</literal><value>путь</value> 1147 <literal>unix:</literal><value>путь</value>
1146 [<literal>default_server</literal>] 1148 [<literal>default_server</literal>]
1147 [<literal>ssl</literal>] 1149 [<literal>ssl</literal>]
1355 Установить его можно только один раз на старте. 1357 Установить его можно только один раз на старте.
1356 <note> 1358 <note>
1357 До версии 1.3.4, 1359 До версии 1.3.4,
1358 если этот параметр не был задан явно, то для сокета действовали 1360 если этот параметр не был задан явно, то для сокета действовали
1359 настройки операционной системы. 1361 настройки операционной системы.
1362 </note>
1363 </tag-desc>
1364
1365 <tag-name>
1366 <literal>reuseport</literal>
1367 </tag-name>
1368 <tag-desc>
1369 этот параметр (1.9.1) указывает, что нужно создавать отдельный слушающий сокет
1370 для каждого рабочего процесса
1371 (через параметр сокета <c-def>SO_REUSEPORT</c-def>), позволяя ядру
1372 эффективнее распределять входящие соединения между рабочими процессами.
1373 В настоящий момент это работает только на Linux и DragonFly BSD.
1374 <note>
1375 Ненадлежащее использование параметра может иметь
1376 <link url="http://man7.org/linux/man-pages/man7/socket.7.html">последствия</link>
1377 в плане безопасности.
1360 </note> 1378 </note>
1361 </tag-desc> 1379 </tag-desc>
1362 1380
1363 <tag-name> 1381 <tag-name>
1364 <literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>] 1382 <literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]