Enum FileError 

pub enum FileError {
    Io {
        operation: &'static str,
        path: PathBuf,
        source: Box<dyn Error + Send + Sync>,
    },
    AfterReplace {
        path: PathBuf,
        source: Box<dyn Error + Send + Sync>,
    },
    AfterRemove {
        path: PathBuf,
        source: Box<dyn Error + Send + Sync>,
    },
    Cleanup {
        operation: Box<FileError>,
        cleanup: Box<dyn Error + Send + Sync>,
    },
    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 + Send + Sync>

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 + Send + Sync>

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 + Send + Sync>

The operating system’s error.

Cleanup

Removing an unpublished temporary file also failed.

Fields

operation: Box<FileError>

The original failure.

cleanup: Box<dyn Error + Send + Sync>

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

Formats the value using the given formatter.

impl Display for FileError

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

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) -> Self

Converts to this type from the input type.

impl From<FileError> for BootstrapDirectoryError

fn from(error: FileError) -> Self

Converts to this type from the input type.

impl From<FileError> for CopyPathError

fn from(error: FileError) -> Self

Converts to this type from the input type.

impl From<FileError> for DirectoryCreationError

fn from(source: FileError) -> Self

Converts to this type from the input type.

impl From<FileError> for ObservationError

fn from(source: FileError) -> Self

Converts to this type from the input type.

impl From<FileError> for SettingsError

fn from(error: FileError) -> Self

Converts to this type from the input type.

impl From<FileError> for StoreLockError

fn from(error: FileError) -> Self

Converts to this type from the input type.

impl From<FileError> for WriterError

fn from(source: FileError) -> Self

Converts to this type from the input type.

impl From<Shutdown> for FileError

fn from(source: Shutdown) -> Self

Converts to this type from the input type.

impl From<TaskFailed> for FileError

fn from(failed: TaskFailed) -> Self

Converts to this type from the input type.