Skip to main content

HmacDrbgSha256

Struct HmacDrbgSha256 

Source
pub struct HmacDrbgSha256 { /* private fields */ }
Expand description

An HMAC_DRBG-SHA-256 instance held by the library (SP 800-90A §10.1.2).

The caller seeds it through instantiate and reseed: the library’s entropy source is not connected to the C ABI’s DRBG handles, so the caller supplies entropy meeting SP 800-90A and SP 800-90B and documents its source. Freed exactly once, when dropped; the library zeroes the state.

Implementations§

Source§

impl HmacDrbgSha256

Source

pub fn instantiate( &mut self, entropy: &[u8], nonce: &[u8], personalization: &[u8], ) -> Result<(), Error>

Instantiate (SP 800-90A §10.1.2.3). Empty nonce or personalization are passed as absent.

Source

pub fn reseed(&mut self, entropy: &[u8], additional: &[u8]) -> Result<(), Error>

Reseed (SP 800-90A §10.1.2.4). An empty additional is passed as absent.

Source

pub fn generate( &mut self, additional: &[u8], out: &mut [u8], ) -> Result<(), Error>

Generate (SP 800-90A §10.1.2.5) out.len() bytes into out. An empty additional is passed as absent. out is zeroed on every error.

A request over HMAC_DRBG_MAX_REQUEST_LEN is refused with Error::OutputTooLong before the library is called, which would otherwise allocate a buffer of the requested length before refusing.

Source

pub fn seed<S: DrbgSeed>(&mut self) -> Result<S, Error>

A 32-byte seed of type S generated by this DRBG, written directly into its zeroing owner. The type is usually inferred from the call the seed is passed to.

Trait Implementations§

Source§

impl Debug for HmacDrbgSha256

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Drop for HmacDrbgSha256

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)
Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned. Read more
Source§

impl Send for HmacDrbgSha256

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.