/* random.h

 *

 * Copyright (C) 2006-2026 wolfSSL Inc.

 *

 * This file is part of wolfSSL.

 *

 * wolfSSL is free software; you can redistribute it and/or modify

 * it under the terms of the GNU General Public License as published by

 * the Free Software Foundation; either version 3 of the License, or

 * (at your option) any later version.

 *

 * wolfSSL is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335, USA

 */

/*!

    \file wolfssl/wolfcrypt/random.h

*/

#ifndef WOLF_CRYPT_RANDOM_H

#define WOLF_CRYPT_RANDOM_H

#include <wolfssl/wolfcrypt/types.h>

#if FIPS_VERSION3_GE(2,0,0)

    #include <wolfssl/wolfcrypt/fips.h>

#endif /* HAVE_FIPS_VERSION >= 2 */

/* One lock per WC_RNG so threads can share it.  WC_RNG_NO_AUTO_LOCK opts out;

 * kernel modules have their own lock-free design and CMSIS-RTOS v1 has only

 * a ten-mutex pool.  Bank builds keep it: they still hand out plain instances. */

/* WC_RNG_WANT_AUTO_LOCK forces the lock on where policy would skip it.  The

 * tests below it are hard prerequisites and nothing can override those. */

#if (defined(WC_RNG_WANT_AUTO_LOCK) || \

     (!defined(WOLFSSL_CMSIS_RTOS) && \

      !defined(WOLFSSL_KERNEL_MODE) && \

      !defined(WOLFSSL_KERNEL_MODE_DEFAULTS))) && \

    !defined(SINGLE_THREADED) && \

    !defined(WC_RNG_NO_AUTO_LOCK) && !defined(WC_NO_RNG) && \

    !defined(WC_NO_HASHDRBG) && !defined(CUSTOM_RAND_GENERATE_BLOCK) && \

    !defined(HAVE_SELFTEST) && (!defined(HAVE_FIPS) || FIPS_VERSION3_GE(7,0,0))

    #define WC_RNG_HAVE_AUTO_LOCK

#else

    #undef WC_RNG_HAVE_AUTO_LOCK

#endif

/* Whether an instance gets the lock when the caller names neither

 * WC_RNG_INIT_FLAG_USE_AUTO_LOCK nor WC_RNG_INIT_FLAG_NO_AUTO_LOCK. */

#if defined(WC_RNG_HAVE_AUTO_LOCK) && defined(WC_RNG_AUTO_LOCK_DEFAULT_OFF)

    #define WC_RNG_AUTO_LOCK_DEFAULT 0

#else

    #define WC_RNG_AUTO_LOCK_DEFAULT 1

#endif

/* pthread_atfork handlers so a forked child can keep using its WC_RNG.

 * configure and CMake define WC_RNG_AUTOFORK where the dlclose pin and unnamed

 * semaphores exist; builds whose locks the handlers cannot cover are left out.

 * getpid() is required alongside them: it is what makes the child throw away

 * the pooled and banked bytes it inherited, which the handlers themselves do

 * not touch. */

#if defined(WC_RNG_HAVE_AUTO_LOCK) && defined(WOLFSSL_PTHREADS) && \

    defined(WC_RNG_AUTOFORK) && !defined(__APPLE__) && \

    defined(HAVE_THREAD_LS) && !defined(NO_THREAD_LS) && \

    defined(HAVE_GETPID) && !defined(WOLFSSL_NO_GETPID) && \

    !defined(WOLFSSL_NO_MALLOC) && !defined(HAVE_ENTROPY_MEMUSE) && \

    !defined(WOLFSSL_STATIC_MEMORY) && !defined(WOLFSSL_CHECK_MEM_ZERO) && \

    !defined(WOLFSSL_TRACK_MEMORY) && !defined(WOLFSSL_MEM_FAIL_COUNT)

    #define WC_RNG_LOCK_ATFORK

#else

    #undef WC_RNG_LOCK_ATFORK

#endif

