Enum Error

#[non_exhaustive]
pub enum Error {
    InterfaceNotFound,
    Address(String),
    InputOutput(Arc<Error>),
    InvalidField,
    ExcessData,
    Variant(Error),
    Names(Error),
    IncorrectEndian,
    Handshake(String),
    InvalidReply,
    MethodError(OwnedErrorName, Option<String>, Message),
    MissingField,
    InvalidGUID,
    Unsupported,
    FDO(Box<Error>),
    NameTaken,
    InvalidMatchRule,
    Failure(String),
    MissingParameter(&'static str),
    InvalidSerial,
    InterfaceExists(InterfaceName<'static>, ObjectPath<'static>),
}

The error type for zbus.

The various errors that can be reported by this crate.

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.

InterfaceNotFound

Interface not found.

Address(String)

Invalid D-Bus address.

InputOutput(Arc<Error>)

An I/O error.

InvalidField

Invalid message field.

ExcessData

Data too large.

Variant(Error)

A zvariant error.

Names(Error)

A zbus_names error.

IncorrectEndian

Endian signature invalid or doesn’t match expectation.

Handshake(String)

Initial handshake error.

InvalidReply

Unexpected or incorrect reply.

MethodError(OwnedErrorName, Option<String>, Message)

A D-Bus method error reply.

MissingField

A required field is missing in the message headers.

InvalidGUID

Invalid D-Bus GUID.

Unsupported

Unsupported function, or support currently lacking.

FDO(Box<Error>)

A fdo::Error transformed into Error.

NameTaken

The requested name was already claimed by another peer.

InvalidMatchRule

Invalid match rule string.

Failure(String)

Generic error.

MissingParameter(&'static str)

A required parameter was missing.

InvalidSerial

Serial number in the message header is 0 (which is invalid).

InterfaceExists(InterfaceName<'static>, ObjectPath<'static>)

The given interface already exists at the given path.

Implementations

impl Error

pub fn description(&self) -> Option<&str>

A description of the error.

This is a generic description of the error (if any). For a more detailed description make use of the std::fmt::Display implementation, for example, through std::string::ToString.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

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 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<Errno> for Error

fn from(val: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(val: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(val: VariantError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(val: NamesError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(val: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(value: Error) -> Error

Converts to this type from the input type.

impl From<FromHexError> for Error

fn from(e: FromHexError) -> Self

Converts to this type from the input type.

impl From<Infallible> for Error

fn from(i: Infallible) -> Self

Converts to this type from the input type.

impl From<Message> for Error

fn from(message: Message) -> Error

Converts to this type from the input type.

impl PartialEq for Error

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.