Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_core_module.xml @ 966:95c3c3bbf1ce

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Text review.
author Egor Nikitin <yegor.nikitin@gmail.com>
date Wed, 14 Aug 2013 12:03:41 +0400
parents fd1f8e0a405e
children 6316a7579448
comparison
equal deleted inserted replaced
965:fadccc156188 966:95c3c3bbf1ce
315 <context>server</context> 315 <context>server</context>
316 <context>location</context> 316 <context>location</context>
317 317
318 <para> 318 <para>
319 Defines a timeout for reading client request body. 319 Defines a timeout for reading client request body.
320 The timeout is only set for a period between two successive read operations, 320 The timeout is set only for a period between two successive read operations,
321 not for the transmission of the whole request body. 321 not for the transmission of the whole request body.
322 If a client does not transmit anything within this time, the 322 If a client does not transmit anything within this time, the
323 <http-status code="408" text="Request Time-out"/> 323 <http-status code="408" text="Request Time-out"/>
324 error is returned to the client. 324 error is returned to the client.
325 </para> 325 </para>
409 <context>http</context> 409 <context>http</context>
410 <context>server</context> 410 <context>server</context>
411 <context>location</context> 411 <context>location</context>
412 412
413 <para> 413 <para>
414 Defines the default MIME-type of a response. 414 Defines the default MIME type of a response.
415 Mapping of file name extensions to MIME types can be set 415 Mapping of file name extensions to MIME types can be set
416 with the <link id="types"/> directive. 416 with the <link id="types"/> directive.
417 </para> 417 </para>
418 418
419 </directive> 419 </directive>
655 <syntax block="yes"/> 655 <syntax block="yes"/>
656 <default/> 656 <default/>
657 <context>main</context> 657 <context>main</context>
658 658
659 <para> 659 <para>
660 Provides a configuration file context in which the HTTP server directives 660 Provides the configuration file context in which the HTTP server directives
661 are specified. 661 are specified.
662 </para> 662 </para>
663 663
664 </directive> 664 </directive>
665 665
947 <context>if in location</context> 947 <context>if in location</context>
948 948
949 <para> 949 <para>
950 Limits the rate of response transmission to a client. 950 Limits the rate of response transmission to a client.
951 The <value>rate</value> is specified in bytes per second. 951 The <value>rate</value> is specified in bytes per second.
952 The value 0 disables rate limiting. 952 The zero value disables rate limiting.
953 <!-- 953 <!--
954 The smaller the rate, the more accurate will be the limitation. 954 The smaller the rate, the more accurate will be the limitation.
955 --> 955 -->
956 The limit is set per a request, and so if a client simultaneously opens 956 The limit is set per a request, and so if a client simultaneously opens
957 two connections, the overall rate will be twice as much 957 two connections, the overall rate will be twice as much
1135 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> 1135 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
1136 <default>*:80 | *:8000</default> 1136 <default>*:80 | *:8000</default>
1137 <context>server</context> 1137 <context>server</context>
1138 1138
1139 <para> 1139 <para>
1140 Sets an <value>address</value> and a <value>port</value> for IP, 1140 Sets the <value>address</value> and <value>port</value> for IP,
1141 or a <value>path</value> for a UNIX-domain socket on which 1141 or the <value>path</value> for a UNIX-domain socket on which
1142 the server will accept requests. 1142 the server will accept requests.
1143 Both <value>address</value> and <value>port</value>, 1143 Both <value>address</value> and <value>port</value>,
1144 or only <value>address</value> or only <value>port</value> can be specified. 1144 or only <value>address</value> or only <value>port</value> can be specified.
1145 An <value>address</value> may also be a hostname, for example: 1145 An <value>address</value> may also be a hostname, for example:
1146 <example> 1146 <example>
1283 This is useful because if there are several <literal>listen</literal> 1283 This is useful because if there are several <literal>listen</literal>
1284 directives with the same port but different addresses, and one of the 1284 directives with the same port but different addresses, and one of the
1285 <literal>listen</literal> directives listens on all addresses 1285 <literal>listen</literal> directives listens on all addresses
1286 for the given port (<literal>*:</literal><value>port</value>), nginx 1286 for the given port (<literal>*:</literal><value>port</value>), nginx
1287 will <c-func>bind</c-func> only to <literal>*:</literal><value>port</value>. 1287 will <c-func>bind</c-func> only to <literal>*:</literal><value>port</value>.
1288 It should be noted that in this case the address that accepted the 1288 It should be noted that the <c-func>getsockname</c-func> system call will be
1289 connection is determined by a <c-func>getsockname</c-func> system call. 1289 made in this case to determine the address that accepted the connection.
1290 If the <literal>backlog</literal>, <literal>rcvbuf</literal>, 1290 If the <literal>backlog</literal>, <literal>rcvbuf</literal>,
1291 <literal>sndbuf</literal>, <literal>accept_filter</literal>, 1291 <literal>sndbuf</literal>, <literal>accept_filter</literal>,
1292 <literal>deferred</literal>, or <literal>so_keepalive</literal> parameters 1292 <literal>deferred</literal>, or <literal>so_keepalive</literal> parameters
1293 are used then for a given 1293 are used then for a given
1294 <value>address</value>:<value>port</value> pair 1294 <value>address</value>:<value>port</value> pair
2107 <context>server</context> 2107 <context>server</context>
2108 <context>location</context> 2108 <context>location</context>
2109 2109
2110 <para> 2110 <para>
2111 Sets a timeout for transmitting a response to the client. 2111 Sets a timeout for transmitting a response to the client.
2112 A timeout is only set between two successive write operations, 2112 A timeout is set only between two successive write operations,
2113 not for the transmission of the whole response. 2113 not for the transmission of the whole response.
2114 If a client does not receive anything within this time, 2114 If a client does not receive anything within this time,
2115 a connection is closed. 2115 a connection is closed.
2116 </para> 2116 </para>
2117 2117
2351 <context>http</context> 2351 <context>http</context>
2352 2352
2353 <para> 2353 <para>
2354 Sets the bucket size for the server names hash tables. 2354 Sets the bucket size for the server names hash tables.
2355 The default value depends on the size of the processor’s cache line. 2355 The default value depends on the size of the processor’s cache line.
2356 Details of setting up hash tables are provided in a separate 2356 The details of setting up hash tables are provided in a separate
2357 <link doc="../hash.xml">document</link>. 2357 <link doc="../hash.xml">document</link>.
2358 </para> 2358 </para>
2359 2359
2360 </directive> 2360 </directive>
2361 2361
2365 <default>512</default> 2365 <default>512</default>
2366 <context>http</context> 2366 <context>http</context>
2367 2367
2368 <para> 2368 <para>
2369 Sets the maximum <value>size</value> of the server names hash tables. 2369 Sets the maximum <value>size</value> of the server names hash tables.
2370 Details of setting up hash tables are provided in a separate 2370 The details of setting up hash tables are provided in a separate
2371 <link doc="../hash.xml">document</link>. 2371 <link doc="../hash.xml">document</link>.
2372 </para> 2372 </para>
2373 2373
2374 </directive> 2374 </directive>
2375 2375
2628 <context>location</context> 2628 <context>location</context>
2629 2629
2630 <para> 2630 <para>
2631 Sets the bucket size for the types hash tables. 2631 Sets the bucket size for the types hash tables.
2632 The default value depends on the size of the processor’s cache line. 2632 The default value depends on the size of the processor’s cache line.
2633 Details of setting up hash tables are provided in a separate 2633 The details of setting up hash tables are provided in a separate
2634 <link doc="../hash.xml">document</link>. 2634 <link doc="../hash.xml">document</link>.
2635 </para> 2635 </para>
2636 2636
2637 </directive> 2637 </directive>
2638 2638
2644 <context>server</context> 2644 <context>server</context>
2645 <context>location</context> 2645 <context>location</context>
2646 2646
2647 <para> 2647 <para>
2648 Sets the maximum <value>size</value> of the types hash tables. 2648 Sets the maximum <value>size</value> of the types hash tables.
2649 Details of setting up hash tables are provided in a separate 2649 The details of setting up hash tables are provided in a separate
2650 <link doc="../hash.xml">document</link>. 2650 <link doc="../hash.xml">document</link>.
2651 </para> 2651 </para>
2652 2652
2653 </directive> 2653 </directive>
2654 2654
2682 <default>64</default> 2682 <default>64</default>
2683 <context>http</context> 2683 <context>http</context>
2684 2684
2685 <para> 2685 <para>
2686 Sets the bucket size for the variables hash table. 2686 Sets the bucket size for the variables hash table.
2687 Details of setting up hash tables are provided in a separate 2687 The details of setting up hash tables are provided in a separate
2688 <link doc="../hash.xml">document</link>. 2688 <link doc="../hash.xml">document</link>.
2689 </para> 2689 </para>
2690 2690
2691 </directive> 2691 </directive>
2692 2692
2696 <default>512</default> 2696 <default>512</default>
2697 <context>http</context> 2697 <context>http</context>
2698 2698
2699 <para> 2699 <para>
2700 Sets the maximum <value>size</value> of the variables hash table. 2700 Sets the maximum <value>size</value> of the variables hash table.
2701 Details of setting up hash tables are provided in a separate 2701 The details of setting up hash tables are provided in a separate
2702 <link doc="../hash.xml">document</link>. 2702 <link doc="../hash.xml">document</link>.
2703 </para> 2703 </para>
2704 2704
2705 </directive> 2705 </directive>
2706 2706