#ifdef __cplusplus

    extern "C" {

#endif

#if FIPS_VERSION3_GE(6,0,0)

    extern const unsigned int wolfCrypt_FIPS_drbg_ro_sanity[2];

    WOLFSSL_LOCAL int wolfCrypt_FIPS_DRBG_sanity(void);

#endif

/***** Setup for RNG extra features *****/

#if (defined(WC_RNG_EXTRAS) || defined(WC_RNG_WANT_LOCK)) && \

    !defined(WC_RNG_NO_LOCK) && !defined(WC_NO_RNG)

    #define WC_RNG_HAVE_LOCK

    #ifdef WOLFSSL_NO_ATOMICS

        typedef word32 WC_RNG_lock_t;

        typedef word32 WC_RNG_lock_arg_t;

    #else

        typedef wolfSSL_Atomic_Uint WC_RNG_lock_t;

        typedef WC_ATOMIC_UINT_ARG WC_RNG_lock_arg_t;

    #endif

#else

    #undef WC_RNG_HAVE_LOCK

#endif

#if defined(WC_RNG_WANT_LOCK_FULL_MUTEX) && !defined(WC_NO_RNG)

    #ifndef WC_RNG_HAVE_LOCK

        #error FULL_MUTEX depends on WC_RNG_HAVE_LOCK.

    #endif

    #define WC_RNG_HAVE_LOCK_FULL_MUTEX

#else

    #undef WC_RNG_HAVE_LOCK_FULL_MUTEX

#endif

#if (defined(WC_RNG_EXTRAS) || defined(WC_RNG_WANT_RBGC)) && \

    !defined(WC_RNG_NO_RBGC) && defined(HAVE_HASHDRBG) && \

    !defined(CUSTOM_RAND_GENERATE_BLOCK) && !defined(WC_NO_RNG)

    #define WC_RNG_HAVE_RBGC

#else

    #undef WC_RNG_HAVE_RBGC

#endif

#if (defined(WC_RNG_EXTRAS) || defined(WC_RNG_WANT_NEXT_SEED)) && \

    !defined(WC_RNG_NO_NEXT_SEED) && defined(HAVE_HASHDRBG) && \

    !defined(CUSTOM_RAND_GENERATE_BLOCK) && !defined(WC_NO_RNG)

    #define WC_RNG_HAVE_NEXT_SEED

    #ifdef WOLFSSL_NO_ATOMICS

        typedef sword32 WC_DRBG_nextSeedLen_t;

    #else

        typedef wolfSSL_Atomic_Int WC_DRBG_nextSeedLen_t;

    #endif

#else

    #undef WC_RNG_HAVE_NEXT_SEED

#endif

#if defined(WC_RNG_HAVE_NEXT_SEED) && !defined(WC_RNG_HAVE_LOCK) && \

    defined(HAVE_FIPS)

    /* FIPS builds: pregenerated output requires the full invalidation/purge

     * protocol, which rides the lock facility. */

    #error WC_RNG_WANT_NEXT_SEED requires WC_RNG_WANT_LOCK in FIPS builds.

#endif

#if (defined(WC_RNG_EXTRAS) || defined(WC_RNG_WANT_POOL)) && \

    !defined(WC_RNG_NO_POOL) && !defined(WC_NO_RNG)

    #define WC_RNG_HAVE_POOL

    #ifdef WOLFSSL_NO_ATOMICS

        typedef word32 WC_RNG_pool_pos_t;

    #else

        typedef wolfSSL_Atomic_Uint WC_RNG_pool_pos_t;

    #endif

#else

    #undef WC_RNG_HAVE_POOL

#endif

#if defined(WC_RNG_HAVE_POOL) && !defined(WC_RNG_HAVE_LOCK) && \

    defined(HAVE_FIPS)

    /* FIPS builds: pregenerated output requires the full invalidation/purge

     * protocol, which rides the lock facility. */

    #error WC_RNG_WANT_POOL requires WC_RNG_WANT_LOCK in FIPS builds.

#endif

#if (defined(WC_RNG_EXTRAS) || defined(WC_RNG_WANT_FREE_HOOK)) && \

    !defined(WC_RNG_NO_FREE_HOOK) && !defined(WC_NO_RNG)

    #define WC_RNG_HAVE_FREE_HOOK

    struct WC_RNG;

    typedef int (*wc_RNG_free_hook_cb_t)(const struct WC_RNG *rng, void *arg);

#else

    #undef WC_RNG_HAVE_FREE_HOOK

#endif

#ifdef WC_RNG_NO_BANKREF_SUPPORT

    #undef WC_RNG_WANT_BANKREF_SUPPORT

#endif

#if defined(WC_RNG_WANT_BANKREF_SUPPORT) && !defined(WC_NO_RNG)

    #if defined(HAVE_FIPS) && \

        !defined(WOLFSSL_FIPS_DEV) && !defined(WOLFSSL_EXPERIMENTAL_SETTINGS)

        #error HAVE_FIPS is incompatible with WC_RNG_WANT_BANKREF_SUPPORT.

    #endif

    #ifndef HAVE_WC_RNG_BANK

        #error WC_RNG_WANT_BANKREF_SUPPORT requires HAVE_WC_RNG_BANK.

    #endif

    #define WC_HAVE_RNG_BANKREF

#else

    #undef WC_HAVE_RNG_BANKREF

#endif

#if defined(WC_RNG_HAVE_LOCK) && defined(WC_RNG_HAVE_RBGC) && \

    !defined(WC_NO_RNG)

    #define WC_RNG_HAVE_GLOBAL_FALLBACK_RNG

#endif

#if defined(HAVE_FIPS) && defined(WC_RNG_HAVE_RBGC) && \

    !defined(WC_RNG_HAVE_LOCK)

    /* FIPS SP 800-90C RBGC lineage persistence depends on the lock facility. */

    #error HAVE_FIPS with WC_RNG_WANT_RBGC requires WC_RNG_WANT_LOCK.

#endif

/***** End setup for RNG extra features *****/

 /* Maximum generate block length */

#ifndef RNG_MAX_BLOCK_LEN

    #ifdef HAVE_INTEL_QA

        #define RNG_MAX_BLOCK_LEN 0xFFFFL

    #else

        #define RNG_MAX_BLOCK_LEN 0x10000L

    #endif

#endif

/* Size of the DRBG seed (SHA-256) */

#ifndef DRBG_SEED_LEN

    #define DRBG_SEED_LEN (440/8)

#endif

#ifdef WOLFSSL_DRBG_SHA512

    #define DRBG_SHA512_SEED_LEN (888/8)  /* 111 bytes per SP 800-90A Table 2 */

#endif

#if !defined(CUSTOM_RAND_TYPE)

    /* To maintain compatibility the default is byte */

    #define CUSTOM_RAND_TYPE    byte

#endif

/* make sure Hash DRBG is enabled, unless WC_NO_HASHDRBG is defined

    or CUSTOM_RAND_GENERATE_BLOCK is defined */

#if !defined(WC_NO_HASHDRBG) && !defined(CUSTOM_RAND_GENERATE_BLOCK)

    #undef  HAVE_HASHDRBG

    #define HAVE_HASHDRBG

    #ifndef WC_RESEED_INTERVAL

        #define WC_RESEED_INTERVAL 1000000

    #endif

#endif

/* avoid redefinition of structs */

#if !defined(HAVE_FIPS) || \

    (defined(HAVE_FIPS_VERSION) && (HAVE_FIPS_VERSION >= 2))

/* RNG supports the following sources (in order):

 * 1. CUSTOM_RAND_GENERATE_BLOCK: Defines name of function as RNG source and

 *     bypasses the options below.

 * 2. HAVE_INTEL_RDRAND: Uses the Intel RDRAND if supported by CPU.

 * 3. HAVE_HASHDRBG (requires SHA256 enabled): Uses SHA256 based P-RNG

 *     seeded via wc_GenerateSeed. This is the default source.

 */

 /* Seed source can be overridden by defining one of these:

      CUSTOM_RAND_GENERATE_SEED

      CUSTOM_RAND_GENERATE_SEED_OS

      CUSTOM_RAND_GENERATE */

#if defined(CUSTOM_RAND_GENERATE_BLOCK)

    /* To use define the following:

     * #define CUSTOM_RAND_GENERATE_BLOCK myRngFunc

     * extern int myRngFunc(byte* output, word32 sz);

     */

    #if defined(CUSTOM_RAND_GENERATE_BLOCK) && defined(WOLFSSL_KCAPI)

        #undef  CUSTOM_RAND_GENERATE_BLOCK

        #define CUSTOM_RAND_GENERATE_BLOCK wc_hwrng_generate_block

        WOLFSSL_LOCAL int wc_hwrng_generate_block(byte *output, word32 sz);

    #endif

#elif defined(HAVE_HASHDRBG)

    #ifdef NO_SHA256

        #ifndef WOLFSSL_DRBG_SHA512

            #error "Hash DRBG requires SHA-256 or SHA-512."

        #endif

    #endif /* NO_SHA256 */

    #ifndef NO_SHA256

        #include <wolfssl/wolfcrypt/sha256.h>

    #endif

    #ifdef WOLFSSL_DRBG_SHA512

        #include <wolfssl/wolfcrypt/sha512.h>

    #endif

#elif defined(HAVE_INTEL_RDRAND)

    /* Intel RDRAND or RDSEED */

#elif defined(WOLF_CRYPTO_CB)

    /* Requires registered Crypto Callback to service RNG, with devId set */

#elif !defined(WC_NO_RNG)

    #error No RNG source defined!

#endif

#ifdef WOLFSSL_ASYNC_CRYPT

    #include <wolfssl/wolfcrypt/async.h>

#endif

#if defined(USE_WINDOWS_API)

    #if defined(_WIN64)

        typedef unsigned __int64 ProviderHandle;

        /* type HCRYPTPROV, avoid #include <windows.h> */

    #else

        typedef unsigned long ProviderHandle;

    #endif

    #ifdef WIN_REUSE_CRYPT_HANDLE

        /* called from wolfCrypt_Init() and wolfCrypt_Cleanup() */

        WOLFSSL_LOCAL int  wc_WinCryptHandleInit(void);

        WOLFSSL_LOCAL void wc_WinCryptHandleCleanup(void);

    #endif

#endif

#ifndef WC_OS_SEED_TYPE_DEFINED

    typedef struct OS_Seed OS_Seed;

    #define WC_OS_SEED_TYPE_DEFINED

#endif

#ifndef WC_RNG_TYPE_DEFINED /* guard on redeclaration */

    typedef struct WC_RNG WC_RNG;

    #ifdef WC_RNG_SEED_CB

        typedef int (*wc_RngSeed_Cb)(OS_Seed* os, byte* seed, word32 sz);

    #endif

    #define WC_RNG_TYPE_DEFINED

#endif

/* OS specific seeder */

struct OS_Seed {

    #if defined(USE_WINDOWS_API)

        ProviderHandle handle;

    #else

        int fd;

    #if defined(WOLFSSL_KEEP_RNG_SEED_FD_OPEN)

        WC_BITFIELD seedFdOpen:1;

        WC_BITFIELD keepSeedFdOpen:1;

    #endif

    #endif

    #if defined(WOLF_CRYPTO_CB)

        int devId;

    #endif

};

#ifdef WC_RNG_HAVE_NEXT_SEED

    /* Length of the DRBG-flavor-independent stir buffer */

    #define WC_RNG_NEXT_STIR_LEN 64

#endif

#ifdef HAVE_HASHDRBG

/* The security strength for the RNG is the target number of bits of

 * entropy you are looking for in a seed. */

/* RNG_SECURITY_STRENGTH is unprefixed for backward compat. */

#ifndef RNG_SECURITY_STRENGTH

    /* SHA-256 requires a minimum of 256-bits of entropy. */

    #define RNG_SECURITY_STRENGTH 256

#endif

/* wolfentropy.h will define for HAVE_ENTROPY_MEMUSE */

#ifdef HAVE_ENTROPY_MEMUSE

    #include <wolfssl/wolfcrypt/wolfentropy.h>

#else

    /* Maximum entropy bits that can be produced. */

    #define MAX_ENTROPY_BITS    256

#endif

/* ENTROPY_SCALE_FACTOR is unprefixed for backward compat. */

#ifndef ENTROPY_SCALE_FACTOR

    /* The entropy scale factor should be the whole number inverse of the

     * minimum bits of entropy per bit of NDRNG output. */

    #if defined(HAVE_AMD_RDSEED)

        /* This will yield a SEED_SZ of 16kb. Since nonceSz will be 0,

         * we'll add an additional 8kb on top.

         *

         * See "AMD RNG ESV Public Use Document".  Version 0.7 of October 24,

         * 2024 specifies 0.656 to 1.312 bits of entropy per 128 bit block of

         * RDSEED output, depending on CPU family.

         */

        #define ENTROPY_SCALE_FACTOR  512

    #elif defined(HAVE_INTEL_RDSEED) || defined(HAVE_INTEL_RDRAND)

        /* The value of 2 applies to Intel's RDSEED which provides about

         * 0.5 bits minimum of entropy per bit. The value of 4 gives a

         * conservative margin for FIPS. */

        #if defined(HAVE_FIPS) && defined(HAVE_FIPS_VERSION) && \

            (HAVE_FIPS_VERSION >= 2)

            #define ENTROPY_SCALE_FACTOR (2*4)

        #else

            /* Not FIPS, but Intel RDSEED, only double. */

            #define ENTROPY_SCALE_FACTOR 2

        #endif

    #elif defined(HAVE_FIPS) && defined(HAVE_FIPS_VERSION) && \

        (HAVE_FIPS_VERSION >= 2)

        /* If doing a FIPS build without a specific scale factor, default

         * to 4. This will give 1024 bits of entropy. More is better, but

         * more is also slower. */

        #define ENTROPY_SCALE_FACTOR 4

    #else

        /* Setting the default to 1. */

        #define ENTROPY_SCALE_FACTOR 1

    #endif

    /* tells test.c the seed-callback known answers apply */

    #define WC_DRBG_ENTROPY_SCALE_FACTOR_DEFAULTED

#endif /* !ENTROPY_SCALE_FACTOR */

/* SEED_BLOCK_SZ is unprefixed for backward compat. */

#ifndef SEED_BLOCK_SZ

    /* The seed block size, is the size of the output of the underlying NDRNG.

     * This value is used for testing the output of the NDRNG. */

    #if defined(HAVE_AMD_RDSEED)

        /* AMD's RDSEED instruction works in 128-bit blocks read 64-bits

        * at a time. */

        #define SEED_BLOCK_SZ (sizeof(word64)*2)

    #elif defined(HAVE_INTEL_RDSEED) || defined(HAVE_INTEL_RDRAND)

        /* RDSEED outputs in blocks of 64-bits. */

        #define SEED_BLOCK_SZ sizeof(word64)

    #else

        /* Setting the default to 4. */

        #define SEED_BLOCK_SZ 4

    #endif

    #define WC_DRBG_SEED_BLOCK_SZ_DEFAULTED

#endif

#define WC_DRBG_SEED_BLOCK_SZ SEED_BLOCK_SZ

/* WC_DRBG_SEED_SZ is the number of bytes of raw entropy gathered from the

 * NDRNG at instantiation and reseed. We deliberately "overseed" beyond the

 * NIST minimum (security_strength bits) to account for entropy sources that

 * may deliver fewer than 1 bit of real entropy per bit of output.  With the

 * default FIPS ENTROPY_SCALE_FACTOR of 4 this yields 256*4/8 = 128 bytes =

 * 1024 bits of raw seed material, guaranteeing at least 256 bits of real

 * entropy even if the source provides only 1 good bit per 4.

 *

 * Hash_df then compresses this seed material into the internal V and C state

 * vectors (seedlen = 440 bits for SHA-256, 888 bits for SHA-512 per

 * SP 800-90A Table 2).

 *

 * In FIPS mode (ENTROPY_SCALE_FACTOR >= 4) the base is already >= 128 bytes

 * which exceeds DRBG_SHA512_SEED_LEN (111), so both DRBGs use the same

 * seed size.  In non-FIPS mode we use the base for both DRBGs so that

 * enabling SHA-512 DRBG does not inflate the per-init entropy cost.

 * SP 800-90A requires only security_strength bits (256 = 32 bytes) of

 * entropy regardless of hash size; hash_df compresses the seed material

 * into the internal V/C state vectors. */

#define WC_DRBG_SEED_SZ_BASE  (RNG_SECURITY_STRENGTH*ENTROPY_SCALE_FACTOR/8)

#if defined(HAVE_FIPS) && defined(WOLFSSL_DRBG_SHA512) && \

    (WC_DRBG_SEED_SZ_BASE < DRBG_SHA512_SEED_LEN)

    #define WC_DRBG_SEED_SZ    DRBG_SHA512_SEED_LEN

#else

    #define WC_DRBG_SEED_SZ    WC_DRBG_SEED_SZ_BASE

#endif

/* The maximum seed size will be the seed size plus a seed block for the

 * test, and an additional half of the seed size. This additional half

 * is in case the user does not supply a nonce. A nonce will be obtained

 * from the NDRNG. FIPS builds draw it from the seed source even when a

 * nonce is supplied. */

#define WC_DRBG_MAX_SEED_SZ    (WC_DRBG_SEED_SZ + WC_DRBG_SEED_SZ/2 + \

                                SEED_BLOCK_SZ)

