Enum Error 

pub enum Error {
    TooShort,
    BadMagic,
    BadVersion(u8),
    BadChecksum,
    BadEntryCount(usize),
    Truncated,
    BadRole(u8),
    PathNotUtf8,
    PathTooLong,
    DataTooLarge,
    BadPath,
    DuplicatePath,
    DuplicateRole(Role),
    UnpairedFirmware,
}

Why a bundle was rejected, reading one or building one.

Most variants can arise either way, because most of what makes a bundle wrong is a property of its entries rather than of its bytes — and one vocabulary for both directions is what keeps a packer from cheerfully building something no device will take. The exceptions are marked.

Variants

TooShort

Fewer bytes than a header and a checksum. Reading only.

BadMagic

The magic did not match the one this application expects. Reading only.

BadVersion(u8)

A format version this build does not read. Carries the version seen. Reading only.

BadChecksum

The trailing CRC-32 did not match the content. Reading only.

BadEntryCount(usize)

No entries at all, or more than Format::max_entries.

Truncated

An entry ran past the end of the bundle, or the entries did not fill it exactly. Reading only.

BadRole(u8)

An entry named a role this build does not know. Carries the byte. Reading only.

PathNotUtf8

An entry’s path was not valid UTF-8. Reading only — a path being built is already a &str.

PathTooLong

A path longer than the 255 bytes its length field can hold. Building only.

DataTooLarge

A file larger than the 4 GiB its size field can hold. Building only.

BadPath

An entry’s path was empty, absolute, or contained ., .., an empty component or a backslash.

DuplicatePath

Two entries wanted the same path.

DuplicateRole(Role)

More than one entry claimed a role that allows only one.

UnpairedFirmware

A start*.elf arrived without its fixup*.dat, or the reverse.

Implementations

impl Error

pub fn http_status(&self) -> u16

The HTTP status to answer this with, for a device that took the bundle over HTTP.

Always 400, and that is the content of the method rather than a placeholder: every rejection in this module is a statement about the bytes that arrived, so none of them is ever the receiver’s fault. An installer whose errors are not all client errors wraps this one and answers for the rest itself.

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

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<E> From<Error> for Error<E>

fn from(error: Error) -> Error<E>

Converts to this type from the input type.

impl PartialEq for Error

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Error