summaryrefslogtreecommitdiff
path: root/docs/namespace-sites-validation.md
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-10-12 17:23:34 -0300
committerGabriel Schneider <[email protected]>2026-11-17 12:15:16 -0300
commit9dd6f001c7d5eee987cbd305a79d1b1d011b83f5 (patch)
tree2ec5b20565b162b54cdfef9ae5d8fec0e57dfb54 /docs/namespace-sites-validation.md
parent7a07e24916cd5bc762996d81aa1faf550177cd6f (diff)
downloadcloud9-9dd6f001c7d5eee987cbd305a79d1b1d011b83f5.tar.gz
cloud9-9dd6f001c7d5eee987cbd305a79d1b1d011b83f5.zip
9web: backpressure asynchronous replies under parallel site load
Reserve output space for an async completion plus the already-dispatched synchronous handler. Wait on a condition without the catalogue mutex, preserving cancellation and connection-slot lifetime. Abort HTTP streaming on an upstream error instead of hiding a truncated response. Reproduced the former failure with concurrent live cafe assets. Add exact-hash load checks with 16 readers, mixed HEAD and 40 interrupted downloads; validate 80 multi-frame responses over 37 live files. All five live sites, mounted 9P browsing, protocol/catalogue/host/HTTP/mux/UI tests and 32 original E2E scenarios pass. Deploy corrected service on sole [::]:8090. See docs/namespace-sites-validation.md.
Diffstat (limited to 'docs/namespace-sites-validation.md')
-rw-r--r--docs/namespace-sites-validation.md28
1 files changed, 28 insertions, 0 deletions
diff --git a/docs/namespace-sites-validation.md b/docs/namespace-sites-validation.md
index 64858fc..e73a572 100644
--- a/docs/namespace-sites-validation.md
+++ b/docs/namespace-sites-validation.md
@@ -72,3 +72,31 @@ IPv6 site requests return 200. An actual café build requested through
prefixed generation; no preview daemon was started.
`zig build -Doptimize=ReleaseSafe e2e` passes all 32 original gateway scenarios.
+
+## Parallel-read follow-up
+
+A final cold browser run exposed an intermittent load failure despite earlier
+successful runs. Sixteen concurrent large-asset requests reproduced HTTP 502s:
+independent host-read completions could overfill the runner's bounded 9P output
+queue. The synchronous dispatch path already checked output space, but these
+asynchronous completions bypassed it.
+
+`Runner.Conn.replyAsync` now waits on an output-space condition, reserving one
+additional full frame for an already-dispatched synchronous handler. It waits
+without the catalogue mutex, remains cancellable, and is joined before slot
+reuse. HTTP streaming now aborts an upstream read error instead of ending a
+truncated response successfully.
+
+`test/web/parallel_reads.mjs` checks 80 exact multi-frame responses with 16
+simultaneous readers, 40 interrupted downloads and mixed HEAD requests. It is
+part of the mounted-host browser fixture and can also be run read-only against
+the live café:
+
+```
+node test/web/parallel_reads.mjs http://127.0.0.1:8090/sites/cafe/ \
+ /home/goblin/.local/state/9web/public/cafe
+```
+
+The deployed service passes this load test against 37 café source files, followed
+by the complete live browser traversal again. Protocol/unit, catalogue, mounted
+host, HTTP FS, mux, UI and original 32-scenario E2E checks pass after the fix.