#ifndef NO_SHA256

    #define RNG_HEALTH_TEST_CHECK_SIZE (WC_SHA256_DIGEST_SIZE * 4)

#endif

#ifdef WOLFSSL_DRBG_SHA512

    #define RNG_HEALTH_TEST_CHECK_SIZE_SHA512 (WC_SHA512_DIGEST_SIZE * 4)

#endif

#define WC_DRBG_SEED_BUF_SIZE (WC_DRBG_SEED_SZ + WC_DRBG_SEED_BLOCK_SZ)

#ifdef WC_RNG_HAVE_NEXT_SEED

    #define WC_DRBG_NEXT_SEED_LEN WC_DRBG_SEED_BUF_SIZE

#endif

#ifndef WC_DRBG_RESEED_CTR_TYPE_DEFINED

#define WC_DRBG_RESEED_CTR_TYPE_DEFINED

    #ifdef WORD64_AVAILABLE

    typedef word64 wc_drbg_reseed_ctr_t;

    #else

    typedef word32 wc_drbg_reseed_ctr_t;

    #endif

#endif

#ifndef NO_SHA256

struct DRBG_internal {

    byte V[DRBG_SEED_LEN];

    byte C[DRBG_SEED_LEN];

    void* heap;

#if defined(WOLFSSL_ASYNC_CRYPT) || defined(WOLF_CRYPTO_CB)

