Enum RpcError 

pub enum RpcError {
    Io(Error),
    Xdr(Error),
    UnexpectedCall,
    Auth(auth_stat),
    RpcMismatch {
        low: u32,
        high: u32,
    },
    WrongLength,
    UnexpectedXid,
    NotFullyParsed {
        buf: Vec<u8>,
        pos: u64,
    },
    ProgUnavail,
    ProgMismatch {
        low: u32,
        high: u32,
    },
    ProcUnavail,
    GarbageArgs,
    FragmentedReply,
    SystemErr,
}

Error from an RPC call.

Covers I/O failures, XDR encoding/decoding issues, and RPC protocol errors. Returned by RpcClient::call and all Nfs3Client operations.

Connection state after an error

Not every error leaves the underlying transport in the same state. Use is_connection_reusable to decide whether the connection can be kept.

Variants

Io(Error)

An I/O error occurred during network communication.

Xdr(Error)

Failed to serialize or deserialize an XDR-encoded message.

UnexpectedCall

Received a CALL message when a REPLY was expected.

Auth(auth_stat)

Server rejected the request due to an authentication failure.

RpcMismatch

Server does not support the requested RPC version.

Fields

low: u32

Lowest supported RPC version.

high: u32

Highest supported RPC version.

WrongLength

The serialized RPC message length is not a multiple of 4 bytes.

UnexpectedXid

The reply XID does not match the request XID.

NotFullyParsed

The reply was not fully consumed after decoding.

Fields

buf: Vec<u8>

Raw reply buffer.

pos: u64

Cursor position where parsing stopped.

ProgUnavail

The requested program is not available on the server.

ProgMismatch

The requested program version is not supported.

Fields

low: u32

Lowest supported program version.

high: u32

Highest supported program version.

ProcUnavail

The requested procedure is not available.

GarbageArgs

The server could not decode the procedure arguments.

FragmentedReply

The server sent a fragmented reply, which is not supported.

Handling fragmented replies would require significant changes to the receive logic because subsequent fragments are not guaranteed to arrive immediately after the first one.

SystemErr

An unspecified server-side system error occurred.

Implementations

impl RpcError

pub const fn is_connection_reusable(&self) -> bool

Returns true if the connection that produced this error is still in a clean state and may be reused for the next call.

Returns false only for Io (transport is dead) and FragmentedReply (unread fragment data left in the socket).

All other errors — including Xdr, WrongLength, NotFullyParsed, and UnexpectedXid — are produced while operating on in-memory buffers after the full fragment has already been consumed from the wire, so the transport remains at a clean message boundary.

Trait Implementations

impl Debug for RpcError

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

Formats the value using the given formatter.

impl Display for RpcError

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

Formats the value using the given formatter.

impl Error for RpcError

fn source(&self) -> Option<&(dyn StdError + '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 RpcError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for RpcError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<RpcError> for MountError

fn from(e: RpcError) -> Self

Converts to this type from the input type.

impl From<RpcError> for PortmapError

fn from(e: RpcError) -> Self

Converts to this type from the input type.

impl From<rejected_reply> for RpcError

fn from(e: rejected_reply) -> Self

Converts to this type from the input type.

impl TryFrom<accept_stat_data> for RpcError

type Error = ()

The type returned in the event of a conversion error.

fn try_from(value: accept_stat_data) -> Result<Self, Self::Error>

Performs the conversion.