Enum glommio::GlommioError

pub enum GlommioError<T> {
    IoError(Error),
    EnhancedIoError {
        source: Error,
        op: &'static str,
        path: Option<PathBuf>,
        fd: Option<RawFd>,
    },
    ExecutorError(ExecutorErrorKind),
    BuilderError(BuilderErrorKind),
    Closed(ResourceType<T>),
    CanNotBeClosed(ResourceType<T>, &'static str),
    WouldBlock(ResourceType<T>),
    ReactorError(ReactorErrorKind),
    TimedOut(Duration),
}

Composite error type to encompass all error types glommio produces.

Single error type that will be produced by any public Glommio API functions. Contains a generic type that is only used for the Channel variants. In other cases it can just be replaced with the unit type () and ignored. The variants are broken up into a few common categories such as Closed and WouldBlock as well as a generic IoError and errors dedicated to the executor and reactor.

Examples

use glommio::{GlommioError, ResourceType};

fn will_error() -> Result<(), GlommioError<()>> {
    Err(GlommioError::WouldBlock(ResourceType::File(
        "Error reading a file".to_string(),
    )))?
}
assert!(will_error().is_err());

Variants

IoError(Error)

IO error from standard library functions or libraries that produce std::io::Error’s.

EnhancedIoError

Fields

source: Error

The source error from std::io::Error.

op: &'static str

The operation that was being attempted.

path: Option<PathBuf>

The path of the file, if relevant.

fd: Option<RawFd>

The numeric file descriptor of the relevant resource.

Enhanced IO error that gives more information in the error message than the basic IoError. It includes the operation, path and file descriptor. It also contains the error from the source IO error from std::io::*.

ExecutorError(ExecutorErrorKind)

Executor error variant(s) for signaling certain error conditions inside the executor.

BuilderError(BuilderErrorKind)

Error variant(s) produced when building executors.

Closed(ResourceType<T>)

The resource in question is closed. Generic because the channel variant needs to return the actual item sent into the channel.

CanNotBeClosed(ResourceType<T>, &'static str)

The resource can not be closed because certain conditions are not satisfied

WouldBlock(ResourceType<T>)

Error encapsulating the WouldBlock error for types that don’t have errors originating in the standard library. Glommio also has nonblocking types that need to indicate if they are blocking or not. This type allows for signaling when a function would otherwise block for a specific ResourceType.

ReactorError(ReactorErrorKind)

Reactor error variants. This includes errors specific to the operation of the io-uring instances or related.

TimedOut(Duration)

Timeout variant used for reporting timed out operations

Implementations

impl<T> GlommioError<T>

pub fn raw_os_error(&self) -> Option<i32>

Returns the OS error that this error represents (if any).

If this Error was constructed from an io::Error which encapsulates a raw OS error, then this function will return Some, otherwise it will return None.

Trait Implementations

impl<T> Display for GlommioError<T>

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

Formats the value using the given formatter.

impl<T> Error for GlommioError<T>

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

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<T> From<(Error, ResourceType<T>)> for GlommioError<T>

fn from(tuple: (Error, ResourceType<T>)) -> Self

Converts to this type from the input type.

impl<T> From<Error> for GlommioError<T>

fn from(err: Error) -> Self

Converts to this type from the input type.

impl<T> From<GlommioError<T>> for Error

fn from(err: GlommioError<T>) -> Self

Converts to this type from the input type.