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