Enum ProcessRunError 

pub enum ProcessRunError {
    CancelledBeforeSpawn {
        program: PathBuf,
    },
    Spawn {
        program: PathBuf,
        provenance: ExecutableProvenance,
        source: Error,
    },
    MissingPipe {
        program: PathBuf,
        stream: ProcessStream,
    },
    ConfigurePipe {
        program: PathBuf,
        stream: ProcessStream,
        source: Error,
    },
    Poll {
        program: PathBuf,
        source: Error,
    },
    Terminate {
        program: PathBuf,
        source: Error,
    },
    Reap {
        program: PathBuf,
        source: Error,
    },
    Capture {
        program: PathBuf,
        stream: ProcessStream,
        source: Error,
    },
    CleanupDeadline {
        program: PathBuf,
    },
    UnsupportedPlatformGuarantee {
        feature: &'static str,
    },
}

Structured failure while starting, supervising, or capturing a child.

Variants

CancelledBeforeSpawn

Cooperative cancellation was already requested before spawn.

Fields

program: PathBuf

Declared program name/path.

Spawn

The child could not be started.

Fields

program: PathBuf

Declared program name/path.

provenance: ExecutableProvenance

Executable-selection provenance.

source: Error

Operating-system error.

MissingPipe

A configured pipe was unexpectedly unavailable.

Fields

program: PathBuf

Declared program name/path.

stream: ProcessStream

Missing stream.

ConfigurePipe

A capture pipe could not be switched to nonblocking mode.

Fields

program: PathBuf

Declared program name/path.

stream: ProcessStream

Stream that could not be configured.

source: Error

Operating-system error.

Poll

The child status could not be polled.

Fields

program: PathBuf

Declared program name/path.

source: Error

Operating-system error.

Terminate

The child process scope could not be terminated during cleanup.

Fields

program: PathBuf

Declared program name/path.

source: Error

Operating-system error.

Reap

The child could not be reaped.

Fields

program: PathBuf

Declared program name/path.

source: Error

Operating-system error.

Capture

Draining a child stream failed.

Fields

program: PathBuf

Declared program name/path.

stream: ProcessStream

Stream that failed.

source: Error

Operating-system error.

CleanupDeadline

The direct child did not become reapable within the cleanup grace.

Fields

program: PathBuf

Declared program name/path.

UnsupportedPlatformGuarantee

The platform cannot provide the process-tree deadline guarantee.

Fields

feature: &'static str

Guarantee that is unavailable.

Implementations

impl ProcessRunError

pub fn spawn_error_kind(&self) -> Option<ErrorKind>

Return the operating-system error kind when spawning failed.

Trait Implementations

impl Debug for ProcessRunError

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

Formats the value using the given formatter.

impl Display for ProcessRunError

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

Formats the value using the given formatter.

impl Error for ProcessRunError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.