CryptRand.c File Reference

#include "InternalCryptLib.h"
#include <Library/RngLib.h>

Go to the source code of this file.

Functions
BOOLEAN EFIAPI	RandomSeed (IN CONST UINT8 *Seed OPTIONAL, IN UINTN SeedSize)
BOOLEAN EFIAPI	RandomBytes (OUT UINT8 *Output, IN UINTN Size)
INT32	MbedtlsRand (VOID *RngState, UINT8 *Output, UINTN Len)

Detailed Description

Pseudorandom Number Generator Wrapper Implementation over MbedTLS.

Copyright (c) 2024, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file CryptRand.c.

Function Documentation

MbedtlsRand()

INT32 MbedtlsRand	(	VOID *	RngState,
		UINT8 *	Output,
		UINTN	Len
	)

The MbedTLS function f_rng, which MbedtlsRand implements.

Parameters

[in]	RngState	Not used, just for compatibility with mbedtls.
[out]	Output	Pointer to buffer to receive random value.
[in]	Len	Size of random bytes to generate.

Return values

0	Pseudorandom byte stream generated successfully.
Non-0	Pseudorandom number generator fails to generate due to lack of entropy.

Definition at line 103 of file CryptRand.c.

RandomBytes()

BOOLEAN EFIAPI RandomBytes	(	OUT UINT8 *	Output,
		IN UINTN	Size
	)

Generates a pseudorandom byte stream of the specified size.

If Output is NULL, then return FALSE.

Parameters

[out]	Output	Pointer to buffer to receive random value.
[in]	Size	Size of random bytes to generate.

Return values

TRUE	Pseudorandom byte stream generated successfully.
FALSE	Pseudorandom number generator fails to generate due to lack of entropy.

Definition at line 52 of file CryptRand.c.

RandomSeed()

BOOLEAN EFIAPI RandomSeed	(	IN CONST UINT8 *Seed	OPTIONAL,
		IN UINTN	SeedSize
	)

Sets up the seed value for the pseudorandom number generator.

This function sets up the seed value for the pseudorandom number generator. If Seed is not NULL, then the seed passed in is used. If Seed is NULL, then default seed is used.

Parameters

[in]	Seed	Pointer to seed value. If NULL, default seed is used.
[in]	SeedSize	Size of seed value. If Seed is NULL, this parameter is ignored.

Return values

TRUE	Pseudorandom number generator has enough entropy for random generation.
FALSE	Pseudorandom number generator does not have enough entropy for random generation.

Definition at line 30 of file CryptRand.c.