iPXE
rbg.h File Reference

RBG mechanism. More...

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

Go to the source code of this file.

Data Structures

struct  random_bit_generator
 An RBG. More...

Functions

 FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
 FILE_SECBOOT (PERMITTED)
int rbg_generate (const void *additional, size_t additional_len, int prediction_resist, void *data, size_t len)
 Generate bits using RBG.

Variables

struct random_bit_generator rbg
 The RBG.

Detailed Description

RBG mechanism.

Definition in file rbg.h.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL )

◆ FILE_SECBOOT()

FILE_SECBOOT ( PERMITTED )

◆ rbg_generate()

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

Generate bits using RBG.

Parameters
additionalAdditional input
additional_lenLength of additional input
prediction_resistPrediction resistance is required
dataOutput buffer
lenLength of output buffer
Return values
rcReturn 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 117 of file rbg.c.

118 {
119
120 /* Attempt startup, if not already attempted */
121 if ( ! rbg.started )
122 rbg_startup();
123
124 /* Generate bits. The DRBG will itself return an error if it
125 * is not valid (e.g. due to an instantiation failure).
126 */
127 return drbg_generate ( &rbg.state, additional, additional_len,
128 prediction_resist, data, len );
129}
int drbg_generate(struct drbg_state *state, const void *additional, size_t additional_len, int prediction_resist, void *data, size_t len)
Generate pseudorandom bits using DRBG.
Definition drbg.c:284
ring len
Length.
Definition dwmac.h:226
uint8_t data[48]
Additional event data.
Definition ena.h:11
struct random_bit_generator rbg
The RBG.
Definition rbg.c:64
static int rbg_startup(void)
Start up RBG.
Definition rbg.c:74
uint16_t additional
Additional sense code and qualifier.
Definition scsi.h:13

References additional, data, drbg_generate(), len, rbg, and rbg_startup().

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

Variable Documentation

◆ rbg

struct random_bit_generator rbg
extern

The RBG.

Definition at line 64 of file rbg.c.

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