Enum posix_mq::error::Error

pub enum Error {
    InvalidQueueName(&'static str),
    ValueReadingError(Error),
    MessageSizeExceeded(),
    MaximumMessageSizeExceeded(),
    MaximumMessageCountExceeded(),
    PermissionDenied(),
    InvalidQueueDescriptor(),
    QueueCallInterrupted(),
    QueueAlreadyExists(),
    QueueNotFound(),
    InsufficientMemory(),
    InsufficientSpace(),
    ProcessFileDescriptorLimitReached(),
    SystemFileDescriptorLimitReached(),
    UnknownForeignError(Errno),
    UnknownInternalError(Option<Error>),
}

This module implements a simple error type to match the errors that can be thrown from the C functions as well as some extra errors resulting from internal validations.

As this crate exposes an opinionated API to the POSIX queues certain errors have been ignored:

• ETIMEDOUT: The low-level timed functions are not exported and this error can not occur.
• EAGAIN: Non-blocking queue calls are not supported.
• EINVAL: Same reason as ETIMEDOUT
• EMSGSIZE: The message size is immutable after queue creation and this crate checks it.
• ENAMETOOLONG: This crate performs name validation

If an unexpected error is encountered it will be wrapped appropriately and should be reported as a bug on https://github.com/aprilabank/posix_mq.rs

Variants

InvalidQueueName(&'static str)

ValueReadingError(Error)

MessageSizeExceeded()

MaximumMessageSizeExceeded()

MaximumMessageCountExceeded()

PermissionDenied()

InvalidQueueDescriptor()

QueueCallInterrupted()

QueueAlreadyExists()

QueueNotFound()

InsufficientMemory()

InsufficientSpace()

ProcessFileDescriptorLimitReached()

SystemFileDescriptorLimitReached()

UnknownForeignError(Errno)

UnknownInternalError(Option<Error>)

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn description(&self) -> &str

Deprecated since 1.41.0:

use the Display impl or to_string()

if let Err(e) = "xc".parse::<u32>() { // Print e itself, no need for description(). eprintln!("Error: {}", e); }

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

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

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

Returns a stack backtrace, if available, of where this error occurred.

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

Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<Error> for Error

This from implementation is used to translate errors from the lower-level C-calls into sensible Rust errors.

fn from(e: Error) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(e: Error) -> Self

Performs the conversion.

impl From<ParseIntError> for Error

fn from(_: ParseIntError) -> Self

Performs the conversion.