Struct ExecOptions 

pub struct ExecOptions {
    pub timeout: Option<Duration>,
    pub open_stdin: bool,
    pub pty: bool,
    pub term: String,
    pub cols: u32,
    pub rows: u32,
    pub idempotency_key: String,
    pub retry_timeout: RetryBudget,
    pub cwd: Option<String>,
    pub background: bool,
}

Optional settings for Sailbox::exec and Sailbox::exec_shell. Default runs a plain foreground command (no pty, no stdin, no timeout) and retries transient failures against a waking or migrating sailbox for 30 seconds (see retry_timeout).

Fields

timeout: Option<Duration>

Wall-clock limit before the server kills the command; None means no limit. The wire is whole seconds, so a set sub-second timeout rounds up to 1 second (it never collapses to the no-limit 0).

open_stdin: bool

Leave the command’s stdin open for ExecProcess::write_stdin.

pty: bool

Allocate a pseudo-terminal for the command.

term: String

TERM value for the pty (e.g. xterm-256color); ignored without pty.

cols: u32

Initial pty width in columns; ignored without pty.

rows: u32

Initial pty height in rows; ignored without pty.

idempotency_key: String

Stable key that dedupes the launch so a reconnect reattaches to the same command. Empty mints a fresh one per call.

retry_timeout: RetryBudget

Budget for retrying transient RPC failures against a waking or migrating sailbox: both while opening the stream and when ExecProcess::wait falls back to WaitSailboxExec, which reattaches to the guest for the result.

cwd: Option<String>

Working directory to run a shell command in. Only valid with Sailbox::exec_shell.

background: bool

Detach a shell command so it keeps running and the call returns immediately; output is discarded. Only valid with Sailbox::exec_shell, and incompatible with open_stdin and pty.

Trait Implementations

impl Clone for ExecOptions

fn clone(&self) -> ExecOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExecOptions

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

Formats the value using the given formatter.

impl Default for ExecOptions

fn default() -> ExecOptions

Returns the “default value” for a type.