    int devId;

#endif

#ifdef WOLFSSL_SMALL_STACK_CACHE

    wc_Sha256 sha256;

    byte seed_scratch[DRBG_SEED_LEN * 2];

    byte digest_scratch[WC_SHA256_DIGEST_SIZE];

    byte newSeed_buf[WC_DRBG_SEED_BUF_SIZE];

#endif

};

#endif /* !NO_SHA256 */

#ifdef WOLFSSL_DRBG_SHA512

struct DRBG_SHA512_internal {

    byte V[DRBG_SHA512_SEED_LEN];

    byte C[DRBG_SHA512_SEED_LEN];

    void* heap;

#if defined(WOLFSSL_ASYNC_CRYPT) || defined(WOLF_CRYPTO_CB)

    int devId;

#endif

#ifdef WOLFSSL_SMALL_STACK_CACHE

    wc_Sha512 sha512;

    byte seed_scratch[DRBG_SHA512_SEED_LEN * 2];

    byte digest_scratch[WC_SHA512_DIGEST_SIZE];

    byte newSeed_buf[WC_DRBG_SEED_BUF_SIZE];

#endif

};

#endif /* WOLFSSL_DRBG_SHA512 */

#endif /* HAVE_HASHDRBG */

/* DRBG type enum */

#ifdef HAVE_HASHDRBG

enum wc_DrbgType {

    WC_DRBG_SHA256 = 0,

    WC_DRBG_SHA512 = 1

};

#endif

/* RNG health states */

enum wc_RngHealthState {

    WC_DRBG_NOT_INIT =    0,

    WC_DRBG_OK =          1,

    WC_DRBG_FAILED =      2,

    WC_DRBG_CONT_FAILED = 3

};

#define WC_RNG_FLAG_NONE                   0

#define WC_RNG_FLAG_RBGC_NEXT_SEED         (1U << 0)

#define WC_RNG_FLAG_BANKREF                (1U << 1)

#define WC_RNG_FLAG_FULL_MUTEX             (1U << 2)

#define WC_RNG_FLAG_UPGRADE_FROM_NEXT_SEED (1U << 3)

#define WC_RNG_FLAG_FAIL_FAST              (1U << 4)

#define WC_RNG_FLAG_NO_RBGC_PARENT         (1U << 5)

#define WC_RNG_FLAG_ONLY_PRIMARY_SEED      (1U << 6)

#define WC_RNG_FLAG_NO_PRIMARY_SEED        (1U << 7)

/* Bits a caller may change after init, via wc_RNG_{Set,Clear}Flags().  The

 * remainder are structural (set by init or by the module) and refused. */

#define WC_RNG_FLAGS_SETTABLE   (WC_RNG_FLAG_FAIL_FAST | \

                                 WC_RNG_FLAG_ONLY_PRIMARY_SEED | \

                                 WC_RNG_FLAG_NO_PRIMARY_SEED)

#define WC_RNG_FLAGS_CLEARABLE  (WC_RNG_FLAG_FAIL_FAST | \

                                 WC_RNG_FLAG_ONLY_PRIMARY_SEED)

#ifndef WC_RNG_RBGC_USER_SEED_STRATUM

    #define WC_RNG_RBGC_USER_SEED_STRATUM 65536

#endif

wc_static_assert(WC_RNG_RBGC_USER_SEED_STRATUM >= 256);

#if defined(HAVE_FIPS) && !defined(WC_RNG_RBGC_STRATUM_IMMUTABLE)

    #define WC_RNG_RBGC_STRATUM_IMMUTABLE

#endif

#ifdef WC_RNG_WANT_DEBUG_STATS

    #define WC_RNG_DEBUG_STATS

#endif

#if defined(WC_RNG_DEBUG_STATS) && !defined(WC_RNG_HAVE_LOCK) && \

    !defined(WC_NO_RNG)

    #error WC_RNG_DEBUG_STATS requires the RNG lock facility (WC_RNG_WANT_LOCK).

#endif

#ifdef WC_RNG_DEBUG_STATS

    #ifdef WORD64_AVAILABLE

        typedef word64 wc_rng_debug_counter_t;

    #else

        typedef word32 wc_rng_debug_counter_t;

    #endif

#endif

#if ((defined(WOLFSSL_ATOMIC_OPS) && !defined(SINGLE_THREADED) && \

      defined(WORD64_AVAILABLE)) || \

     defined(WC_RNG_WANT_ENTROPY_EPOCH)) && \

    !defined(WC_RNG_NO_ENTROPY_EPOCH) && !defined(WC_NO_RNG)

    #if !defined(WOLFSSL_ATOMIC_OPS) || !defined(WORD64_AVAILABLE)

        #error WC_RNG_HAVE_ENTROPY_EPOCH requires WOLFSSL_ATOMIC_OPS and WORD64_AVAILABLE.

    #endif

    #define WC_RNG_HAVE_ENTROPY_EPOCH

    typedef word64 wc_RNG_entropy_epoch_t;

#endif

/* RNG context */

struct WC_RNG {

    struct OS_Seed seed;

    void* heap;

    byte status;

    word32 flags;

  #ifdef WC_RNG_HAVE_ENTROPY_EPOCH

    wc_RNG_entropy_epoch_t entropy_epoch;

  #endif

    #ifdef WC_RNG_DEBUG_STATS

        wc_rng_debug_counter_t _stats_total_bytes_requested;

        wc_rng_debug_counter_t _stats_total_bytes_produced;

        wc_rng_debug_counter_t _stats_total_requests;

        wc_rng_debug_counter_t _stats_reseeds;

        wc_rng_debug_counter_t _stats_stirs;

        wc_rng_debug_counter_t _stats_seed_failures;

    #endif

#ifdef WC_RNG_HAVE_RBGC

    int RBGCStratum;

    #ifdef WC_RNG_DEBUG_STATS

        wc_rng_debug_counter_t _stats_RBGC_bytes_produced;

        wc_rng_debug_counter_t _stats_RBGC_reseeds;

    #endif

#endif /* WC_RNG_HAVE_RBGC */

#ifdef WC_RNG_HAVE_LOCK

    WC_RNG_lock_t lock;

  #ifdef WC_RNG_HAVE_RBGC

    wolfSSL_Atomic_Uint RBGC_refcount;

    struct WC_RNG *RBGC_parent;

  #endif /* WC_RNG_HAVE_LOCK */

#endif

    /* Both lock facilities use this one mutex, so it is declared once here.

     * The fork handler build holds a wc_ForkLock instead and needs no mutex. */

#if defined(WC_RNG_HAVE_LOCK_FULL_MUTEX) || \

    (defined(WC_RNG_HAVE_AUTO_LOCK) && !defined(WC_RNG_LOCK_ATFORK))

    wolfSSL_Mutex mutex;

#endif

#ifdef WC_RNG_HAVE_LOCK

    #ifdef WC_RNG_DEBUG_STATS

        wc_rng_debug_counter_t _stats_locks_taken;

