mbedtls_mpi_gen_prime() function

Generate a prime number.

Syntax

int mbedtls_mpi_gen_prime( mbedtls_mpi *X, size_t nbits, int flags, int (*f_rng)(void *, unsigned char *, size_t), void *p_rng );

Arguments

X

The destination MPI to store the generated prime in. This must point to an initialized MPi.

nbits

The required size of the destination MPI in bits. This must be between \c 3 and #MBEDTLS_MPI_MAX_BITS.

flags

A mask of flags of type #mbedtls_mpi_gen_prime_flag_t.

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 use a context parameter.

Return value

\c 0 if successful, in which case \p X holds a probably prime number. #MBEDTLS_ERR_MPI_ALLOC_FAILED if a memory allocation failed. #MBEDTLS_ERR_MPI_BAD_INPUT_DATA if `nbits` is not between \c 3 and #MBEDTLS_MPI_MAX_BITS.

References

Location	Text
bignum.h:947	int mbedtls_mpi_gen_prime( mbedtls_mpi *X, size_t nbits, int flags,