Enum Error 

pub enum Error {
    EntropySourceUnavailable {
        source: &'static str,
        context: Option<&'static str>,
    },
    InsufficientEntropy {
        required: usize,
        available: usize,
        quality: f64,
    },
    EntropyValidationFailed {
        reason: &'static str,
        quality: f64,
        details: Option<&'static str>,
    },
    HardwareRngFailed {
        device: &'static str,
        status: Option<u32>,
        details: Option<&'static str>,
    },
    PlatformRngFailed {
        platform: &'static str,
        code: Option<i32>,
        details: Option<&'static str>,
    },
    InvalidConfiguration {
        parameter: &'static str,
        expected: String,
        actual: String,
    },
    MemoryAllocationFailed {
        size: usize,
        context: Option<&'static str>,
    },
    ThreadSafetyViolation {
        violation: &'static str,
        context: Option<&'static str>,
    },
    CryptographicFailure {
        operation: &'static str,
        code: Option<u32>,
        details: Option<&'static str>,
    },
    TestVectorValidationFailed {
        vector_id: &'static str,
        expected: String,
        actual: String,
    },
    FeatureNotAvailable {
        feature: &'static str,
        required_features: &'static [&'static str],
    },
    InternalError {
        component: &'static str,
        message: &'static str,
    },
}

Comprehensive error types for RNG operations

This enum provides detailed error information for various failure modes in random number generation, enabling proper error handling and recovery.

Variants

EntropySourceUnavailable

Entropy source is not available or failed

Fields

source: &'static str

Description of the entropy source failure

context: Option<&'static str>

Additional context about the failure

InsufficientEntropy

Insufficient entropy for cryptographic operations

Fields

required: usize

Required entropy bits

available: usize

Available entropy bits

quality: f64

Quality assessment of available entropy

EntropyValidationFailed

Entropy validation failed

Fields

reason: &'static str

Reason for validation failure

quality: f64

Entropy quality score (0.0 to 1.0)

details: Option<&'static str>

Additional validation details

HardwareRngFailed

Hardware RNG failure

Fields

device: &'static str

Hardware device identifier

status: Option<u32>

Error code or status

details: Option<&'static str>

Additional error details

PlatformRngFailed

Platform-specific RNG failure

Fields

platform: &'static str

Platform identifier

code: Option<i32>

Error code or status

details: Option<&'static str>

Additional error details

InvalidConfiguration

Invalid configuration or parameters

Fields

parameter: &'static str

Parameter that caused the error

expected: String

Expected value or range

actual: String

Actual value provided

MemoryAllocationFailed

Memory allocation failure

Fields

size: usize

Size of allocation that failed

context: Option<&'static str>

Additional context

ThreadSafetyViolation

Thread safety violation

Fields

violation: &'static str

Description of the violation

context: Option<&'static str>

Additional context

CryptographicFailure

Cryptographic operation failed

Fields

operation: &'static str

Operation that failed

code: Option<u32>

Error code or status

details: Option<&'static str>

Additional details

TestVectorValidationFailed

Test vector validation failed

Fields

vector_id: &'static str

Test vector identifier

expected: String

Expected value

actual: String

Actual value

FeatureNotAvailable

Feature not available

Fields

feature: &'static str

Feature that is not available

required_features: &'static [&'static str]

Required features for this functionality

InternalError

Internal implementation error

Fields

component: &'static str

Component that failed

message: &'static str

Error message

Implementations

impl Error

pub fn entropy_source_unavailable(source: &'static str) -> Self

Create a new entropy source unavailable error

pub fn entropy_source_unavailable_with_context( source: &'static str, context: &'static str, ) -> Self

Create a new entropy source unavailable error with context

pub fn insufficient_entropy( required: usize, available: usize, quality: f64, ) -> Self

Create a new insufficient entropy error

pub fn entropy_validation_failed(reason: &'static str, quality: f64) -> Self

Create a new entropy validation failed error

pub fn entropy_validation_failed_with_details( reason: &'static str, quality: f64, details: &'static str, ) -> Self

Create a new entropy validation failed error with details

pub fn hardware_rng_failed(device: &'static str) -> Self

Create a new hardware RNG failed error

pub fn hardware_rng_failed_with_status( device: &'static str, status: u32, details: &'static str, ) -> Self

Create a new hardware RNG failed error with status

pub fn platform_rng_failed(platform: &'static str) -> Self

Create a new platform RNG failed error

pub fn platform_rng_failed_with_code( platform: &'static str, code: i32, details: &'static str, ) -> Self

Create a new platform RNG failed error with code

pub fn invalid_configuration( parameter: &'static str, expected: &'static str, actual: &'static str, ) -> Self

Create a new invalid configuration error

pub fn memory_allocation_failed(size: usize) -> Self

Create a new memory allocation failed error

pub fn memory_allocation_failed_with_context( size: usize, context: &'static str, ) -> Self

Create a new memory allocation failed error with context

pub fn thread_safety_violation(violation: &'static str) -> Self

Create a new thread safety violation error

pub fn thread_safety_violation_with_context( violation: &'static str, context: &'static str, ) -> Self

Create a new thread safety violation error with context

pub fn cryptographic_failure(operation: &'static str) -> Self

Create a new cryptographic failure error

pub fn cryptographic_failure_with_code( operation: &'static str, code: u32, details: &'static str, ) -> Self

Create a new cryptographic failure error with code

pub fn test_vector_validation_failed( vector_id: &'static str, expected: &'static str, actual: &'static str, ) -> Self

Create a new test vector validation failed error

pub fn feature_not_available( feature: &'static str, required_features: &'static [&'static str], ) -> Self

Create a new feature not available error

pub fn internal_error(component: &'static str, message: &'static str) -> Self

Create a new internal error

pub fn is_recoverable(&self) -> bool

Check if this error is recoverable

pub fn is_entropy_related(&self) -> bool

Check if this error indicates insufficient entropy

pub fn description(&self) -> &'static str

Get a human-readable error description

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

Available on crate feature std only.

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 Error

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Error