Struct RunCommandRequest 

pub struct RunCommandRequest {
    pub command: Vec<String>,
    pub working_directory: Option<String>,
    pub env: BTreeMap<String, String>,
    pub deadline: Duration,
}

A command to run inside a sandbox.

Fields

command: Vec<String>

Command and arguments

working_directory: Option<String>

Working directory inside the sandbox

env: BTreeMap<String, String>

Environment overlaid on the session’s own

deadline: Duration

How long the command may run. Required — a defaulted deadline is a hang waiting for a slow day.

It bounds the command, not the call, and the call lands just after it. Where the agent supervises the process it kills the process group; where the data plane has no timeout of its own the command runs under timeout inside the session. Either way the session stays usable. Only a session that cannot run timeout is ended instead, and that call returns once the session is gone.

On every backend deadlineExceeded is reported only once the command has verifiably stopped — the agent waits for its kill, and where there is no agent the session kills the command itself and says so. It is never reported on a stop that was merely requested: a deadline that leaves untrusted code running is not a deadline.

What stops is the command and its process group. A descendant that detaches itself into a session of its own is beyond any signal sent from inside, on every backend; it is bounded by the sandbox session, which ends on terminate or at its own lifetime ceiling.

Trait Implementations

impl Clone for RunCommandRequest

fn clone(&self) -> RunCommandRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunCommandRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RunCommandRequest

fn deserialize<__D>( __deserializer: __D, ) -> Result<RunCommandRequest, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for RunCommandRequest

impl PartialEq for RunCommandRequest

fn eq(&self, other: &RunCommandRequest) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for RunCommandRequest

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RunCommandRequest