Enum Error 

pub enum Error {
    Io(Error),
    OutOfBounds {
        offset: u64,
        len: u64,
        size: u64,
    },
    InvalidImage(String),
    Unsupported(String),
    InvalidArgument(String),
    Streaming {
        kind: &'static str,
        op: &'static str,
    },
    Immutable {
        kind: &'static str,
        op: &'static str,
    },
}

Crate-wide error type.

Variants

Io(Error)

Underlying I/O failure (file backend, host file source, etc.).

OutOfBounds

A block-device operation referenced a byte range that lies (partly or wholly) outside the device’s logical extent. Includes slice violations.

Fields

offset: u64

len: u64

size: u64

InvalidImage(String)

On-disk structure failed validation (bad magic, bad checksum, etc.).

Unsupported(String)

The requested feature exists in the format but is not implemented in this build of fstool. Used for clean “FAT32 not in v1” type messages.

InvalidArgument(String)

A user-supplied value was malformed or contradictory (bad spec, etc.).

Streaming

The operation tried to modify a streaming filesystem — one whose writer can’t seek backward once bytes have been emitted. Tar today; any future stream-of-records format that lands in fstool. Distinct from Error::Immutable so callers can tell “the writer fundamentally can’t go back” apart from “the on-disk layout was never designed for in-place edits.”

Fields

kind: &'static str

The filesystem kind that refused (today: "tar").

op: &'static str

Short verb describing the attempted op ("add", "rm", …). Free-form; not a stable enum.

Immutable

The operation tried to modify a write-once filesystem whose on-disk layout has no in-place mutation hooks (no free-block tracking, no journal). ISO 9660 and SquashFS today. The writer can seek, but re-opening the image as writable isn’t part of the format’s design — modifications go through fstool repack to rebuild the image from scratch.

Fields

kind: &'static str

The filesystem kind that refused (today: "iso9660", "squashfs").

op: &'static str

Short verb describing the attempted op.

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, __formatter: &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<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.