Struct ResolvedStreams 

#[non_exhaustive]
pub struct ResolvedStreams {
    pub stdin: ResolvedStdio,
    pub stdout: ResolvedStdio,
    pub stderr: ResolvedStdio,
}

Where a built sandbox wires the command’s three standard streams.

What a build produces depends on what the command sees, and these are that: isatty on the standard streams steers debconf’s frontend choice, a compiler’s color diagnostics, and every progress display, and the standard-input disposition additionally decides whether the command runs in the caller’s session.

What this reports

The plan — what every launch of the sandbox shares. A launch that attaches a conduit of its own supersedes it at that one call site, in two ways:

• a capturing launch (Cage::run_with, Cage::output) puts a pipe on the output pair;
• a terminal launch (Cage::spawn_terminal, Cage::spawn_pending_terminal) wires a pseudoterminal replica onto all three, because a terminal is one stream rather than three.

That act belongs to the caller that made it, and recording it does too. The dispositions here are refused against a launch that would contradict them, so a record and a launch cannot disagree about a stream the caller directed somewhere. Inherit states no destination and so contradicts nothing: a record reading Inherit on all three is what a cage launched with a terminal reports, and it is a true statement about the plan rather than about what that launch’s command saw.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

stdin: ResolvedStdio

Where the command’s standard input reads from.

stdout: ResolvedStdio

Where the command’s standard output is written.

stderr: ResolvedStdio

Where the command’s standard error is written.

Trait Implementations

impl Clone for ResolvedStreams

fn clone(&self) -> ResolvedStreams

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ResolvedStreams

impl Debug for ResolvedStreams

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

Formats the value using the given formatter.

impl Eq for ResolvedStreams

impl PartialEq for ResolvedStreams

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ResolvedStreams

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ResolvedStreams