Struct VfError 

pub struct VfError { /* private fields */ }

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.

Construct errors through the typed factories and inspect them through methods; status domains and transport provenance cannot be modified independently.

let mut error = vfsi_core::VfError::failure(0, 2);
error.index = Some(9);

Implementations

impl VfError

pub fn from_status(index: impl Into<Option<usize>>, status: StatusCode) -> Self

A typed status, with an optional logical request index.

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 raw_code(&self) -> u32

Raw code in the error’s status domain, or VF_ERR_RPC for transport. 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 failure with no filesystem status.

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

Transport provenance only; this never authorizes mutation replay.

pub fn transport_message(&self) -> Option<&str>

The backend’s transport diagnostic, without formatted index/path context.

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 failure as None.

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

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

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

Formats the value using the given formatter.

impl Display for VfError

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

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 From<VfError> for Error

fn from(error: VfError) -> Self

Converts to this type from the input type.

impl PartialEq for VfError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for VfError