Enum FileReadError 

pub enum FileReadError {
    UpdateRequired(RequiredUpdate),
    NoStorage,
    Missing {
        id: String,
        device: DeviceId,
    },
    DeviceOnly {
        file: FileId,
        device: DeviceId,
    },
    UserFileMissing {
        id: String,
        path: PathBuf,
    },
    UserFileChanged {
        id: String,
        path: PathBuf,
    },
    Integrity {
        id: String,
        cause: Option<Arc<CryptoError>>,
    },
    RangeOutOfBounds {
        id: String,
        offset: u64,
        end: u64,
        size: u64,
    },
    Database(DbError),
    Disk(FileError),
    Lock(StoreLockError),
    Storage(StorageError),
    Sync(Box<SyncError>),
    Bug(Bug),
}

Reading a file failed with a cause the app can distinguish (E8).

Variants

UpdateRequired(RequiredUpdate)

This file uses a newer coven format (Appendix C.2).

NoStorage

No storage capability is connected.

Missing

Storage confirms nothing at the path a stored file’s record names: the provider lost it (§17.6). Nothing brings it back on its own.

Fields

id: String

The file’s id.

device: DeviceId

The device that uploaded it.

DeviceOnly

The file is only on one device, another one or this one with no source to read: nothing here can read it, and nothing waits for it (§17.2).

Fields

file: FileId

The file.

device: DeviceId

The device that has it.

UserFileMissing

A recorded original is absent.

Fields

id: String

The file’s id.

path: PathBuf

Recorded original path.

UserFileChanged

An original changed after it was staged.

Fields

id: String

The file’s id.

path: PathBuf

Recorded original path.

Integrity

Authentication, a chunk hash or the whole-file hash failed.

Fields

id: String

The file’s id.

cause: Option<Arc<CryptoError>>

The authentication failure, when a chunk failed to open. A size, layout or hash disagreement has no cause beyond the comparison.

RangeOutOfBounds

The requested range is outside the file.

Fields

id: String

The file’s id.

offset: u64

Requested start.

end: u64

Requested end, saturated on overflow.

size: u64

Whole plaintext size.

Database(DbError)

A database failure, retaining its cause.

Disk(FileError)

A disk failure, retaining its cause.

Lock(StoreLockError)

The store cannot be retained while opening its file.

Storage(StorageError)

A provider failure, retaining its classification and native cause.

Sync(Box<SyncError>)

Recording what a read or an upload settled failed in sync’s own work, as a retry wait the clock can’t hold, keeping its cause; a failed read whose failure couldn’t be recorded keeps both (§17.9).

Bug(Bug)

The read’s work panicked: a bug, which the caller reports (E15).

Trait Implementations

impl CarriesBug for FileReadError

fn bug(&self) -> Option<&Bug>

The bug this error carries, itself or through the failure it keeps.

impl Debug for FileReadError

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

Formats the value using the given formatter.

impl Display for FileReadError

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

Formats the value using the given formatter.

impl Error for FileReadError

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<Bug> for FileReadError

fn from(source: Bug) -> FileReadError

Converts to this type from the input type.

impl From<DbError> for FileReadError

fn from(error: DbError) -> FileReadError

Converts to this type from the input type.

impl From<FileError> for FileReadError

fn from(error: FileError) -> FileReadError

Converts to this type from the input type.

impl From<LocalFileError> for FileReadError

fn from(error: LocalFileError) -> FileReadError

Converts to this type from the input type.

impl From<StorageError> for FileReadError

fn from(error: StorageError) -> FileReadError

Converts to this type from the input type.

impl From<StoreLockError> for FileReadError

fn from(error: StoreLockError) -> FileReadError

Converts to this type from the input type.

impl From<SyncError> for FileReadError

A database or provider failure as itself; any other of sync’s own failures kept whole.

fn from(error: SyncError) -> FileReadError

Converts to this type from the input type.

impl From<WriterError> for FileReadError

fn from(error: WriterError) -> FileReadError

Converts to this type from the input type.