        wc_rng_debug_counter_t _stats_locks_released;

        wc_rng_debug_counter_t _stats_locks_refused; /* racy */

    #endif

#endif

#ifdef WC_RNG_HAVE_FREE_HOOK

    wc_RNG_free_hook_cb_t free_hook;

    void *free_hook_arg;

#endif

#ifdef WC_RNG_HAVE_POOL

    byte* pool;     /* heap ring; lifecycle arbitrated by poolHead */

    word16 poolSize;

    WC_RNG_pool_pos_t poolHead; /* {state:2, epoch:14, pos:16} -- written by

                                 * writer/purger/allocator/teardown, CAS.

                                 * Survives _InitRng()'s wipe (atomically

                                 * set to the unallocated sentinel). */

    WC_RNG_pool_pos_t poolTail; /* {0, epoch, pos} written by reader only,

                                 * plain. */

    #ifdef WC_RNG_DEBUG_STATS

        wc_rng_debug_counter_t _stats_pool_bytes_produced;

        wc_rng_debug_counter_t _stats_pool_bytes_missed;

    #endif

#endif

#ifdef WC_RNG_HAVE_NEXT_SEED

    byte nextStir[WC_RNG_NEXT_STIR_LEN];

    WC_DRBG_nextSeedLen_t nextStirLen;

#endif

#ifdef WC_RNG_DEBUG_STATS

    #ifdef WC_RNG_HAVE_NEXT_SEED

        wc_rng_debug_counter_t _stats_nextseedsprimary_redeemed;

        wc_rng_debug_counter_t _stats_nextseedsRBGC_redeemed;

        wc_rng_debug_counter_t _stats_nextstirs_redeemed;

        wc_rng_debug_counter_t _stats_nextseedsbanked;

        wc_rng_debug_counter_t _stats_nextstirs_banked;

    #endif

#endif

#ifdef HAVE_HASHDRBG

    /* Common members for DRBG cores, here for safe lock-free access. */

    byte drbgType; /* WC_DRBG_SHA256 or WC_DRBG_SHA512 */

    wc_drbg_reseed_ctr_t reseedCtr; /* SP 800-90A reseed budget */

#ifdef WC_RNG_HAVE_NEXT_SEED

    byte *nextSeed;

    #if defined(WOLFSSL_NO_MALLOC) && !defined(WOLFSSL_STATIC_MEMORY)

    byte nextSeed_data[WC_DRBG_SEED_BUF_SIZE];

    #endif

    WC_DRBG_nextSeedLen_t nextSeedLen;

    #ifdef WC_RNG_HAVE_RBGC

    int nextSeedRBGCStratum;

    #endif

#endif

#endif /* HAVE_HASHDRBG */

#if defined(HAVE_HASHDRBG) || defined(WC_HAVE_RNG_BANKREF)

  #ifdef HAVE_ANONYMOUS_INLINE_AGGREGATES

    union {

  #endif

    #ifdef WC_HAVE_RNG_BANKREF

        struct wc_rng_bank *bankref;

    #endif

    #if defined(HAVE_HASHDRBG) && !defined(NO_SHA256)

      #ifdef HAVE_ANONYMOUS_INLINE_AGGREGATES

        struct {

      #endif

            /* SHA-256 Hash-based Deterministic Random Bit Generator */

            struct DRBG* drbg;

        #if defined(WOLFSSL_NO_MALLOC) && !defined(WOLFSSL_STATIC_MEMORY)

            struct DRBG_internal drbg_data;

        #endif

        #ifdef WOLFSSL_SMALL_STACK_CACHE

            /* SHA-256 scratch buffers -- preallocated by _InitRng(). */

            struct DRBG_internal *drbg_scratch;

            byte *health_check_scratch;

        #endif

      #ifdef HAVE_ANONYMOUS_INLINE_AGGREGATES

        };

      #endif

    #endif /* HAVE_HASHDRBG && !NO_SHA256 */

    #if defined(HAVE_HASHDRBG) && defined(WOLFSSL_DRBG_SHA512)

      #ifdef HAVE_ANONYMOUS_INLINE_AGGREGATES

        struct {

      #endif

            /* SHA-512 Hash-based Deterministic Random Bit Generator */

            struct DRBG_SHA512* drbg512;

        #if defined(WOLFSSL_NO_MALLOC) && !defined(WOLFSSL_STATIC_MEMORY)

            struct DRBG_SHA512_internal drbg512_data;

        #endif

        #ifdef WOLFSSL_SMALL_STACK_CACHE

            /* SHA-512 scratch buffers -- preallocated by _InitRng(). */

            struct DRBG_SHA512_internal *drbg512_scratch;

            byte *health_check_scratch_512;

        #endif

      #ifdef HAVE_ANONYMOUS_INLINE_AGGREGATES

        };

      #endif

    #endif /* HAVE_HASHDRBG && WOLFSSL_DRBG_SHA512 */

  #ifdef HAVE_ANONYMOUS_INLINE_AGGREGATES

    };

  #endif

#endif /* HAVE_HASHDRBG || WC_HAVE_RNG_BANKREF */

#if defined(HAVE_GETPID) && !defined(WOLFSSL_NO_GETPID)

    pid_t pid;

#endif

#ifdef WOLFSSL_ASYNC_CRYPT

    WC_ASYNC_DEV asyncDev;

#endif

#if defined(WOLFSSL_ASYNC_CRYPT) || defined(WOLF_CRYPTO_CB)

    int devId;

#endif

#ifdef WC_RNG_LOCK_ATFORK

    /* NULL until wc_InitRng succeeds.  Initialize only a new or freed WC_RNG:

     * wc_InitRng over a live one leaks this and grows the fork registry that

     * every fork() walks. */

    struct wc_ForkLock* autoLock;   /* defined in wc_port.c */

#elif defined(WC_RNG_HAVE_AUTO_LOCK)

    byte autoLockInited;      /* nonzero once lock exists */

    int autoLockCancel;       /* the holder's cancel state, back on exit */

#endif

};

#define WC_RNG_STATIC_INITIALIZER WC_STATIC_STRUCT_INITIALIZER

#endif /* NO FIPS or have FIPS v2*/

/* NO_OLD_RNGNAME removes RNG struct name to prevent possible type conflicts,

 * can't be used with CTaoCrypt FIPS */

#if !defined(NO_OLD_RNGNAME) && !defined(HAVE_FIPS)

    #define RNG WC_RNG

#endif

WOLFSSL_API int wc_GenerateSeed(OS_Seed* os, byte* output, word32 sz);

#ifndef WC_NO_RNG

/* Note, wc_rng_new*, wc_InitRng*, wc_InitRng_BankRef, wc_FreeRng and

 * wc_rng_free do return unlocked instances, unless a flag-recognizing variant

 * is used and WC_RNG_INIT_FLAG_LOCK_INITIALLY is passed. */

WOLFSSL_ABI WOLFSSL_API WC_RNG* wc_rng_new(byte* nonce, word32 nonceSz,

                                           void* heap);

WOLFSSL_API int wc_rng_new_ex(WC_RNG **rng, byte* nonce, word32 nonceSz,

                              void* heap, int devId);

WOLFSSL_ABI WOLFSSL_API void wc_rng_free(WC_RNG* rng);

WOLFSSL_ABI WOLFSSL_API int  wc_InitRng(WC_RNG* rng);

WOLFSSL_API int  wc_InitRng_ex(WC_RNG* rng, void* heap, int devId);

