Struct LaunchOptions 

pub struct LaunchOptions {
    pub bootstrap_payload: String,
    pub process_name: String,
    pub command: BootstrapCommand,
    pub want_stdio: bool,
    pub tail_lines: usize,
    pub log_channel: Option<ChannelAddr>,
    pub proc_bind: Option<ProcBind>,
}

Per-launch policy computed by the manager and handed to the launcher.

Motivation: different launch backends (native OS process, docker, python/actor protocol) need different mechanics, but they should all receive the same intent from the manager:

• do we need a stdio stream we can forward / tail?
• if so, how many tail lines should be retained for diagnostics?
• if forwarding over the mesh is enabled, what channel address should be used (if applicable)?

Fields

bootstrap_payload: String

Serialized Bootstrap payload for HYPERACTOR_MESH_BOOTSTRAP_MODE env var.

process_name: String

Human-readable process name for HYPERACTOR_PROCESS_NAME env var.

command: BootstrapCommand

The bootstrap command describing what should be executed for a proc.

This is the payload of what to run; the launcher decides how to run it:

• Native launcher: execs it directly (spawns the command).
• systemd/container/VM/actor launchers: may treat it as the command to run inside the launched environment.

Used by backends to construct the actual invocation.

want_stdio: bool

If true, the manager wants access to a stream (pipes or an equivalent).

Native: pipe stdout/stderr (Stdio::piped()), return StdioHandling::Captured. Docker/Python: may implement as log streaming, RPC, etc., or ignore and return StdioHandling::ManagedByLauncher / Inherited depending on capability.

tail_lines: usize

Max number of stderr (and/or stdout) lines retained for diagnostics/tailing.

Manager uses this when attaching StreamFwder for native Captured pipes. Backends that manage logs internally may use it to decide how much to retain before reporting stderr_tail in ProcExitResult.

0 means “no tail buffering requested”.

log_channel: Option<ChannelAddr>

Optional “forward logs over mesh” address.

This is provisioned by the manager when log-forwarding is enabled.

• None means “no mesh log forwarding requested”.
• Some(addr) means “arrange for child logs to be forwarded to addr” (if the backend supports it).

Native backend: sets BOOTSTRAP_LOG_CHANNEL=addr in the child env when Some. Other backends may ignore it or use it to wire their own forwarding mechanism.

proc_bind: Option<ProcBind>

Optional CPU/NUMA binding for this proc.

Launchers that support binding should apply it using backend-appropriate mechanisms (e.g., numactl for native, unit properties for systemd). Launchers that do not support it may ignore this field.

Trait Implementations

impl Clone for LaunchOptions

fn clone(&self) -> LaunchOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LaunchOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.