comparison xml/en/docs/http/ngx_http_core_module.xml @ 235:6d8356490215

Consistently call header fields as such.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 13 Dec 2011 13:06:25 +0000
parents ad26f0ae970f
children 9ba4f5333a56
comparison
equal deleted inserted replaced
234:ad26f0ae970f 235:6d8356490215
543 543
544 <para> 544 <para>
545 Specifies how to compare modification time of a response 545 Specifies how to compare modification time of a response
546 with the time in the 546 with the time in the
547 <header>If-Modified-Since</header> 547 <header>If-Modified-Since</header>
548 request header: 548 request header field:
549 549
550 <list type="tag"> 550 <list type="tag">
551 551
552 <tag-name><value>off</value></tag-name> 552 <tag-name><value>off</value></tag-name>
553 <tag-desc> 553 <tag-desc>
554 the 554 the
555 <header>If-Modified-Since</header> request header is ignored (0.7.34); 555 <header>If-Modified-Since</header> request header field is ignored (0.7.34);
556 </tag-desc> 556 </tag-desc>
557 557
558 <tag-name><value>exact</value></tag-name> 558 <tag-name><value>exact</value></tag-name>
559 <tag-desc> 559 <tag-desc>
560 exact match; 560 exact match;
562 562
563 <tag-name><value>before</value></tag-name> 563 <tag-name><value>before</value></tag-name>
564 <tag-desc> 564 <tag-desc>
565 modification time of a response is 565 modification time of a response is
566 less than or equal to the time in the <header>If-Modified-Since</header> 566 less than or equal to the time in the <header>If-Modified-Since</header>
567 request header. 567 request header field.
568 </tag-desc> 568 </tag-desc>
569 569
570 </list> 570 </list>
571 </para> 571 </para>
572 572
578 <default>on</default> 578 <default>on</default>
579 <context>http</context> 579 <context>http</context>
580 <context>server</context> 580 <context>server</context>
581 581
582 <para> 582 <para>
583 Controls whether headers with invalid names should be ignored. 583 Controls whether header fields with invalid names should be ignored.
584 Valid header names consist of letters, digits, hyphens, and possibly 584 Valid names consist of English letters, digits, hyphens, and possibly
585 underscores (as controlled by the <link id="underscores_in_headers"/> 585 underscores (as controlled by the <link id="underscores_in_headers"/>
586 directive). 586 directive).
587 </para> 587 </para>
588 588
589 </directive> 589 </directive>
690 <para> 690 <para>
691 The first argument sets a timeout during which a keep-alive 691 The first argument sets a timeout during which a keep-alive
692 client connection will stay open on the server side. 692 client connection will stay open on the server side.
693 The optional second argument sets a value in the 693 The optional second argument sets a value in the
694 <header>Keep-Alive: timeout=<argument>time</argument></header> 694 <header>Keep-Alive: timeout=<argument>time</argument></header>
695 response header. 695 response header field.
696 Two arguments may differ. 696 Two arguments may differ.
697 </para> 697 </para>
698 698
699 <para> 699 <para>
700 The 700 The
701 <header>Keep-Alive: timeout=</header> 701 <header>Keep-Alive: timeout=<argument>time</argument></header>
702 is understood by Mozilla and Konqueror. 702 header field is understood by Mozilla and Konqueror.
703 MSIE will close keep-alive connection in about 60 seconds. 703 MSIE will close keep-alive connection in about 60 seconds.
704 </para> 704 </para>
705 705
706 </directive> 706 </directive>
707 707
712 <context>http</context> 712 <context>http</context>
713 <context>server</context> 713 <context>server</context>
714 714
715 <para> 715 <para>
716 Sets the maximum <argument>number</argument> and <argument>size</argument> of 716 Sets the maximum <argument>number</argument> and <argument>size</argument> of
717 buffers used when reading large client request headers. 717 buffers used when reading large client request header.
718 A request line cannot exceed the size of one buffer, or the client error 718 A request line cannot exceed the size of one buffer, or the client error
719 <http-status code="414" text="Request-URI Too Large"/> 719 <http-status code="414" text="Request-URI Too Large"/>
720 is returned. 720 is returned.
721 A request header field cannot exceed the size of one buffer as well, or the 721 A request header field cannot exceed the size of one buffer as well, or the
722 client error 722 client error
2025 server { 2025 server {
2026 server_name www.example.com ""; 2026 server_name www.example.com "";
2027 } 2027 }
2028 </example> 2028 </example>
2029 It allows this server to process requests without the <header>Host</header> 2029 It allows this server to process requests without the <header>Host</header>
2030 header, instead of the default server for the given address:port pair. 2030 header field, instead of the default server for the given address:port pair.
2031 This is the default setting. 2031 This is the default setting.
2032 <note> 2032 <note>
2033 Before 0.8.48, the machine's hostname was used by default. 2033 Before 0.8.48, the machine's hostname was used by default.
2034 </note> 2034 </note>
2035 </para> 2035 </para>