Enum Cap 

pub enum Cap {
    Cpu,
    Memory,
    Wall,
}

A resource cap that was breached, killing the sandboxed process. Returned in SandboxOutcome::cap_hit so a cap hit is a typed result, never a hang.

Worth matching on rather than folding into “it failed”: a process killed by a cap has no exit code at all, so a caller reading only exit_code sees None and loses the one fact that says whether to raise a limit or fix the code.

use io_harness::sandbox::{Cap, SandboxOutcome};

fn why(outcome: &SandboxOutcome) -> String {
    match outcome.cap_hit {
        Some(Cap::Wall) => "hung: outlived max_wall_secs".into(),
        Some(Cap::Cpu) => "spun: burned max_cpu_secs of CPU and took SIGXCPU".into(),
        Some(Cap::Memory) => "grew past max_memory_bytes and the RSS monitor killed it".into(),
        // No cap fired, so the exit code is the whole story.
        None => format!("exited {:?}", outcome.exit_code),
    }
}

// A cap is also what goes in the trace, by this stable label.
assert_eq!(Cap::Wall.as_str(), "wall");

Variants

Cpu

CPU time (RLIMIT_CPU on unix; the process took SIGXCPU).

Memory

Resident memory (an RSS monitor killed it).

Wall

Wall-clock time (the run outlived max_wall_secs).

Implementations

impl Cap

pub fn as_str(&self) -> &'static str

A stable label for the trace and error messages.

Trait Implementations

impl Clone for Cap

fn clone(&self) -> Cap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Cap

impl Debug for Cap

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Cap

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Cap

impl PartialEq for Cap

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Cap

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 Cap