]> granicus.if.org Git - apache/commitdiff
event.xml: add a note about lingering close
authorLuca Toscano <elukey@apache.org>
Sun, 7 Jan 2018 14:39:47 +0000 (14:39 +0000)
committerLuca Toscano <elukey@apache.org>
Sun, 7 Jan 2018 14:39:47 +0000 (14:39 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1820466 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/mod/event.xml

index 9e9b7cd28c2e4cd0315d6f5962b662df0a329576..8f39acbc34e7a29c4dc54178615459f19f070e86 100644 (file)
@@ -94,7 +94,9 @@ of the <directive>AsyncRequestWorkerFactor</directive>.</p>
             sockets and they can be re-used to serve other requests.</dd>
 
             <dt>Closing</dt>
-            <dd>Sometimes the MPM needs to perform a lingering close, namely sending back an early error to the client while it is still transmitting data to httpd. Sending the response and then closing the connection immediately is not the correct thing to do since the client (still trying to send the rest of the request) would get a connection reset and could not read the httpd's response. So in such cases, httpd tries to read the rest of the request to allow the client to consume the response. The lingering close is time bounded but it can take relatively long time, so a worker thread can offload this work to the listener.</dd>
+            <dd>Sometimes the MPM needs to perform a lingering close, namely sending back an early error to the client while it is still transmitting data to httpd. Sending the response and then closing the connection immediately is not the correct thing to do since the client (still trying to send the rest of the request) would get a connection reset and could not read the httpd's response. So in such cases, httpd tries to read the rest of the request to allow the client to consume the response. The lingering close is time bounded but it can take relatively long time, so a worker thread can offload this work to the listener. From 2.4.28 onward
+            the listener does not perform the lingering close anymore but it offloads the job to the first worker available.
+            </dd>
         </dl>
 
         <p>These improvements are valid for both HTTP/HTTPS connections.</p>