Enum RpcError 

#[non_exhaustive]
pub enum RpcError {
    InvalidProcedure,
    ProgUnavail,
    InvalidVersion {
        low: u32,
        high: u32,
    },
    RpcMismatch,
    GarbageArguments,
    SystemError,
    AuthenticationError,
    ConnectFailed,
    PoolClosed,
    Canceled,
    InvalidPoolConfiguration,
}

Errors that can occur while preparing or performing RPC calls.

Protocol errors correspond to ONC-RPC reply statuses. Local transport and pool errors have no wire-level equivalent; if returned by a server handler, rpc_driver encodes them as RpcError::SystemError.

Wire boundary versus driver-local variants

The wire-level contract — stable across driver releases — is: InvalidProcedure, ProgUnavail, InvalidVersion, RpcMismatch, GarbageArguments, SystemError, and AuthenticationError.

The remaining variants describe local operational failures (connections, pools) and are surfaced to callers without crossing the wire. The enum is #[non_exhaustive], so new operational variants can be added without a breaking release; any variant unknown to a given driver release is encoded on the wire as a system error.

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.

InvalidProcedure

The requested procedure is not defined for the selected service.

ProgUnavail

No service is registered for the requested program number.

InvalidVersion

The program exists, but not at the requested version.

Fields

low: u32

Lowest supported version.

high: u32

Highest supported version.

RpcMismatch

The peer requested an unsupported ONC-RPC protocol version.

GarbageArguments

The call arguments could not be decoded.

SystemError

The call failed without a more specific wire-level error.

AuthenticationError

Authentication credentials or verification failed.

ConnectFailed

A client connection could not be established.

PoolClosed

The connection pool has been shut down or can no longer accept work.

Canceled

The pool abandoned a queued request before it could complete.

InvalidPoolConfiguration

The requested pool configuration is invalid.

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, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for RpcError

impl Error for RpcError

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 RpcError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RpcError