Enum Error 

pub enum Error {
    Cancelled,
    Io {
        path: PathBuf,
        source: Error,
    },
    BareIo(Error),
    Containment(PathBuf),
    EmptySource(PathBuf),
    Pattern(String),
    Filter(String),
    DeltaApply(String),
    Protocol(String),
    Verification(usize),
}

Errors that can arise while planning or applying a sync.

Variants

Cancelled

The run was cancelled cooperatively.

Io

An underlying I/O failure, annotated with the offending path.

Fields

path: PathBuf

Path that triggered the error.

source: Error

The underlying I/O error.

BareIo(Error)

A bare I/O failure with no associated path.

Containment(PathBuf)

A path escaped the destination root (containment violation).

EmptySource(PathBuf)

--delete was requested but the source is empty or unreadable.

Pattern(String)

An exclude/glob pattern failed to compile.

Filter(String)

An include/exclude/files-from filter was invalid.

DeltaApply(String)

A delta could not be applied to the supplied basis.

Protocol(String)

The remote-sync wire protocol was violated (bad frame, version mismatch, unexpected message, oversized frame).

Verification(usize)

Verification found one or more mismatches.

Implementations

impl Error

pub fn io(path: impl Into<PathBuf>, source: Error) -> Self

Wrap an std::io::Error together with the path that produced it.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.