aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2023-10-06 09:11:57 +0200
committerDaniel Stenberg <daniel@haxx.se>2023-10-06 14:47:36 +0200
commit4a80c7503f5a36ad5402407df0771a1783090936 (patch)
treead1b2791646dddab57e64cb6dd48aa08b56baa3a
parent8bc474fa0593bfc6e19bae5220b4021d5db39260 (diff)
downloadcurl-4a80c7503f5a36ad5402407df0771a1783090936.tar.gz
curl_easy_pause.3: mention h2/h3 buffering
Asked-by: Maxim Dzhura Ref: https://curl.se/mail/lib-2023-10/0011.html Closes #12045
-rw-r--r--docs/libcurl/curl_easy_pause.35
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/libcurl/curl_easy_pause.3 b/docs/libcurl/curl_easy_pause.3
index 7d53eac58..f3a879391 100644
--- a/docs/libcurl/curl_easy_pause.3
+++ b/docs/libcurl/curl_easy_pause.3
@@ -106,6 +106,11 @@ effect that if you download something that is compressed a lot, it can result
in a large data amount needing to be allocated to save the data during the
pause. consider not using paused receiving if you allow libcurl to uncompress
data automatically.
+
+If the download is done with HTTP/2 or HTTP/3, there is up to a stream window
+size worth of data that curl cannot stop but instead needs to cache while the
+transfer is paused. This means that if a window size of 64 MB is used, libcurl
+might end up having to cache 64 MB of data.
.SH AVAILABILITY
Added in 7.18.0.
.SH RETURN VALUE