Enum EntropyError 

pub enum EntropyError {
    Unavailable {
        reason: &'static str,
    },
    Failed {
        reason: &'static str,
        code: Option<i32>,
    },
}

Why an EntropySource could not produce randomness.

Both variants are fatal for the operation that needed the bytes. Callers must fail that operation rather than fall back to a weaker source: minip2p uses entropy for key generation, Noise handshakes, and nonces, where a predictable substitute is a security bug.

Variants

Unavailable

The platform has no entropy source at all.

Permanent — retrying will not help. Typically an embedded target built without a hardware RNG or a configured seed.

Fields

reason: &'static str

What the adapter expected to find.

Failed

The entropy source exists but failed to produce bytes.

May be transient, for example a hardware RNG reporting a health-check failure or an exhausted file descriptor table.

Fields

reason: &'static str

What went wrong.

code: Option<i32>

Platform error code, when the adapter has one.

Implementations

impl EntropyError

pub const fn unavailable(reason: &'static str) -> Self

Creates an Unavailable error.

pub const fn failed(reason: &'static str) -> Self

Creates a Failed error without a platform code.

pub const fn failed_with_code(reason: &'static str, code: i32) -> Self

Creates a Failed error carrying a platform code.

Trait Implementations

impl Clone for EntropyError

fn clone(&self) -> EntropyError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for EntropyError

impl Debug for EntropyError

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

Formats the value using the given formatter.

impl Display for EntropyError

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

Formats the value using the given formatter.

impl Eq for EntropyError

impl Error for EntropyError

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 EntropyError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for EntropyError