RBG mechanism. More...

#include <stdint.h>
#include <ipxe/drbg.h>

Data Structures
struct	random_bit_generator
	An RBG. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)

int	rbg_generate (const void additional, size_t additional_len, int prediction_resist, void data, size_t len)
	Generate bits using RBG. More...

Variables
struct random_bit_generator	rbg
	The RBG. More...

Detailed Description

RBG mechanism.

Definition in file rbg.h.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL )

◆ rbg_generate()

int rbg_generate	(	const void *	additional,
		size_t	additional_len,
		int	prediction_resist,
		void *	data,
		size_t	len
	)

Generate bits using RBG.

Parameters

additional	Additional input
additional_len	Length of additional input
prediction_resist	Prediction resistance is required
data	Output buffer
len	Length of output buffer

Return values

rc	Return status code

This is the RBG_Generate function defined in ANS X9.82 Part 4 (April 2011 Draft) Section 9.1.2.2.

Definition at line 116 of file rbg.c.

                                                                    {
 
         /* Attempt startup, if not already attempted */
         if ( ! rbg.started )
                 rbg_startup();
 
         /* Generate bits.  The DRBG will itself return an error if it
          * is not valid (e.g. due to an instantiation failure).
          */
         return drbg_generate ( &rbg.state, additional, additional_len,
                                prediction_resist, data, len );
 }

References additional, data, drbg_generate(), len, rbg, rbg_startup(), random_bit_generator::started, and random_bit_generator::state.

Referenced by get_random_nz(), tls_generate_random(), and wpa_handle_1_of_4().

Variable Documentation

◆ rbg

struct random_bit_generator rbg

The RBG.

Definition at line 63 of file rbg.c.

Referenced by rbg_generate(), rbg_shutdown(), rbg_startup(), and rbg_startup_fn().

Data Structures