#if FIPS_VERSION3_GE(7,0,0) && defined(HAVE_HASHDRBG) && \

    defined(BUILDING_WOLFSSL)

/* Fixed seed start for the module's own known answer tests.  seedSz must be

 * over SEED_BLOCK_SZ and no more than WC_DRBG_MAX_SEED_SZ; the leading

 * SEED_BLOCK_SZ bytes are checked but do not reach the DRBG. */

WOLFSSL_LOCAL int wc_InitRngFixedSeed(WC_RNG* rng, const byte* seed,

                                      word32 seedSz);

#endif

WOLFSSL_API int  wc_InitRngNonce(WC_RNG* rng, const byte* nonce, word32 nonceSz);

#define WC_RNG_INIT_FLAG_NONE            0

#define WC_RNG_INIT_FLAG_LOCK_REQUIRED   (1U << 0)

#define WC_RNG_INIT_FLAG_LOCK_INITIALLY  (1U << 1)

#define WC_RNG_INIT_FLAG_USE_FULL_MUTEX  (1U << 2)

#define WC_RNG_INIT_FLAG_UPGRADE_FROM_NEXT_SEED (1U << 3)

#define WC_RNG_INIT_FLAG_USE_AUTO_LOCK   (1U << 4)

#define WC_RNG_INIT_FLAG_NO_AUTO_LOCK    (1U << 5)

#define WC_RNG_INIT_FLAG_PRESERVE_LOCK   (1U << 6)

#define WC_RNG_INIT_FLAG_NO_PRIMARY_SEED (1U << 7)

#define WC_RNG_INIT_FLAG_TEST_USER_SEED  (1U << 8)

#define WC_RNG_INIT_FLAG_FAIL_FAST       (1U << 9)

#define WC_RNG_INIT_FLAG_DRBG_SHA256     (1U << 10)

#define WC_RNG_INIT_FLAG_DRBG_SHA512     (1U << 11)

/* Codes from the seed source or the instance that mean "not now", not

 * "not ever": a caller that can wait may retry the instantiation, reseed or

 * recovery that returned one.  wc_InitRng*() passes these through from the

 * source rather than folding them into RNG_FAILURE_E, and rng_bank.c keys

 * its retry loops on the same set. */

#define WC_RNG_ERR_IS_TRANSIENT(e)                  \

    (((e) == WC_NO_ERR_TRACE(BUSY_E)) ||            \

     ((e) == WC_NO_ERR_TRACE(NOT_READY_E)) ||       \

     ((e) == WC_NO_ERR_TRACE(NEEDS_RECOVERY_E)) ||  \

     ((e) == WC_NO_ERR_TRACE(RAN_BLOCK_E)) ||       \

     ((e) == WC_NO_ERR_TRACE(ENTROPY_RT_E)) ||      \

     ((e) == WC_NO_ERR_TRACE(ENTROPY_APT_E)))

WOLFSSL_API int  wc_InitRng_ex2(WC_RNG* rng, void* heap, int devId,

                                word32 flags);

WOLFSSL_API int  wc_InitRngNonce_ex2(WC_RNG* rng, const byte* nonce, word32 nonceSz,

                                     const byte *perso, word32 persoSz,

                                     void* heap, int devId, word32 flags);

WOLFSSL_API int  wc_InitRngNonce_ex(WC_RNG* rng, const byte* nonce, word32 nonceSz,

                                    void* heap, int devId);

WOLFSSL_API int  wc_InitRngNonce_UserSeed(WC_RNG* rng,

                                          const byte* seed, word32 seedSz,

                                          const byte* nonce, word32 nonceSz,

                                          const byte *perso, word32 persoSz,

                                          void* heap, int devId, word32 flags);

#ifdef WC_RNG_HAVE_GLOBAL_FALLBACK_RNG

WOLFSSL_API int wc_RNG_global_fallback_init(const byte* nonce, word32 nonceSz,

                                     const byte *perso, word32 persoSz,

                                     void* heap, int devId, word32 flags);

WOLFSSL_API int wc_RNG_global_fallback_init_user_seed(const byte* seed, word32 seedSz,

                                              const byte* nonce, word32 nonceSz,

                                              const byte *perso, word32 persoSz,

                                              void* heap, int devId, word32 flags);

WOLFSSL_API int wc_RNG_global_fallback_get(WC_RNG **rng);

WOLFSSL_API int wc_RNG_global_fallback_free(void);

#endif

WOLFSSL_API int wc_RNG_Status(const WC_RNG *rng);

WOLFSSL_ABI WOLFSSL_API int wc_RNG_GenerateBlock(WC_RNG* rng, byte* output, word32 sz);

WOLFSSL_API int  wc_RNG_GenerateByte(WC_RNG* rng, byte* b);

/* Note, when WC_RNG_HAVE_LOCK, wc_FreeRng() takes the instance lock itself, so

 * it mustn't be called with the lock already held (use wc_FreeRng_PreLocked()

 * for that).  A STILL_REFERENCED_E return has persistent side effects:

 * sensitive state is wiped, but the object stays pinned by its RBGC children

 * and must outlive them. */

WOLFSSL_API int  wc_FreeRng(WC_RNG* rng);

#ifdef WC_RNG_HAVE_LOCK

/* Note, caller must hold the instance lock, which is retained on return. */

WOLFSSL_API int  wc_FreeRng_PreLocked(WC_RNG* rng);

#endif

#else

#include <wolfssl/wolfcrypt/error-crypt.h>

#define wc_InitRng(rng) NOT_COMPILED_IN

#define wc_InitRng_ex(rng, h, d) NOT_COMPILED_IN

#define wc_InitRngNonce(rng, n, s) NOT_COMPILED_IN

#define wc_InitRngNonce_ex(rng, n, s, h, d) NOT_COMPILED_IN

#define wc_InitRng_ex2(rng, h, d, f) NOT_COMPILED_IN

#define wc_InitRngNonce_ex2(rng, n, s, p, ps, h, d, f) NOT_COMPILED_IN

#if defined(__ghs__) || defined(WC_NO_RNG_SIMPLE)

/* some older compilers do not like macro function in expression */

#define wc_RNG_GenerateBlock(rng, b, s) NOT_COMPILED_IN

#else

#ifdef _MSC_VER

#define wc_RNG_GenerateBlock(rng, b, s) (int)(NOT_COMPILED_IN)

#else

#define wc_RNG_GenerateBlock(rng, b, s) \

        ({(void)rng; (void)b; (void)s; NOT_COMPILED_IN;})

#endif

#endif

#define wc_RNG_GenerateByte(rng, b) NOT_COMPILED_IN

#define wc_FreeRng(rng) (void)NOT_COMPILED_IN

#endif

#ifdef WOLFSSL_FIPS_EXPORT_LOCAL_APIS

    #define WC_FIPS_LOCAL_API   WOLFSSL_API

#else

    #define WC_FIPS_LOCAL_API   WOLFSSL_LOCAL

#endif

#ifdef WC_RNG_SEED_CB

    WOLFSSL_API int wc_SetSeed_Cb(wc_RngSeed_Cb cb);

#endif

WOLFSSL_API int wc_RNG_GetStatus(const WC_RNG* rng);

WOLFSSL_API int wc_RNG_DRBG_Present(const WC_RNG* rng);

/* Post-init flag policy: only bits in WC_RNG_FLAGS_SETTABLE /

 * WC_RNG_FLAGS_CLEARABLE, only with exclusive ownership (SINGLE_THREADED, or

 * WC_RNG_HAVE_LOCK with the instance _LOCK_REQUIRED and the lease held). */

