Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_core_module.xml @ 172:5e8e63f73c33
Documented "lingering_close", "lingering_time", and "lingering_timeout".
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Thu, 03 Nov 2011 21:44:34 +0000 |
parents | 6eeaa9e1f3b5 |
children | 6b81a1950ecb |
comparison
equal
deleted
inserted
replaced
171:6eeaa9e1f3b5 | 172:5e8e63f73c33 |
---|---|
815 flv; | 815 flv; |
816 limit_rate_after 500k; | 816 limit_rate_after 500k; |
817 limit_rate 50k; | 817 limit_rate 50k; |
818 } | 818 } |
819 </example> | 819 </example> |
820 </para> | |
821 | |
822 </directive> | |
823 | |
824 | |
825 <directive name="lingering_close"> | |
826 <syntax><value>off</value> | <value>on</value> | <value>always</value></syntax> | |
827 <default>on</default> | |
828 <context>http</context> | |
829 <context>server</context> | |
830 <context>location</context> | |
831 <appeared-in>1.1.0</appeared-in> | |
832 <appeared-in>1.0.6</appeared-in> | |
833 | |
834 <para> | |
835 Controls how nginx closes client connections. | |
836 </para> | |
837 | |
838 <para> | |
839 The default value “<value>on</value>” instructs nginx to | |
840 <link id="lingering_timeout">wait for</link> and | |
841 <link id="lingering_time">process</link> additional data from a client | |
842 before fully closing a connection, but only | |
843 if heuristics suggests that a client may be sending more data. | |
844 </para> | |
845 | |
846 <para> | |
847 The value “<value>always</value>” will cause nginx to unconditionally | |
848 wait for and process additional client data. | |
849 </para> | |
850 | |
851 <para> | |
852 The value “<value>off</value>” tells nginx to never wait for | |
853 more data and close the connection immediately. | |
854 This breaks the protocol and should not be used under normal circumstances. | |
855 </para> | |
856 | |
857 </directive> | |
858 | |
859 | |
860 <directive name="lingering_time"> | |
861 <syntax><argument>time</argument></syntax> | |
862 <default>30s</default> | |
863 <context>http</context> | |
864 <context>server</context> | |
865 <context>location</context> | |
866 | |
867 <para> | |
868 When <link id="lingering_close"/> is in effect, | |
869 this directive specifies a maximum time during which nginx | |
870 will process (read and ignore) additional data coming from a client. | |
871 After that, the connection is closed, even if there are more data. | |
872 </para> | |
873 | |
874 </directive> | |
875 | |
876 | |
877 <directive name="lingering_timeout"> | |
878 <syntax><argument>time</argument></syntax> | |
879 <default>5s</default> | |
880 <context>http</context> | |
881 <context>server</context> | |
882 <context>location</context> | |
883 | |
884 <para> | |
885 When <link id="lingering_close"/> is in effect, this directive specifies | |
886 a maximum waiting time for more client data to arrive. | |
887 If data are not received during this time, the connection is closed. | |
888 Otherwise, data are read and ignored, then nginx waits again for more data. | |
889 The “wait-read-ignore” cycle is repeated, but no longer than specified by the | |
890 <link id="lingering_time"/> directive. | |
820 </para> | 891 </para> |
821 | 892 |
822 </directive> | 893 </directive> |
823 | 894 |
824 | 895 |