Enum Error 

pub enum Error {
    Empty,
    UnknownArch(String),
    UnknownOs(String),
    UnknownEnv(String),
    Trailing(Vec<String>),
    BadVersion {
        component: &'static str,
        found: String,
    },
    SubArchMismatch {
        arch: Arch,
        sub_arch: SubArch,
    },
    EndianUnsupported {
        arch: Arch,
        endian: Endian,
    },
    EnvMismatch {
        os: Os,
        env: Env,
    },
    AbiMismatch {
        arch: Arch,
        abi: Abi,
    },
    VersionNotAccepted {
        component: &'static str,
    },
}

A tuple that could not be read, or that was read and does not describe a machine.

Every variant names the component it is unhappy about. That is the whole design goal of this type: the model this replaces had a catch-all arm that skipped anything it did not recognize, so x86_64-linux-gnu.2.28 parsed as x86_64-linux-gnu and the version was thrown away with no diagnostic. A user who pins a glibc version and gets the host’s is not going to find out until the binary fails on the target machine.

Variants

Empty

The tuple was empty or all separators.

UnknownArch(String)

The leading component is not an architecture we know.

UnknownOs(String)

The OS component is not an OS we know.

UnknownEnv(String)

The environment component is not an environment we know.

Trailing(Vec<String>)

Components were left over after the environment was read.

This is the case the old catch-all silently ate, so it is an error with the leftovers quoted rather than a shrug.

BadVersion

A version was attached to a component and could not be read as one.

Fields

component: &'static str

The component the version was attached to, for the message.

found: String

What was found where a version was expected.

SubArchMismatch

A sub-architecture was named that does not belong to the architecture.

Fields

arch: Arch

The architecture that was named.

sub_arch: SubArch

The baseline that does not belong to it.

EndianUnsupported

A byte order was named that the architecture does not have.

Fields

arch: Arch

The architecture that was named.

endian: Endian

The byte order it does not have.

EnvMismatch

An environment was named that the OS does not have.

Fields

os: Os

The OS that was named.

env: Env

The environment it does not have.

AbiMismatch

A float ABI was named for an architecture that has one calling convention.

Fields

arch: Arch

The architecture that was named.

abi: Abi

The ABI it cannot select.

VersionNotAccepted

A version was attached to a component that does not take one.

x86_64-linux.5.15-gnu is not a request for a kernel version, it is a mistake, and accepting it would mean the tuple carries a field nothing reads.

Fields

component: &'static str

The component the version was attached to.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

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

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

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Error