Mercurial > hg > nginx-site

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

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented the "reuseport" option of the "listen" directive.
author Yaroslav Zhuravlev <yar@nginx.com>
date Mon, 25 May 2015 20:48:34 +0300
parents 42f288fc9ad3
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="Module ngx_http_core_module" 10 <module name="Module ngx_http_core_module"
11 link="/en/docs/http/ngx_http_core_module.html" 11 link="/en/docs/http/ngx_http_core_module.html"
12 lang="en" 12 lang="en"
13 rev="39"> 13 rev="40">
14 14
15 <section id="directives" name="Directives"> 15 <section id="directives" name="Directives">
16 16
17 <directive name="aio"> 17 <directive name="aio">
18 <syntax> 18 <syntax>
1127 [<literal>sndbuf</literal>=<value>size</value>] 1127 [<literal>sndbuf</literal>=<value>size</value>]
1128 [<literal>accept_filter</literal>=<value>filter</value>] 1128 [<literal>accept_filter</literal>=<value>filter</value>]
1129 [<literal>deferred</literal>] 1129 [<literal>deferred</literal>]
1130 [<literal>bind</literal>] 1130 [<literal>bind</literal>]
1131 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] 1131 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
1132 [<literal>reuseport</literal>]
1132 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> 1133 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
1133 <syntax> 1134 <syntax>
1134 <value>port</value> 1135 <value>port</value>
1135 [<literal>default_server</literal>] 1136 [<literal>default_server</literal>]
1136 [<literal>ssl</literal>] 1137 [<literal>ssl</literal>]
1143 [<literal>sndbuf</literal>=<value>size</value>] 1144 [<literal>sndbuf</literal>=<value>size</value>]
1144 [<literal>accept_filter</literal>=<value>filter</value>] 1145 [<literal>accept_filter</literal>=<value>filter</value>]
1145 [<literal>deferred</literal>] 1146 [<literal>deferred</literal>]
1146 [<literal>bind</literal>] 1147 [<literal>bind</literal>]
1147 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] 1148 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
1149 [<literal>reuseport</literal>]
1148 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> 1150 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
1149 <syntax> 1151 <syntax>
1150 <literal>unix:</literal><value>path</value> 1152 <literal>unix:</literal><value>path</value>
1151 [<literal>default_server</literal>] 1153 [<literal>default_server</literal>]
1152 [<literal>ssl</literal>] 1154 [<literal>ssl</literal>]
1360 It can only be set once on start. 1362 It can only be set once on start.
1361 <note> 1363 <note>
1362 Prior to version 1.3.4, 1364 Prior to version 1.3.4,
1363 if this parameter was omitted then the operating system’s settings were 1365 if this parameter was omitted then the operating system’s settings were
1364 in effect for the socket. 1366 in effect for the socket.
1367 </note>
1368 </tag-desc>
1369
1370 <tag-name>
1371 <literal>reuseport</literal>
1372 </tag-name>
1373 <tag-desc>
1374 this parameter (1.9.1) instructs to create an individual listening socket
1375 for each worker process
1376 (using the <c-def>SO_REUSEPORT</c-def> socket option), allowing a kernel
1377 to distribute incoming connections between worker processes more effectively.
1378 This currently works only on Linux and DragonFly BSD.
1379 <note>
1380 Inappropriate use of this option may have its security
1381 <link url="http://man7.org/linux/man-pages/man7/socket.7.html">implications</link>.
1365 </note> 1382 </note>
1366 </tag-desc> 1383 </tag-desc>
1367 1384
1368 <tag-name> 1385 <tag-name>
1369 <literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>] 1386 <literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]