WOLFSSL_API int wc_RNG_SetFlags(WC_RNG* rng, word32 flags);

WOLFSSL_API int wc_RNG_ClearFlags(WC_RNG* rng, word32 flags);

WOLFSSL_API int wc_RNG_GetFlags(const WC_RNG* rng, word32 *flags);

#ifdef HAVE_HASHDRBG

    WOLFSSL_API int wc_RNG_DRBG_Reseed(WC_RNG* rng, const byte* seed,

                                       word32 seedSz);

    WOLFSSL_API int wc_RNG_DRBG_Reseed_AddIn(WC_RNG* rng, const byte* seed,

                                             word32 seedSz, const byte *addIn,

                                             word32 addInSz);

    /* Capability markers for code compiled against a random.h of uncertain

     * vintage (FIPS builds substitute the module's pinned random.[ch] for

     * the tree's): consumers outside the boundary gate on these rather than

     * on FIPS version arithmetic or on WC_RNG_RBGC_STRATUM_IMMUTABLE. */

    #define WC_RNG_HAVE_STIR

    WOLFSSL_API int wc_RNG_DRBG_Stir(WC_RNG* rng,

                                     const byte* seed,

                                     word32 seedSz);

    WOLFSSL_API int wc_RNG_DRBG_Stir_AddIn(

                                 WC_RNG* rng, const byte* seed, word32 seedSz,

                                 const byte *addIn, word32 addInSz);

    #define WC_RNG_HAVE_RESEED_NOW

    WOLFSSL_API int wc_RNG_DRBG_Reseed_Now(WC_RNG* rng, const byte* addIn,

                                           word32 addInSz);

    WOLFSSL_API int wc_RNG_DRBG_Reseed_Now_Primary(WC_RNG* rng,

                                             const byte* addIn, word32 addInSz);

    WOLFSSL_API int wc_RNG_TestSeed(const byte* seed, word32 seedSz);

#ifdef WC_RNG_HAVE_RBGC

    WOLFSSL_API int wc_RNG_DRBG_GetRBGCStratum(const WC_RNG* rng);

    #ifdef WC_RNG_HAVE_NEXT_SEED

    WOLFSSL_API int wc_RNG_DRBG_GetNextSeedRBGCStratum(const WC_RNG* rng);

    #endif

  #ifdef WC_RNG_HAVE_LOCK

    /* get a racy snapshot of the refcount, e.g. to pre-screen deallocation

     * eligibility. */

    #define WC_RNG_RBGC_REFCOUNT(rng) WOLFSSL_ATOMIC_LOAD((rng)->RBGC_refcount)

  #endif

#endif /* WC_RNG_HAVE_RBGC */

    /* The reseed counter is treated as potentially sensitive internal state --

     * only internal users are allowed. */

    WOLFSSL_LOCAL int wc_RNG_DRBG_GetReseedCtr(const WC_RNG* rng,

                                             wc_drbg_reseed_ctr_t* reseedCtr);

    WOLFSSL_API int wc_RNG_DRBG_ScheduleReseed(WC_RNG* rng);

#ifndef NO_SHA256

    /* SHA-256 Hash_DRBG health test entry points. SHA-512-only builds

     * (NO_SHA256 + WOLFSSL_DRBG_SHA512) use wc_RNG_HealthTest_SHA512_ex

     * declared below. */

    WC_FIPS_LOCAL_API int wc_RNG_HealthTest(int reseed,

                                        const byte* seedA, word32 seedASz,

                                        const byte* seedB, word32 seedBSz,

                                        byte* output, word32 outputSz);

    WC_FIPS_LOCAL_API int wc_RNG_HealthTest_ex(int reseed,

                                        const byte* nonce, word32 nonceSz,

                                        const byte* seedA, word32 seedASz,

                                        const byte* seedB, word32 seedBSz,

                                        byte* output, word32 outputSz,

                                        void* heap, int devId);

#endif /* !NO_SHA256 */

#if !defined(NO_SHA256) && !defined(HAVE_SELFTEST) && \

    (!defined(HAVE_FIPS) || FIPS_VERSION3_GE(7,0,0))

    /* Extended SHA-256 Hash_DRBG health test per SP 800-90A.

     * Flexible output size, prediction resistance, personalization

     * strings, and additional input support. */

    WC_FIPS_LOCAL_API int wc_RNG_HealthTest_SHA256_ex(

                                        int predResistance,

                                        const byte* nonce, word32 nonceSz,

                                        const byte* persoString,

                                            word32 persoStringSz,

                                        const byte* entropyA,

                                            word32 entropyASz,

                                        const byte* entropyB,

                                            word32 entropyBSz,

                                        const byte* entropyC,

                                            word32 entropyCsz,

                                        const byte* additionalA,

                                            word32 additionalASz,

                                        const byte* additionalB,

                                            word32 additionalBSz,

                                        const byte* additionalReseed,

                                            word32 additionalReseedSz,

                                        byte* output, word32 outputSz,

                                        void* heap, int devId);

#endif /* !NO_SHA256 && !HAVE_SELFTEST && FIPS v7+ */

#if defined(WOLFSSL_DRBG_SHA512) && !defined(HAVE_SELFTEST) && \

    (!defined(HAVE_FIPS) || FIPS_VERSION3_GE(7,0,0))

    WC_FIPS_LOCAL_API int wc_RNG_HealthTest_SHA512(int reseed,

                                        const byte* seedA, word32 seedASz,

                                        const byte* seedB, word32 seedBSz,

                                        byte* output, word32 outputSz);

    WC_FIPS_LOCAL_API int wc_RNG_HealthTest_SHA512_ex(int reseed,

                                        const byte* nonce, word32 nonceSz,

                                        const byte* persoString,

                                            word32 persoStringSz,

                                        const byte* seedA, word32 seedASz,

                                        const byte* seedB, word32 seedBSz,

                                        const byte* additionalA,

                                            word32 additionalASz,

                                        const byte* additionalB,

                                            word32 additionalBSz,

                                        byte* output, word32 outputSz,

                                        void* heap, int devId);

    /* Extended SHA-512 Hash_DRBG health test per SP 800-90A.

     * Flexible output size, prediction resistance support.

     * predResistance=1: additionalA/B go to Reseed per SP 800-90A 9.3.1,

     *                   Generate gets NULL additional input.

     * predResistance=0: additionalReseed goes to Reseed, additionalA/B go

     *                   to Generate calls 1 and 2 respectively. */

    WC_FIPS_LOCAL_API int wc_RNG_HealthTest_SHA512_ex2(

                                        int predResistance,

                                        const byte* nonce, word32 nonceSz,

                                        const byte* persoString,

                                            word32 persoStringSz,

                                        const byte* entropyA,

                                            word32 entropyASz,

                                        const byte* entropyB,

                                            word32 entropyBSz,

                                        const byte* entropyC,

                                            word32 entropyCsz,

                                        const byte* additionalA,

                                            word32 additionalASz,

                                        const byte* additionalB,

                                            word32 additionalBSz,

                                        const byte* additionalReseed,

                                            word32 additionalReseedSz,

                                        byte* output, word32 outputSz,

                                        void* heap, int devId);

#endif /* WOLFSSL_DRBG_SHA512 && !HAVE_SELFTEST && FIPS v7+ */

    /* Runtime DRBG disable/enable API */

    WOLFSSL_API int wc_Sha256Drbg_Disable(void);

    WOLFSSL_API int wc_Sha256Drbg_Enable(void);

    WOLFSSL_API int wc_Sha256Drbg_IsDisabled(void);

