Enum FileError 

pub enum FileError {
    Io {
        operation: &'static str,
        path: PathBuf,
        source: Box<dyn Error + Sync + Send>,
    },
    AfterReplace {
        path: PathBuf,
        source: Box<dyn Error + Sync + Send>,
    },
    AfterRemove {
        path: PathBuf,
        source: Box<dyn Error + Sync + Send>,
    },
    Cleanup {
        operation: Box<FileError>,
        cleanup: Box<dyn Error + Sync + Send>,
    },
    DeviceLocked {
        path: PathBuf,
    },
    Shutdown(Shutdown),
    Bug(Bug),
}

A file operation’s cause, including whether replacement already happened.

Variants

Io

An operation failed without replacing the target.

Fields

operation: &'static str

The operation that failed.

path: PathBuf

The affected path.

source: Box<dyn Error + Sync + Send>

The operating system’s error.

AfterReplace

The new bytes are visible, but syncing the directory failed.

Fields

path: PathBuf

The replaced file.

source: Box<dyn Error + Sync + Send>

The operating system’s error.

AfterRemove

The file is absent, but syncing its directory failed.

Fields

path: PathBuf

The removed file.

source: Box<dyn Error + Sync + Send>

The operating system’s error.

Cleanup

Removing an unpublished temporary file also failed.

Fields

operation: Box<FileError>

The original failure.

cleanup: Box<dyn Error + Sync + Send>

The error removing the temporary file.

DeviceLocked

The device is locked, and the file’s protection class keeps it from being made, opened or given its class until the device unlocks (api.md E1). The app waits for the unlock and retries.

Fields

path: PathBuf

The protected file, or the file that couldn’t be made in a protected folder.

Shutdown(Shutdown)

The operation’s runtime is shutting down and dropped it unstarted (E15).

Bug(Bug)

The operation panicked on the blocking pool: a bug, which the caller reports (E15).

Implementations

impl FileError

pub fn installed_new_bytes(&self) -> bool

Whether readers already see the replacement despite a durability error.

Trait Implementations

impl CarriesBug for FileError

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

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

impl Debug for FileError

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

Formats the value using the given formatter.

impl Display for FileError

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

Formats the value using the given formatter.

impl Error for FileError

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 FileError

fn from(source: Bug) -> FileError

Converts to this type from the input type.

impl From<FileError> for BootstrapDirectoryError

fn from(error: FileError) -> BootstrapDirectoryError

Converts to this type from the input type.

impl From<FileError> for BootstrapError

fn from(error: FileError) -> Self

Converts to this type from the input type.

impl From<FileError> for CopyPathError

fn from(error: FileError) -> CopyPathError

Converts to this type from the input type.

impl From<FileError> for CovenError

fn from(error: FileError) -> Self

Converts to this type from the input type.

impl From<FileError> for DbError

fn from(error: FileError) -> DbError

Converts to this type from the input type.

impl From<FileError> for DeviceOnlyError

fn from(error: FileError) -> DeviceOnlyError

Converts to this type from the input type.

impl From<FileError> for DirectoryCreationError

fn from(source: FileError) -> DirectoryCreationError

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<FileError> for KeyError

fn from(error: FileError) -> KeyError

Converts to this type from the input type.

impl From<FileError> for SettingsError

fn from(error: FileError) -> SettingsError

Converts to this type from the input type.

impl From<FileError> for StorageError

fn from(error: FileError) -> StorageError

Converts to this type from the input type.

impl From<FileError> for StoreDeletionError

fn from(error: FileError) -> Self

Converts to this type from the input type.

impl From<FileError> for StoreListError

fn from(error: FileError) -> Self

Converts to this type from the input type.

impl From<FileError> for StoreLockError

fn from(error: FileError) -> StoreLockError

Converts to this type from the input type.

impl From<FileError> for SyncError

fn from(error: FileError) -> SyncError

Converts to this type from the input type.

impl From<Shutdown> for FileError

fn from(source: Shutdown) -> FileError

Converts to this type from the input type.

impl From<TaskFailed> for FileError

fn from(failed: TaskFailed) -> FileError

Converts to this type from the input type.