Struct BeeSupervisor 

pub struct BeeSupervisor { /* private fields */ }

Owns a child Bee process and the file its stdio is captured to.

Implementations

impl BeeSupervisor

pub fn spawn(bin: &Path, config: &Path, log_cfg: BeeLogsConfig) -> Result<Self>

Spawn bin start --config <config> as a child process. Stdout and stderr are piped through a rotating writer (governed by log_cfg) so a long-running node can’t fill $TMPDIR. The child runs in its own process group so we can SIGTERM the whole tree at quit without leaking helpers.

Errors:

• bin doesn’t exist or isn’t executable
• the log file can’t be created
• the OS rejects the spawn (rare; usually fork resource limits)

pub fn log_path(&self) -> &Path

Path to the captured log file. Lives in $TMPDIR; survives the supervisor’s lifetime so a post-mortem operator can still read it after bee-tui exits.

pub fn pid(&self) -> Option<u32>

Process id of the child, if the OS reported one.

pub fn uptime(&self) -> Duration

Wall-clock time since [spawn] returned.

pub fn status(&mut self) -> BeeStatus

Non-blocking check of the child’s exit state. Cheap to call every Tick — the OS keeps a status word for terminated children that try_wait reads without blocking.

pub async fn wait_for_api( &mut self, base_url: &str, timeout: Duration, ) -> Result<()>

Poll the Bee node at base_url until /health returns successfully, the child exits, or the timeout elapses. Returns Ok(()) only on a successful health response. Reuses bee::Client::ping so the readiness probe goes through the exact same code path the cockpit uses afterwards.

pub async fn shutdown(self, grace: Duration) -> BeeStatus

Graceful shutdown: SIGTERM the pgroup, wait up to grace for clean exit, escalate to SIGKILL. Returns the resulting status. Idempotent — calling on an already-exited child is a no-op past the SIGTERM (which the kernel rejects with ESRCH).

pub async fn shutdown_default(self) -> BeeStatus

Convenience for shutdown with the default grace period.

Trait Implementations

impl Drop for BeeSupervisor

fn drop(&mut self)

Executes the destructor for this type.