From: Christopher Faulet <cfaulet@haproxy.com>
Date: Mon, 2 Nov 2026 20:24:31 +0000 (+0100)
Subject: DOC: configuration: Clarify wait-for-body doc for the response side
X-Git-Tag: v3.5-dev11~79
X-Git-Url: https://git.kaiwu.me/?a=commitdiff_plain;h=3359100f568e82ce3ef380b1a04859fd0742c2cd;p=haproxy.git

DOC: configuration: Clarify wait-for-body doc for the response side

The documentation was too request-oriented and did not mention the 504
"Gateway Timeout" error returned to the client when the timeout occurs while
waiting for a response body. It is now side-neutral and explicitly mentions
the 408 and the 504 errors returned on timeout, depending on the side.
---

diff --git a/doc/configuration.txt b/doc/configuration.txt
index 9cc9f174b..bf3a95e48 100644
--- a/doc/configuration.txt
+++ b/doc/configuration.txt
@@ -17871,15 +17871,17 @@ wait-for-body time <time> [ at-least <bytes> ] [use-large-buffer]
 
   This will delay the processing of the request or response until one of the
   following conditions occurs:
-  - The full request body is received, in which case processing proceeds
+  - The full message body is received, in which case processing proceeds
     normally.
   - <bytes> bytes have been received, when the "at-least" argument is given and
     <bytes> is non-zero, in which case processing proceeds normally.
-  - The request buffer is full, in which case processing proceeds normally. The
-    size of this buffer is determined by the "tune.bufsize" option.
-  - The request has been waiting for more than <time> milliseconds. In this
-    case HAProxy will respond with a 408 "Request Timeout" error to the client
-    and stop processing the request. Note that if any of the other conditions
+  - The buffer is full, in which case processing proceeds normally. The size
+    of this buffer is determined by the "tune.bufsize" option.
+  - The message has been waiting for more than <time> milliseconds. In this
+    case HAProxy stops the processing and responds to the client with a 408
+    "Request Timeout" error if the timeout occurred while waiting for a
+    request body, or with a 504 "Gateway Timeout" error if it occurred while
+    waiting for a response body. Note that if any of the other conditions
     happens first, this timeout will not occur even if the full body has
     not yet been received.