Enum TerminationError 

#[non_exhaustive]
pub enum TerminationError {
    SignalFailed {
        process_name: Cow<'static, str>,
        attempt_errors: Vec<TerminationAttemptError>,
    },
    TerminationFailed {
        process_name: Cow<'static, str>,
        attempt_errors: Vec<TerminationAttemptError>,
    },
}

Errors that can occur when terminating a process.

Brief grace window after a failed signal send

During each graceful phase of crate::ProcessHandle::terminate, if the signal send itself fails (EPERM on macOS, ESRCH on Linux against a not-yet-reaped process group on Unix; the equivalent ERROR_INVALID_HANDLE / ERROR_ACCESS_DENIED window on Windows), the library applies a fixed 100 ms grace and re-checks for child exit before escalating. This covers the small race where the child has already exited but Tokio’s SIGCHLD reaper has not yet observed it. The 100 ms grace replaces, never adds to, the user timeout for that phase. Real permission denials and other genuine signal failures still surface here as SignalFailed or TerminationFailed with the underlying io::Error preserved on each TerminationAttemptError.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

SignalFailed

Failed to manually send a graceful signal to the process.

Fields

process_name: Cow<'static, str>

The name of the process.

attempt_errors: Vec<TerminationAttemptError>

Errors recorded while attempting to send the signal, in chronological order.

TerminationFailed

Failed to terminate the process after trying all platform termination signals.

Fields

process_name: Cow<'static, str>

The name of the process.

attempt_errors: Vec<TerminationAttemptError>

Errors recorded while attempting process termination, in chronological order.

Implementations

impl TerminationError

pub fn process_name(&self) -> &str

The name of the process involved in the termination error.

pub fn attempt_errors(&self) -> &[TerminationAttemptError]

Errors recorded while attempting the operation, in chronological order.

Trait Implementations

impl Debug for TerminationError

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

Formats the value using the given formatter.

impl Display for TerminationError

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

Formats the value using the given formatter.

impl Error for TerminationError

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.