Symbols

Files

Summary Syntax Arguments References Call Tree Data Use

SourceVuESP-IDF Framework and ExamplesmbedTLSmbedtls_mpi_core_fill_random()

mbedtls_mpi_core_fill_random() function

Fill an integer with a number of random bytes.

Syntax

Show:

Summary

Declaration

Definition

from bignum_core.h:567

int mbedtls_mpi_core_fill_random(mbedtls_mpi_uint *X, size_t X_limbs, size_t bytes, int (*f_rng)(void *, unsigned char *, size_t), void *p_rng);

Implemented in bignum_core.c:615

Arguments

Argument

Description

The destination MPI.

X_limbs

The number of limbs of \p X.

bytes

The number of random bytes to generate.

f_rng

The RNG function to use. This must not be \c NULL.

p_rng

The RNG parameter to be passed to \p f_rng. This may be \c NULL if \p f_rng doesn't need a context argument.

Return value

\c 0 if successful. #MBEDTLS_ERR_MPI_BAD_INPUT_DATA if \p X does not have enough room for \p bytes bytes. A negative error code on RNG failure.

Notes

The bytes obtained from the RNG are interpreted as a big-endian representation of an MPI; this can be relevant in applications like deterministic ECDSA.

References

Code

Location

Referrer

int mbedtls_mpi_core_fill_random(

bignum_core.c:615

int mbedtls_mpi_core_fill_random(mbedtls_mpi_uint *X, size_t X_limbs,

bignum_core.h:567

ret = mbedtls_mpi_core_fill_random(X->p, X->n, size, f_rng, p_rng);

bignum.c:1901

mbedtls_mpi_fill_random()

MBEDTLS_MPI_CHK(mbedtls_mpi_core_fill_random(X, limbs,

bignum_core.c:677

mbedtls_mpi_core_random()

Call Tree

mbedtls_mpi_core_fill_random() is called by 2 functions and calls 2 functions:

mbedtls_mpi_core_random()

mbedtls_mpi_fill_random()

mbedtls_mpi_core_fill_random()

mbedtls_mpi_core_bigendian_to_host()

mbedtls_mpi_core_fill_random()::f_rng

Data Use

mbedtls_mpi_core_fill_random():

mbedtls_mpi_core_fill_random()

Class Tree

All items filtered out

Override Tree

All items filtered out

Implementations

All items filtered out

Instances

Lifecycle

All items filtered out