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

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="Модуль 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="17"> 13 rev="18">
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>
1086 1086
1087 <directive name="listen"> 1087 <directive name="listen">
1088 <syntax> 1088 <syntax>
1089 <value>адрес</value>[:<value>порт</value>] 1089 <value>адрес</value>[:<value>порт</value>]
1090 [<literal>default_server</literal>] 1090 [<literal>default_server</literal>]
1091 [<literal>ssl</literal>]
1092 [<literal>spdy</literal>]
1091 [<literal>setfib</literal>=<value>число</value>] 1093 [<literal>setfib</literal>=<value>число</value>]
1092 [<literal>backlog</literal>=<value>число</value>] 1094 [<literal>backlog</literal>=<value>число</value>]
1093 [<literal>rcvbuf</literal>=<value>размер</value>] 1095 [<literal>rcvbuf</literal>=<value>размер</value>]
1094 [<literal>sndbuf</literal>=<value>размер</value>] 1096 [<literal>sndbuf</literal>=<value>размер</value>]
1095 [<literal>accept_filter</literal>=<value>фильтр</value>] 1097 [<literal>accept_filter</literal>=<value>фильтр</value>]
1096 [<literal>deferred</literal>] 1098 [<literal>deferred</literal>]
1097 [<literal>bind</literal>] 1099 [<literal>bind</literal>]
1098 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] 1100 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
1099 [<literal>ssl</literal>]
1100 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> 1101 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
1101 <syntax> 1102 <syntax>
1102 <value>порт</value> 1103 <value>порт</value>
1103 [<literal>default_server</literal>] 1104 [<literal>default_server</literal>]
1105 [<literal>ssl</literal>]
1106 [<literal>spdy</literal>]
1104 [<literal>setfib</literal>=<value>число</value>] 1107 [<literal>setfib</literal>=<value>число</value>]
1105 [<literal>backlog</literal>=<value>число</value>] 1108 [<literal>backlog</literal>=<value>число</value>]
1106 [<literal>rcvbuf</literal>=<value>размер</value>] 1109 [<literal>rcvbuf</literal>=<value>размер</value>]
1107 [<literal>sndbuf</literal>=<value>размер</value>] 1110 [<literal>sndbuf</literal>=<value>размер</value>]
1108 [<literal>accept_filter</literal>=<value>фильтр</value>] 1111 [<literal>accept_filter</literal>=<value>фильтр</value>]
1109 [<literal>deferred</literal>] 1112 [<literal>deferred</literal>]
1110 [<literal>bind</literal>] 1113 [<literal>bind</literal>]
1111 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] 1114 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
1112 [<literal>ssl</literal>]
1113 [<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>
1114 <syntax> 1116 <syntax>
1115 <literal>unix:</literal><value>путь</value> 1117 <literal>unix:</literal><value>путь</value>
1116 [<literal>default_server</literal>] 1118 [<literal>default_server</literal>]
1119 [<literal>ssl</literal>]
1120 [<literal>spdy</literal>]
1117 [<literal>backlog</literal>=<value>число</value>] 1121 [<literal>backlog</literal>=<value>число</value>]
1118 [<literal>rcvbuf</literal>=<value>размер</value>] 1122 [<literal>rcvbuf</literal>=<value>размер</value>]
1119 [<literal>sndbuf</literal>=<value>размер</value>] 1123 [<literal>sndbuf</literal>=<value>размер</value>]
1120 [<literal>accept_filter</literal>=<value>фильтр</value>] 1124 [<literal>accept_filter</literal>=<value>фильтр</value>]
1121 [<literal>deferred</literal>] 1125 [<literal>deferred</literal>]
1122 [<literal>bind</literal>] 1126 [<literal>bind</literal>]
1123 [<literal>ssl</literal>]
1124 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> 1127 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
1125 <default>*:80 | *:8000</default> 1128 <default>*:80 | *:8000</default>
1126 <context>server</context> 1129 <context>server</context>
1127 1130
1128 <para> 1131 <para>
1169 <value>адрес</value>:<value>порт</value>. 1172 <value>адрес</value>:<value>порт</value>.
1170 <note> 1173 <note>
1171 До версии 0.8.21 этот параметр назывался просто 1174 До версии 0.8.21 этот параметр назывался просто
1172 <literal>default</literal>. 1175 <literal>default</literal>.
1173 </note> 1176 </note>
1177 </para>
1178
1179 <para>
1180 Параметр <literal>ssl</literal>(0.7.14) позволяет указать, что все соединения,
1181 принимаемые на этом порту, должны работать в режиме SSL.
1182 Это позволяет задать компактную <link doc="configuring_https_servers.xml"
1183 id="single_http_https_server">конфигурацию</link> для сервера,
1184 работающего сразу в двух режимах — HTTP и HTTPS.
1185 </para>
1186
1187 <para>
1188 Параметр <literal>spdy</literal> (1.3.15) позволяет принимать на этом порту
1189 <link doc="ngx_http_spdy_module.xml">SPDY</link>-соединения.
1190 Обычно, чтобы это работало, следует также указать параметр
1191 <literal>ssl</literal>, однако nginx можно также настроить и на приём
1192 SPDY-соединений без SSL.
1174 </para> 1193 </para>
1175 1194
1176 <para> 1195 <para>
1177 В директиве <literal>listen</literal> можно также указать несколько 1196 В директиве <literal>listen</literal> можно также указать несколько
1178 дополнительных параметров, специфичных для связанных с сокетами 1197 дополнительных параметров, специфичных для связанных с сокетами
1280 <note> 1299 <note>
1281 До версии 1.3.4, 1300 До версии 1.3.4,
1282 если этот параметр не был задан явно, то для сокета действовали 1301 если этот параметр не был задан явно, то для сокета действовали
1283 настройки операционной системы. 1302 настройки операционной системы.
1284 </note> 1303 </note>
1285 </tag-desc>
1286
1287 <tag-name>
1288 <literal>ssl</literal>
1289 </tag-name>
1290 <tag-desc>
1291 этот параметр (0.7.14) не имеет отношения к связанным с сокетами системным
1292 вызовам, а позволяет указать, что все соединения, принимаемые на этом порту,
1293 должны работать в режиме SSL.
1294 Это позволяет задать компактную <link doc="configuring_https_servers.xml"
1295 id="single_http_https_server">конфигурацию</link> для сервера,
1296 работающего сразу в двух режимах — HTTP и HTTPS.
1297 </tag-desc> 1304 </tag-desc>
1298 1305
1299 <tag-name> 1306 <tag-name>
1300 <literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>] 1307 <literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]
1301 </tag-name> 1308 </tag-name>