Enum PidlockError 

#[non_exhaustive]
pub enum PidlockError {
    LockExists,
    InvalidState,
    IOError(Error),
    InvalidPath(InvalidPathError),
}

Errors that may occur during the Pidlock lifetime.

This enum covers all possible error conditions that can occur when working with pidlocks, from path validation to I/O errors during lock operations.

Examples

use pidlock::{Pidlock, PidlockError};

let temp_dir = std::env::temp_dir();
let lock_path = temp_dir.join("error_example.pid");
let mut lock = Pidlock::new_validated(&lock_path)?;

match lock.acquire() {
    Ok(()) => {
        println!("Lock acquired successfully");
        lock.release()?;
    }
    Err(PidlockError::LockExists) => {
        println!("Another process is holding the lock");
    }
    Err(PidlockError::InvalidState) => {
        println!("Lock is in wrong state for this operation");
    }
    Err(e) => {
        println!("Other error: {}", e);
    }
}

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.

LockExists

InvalidState

IOError(Error)

InvalidPath(InvalidPathError)

Trait Implementations

impl Debug for PidlockError

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

Formats the value using the given formatter.

impl Display for PidlockError

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

Formats the value using the given formatter.

impl Error for PidlockError

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.

impl From<Error> for PidlockError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<InvalidPathError> for PidlockError

fn from(source: InvalidPathError) -> Self

Converts to this type from the input type.

impl PartialEq for PidlockError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.