Enum VfError 

#[non_exhaustive]
pub enum VfError {
    Op {
        index: usize,
        err_no: u32,
        domain: ErrorDomain,
        operation: Option<&'static str>,
        path: Option<PathBuf>,
    },
    OpUnattributed {
        err_no: u32,
        domain: ErrorDomain,
        operation: Option<&'static str>,
        path: Option<PathBuf>,
    },
    Transport {
        index: Option<usize>,
        kind: TransportKind,
        message: String,
        operation: Option<&'static str>,
        path: Option<PathBuf>,
    },
}

The failure of one operation in a vectorized call.

Either a filesystem status failure attributable to a specific operation index, or a transport / client-side failure (where the index is optional because some failures cannot be attributed to one request). An indexed failure does not roll back an already-completed prefix, and a transport failure can make the outcome of an in-flight mutation ambiguous.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Op

A filesystem status failure; err_no is errno-style or an NFS4ERR code, mirroring the C tc_res struct.

Fields

index: usize

err_no: u32

domain: ErrorDomain

operation: Option<&'static str>

path: Option<PathBuf>

OpUnattributed

A filesystem / protocol status that cannot be attributed to a specific operation index (for example a compound-level failure with no per-op result). Unlike Op, it does not pretend the failure is operation 0. index reports None.

Fields

err_no: u32

domain: ErrorDomain

operation: Option<&'static str>

path: Option<PathBuf>

Transport

A transport / client-side failure with a human-readable message; there is no filesystem status (err_no reports VF_ERR_RPC). index is None when the failure cannot be attributed to any operation.

Fields

index: Option<usize>

kind: TransportKind

message: String

operation: Option<&'static str>

path: Option<PathBuf>

Implementations

impl VfError

pub fn failure(index: usize, err_no: u32) -> VfError

pub fn client(index: usize, code: u32) -> VfError

pub fn nfs(index: usize, status: u32) -> VfError

A status returned by an NFS server.

pub fn smb(index: usize, status: u32) -> VfError

A status returned by an SMB server.

pub fn transport( index: impl Into<Option<usize>>, message: impl Into<String>, ) -> VfError

A transport / client-side failure. index is best-effort; pass None when the failure cannot be attributed to a specific operation.

pub fn transport_with_kind( index: impl Into<Option<usize>>, kind: TransportKind, message: impl Into<String>, ) -> VfError

pub fn unsupported(index: usize) -> VfError

pub fn index(&self) -> Option<usize>

Logical request index, or None when a failure cannot be attributed. An index is not a completion boundary: this item can itself contain completed chunks, and other requests can already have changed state.

pub fn err_no(&self) -> u32

Raw compatibility code: errno, NFS status, SMB status, or VF_ERR_RPC. Application code should use kind or typed status, not compare this value to errno constants.

pub fn is_transport(&self) -> bool

Whether this is a transport / client-side failure (no filesystem status).

pub fn transport_kind(&self) -> Option<TransportKind>

Transport provenance only; this never authorizes mutation replay.

pub fn with_index(self, index: usize) -> VfError

Re-attribute this error to a different operation index.

pub fn map_index(self, map: impl FnOnce(usize) -> usize) -> VfError

Transform a known request index while preserving an unattributable transport failure as None.

pub fn with_context( self, operation: &'static str, path: impl Into<PathBuf>, ) -> VfError

Attach operation and path context without string parsing.

pub fn domain(&self) -> ErrorDomain

pub fn status(&self) -> Option<StatusCode>

pub fn operation(&self) -> Option<&'static str>

pub fn path(&self) -> Option<&Path>

impl VfError

pub fn kind(&self) -> ErrorKind

Portable category; Self::status retains the original status.

This is deliberately not retry guidance. Even a semantic failure can follow successful chunks of the same logical mutation. Reconcile state before replaying a mutation unless its idempotence is established.

Trait Implementations

impl Clone for VfError

fn clone(&self) -> VfError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for VfError

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

Formats the value using the given formatter.

impl Display for VfError

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

Formats the value using the given formatter.

impl Eq for VfError

impl Error for VfError

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 PartialEq for VfError

fn eq(&self, other: &VfError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for VfError