Enum AppRootError 

pub enum AppRootError {
    InvalidName(String),
    PathEscape(String),
    CaseConflict {
        requested: String,
        existing: String,
    },
    WriterBusy(PathBuf),
    UnsupportedSource(PathBuf),
    Collision(PathBuf),
    Overlap(PathBuf),
    VerifyFailed(PathBuf),
    Suite(SuiteError),
    Io(Error),
}

Variants

InvalidName(String)

PathEscape(String)

A subpath was absolute, had .., ., a prefix, was empty, or resolved outside the root.

CaseConflict

An existing sibling differs from the requested app name only by case.

Fields

requested: String

existing: String

WriterBusy(PathBuf)

Another process holds the single-writer lock.

UnsupportedSource(PathBuf)

The source tree holds a symlink, junction or other reparse point, or special file that this migration mode refuses (strict mode refuses every one; an opt-in mode still refuses devices and other specials, and a junction or reparse point unless MigrateOptions::skip_reparse_points is on).

Collision(PathBuf)

A destination file exists with different content; nothing is overwritten.

Overlap(PathBuf)

Source and destination are the same tree or nested in each other.

VerifyFailed(PathBuf)

Post-copy verification found a difference.

Suite(SuiteError)

Io(Error)

Implementations

impl AppRootError

pub fn link_not_created(&self) -> Option<&LinkNotCreated>

The typed link failure carried by an AppRootError::Io, if that is what this is: a symlink the destination could not create (Windows without the symlink privilege or Developer Mode, or a filesystem without links) during an opt-in migration. Read the link, its original target and the target that would have been written from LinkNotCreated.

pub fn is_retryable(&self) -> bool

True when trying again can succeed without changing the request: a link the destination could not create yet (AppRootError::link_not_created) or a busy writer lock.

Trait Implementations

impl Debug for AppRootError

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

Formats the value using the given formatter.

impl Display for AppRootError

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

Formats the value using the given formatter.

impl Error for AppRootError

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<Error> for AppRootError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<SuiteError> for AppRootError

fn from(e: SuiteError) -> Self

Converts to this type from the input type.