File Explorer

1/*2 * Copyright 1995-2025 The OpenSSL Project Authors. All Rights Reserved.3 *4 * Licensed under the Apache License 2.0 (the "License").  You may not use5 * this file except in compliance with the License.  You can obtain a copy6 * in the file LICENSE in the source distribution or at7 * https://www.openssl.org/source/license.html8 */9 10#ifndef OPENSSL_RAND_H11#define OPENSSL_RAND_H12#pragma once13 14#include <openssl/macros.h>15#ifndef OPENSSL_NO_DEPRECATED_3_016#define HEADER_RAND_H17#endif18 19#include <stdlib.h>20#include <openssl/types.h>21#include <openssl/e_os2.h>22#include <openssl/randerr.h>23#include <openssl/evp.h>24 25#ifdef __cplusplus26extern "C" {27#endif28 29/*30 * Default security strength (in the sense of [NIST SP 800-90Ar1])31 *32 * NIST SP 800-90Ar1 supports the strength of the DRBG being smaller than that33 * of the cipher by collecting less entropy. The current DRBG implementation34 * does not take RAND_DRBG_STRENGTH into account and sets the strength of the35 * DRBG to that of the cipher.36 */37#define RAND_DRBG_STRENGTH 25638 39#ifndef OPENSSL_NO_DEPRECATED_3_040struct rand_meth_st {41    int (*seed)(const void *buf, int num);42    int (*bytes)(unsigned char *buf, int num);43    void (*cleanup)(void);44    int (*add)(const void *buf, int num, double randomness);45    int (*pseudorand)(unsigned char *buf, int num);46    int (*status)(void);47};48 49OSSL_DEPRECATEDIN_3_0 int RAND_set_rand_method(const RAND_METHOD *meth);50OSSL_DEPRECATEDIN_3_0 const RAND_METHOD *RAND_get_rand_method(void);51#ifndef OPENSSL_NO_ENGINE52OSSL_DEPRECATEDIN_3_0 int RAND_set_rand_engine(ENGINE *engine);53#endif54 55OSSL_DEPRECATEDIN_3_0 RAND_METHOD *RAND_OpenSSL(void);56#endif /* OPENSSL_NO_DEPRECATED_3_0 */57 58#ifndef OPENSSL_NO_DEPRECATED_1_1_059#define RAND_cleanup() \60    while (0)          \61    continue62#endif63int RAND_bytes(unsigned char *buf, int num);64int RAND_priv_bytes(unsigned char *buf, int num);65 66/*67 * Equivalent of RAND_priv_bytes() but additionally taking an OSSL_LIB_CTX and68 * a strength.69 */70int RAND_priv_bytes_ex(OSSL_LIB_CTX *ctx, unsigned char *buf, size_t num,71    unsigned int strength);72 73/*74 * Equivalent of RAND_bytes() but additionally taking an OSSL_LIB_CTX and75 * a strength.76 */77int RAND_bytes_ex(OSSL_LIB_CTX *ctx, unsigned char *buf, size_t num,78    unsigned int strength);79 80#ifndef OPENSSL_NO_DEPRECATED_1_1_081OSSL_DEPRECATEDIN_1_1_0 int RAND_pseudo_bytes(unsigned char *buf, int num);82#endif83 84EVP_RAND_CTX *RAND_get0_primary(OSSL_LIB_CTX *ctx);85EVP_RAND_CTX *RAND_get0_public(OSSL_LIB_CTX *ctx);86EVP_RAND_CTX *RAND_get0_private(OSSL_LIB_CTX *ctx);87int RAND_set0_public(OSSL_LIB_CTX *ctx, EVP_RAND_CTX *rand);88int RAND_set0_private(OSSL_LIB_CTX *ctx, EVP_RAND_CTX *rand);89 90int RAND_set_DRBG_type(OSSL_LIB_CTX *ctx, const char *drbg, const char *propq,91    const char *cipher, const char *digest);92int RAND_set_seed_source_type(OSSL_LIB_CTX *ctx, const char *seed,93    const char *propq);94 95void RAND_seed(const void *buf, int num);96void RAND_keep_random_devices_open(int keep);97 98#if defined(__ANDROID__) && defined(__NDK_FPABI__)99__NDK_FPABI__ /* __attribute__((pcs("aapcs"))) on ARM */100#endif101    void RAND_add(const void *buf, int num, double randomness);102int RAND_load_file(const char *file, long max_bytes);103int RAND_write_file(const char *file);104const char *RAND_file_name(char *file, size_t num);105int RAND_status(void);106 107#ifndef OPENSSL_NO_EGD108int RAND_query_egd_bytes(const char *path, unsigned char *buf, int bytes);109int RAND_egd(const char *path);110int RAND_egd_bytes(const char *path, int bytes);111#endif112 113int RAND_poll(void);114 115#if defined(_WIN32) && (defined(BASETYPES) || defined(_WINDEF_H))116/* application has to include <windows.h> in order to use these */117#ifndef OPENSSL_NO_DEPRECATED_1_1_0118OSSL_DEPRECATEDIN_1_1_0 void RAND_screen(void);119OSSL_DEPRECATEDIN_1_1_0 int RAND_event(UINT, WPARAM, LPARAM);120#endif121#endif122 123int RAND_set1_random_provider(OSSL_LIB_CTX *ctx, OSSL_PROVIDER *p);124 125/* Which parameter to provider_random call */126#define OSSL_PROV_RANDOM_PUBLIC 0127#define OSSL_PROV_RANDOM_PRIVATE 1128 129#ifdef __cplusplus130}131#endif132 133#endif134