#ifdef WOLFSSL_DRBG_SHA512

    WOLFSSL_API int wc_Sha512Drbg_Disable(void);

    WOLFSSL_API int wc_Sha512Drbg_Enable(void);

    WOLFSSL_API int wc_Sha512Drbg_IsDisabled(void);

#endif

#endif /* HAVE_HASHDRBG */

#ifdef WC_RNG_HAVE_RBGC

    /* SP 800-90C RBG-chain spawn: instantiate child as a subordinate DRBG

     * seeded from parent's generate output.  The _New variants allocate the

     * child from parent's heap; release them with ordinary wc_rng_free(). */

    WOLFSSL_API int wc_InitRngRBGC(WC_RNG* child, WC_RNG* parent, word32 flags);

    WOLFSSL_API int wc_InitRngNonceRBGC(WC_RNG* child, WC_RNG* parent,

                                        const byte* nonce, word32 nonceSz,

                                        const byte *perso, word32 persoSz,

                                        word32 flags);

    #ifndef WC_NO_CONSTRUCTORS

    /* Flags are per-object (WC_RNG_INIT_FLAG_*), deliberately not

     * inherited from the parent: a child's lock policy is its own. */

    WOLFSSL_API int wc_InitRngRBGC_New(WC_RNG** child, WC_RNG* parent,

                                       word32 flags);

    WOLFSSL_API int wc_InitRngNonceRBGC_New(WC_RNG** child, WC_RNG* parent,

                                            const byte* nonce, word32 nonceSz,

                                            const byte *perso, word32 persoSz,

                                            word32 flags);

    #endif /* !WC_NO_CONSTRUCTORS */

    WOLFSSL_API int wc_RNG_DRBG_ReseedRBGC(WC_RNG* rng, WC_RNG* root,

                                           const byte* addIn, word32 addInSz);

    WOLFSSL_API int wc_RNG_DRBG_StirRBGC(WC_RNG* rng,

                                         WC_RNG* root,

                                         const byte* addIn,

                                         word32 addInSz);

#endif /* WC_RNG_HAVE_RBGC */

#ifdef WC_RNG_HAVE_NEXT_SEED

    #define WC_DRBG_NEXT_SEED_EMPTY 0

    /* All sentinel states are negative; non-negative values are banked byte

     * counts. */

    #define WC_DRBG_NEXT_SEED_PRODUCING (-1)

    #define WC_DRBG_NEXT_SEED_READY     (-2)

    #define WC_DRBG_NEXT_SEED_CONSUMING (-3)

    #define WC_DRBG_NEXT_SEED_PURGED    (-4)

    #define WC_DRBG_NEXT_SEED_TORNDOWN  (-5)

    WOLFSSL_API int wc_RNG_DRBG_NextSeedGenerate(WC_RNG* rng, word32 n);

    WOLFSSL_API int wc_RNG_DRBG_NextSeedGenerate_Primary(WC_RNG* rng, word32 n);

#ifdef WC_RNG_HAVE_RBGC

    WOLFSSL_API int wc_RNG_DRBG_NextSeedGenerate_RBGC(WC_RNG* rng,

                                                      WC_RNG *root,

                                                      word32 n);

#endif

    WOLFSSL_API int wc_RNG_DRBG_NextSeedCurrent(const WC_RNG* rng,

                                                WC_ATOMIC_INT_ARG* n);

    WOLFSSL_API int wc_RNG_DRBG_NextSeedNow_AddIn(WC_RNG* rng,

                                                   const byte* addIn,

                                                   word32 addInSz);

    WOLFSSL_API int wc_RNG_DRBG_NextSeedNow(WC_RNG* rng);

    WOLFSSL_API int wc_RNG_DRBG_NextStirStore(

        WC_RNG* rng, const byte *addIn, word32 addInSz);

    WOLFSSL_API int wc_RNG_DRBG_NextStirNow(WC_RNG* rng);

#endif /* WC_RNG_HAVE_NEXT_SEED */

#ifdef WC_RNG_HAVE_LOCK

    #define WC_RNG_LOCK_FREE 0

    #define WC_RNG_LOCK_HELD (1U<<0)

    #define WC_RNG_LOCK_REQUIRED (1U<<1)

    #define WC_RNG_LOCK_ENTROPY_INVALIDATED (1U<<2)

    #define WC_RNG_LOCK_ENTROPY_RECOVERING (1U<<3)

    /* The lease was held across a fork() by a holder absent in this process:

     * set by the first post-fork contender (wc_RNG_lock_get() and kin report

     * OBJECT_ORPHANED_E), sticky until the instance's owner adopts the lease

     * (wc_FreeRng_PreLocked(), then wc_InitRng_ex2() with

     * WC_RNG_INIT_FLAG_PRESERVE_LOCK) or a surviving holder releases or

     * recovers it, either of which proves the lease live after all. */

    #define WC_RNG_LOCK_ORPHANED (1U<<4)

    /* consumers' annotation bits start here (see e.g. rng_bank.h) */

    #define WC_RNG_LOCK_EXTRA_SHIFT 5U

    WOLFSSL_API int wc_RNG_lock_get(WC_RNG* rng, WC_RNG_lock_arg_t extra_bits);

    WOLFSSL_API int wc_RNG_lock_get_conditional(

        WC_RNG* rng,

        WC_RNG_lock_arg_t expected_extra_bits,

        WC_RNG_lock_arg_t want_extra_bits);

    WOLFSSL_LOCAL int wc_RNG_lock_get_unconditional(WC_RNG* rng);

    WOLFSSL_LOCAL void wc_RNG_lock_put_unconditional(WC_RNG* rng);

    WOLFSSL_API int wc_RNG_lock_put(WC_RNG* rng, WC_RNG_lock_arg_t extra_bits);

    WOLFSSL_API int wc_RNG_lock_put_conditional(

        WC_RNG* rng,

        WC_RNG_lock_arg_t expected_extra_bits,

        WC_RNG_lock_arg_t want_extra_bits);

    WOLFSSL_API int wc_RNG_lock_read(const WC_RNG* rng,

                                     WC_RNG_lock_arg_t* state);

    WOLFSSL_API int wc_RNG_lock_set_extra(WC_RNG* rng,

                                          WC_RNG_lock_arg_t extra_bits);

    WOLFSSL_API int wc_RNG_lock_add_extra(WC_RNG* rng,

                                          WC_RNG_lock_arg_t extra_bits);

    WOLFSSL_API int wc_RNG_lock_clear_extra(WC_RNG* rng,

                                            WC_RNG_lock_arg_t extra_bits);

#endif /* WC_RNG_HAVE_LOCK */

WOLFSSL_API int wc_RNG_invalidate_entropy(WC_RNG* rng);

WOLFSSL_API int wc_RNG_entropy_needs_recovery(WC_RNG* rng);

#ifdef WC_RNG_HAVE_ENTROPY_EPOCH

    struct wc_RNG_entropy_epoch_atomic {

        wolfSSL_Atomic_Uint high;

        wolfSSL_Atomic_Uint low;

    };

    #define WC_RNG_ENTROPY_EPOCH_ATOMIC_INITIALIZER { \

        WOLFSSL_ATOMIC_INITIALIZER(0U), \

        WOLFSSL_ATOMIC_INITIALIZER(1U)  \