From 1b8e71c16ec2ecaff1b84a8100c1265ef4e84f4f Mon Sep 17 00:00:00 2001 From: Diogo Martins Date: Sat, 14 Nov 2026 20:51:17 +0000 Subject: [PATCH 1/2] docs, tests: the h2 streamed-both text says a handler that stops reading stalls only its own stream's upload, and the early-answer comment gives h2's stop as up to 320 KiB (#618) The docs page's HTTP/2 both-directions-streamed sample said a handler that stops reading holds the shared connection window down for every other stream on the connection. The server now opens its connection receive window to 2^31-1 behind its SETTINGS and tops it up below a quarter, so a handler that stops reading holds only its own stream's window. The page says so, in the words the Playground sample already uses. EarlyAnswerTests gave the h2 stop as 64 KiB, the connection window. Measured at main it is up to 320 KiB: the 256 KiB stream window, plus the 64 KiB the upload's copy buffer has taken and not yet sent. The 512 KiB bar is unchanged. --- docs/index.html | 2 +- tests/Ioxide.Tests.E2E/Protocols/EarlyAnswerTests.cs | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/index.html b/docs/index.html index d9db9393..cbfb6fc0 100644 --- a/docs/index.html +++ b/docs/index.html @@ -5657,7 +5657,7 @@

HTTP/2 · both directions streamed

{ thread.Join(); } -

Both at once, which is the shape a proxy needs: /echo reads a chunk and writes a chunk, so neither the upload nor the download is ever held whole. The two directions are separate parameters - a body reader for the read side, a writer for the write side - because they solve different problems and most servers want exactly one of them. Mirrors ; the difference is HTTP/2's shared connection window, which a handler that stops reading holds down for every other stream on the connection.

+

Both at once, which is the shape a proxy needs: /echo reads a chunk and writes a chunk, so neither the upload nor the download is ever held whole. The two directions are separate parameters - a body reader for the read side, a writer for the write side - because they solve different problems and most servers want exactly one of them. Mirrors . The server keeps its own connection window open, so a handler that stops reading stalls only its own stream's upload.

diff --git a/tests/Ioxide.Tests.E2E/Protocols/EarlyAnswerTests.cs b/tests/Ioxide.Tests.E2E/Protocols/EarlyAnswerTests.cs index 66b904de..17d58397 100644 --- a/tests/Ioxide.Tests.E2E/Protocols/EarlyAnswerTests.cs +++ b/tests/Ioxide.Tests.E2E/Protocols/EarlyAnswerTests.cs @@ -16,7 +16,7 @@ internal static class EarlyAnswerTests // A control's upload, read whole by its handler. private const long ReadUpload = 8L << 20; - // Measured stops are 64 KiB on h2, the connection window, and 192 KiB on h3; these leave room for a slow box. + // Measured stops are up to 320 KiB on h2, the stream window and what the client had buffered, and 192 KiB on h3; these leave room for a slow box. private const long H2Stopped = 512L << 10; private const long H3Stopped = 1L << 20; From 54b048740cbafb5ca1faf6df1696e9b8264e37e0 Mon Sep 17 00:00:00 2001 From: Diogo Martins Date: Sun, 15 Nov 2026 10:33:34 +0000 Subject: [PATCH 2/2] docs: the pane generator carries the h2 streamed-both sentence the page now has, so regenerating the page keeps it (#618) --- scripts/gen-docs-panes.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/scripts/gen-docs-panes.py b/scripts/gen-docs-panes.py index 5baf55c8..8dadd882 100644 --- a/scripts/gen-docs-panes.py +++ b/scripts/gen-docs-panes.py @@ -380,8 +380,8 @@ "write side - because they solve different " "problems and most servers want exactly one of them. Mirrors " "; the difference is HTTP/2's shared connection window, which a handler " - "that stops reading holds down for every other stream on the connection."), + "streamed. The server keeps its own connection window open, so a handler that " + "stops reading stalls only its own stream's upload."), "h2ng": ( "Http2/Nghttp2Buffered", "HTTP/2 · nghttp2", "ioxide + ioxide.nghttp2", ["curl --http2-prior-knowledge http://127.0.0.1:8080/"],