Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_core_module.xml @ 869:ade81792bdaa

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented SPDY support. New SPDY module added and the "listen" directive description is updated.
author Homutov Vladimir <vl@nginx.com>
date Wed, 20 Mar 2013 15:00:06 +0400
parents 9dab69f2b71d
children 96839d165b8a
comparison
equal deleted inserted replaced
868:17d0c825f098 869:ade81792bdaa
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="17"> 13 rev="18">
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>
1100 1100
1101 <directive name="listen"> 1101 <directive name="listen">
1102 <syntax> 1102 <syntax>
1103 <value>address</value>[:<value>port</value>] 1103 <value>address</value>[:<value>port</value>]
1104 [<literal>default_server</literal>] 1104 [<literal>default_server</literal>]
1105 [<literal>ssl</literal>]
1106 [<literal>spdy</literal>]
1105 [<literal>setfib</literal>=<value>number</value>] 1107 [<literal>setfib</literal>=<value>number</value>]
1106 [<literal>backlog</literal>=<value>number</value>] 1108 [<literal>backlog</literal>=<value>number</value>]
1107 [<literal>rcvbuf</literal>=<value>size</value>] 1109 [<literal>rcvbuf</literal>=<value>size</value>]
1108 [<literal>sndbuf</literal>=<value>size</value>] 1110 [<literal>sndbuf</literal>=<value>size</value>]
1109 [<literal>accept_filter</literal>=<value>filter</value>] 1111 [<literal>accept_filter</literal>=<value>filter</value>]
1110 [<literal>deferred</literal>] 1112 [<literal>deferred</literal>]
1111 [<literal>bind</literal>] 1113 [<literal>bind</literal>]
1112 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] 1114 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
1113 [<literal>ssl</literal>]
1114 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> 1115 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
1115 <syntax> 1116 <syntax>
1116 <value>port</value> 1117 <value>port</value>
1117 [<literal>default_server</literal>] 1118 [<literal>default_server</literal>]
1119 [<literal>ssl</literal>]
1120 [<literal>spdy</literal>]
1118 [<literal>setfib</literal>=<value>number</value>] 1121 [<literal>setfib</literal>=<value>number</value>]
1119 [<literal>backlog</literal>=<value>number</value>] 1122 [<literal>backlog</literal>=<value>number</value>]
1120 [<literal>rcvbuf</literal>=<value>size</value>] 1123 [<literal>rcvbuf</literal>=<value>size</value>]
1121 [<literal>sndbuf</literal>=<value>size</value>] 1124 [<literal>sndbuf</literal>=<value>size</value>]
1122 [<literal>accept_filter</literal>=<value>filter</value>] 1125 [<literal>accept_filter</literal>=<value>filter</value>]
1123 [<literal>deferred</literal>] 1126 [<literal>deferred</literal>]
1124 [<literal>bind</literal>] 1127 [<literal>bind</literal>]
1125 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] 1128 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
1126 [<literal>ssl</literal>]
1127 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> 1129 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
1128 <syntax> 1130 <syntax>
1129 <literal>unix:</literal><value>path</value> 1131 <literal>unix:</literal><value>path</value>
1130 [<literal>default_server</literal>] 1132 [<literal>default_server</literal>]
1133 [<literal>ssl</literal>]
1134 [<literal>spdy</literal>]
1131 [<literal>backlog</literal>=<value>number</value>] 1135 [<literal>backlog</literal>=<value>number</value>]
1132 [<literal>rcvbuf</literal>=<value>size</value>] 1136 [<literal>rcvbuf</literal>=<value>size</value>]
1133 [<literal>sndbuf</literal>=<value>size</value>] 1137 [<literal>sndbuf</literal>=<value>size</value>]
1134 [<literal>accept_filter</literal>=<value>filter</value>] 1138 [<literal>accept_filter</literal>=<value>filter</value>]
1135 [<literal>deferred</literal>] 1139 [<literal>deferred</literal>]
1136 [<literal>bind</literal>] 1140 [<literal>bind</literal>]
1137 [<literal>ssl</literal>]
1138 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> 1141 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
1139 <default>*:80 | *:8000</default> 1142 <default>*:80 | *:8000</default>
1140 <context>server</context> 1143 <context>server</context>
1141 1144
1142 <para> 1145 <para>
1184 the default server for this pair. 1187 the default server for this pair.
1185 <note> 1188 <note>
1186 In versions prior to 0.8.21 this parameter is named simply 1189 In versions prior to 0.8.21 this parameter is named simply
1187 <literal>default</literal>. 1190 <literal>default</literal>.
1188 </note> 1191 </note>
1192 </para>
1193
1194 <para>
1195 The <literal>ssl</literal> parameter (0.7.14) allows to specify that all
1196 connections accepted on this port should work in SSL mode.
1197 This allows for a more compact <link doc="configuring_https_servers.xml"
1198 id="single_http_https_server">configuration</link> for the server that
1199 handles both HTTP and HTTPS requests.
1200 </para>
1201
1202 <para>
1203 The <literal>spdy</literal> parameter (1.3.15) allows to accept
1204 <link doc="ngx_http_spdy_module.xml">SPDY</link> connections on this port.
1205 Normally, for this to work the <literal>ssl</literal> parameter should be
1206 specified as well, but nginx can also be configured to accept SPDY
1207 connections without SSL.
1189 </para> 1208 </para>
1190 1209
1191 <para> 1210 <para>
1192 A <literal>listen</literal> directive 1211 A <literal>listen</literal> directive
1193 can have several additional parameters specific to socket-related system calls. 1212 can have several additional parameters specific to socket-related system calls.
1296 <note> 1315 <note>
1297 Prior to version 1.3.4, 1316 Prior to version 1.3.4,
1298 if this parameter was omitted then the operating system’s settings were 1317 if this parameter was omitted then the operating system’s settings were
1299 in effect for the socket. 1318 in effect for the socket.
1300 </note> 1319 </note>
1301 </tag-desc>
1302
1303 <tag-name>
1304 <literal>ssl</literal>
1305 </tag-name>
1306 <tag-desc>
1307 this parameter (0.7.14) does not relate to socket-related system calls,
1308 but allows to specify that all connections accepted on this port
1309 should work in SSL mode.
1310 This allows for a more compact <link doc="configuring_https_servers.xml"
1311 id="single_http_https_server">configuration</link> for the server that
1312 handles both HTTP and HTTPS requests.
1313 </tag-desc> 1320 </tag-desc>
1314 1321
1315 <tag-name> 1322 <tag-name>
1316 <literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>] 1323 <literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]
1317 </tag-name> 1324 </tag-name>