Module bootstrap

Source

Structs§

BootstrapCommand
A specification of the command used to bootstrap procs.
BootstrapProcConfig
The configuration used for bootstrapped procs.
BootstrapProcHandle
A handle to a proc launched by BootstrapProcManager.
BootstrapProcManager
A process manager for launching and supervising bootstrap processes (via the bootstrap entry point).

Enums§

Bootstrap
Bootstrap configures how a mesh process starts up.
ProcStatus
Represents the lifecycle state of a proc as hosted in an OS process managed by BootstrapProcManager.
ReadyError
Error returned by BootstrapProcHandle::ready.

Constants§

BOOTSTRAP_ADDR_ENV
BOOTSTRAP_INDEX_ENV
CLIENT_TRACE_ID_ENV

Statics§

MESH_BOOTSTRAP_ENABLE_PDEATHSIG
If enabled (default), bootstrap child processes install PR_SET_PDEATHSIG(SIGKILL) so the kernel reaps them if the parent dies unexpectedly. This is a production safety net against leaked children; tests usually disable it via std::env::set_var("HYPERACTOR_MESH_BOOTSTRAP_ENABLE_PDEATHSIG", "false").
MESH_ENABLE_FILE_CAPTURE
When true: if stdio is piped, each child’s StreamFwder also forwards lines to a host-scoped FileAppender managed by the BootstrapProcManager. That appender creates exactly two files per manager instance—one for stdout and one for stderr—and all child processes’ lines are multiplexed into those two files. This can be combined with MESH_ENABLE_LOG_FORWARDING (“stream+local”).
MESH_ENABLE_LOG_FORWARDING
Enable forwarding child stdout/stderr over the mesh log channel.
MESH_TAIL_LOG_LINES
Maximum number of log lines retained in a proc’s stderr/stdout tail buffer. Used by StreamFwder when wiring child pipes. Default: 100
MESH_TERMINATE_CONCURRENCY
Maximum number of child terminations to run concurrently during bulk shutdown. Prevents unbounded spawning of termination tasks (which could otherwise spike CPU, I/O, or file descriptor load).
MESH_TERMINATE_TIMEOUT
Per-child grace window for termination. When a shutdown is requested, the manager sends SIGTERM and waits this long for the child to exit before escalating to SIGKILL.

Functions§

bootstrap
Entry point to processes managed by hyperactor_mesh. Any process that is part of a hyperactor_mesh program should call bootstrap, which then configures the process according to how it is invoked.
bootstrap_or_die
A variant of bootstrap that logs the error and exits the process if bootstrapping fails.
install_pdeathsig_kill
Install “kill me if parent dies” and close the race window.