Enum VfError 

#[non_exhaustive]
pub enum VfError {
    Op {
        index: usize,
        err_no: u32,
    },
    Transport {
        index: Option<usize>,
        message: String,
    },
}

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 best-effort: backends report 0 when the failure cannot be attributed).

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

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>

message: String

Implementations

impl VfError

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

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 unsupported(index: usize) -> VfError

pub fn index(&self) -> usize

The operation index this error refers to (best-effort for transport failures; 0 when unknown).

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

The operation index as an Option; None only for a transport failure that cannot be attributed to any operation.

pub fn err_no(&self) -> u32

The filesystem status code, or VF_ERR_RPC for transport failures.

pub fn is_transport(&self) -> bool

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

pub fn from_rpc(e: RpcError, index: impl Into<Option<usize>>) -> VfError

Convert a low-level RpcError into a VfError, attributing the failure to index in the caller’s operation array. index is the caller’s operation index, which may differ from the compound-internal op index; for transport failures the index is best-effort. The transport message (if any) is preserved.

pub fn from_rpc_indexed(e: RpcError) -> VfError

Like from_rpc, but trusts e.op_index as the caller-relative operation index. The batched client helpers translate compound positions to caller indices before returning, so batched backend calls can use this directly.

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

Re-attribute this error to a different operation index.

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