AtlatestRepositorysigil-http3
sigil-http3 / tree / docsecho-lifecycle.md
1
# Bounded echo lifecycle3
The Linux supervisor in scripts/echo-lifecycle.mjs validates a configuration4
and starts one foreground server. It binds no sockets itself. Lifetime,5
readiness, log-size and child-identity checks bound cleanup.7
Configuration schema 1 requires testId, expectedHost, binary, binarySha256,8
certificateDirectory, runDirectory, interopReceipt, scope, bindAddress, port,9
lifetimeSeconds, authority and origins. Paths must be absolute; runDirectory10
must be new. expectedHost must match the local hostname. The certificate11
must cover the bind address and the complete run, with a private owned key.12
Use an unprivileged UDP port and a lifetime from 1 through 7200 seconds.14
The test-loopback scope admits 127.0.0.1 or ::1. The vpn scope uses the15
HTTP3_IPV4_ADDRESS environment setting (default 127.0.0.1); ipv6-direct16
requires a numeric global IPv6 address. Authority and origin checks stay exact.18
Run node scripts/echo-lifecycle.mjs plan CONFIG.json for validation,19
run CONFIG.json to start, and stop RUN_DIRECTORY to terminate the recorded20
supervisor. Repeated stop returns the retained result. Child signals check21
PID, start time and UID. Keep signing keys and private observations local.