Struct RandCtx 

pub struct RandCtx { /* private fields */ }

A seeded DRBG context (EVP_RAND_CTX*).

Has up_ref so Clone is implemented; wrapping in Arc<RandCtx> is safe.

Implementations

impl RandCtx

pub fn new(alg: &RandAlg, parent: Option<&RandCtx>) -> Result<Self, ErrorStack>

Create a new uninstantiated DRBG context from an algorithm descriptor.

Provide parent = None to seed from the global PRNG.

Errors

pub fn instantiate( &mut self, strength: u32, prediction_resistance: bool, params: Option<&Params<'_>>, ) -> Result<(), ErrorStack>

Instantiate (seed) the DRBG at the requested security strength.

Must be called before generate if the context was not auto-seeded. When parent = None was used in new, pass strength ≤ 128 to stay within the system seed-source’s entropy ceiling.

Errors

pub fn generate( &mut self, out: &mut [u8], req: &GenerateRequest<'_>, ) -> Result<(), ErrorStack>

Generate random bytes into out.

Zero-copy: writes directly into the caller’s slice.

Errors

pub fn fill(&mut self, out: &mut [u8]) -> Result<(), ErrorStack>

Generate random bytes with default parameters (strength=256, no prediction resistance, no additional input).

Equivalent to calling generate with GenerateRequest::default. Call Self::instantiate before the first fill.

Errors

pub fn strength(&self) -> u32

Security strength of this DRBG instance in bits.

pub fn state(&self) -> RandState

Current lifecycle state of this DRBG context.

Returns RandState::Ready after a successful Self::instantiate.

Trait Implementations

impl Drop for RandCtx

fn drop(&mut self)

Executes the destructor for this type.

impl Send for RandCtx

impl Sync for RandCtx