From 4a80c7503f5a36ad5402407df0771a1783090936 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Fri, 6 Oct 2023 09:11:57 +0200 Subject: [PATCH] curl_easy_pause.3: mention h2/h3 buffering Asked-by: Maxim Dzhura Ref: https://curl.se/mail/lib-2023-10/0011.html Closes #12045 --- docs/libcurl/curl_easy_pause.3 | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/libcurl/curl_easy_pause.3 b/docs/libcurl/curl_easy_pause.3 index 7d53eac584..f3a879391e 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