Enum RestoreS3Error 

pub enum RestoreS3Error {
    Config(String),
    Store(Error),
    Io(Error),
    NoBackup {
        from: String,
    },
    Manifest(String),
    Verify(String),
    IntoNotEmpty {
        into: PathBuf,
    },
    DataDirNotEmpty {
        dir: PathBuf,
        entries: Vec<String>,
    },
    BeforeOldestArchive {
        target: u64,
        oldest: u64,
    },
    AfterLatest {
        target: u64,
        commits: u64,
        not_restorable: Option<String>,
    },
    CommitTimesAbsent,
    CommitTimesEnd {
        recorded_through: u64,
        recorded_through_ms: i64,
        commits: u64,
    },
    Unreachable(String),
}

Why a restore failed. The target is in every case as it was before the restore — absent, or an empty directory. (Once the store is in place nothing is reported as a failure; see RestoreS3Outcome::install_note.)

Variants

Config(String)

The --from URL or the AWS_* environment cannot be used.

Store(Error)

The object store refused or failed a request.

Io(Error)

Reading or writing local files failed.

NoBackup

The prefix holds no backup: there is no LATEST.

Fields

from: String

Manifest(String)

A manifest is missing or does not parse.

Verify(String)

An object does not match its manifest entry (size, CRC-32, lineage, generation or offsets), or the restored copy does not hold what the manifest says.

IntoNotEmpty

The target directory already holds something.

Fields

into: PathBuf

DataDirNotEmpty

A restore on boot: the data directory holds no store, but holds files a restore must not mix with (entries, by name).

Fields

dir: PathBuf

entries: Vec<String>

BeforeOldestArchive

--at names a commit below the oldest one the backup still holds.

Fields

target: u64

oldest: u64

AfterLatest

--at names a commit past the newest one in the backup, which holds commits 0..commits.

Fields

target: u64

commits: u64

not_restorable: Option<String>

Why the backup holds no more: segments after the newest manifest that exist but could not be used.

CommitTimesAbsent

--at is a timestamp, and the backup holds no commit_times.bin (or one that records no commit) to resolve it with.

CommitTimesEnd

--at is a timestamp at or after the newest commit time the backup records, and the backup holds commits after that one with no recorded time: which of them the instant falls after cannot be told.

Fields

recorded_through: u64

The newest commit with a recorded time.

recorded_through_ms: i64

That commit’s recorded time, in Unix milliseconds.

commits: u64

The commits the backup holds (0..commits).

Unreachable(String)

The target cannot be rebuilt from what the backup holds.

Trait Implementations

impl Debug for RestoreS3Error

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

Formats the value using the given formatter.

impl Display for RestoreS3Error

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

Formats the value using the given formatter.

impl Error for RestoreS3Error

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<BackupError> for RestoreS3Error

fn from(e: BackupError) -> Self

Converts to this type from the input type.

impl From<Error> for RestoreS3Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for RestoreS3Error

fn from(e: Error) -> Self

Converts to this type from the input type.