Module bootstrap

Structs

BootstrapCommand

A specification of the command used to bootstrap 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_TAIL_LOG_LINES

Maximum number of log lines retained in a proc’s stderr/stdout tail buffer. Used by [LogTailer::tee] 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.