Enum NumaError 

pub enum NumaError {
    PolicyNotSupported {
        policy: String,
        reason: String,
    },
    CapabilityMissing {
        capability: &'static str,
    },
    HardModeUnavailable {
        feature: &'static str,
        reason: String,
    },
    TopologyError {
        source: Error,
    },
    AllocationFailed {
        size: usize,
        source: Error,
    },
    PinningFailed {
        source: Error,
    },
    BindFailed {
        source: Error,
    },
    InvalidArgument {
        message: String,
    },
    NotSupported {
        feature: &'static str,
    },
    Io(Error),
}

Unified error type for all numaperf operations.

Errors are structured to explain both what failed and why, enabling callers to take appropriate recovery actions.

Variants

PolicyNotSupported

The requested memory policy is not supported on this kernel.

Fields

policy: String

Description of the policy that failed.

reason: String

Why the policy is not supported.

CapabilityMissing

A required capability is missing.

Fields

capability: &'static str

The name of the missing capability (e.g., “CAP_SYS_NICE”).

HardModeUnavailable

Hard mode was requested but cannot be enforced.

Fields

feature: &'static str

The feature that cannot be enforced.

reason: String

Why hard mode is unavailable.

TopologyError

Topology discovery failed.

Fields

source: Error

The underlying I/O error.

AllocationFailed

Memory allocation or mapping failed.

Fields

size: usize

The requested allocation size.

source: Error

The underlying I/O error.

PinningFailed

Thread pinning failed.

Fields

source: Error

The underlying I/O error.

BindFailed

Memory binding (mbind) failed.

Fields

source: Error

The underlying I/O error.

InvalidArgument

An invalid argument was provided.

Fields

message: String

Description of the invalid argument.

NotSupported

Platform does not support the requested feature.

Fields

feature: &'static str

The unsupported feature.

Io(Error)

Generic I/O error.

Implementations

impl NumaError

pub fn topology(source: Error) -> NumaError

Create a topology error from an I/O error.

pub fn allocation(size: usize, source: Error) -> NumaError

Create an allocation error.

pub fn pinning(source: Error) -> NumaError

Create a pinning error from an I/O error.

pub fn bind(source: Error) -> NumaError

Create a bind error from an I/O error.

pub fn policy_not_supported( policy: impl Into<String>, reason: impl Into<String>, ) -> NumaError

Create a policy not supported error.

pub fn hard_mode_unavailable( feature: &'static str, reason: impl Into<String>, ) -> NumaError

Create a hard mode unavailable error.

pub fn invalid_argument(message: impl Into<String>) -> NumaError

Create an invalid argument error.

pub fn is_permission_error(&self) -> bool

Check if this error indicates a permission issue.

pub fn is_not_supported(&self) -> bool

Check if this error indicates the feature is not supported.

Trait Implementations

impl Debug for NumaError

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

Formats the value using the given formatter.

impl Display for NumaError

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

Formats the value using the given formatter.

impl Error for NumaError

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<Error> for NumaError

fn from(source: Error) -> NumaError

Converts to this type from the input type.