Mercurial > hg > nginx-site

changeset 1036:5894aa46ffef

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented "listen fastopen=" parameter.
author Vladimir Homutov <vl@nginx.com>
date Fri, 20 Dec 2013 10:01:29 +0400
parents e9c485d6cc0c
children 3fde5aa256ac
files xml/en/docs/http/ngx_http_core_module.xml xml/ru/docs/http/ngx_http_core_module.xml
diffstat 2 files changed, 44 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_core_module.xml
+++ b/xml/en/docs/http/ngx_http_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_core_module"
         link="/en/docs/http/ngx_http_core_module.html"
         lang="en"
-        rev="27">
+        rev="28">
 
 <section id="directives" name="Directives">
 
@@ -1099,6 +1099,7 @@ The “wait-read-ignore” cycle is repeated, but no longer than specified by the
     [<literal>ssl</literal>]
     [<literal>spdy</literal>]
     [<literal>setfib</literal>=<value>number</value>]
+    [<literal>fastopen</literal>=<value>number</value>]
     [<literal>backlog</literal>=<value>number</value>]
     [<literal>rcvbuf</literal>=<value>size</value>]
     [<literal>sndbuf</literal>=<value>size</value>]
@@ -1113,6 +1114,7 @@ The “wait-read-ignore” cycle is repeated, but no longer than specified by the
     [<literal>ssl</literal>]
     [<literal>spdy</literal>]
     [<literal>setfib</literal>=<value>number</value>]
+    [<literal>fastopen</literal>=<value>number</value>]
     [<literal>backlog</literal>=<value>number</value>]
     [<literal>rcvbuf</literal>=<value>size</value>]
     [<literal>sndbuf</literal>=<value>size</value>]
@@ -1225,6 +1227,25 @@ This currently works only on FreeBSD.
 </tag-desc>
 
 <tag-name>
+<literal>fastopen</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+enables
+“<link url="http://en.wikipedia.org/wiki/TCP_Fast_Open">TCP Fast Open</link>”
+for the listening socket (1.5.8).
+The <literal>number</literal> parameter
+<link url="http://tools.ietf.org/html/draft-ietf-tcpm-fastopen#section-5.1">limits</link>
+the maximum length for the queue of connections that have not yet completed
+the three-way handshake.
+<note>
+Do not enable this feature unless the server can handle
+receiving the
+<link url="http://tools.ietf.org/html/draft-ietf-tcpm-fastopen#section-6.1">
+same SYN packet with data</link> more than once.
+</note>
+</tag-desc>
+
+<tag-name>
 <literal>backlog</literal>=<value>number</value>
 </tag-name>
 <tag-desc>
--- a/xml/ru/docs/http/ngx_http_core_module.xml
+++ b/xml/ru/docs/http/ngx_http_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_core_module"
         link="/ru/docs/http/ngx_http_core_module.html"
         lang="ru"
-        rev="27">
+        rev="28">
 
 <section id="directives" name="Директивы">
 
@@ -1094,6 +1094,7 @@ location /flv/ {
     [<literal>ssl</literal>]
     [<literal>spdy</literal>]
     [<literal>setfib</literal>=<value>число</value>]
+    [<literal>fastopen</literal>=<value>число</value>]
     [<literal>backlog</literal>=<value>число</value>]
     [<literal>rcvbuf</literal>=<value>размер</value>]
     [<literal>sndbuf</literal>=<value>размер</value>]
@@ -1108,6 +1109,7 @@ location /flv/ {
     [<literal>ssl</literal>]
     [<literal>spdy</literal>]
     [<literal>setfib</literal>=<value>число</value>]
+    [<literal>fastopen</literal>=<value>число</value>]
     [<literal>backlog</literal>=<value>число</value>]
     [<literal>rcvbuf</literal>=<value>размер</value>]
     [<literal>sndbuf</literal>=<value>размер</value>]
@@ -1218,6 +1220,25 @@ SPDY-соединений без SSL.
 </tag-desc>
 
 <tag-name>
+<literal>fastopen</literal>=<value>число</value>
+</tag-name>
+<tag-desc>
+включает
+“<link url="http://en.wikipedia.org/wiki/TCP_Fast_Open">TCP Fast Open</link>”
+для слушающего сокета (1.5.8).
+Параметр <literal>число</literal>
+<link url="http://tools.ietf.org/html/draft-ietf-tcpm-fastopen#section-5.1">ограничивает</link>
+максимальную длину очереди соединений, которые ещё не завершили процесс
+three-way handshake.
+<note>
+Не включайте “TCP Fast Open”, не убедившись, что сервер может адекватно
+обрабатывать многократное получение
+<link url="http://tools.ietf.org/html/draft-ietf-tcpm-fastopen#section-6.1">
+одного и того же SYN-пакета с данными</link>.
+</note>
+</tag-desc>
+
+<tag-name>
 <literal>backlog</literal>=<value>число</value>
 </tag-name>
 <tag-desc>