rte_random.h File Reference

OS Abstraction Layer - Cryptographically secure random bytes. More...

#include <stddef.h>
#include <stdint.h>
#include "rte/utils/status/rte_status.h"

Include dependency graph for rte_random.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	RTE_RANDOM_MAX_REQUEST   256U
	Largest request rte_random_fill() accepts in one call (bytes).

Functions
rte_status_t	rte_random_fill (uint8_t *out, size_t len)
	Fills out with len cryptographically secure random bytes from the registered OSAdapter.

Detailed Description

OS Abstraction Layer - Cryptographically secure random bytes.

The seam through which application code obtains unpredictable random bytes (e.g. the EuroRadio responder random RB, Subset-037-2) without naming an OSAdapter or calling the OS itself (ADR-005). What backs it is OSAdapter-defined: a POSIX OSAdapter uses the kernel CSPRNG; a bare-metal one would use a hardware TRNG.

REQ-OAL-RANDOM-001: the registered OSAdapter shall return bytes from a cryptographically secure source, or fail; it shall never fall back to a predictable generator.

Definition in file rte_random.h.