comparison xml/en/docs/stream/ngx_stream_core_module.xml @ 2725:6d082b470918

Documented "listen fastopen=" parameter in stream.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 25 May 2021 12:53:00 +0100
parents 00afc7c4d4df
children 4add6ae1296f
comparison
equal deleted inserted replaced
2724:00afc7c4d4df 2725:6d082b470918
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8 8
9 <module name="Module ngx_stream_core_module" 9 <module name="Module ngx_stream_core_module"
10 link="/en/docs/stream/ngx_stream_core_module.html" 10 link="/en/docs/stream/ngx_stream_core_module.html"
11 lang="en" 11 lang="en"
12 rev="33"> 12 rev="34">
13 13
14 <section id="summary"> 14 <section id="summary">
15 15
16 <para> 16 <para>
17 The <literal>ngx_stream_core_module</literal> module 17 The <literal>ngx_stream_core_module</literal> module
80 <syntax> 80 <syntax>
81 <value>address</value>:<value>port</value> 81 <value>address</value>:<value>port</value>
82 [<literal>ssl</literal>] 82 [<literal>ssl</literal>]
83 [<literal>udp</literal>] 83 [<literal>udp</literal>]
84 [<literal>proxy_protocol</literal>] 84 [<literal>proxy_protocol</literal>]
85 [<literal>fastopen</literal>=<value>number</value>]
85 [<literal>backlog</literal>=<value>number</value>] 86 [<literal>backlog</literal>=<value>number</value>]
86 [<literal>rcvbuf</literal>=<value>size</value>] 87 [<literal>rcvbuf</literal>=<value>size</value>]
87 [<literal>sndbuf</literal>=<value>size</value>] 88 [<literal>sndbuf</literal>=<value>size</value>]
88 [<literal>bind</literal>] 89 [<literal>bind</literal>]
89 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] 90 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
149 150
150 <para> 151 <para>
151 The <literal>listen</literal> directive 152 The <literal>listen</literal> directive
152 can have several additional parameters specific to socket-related system calls. 153 can have several additional parameters specific to socket-related system calls.
153 <list type="tag"> 154 <list type="tag">
155
156 <tag-name>
157 <literal>fastopen</literal>=<value>number</value>
158 </tag-name>
159 <tag-desc>
160 enables
161 “<link url="http://en.wikipedia.org/wiki/TCP_Fast_Open">TCP Fast Open</link>”
162 for the listening socket (1.21.0) and
163 <link url="https://tools.ietf.org/html/rfc7413#section-5.1">limits</link>
164 the maximum length for the queue of connections that have not yet completed
165 the three-way handshake.
166 <note>
167 Do not enable this feature unless the server can handle
168 receiving the
169 <link url="https://tools.ietf.org/html/rfc7413#section-6.1">
170 same SYN packet with data</link> more than once.
171 </note>
172 </tag-desc>
154 173
155 <tag-name> 174 <tag-name>
156 <literal>backlog</literal>=<value>number</value> 175 <literal>backlog</literal>=<value>number</value>
157 </tag-name> 176 </tag-name>
158 <tag-desc> 177 <tag-desc>