AtlatestRenderedmarkdown

sigil-http3 / tree / docsecho-lifecycle.md

Read the source

Readme

Bounded echo lifecycle

The Linux supervisor in scripts/echo-lifecycle.mjs validates a configuration and starts one foreground server. It binds no sockets itself. Lifetime, readiness, log-size and child-identity checks bound cleanup.

Configuration schema 1 requires testId, expectedHost, binary, binarySha256, certificateDirectory, runDirectory, interopReceipt, scope, bindAddress, port, lifetimeSeconds, authority and origins. Paths must be absolute; runDirectory must be new. expectedHost must match the local hostname. The certificate must cover the bind address and the complete run, with a private owned key. Use an unprivileged UDP port and a lifetime from 1 through 7200 seconds.

The test-loopback scope admits 127.0.0.1 or ::1. The vpn scope uses the HTTP3_IPV4_ADDRESS environment setting (default 127.0.0.1); ipv6-direct requires a numeric global IPv6 address. Authority and origin checks stay exact.

Run node scripts/echo-lifecycle.mjs plan CONFIG.json for validation, run CONFIG.json to start, and stop RUN_DIRECTORY to terminate the recorded supervisor. Repeated stop returns the retained result. Child signals check PID, start time and UID. Keep signing keys and private observations local.