Enum CleanFailure 

pub enum CleanFailure {
    Shard {
        path: PathBuf,
        source: FsError,
    },
    Manifest {
        path: PathBuf,
        source: FsError,
    },
    Entry {
        path: PathBuf,
        source: FsError,
    },
    Tmp {
        path: PathBuf,
        source: FsError,
    },
    Restore {
        path: PathBuf,
        source: FsError,
    },
}

One best-effort failure collected during CacheWriter::clean per AUX-028.

A clean run records these and keeps going rather than aborting, so a single un-removable entry or unreadable shard does not strand the rest of the plan. Each variant carries the path it concerns and the originating FsError.

Variants

Shard

A cache shard directory could not be read during planning, so its entries were skipped.

Fields

path: PathBuf

Shard directory that could not be read.

source: FsError

Originating filesystem error.

Manifest

An entry’s manifest could not be read (a real I/O error, not a simply-absent manifest), so the entry was skipped.

Fields

path: PathBuf

Manifest path that could not be read.

source: FsError

Originating filesystem error.

Entry

A planned entry directory could not be removed.

Fields

path: PathBuf

Entry directory that could not be removed.

source: FsError

Originating filesystem error.

Tmp

An orphan .tmp- directory could not be removed.

Fields

path: PathBuf

Tmp directory that could not be removed.

source: FsError

Originating filesystem error.

Restore

An orphan .restore- directory could not be removed.

Fields

path: PathBuf

Restore directory that could not be removed.

source: FsError

Originating filesystem error.

Trait Implementations

impl Debug for CleanFailure

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

Formats the value using the given formatter.

impl Display for CleanFailure

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

Formats the value using the given formatter.

impl Error for CleanFailure

where Self: Debug + Display,

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 ErrorCompat for CleanFailure

fn backtrace(&self) -> Option<&Backtrace>

Returns a Backtrace that may be printed.

fn iter_chain(&self) -> ChainCompat<'_, '_>

where Self: AsErrorSource,

Returns an iterator for traversing the chain of errors, starting with the current error and continuing with recursive calls to Error::source.