Where Online Learning is simpler!

The C and C++ Include Header Files

cat -n /usr/include/openssl/rand.h

     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 use
     5	 * this file except in compliance with the License.  You can obtain a copy
     6	 * in the file LICENSE in the source distribution or at
     7	 * https://www.openssl.org/source/license.html
     8	 */
     9	
    10	#ifndef OPENSSL_RAND_H
    11	#define OPENSSL_RAND_H
    12	#pragma once
    13	
    14	#include <openssl/macros.h>
    15	#ifndef OPENSSL_NO_DEPRECATED_3_0
    16	#define HEADER_RAND_H
    17	#endif
    18	
    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 __cplusplus
    26	extern "C" {
    27	#endif
    28	
    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 that
    33	 * of the cipher by collecting less entropy. The current DRBG implementation
    34	 * does not take RAND_DRBG_STRENGTH into account and sets the strength of the
    35	 * DRBG to that of the cipher.
    36	 */
    37	#define RAND_DRBG_STRENGTH 256
    38	
    39	#ifndef OPENSSL_NO_DEPRECATED_3_0
    40	struct 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	
    49	OSSL_DEPRECATEDIN_3_0 int RAND_set_rand_method(const RAND_METHOD *meth);
    50	OSSL_DEPRECATEDIN_3_0 const RAND_METHOD *RAND_get_rand_method(void);
    51	#ifndef OPENSSL_NO_ENGINE
    52	OSSL_DEPRECATEDIN_3_0 int RAND_set_rand_engine(ENGINE *engine);
    53	#endif
    54	
    55	OSSL_DEPRECATEDIN_3_0 RAND_METHOD *RAND_OpenSSL(void);
    56	#endif /* OPENSSL_NO_DEPRECATED_3_0 */
    57	
    58	#ifndef OPENSSL_NO_DEPRECATED_1_1_0
    59	#define RAND_cleanup() \
    60	    while (0)          \
    61	    continue
    62	#endif
    63	int RAND_bytes(unsigned char *buf, int num);
    64	int RAND_priv_bytes(unsigned char *buf, int num);
    65	
    66	/*
    67	 * Equivalent of RAND_priv_bytes() but additionally taking an OSSL_LIB_CTX and
    68	 * a strength.
    69	 */
    70	int 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 and
    75	 * a strength.
    76	 */
    77	int 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_0
    81	OSSL_DEPRECATEDIN_1_1_0 int RAND_pseudo_bytes(unsigned char *buf, int num);
    82	#endif
    83	
    84	EVP_RAND_CTX *RAND_get0_primary(OSSL_LIB_CTX *ctx);
    85	EVP_RAND_CTX *RAND_get0_public(OSSL_LIB_CTX *ctx);
    86	EVP_RAND_CTX *RAND_get0_private(OSSL_LIB_CTX *ctx);
    87	int RAND_set0_public(OSSL_LIB_CTX *ctx, EVP_RAND_CTX *rand);
    88	int RAND_set0_private(OSSL_LIB_CTX *ctx, EVP_RAND_CTX *rand);
    89	
    90	int RAND_set_DRBG_type(OSSL_LIB_CTX *ctx, const char *drbg, const char *propq,
    91	    const char *cipher, const char *digest);
    92	int RAND_set_seed_source_type(OSSL_LIB_CTX *ctx, const char *seed,
    93	    const char *propq);
    94	
    95	void RAND_seed(const void *buf, int num);
    96	void RAND_keep_random_devices_open(int keep);
    97	
    98	#if defined(__ANDROID__) && defined(__NDK_FPABI__)
    99	__NDK_FPABI__ /* __attribute__((pcs("aapcs"))) on ARM */
   100	#endif
   101	    void RAND_add(const void *buf, int num, double randomness);
   102	int RAND_load_file(const char *file, long max_bytes);
   103	int RAND_write_file(const char *file);
   104	const char *RAND_file_name(char *file, size_t num);
   105	int RAND_status(void);
   106	
   107	#ifndef OPENSSL_NO_EGD
   108	int RAND_query_egd_bytes(const char *path, unsigned char *buf, int bytes);
   109	int RAND_egd(const char *path);
   110	int RAND_egd_bytes(const char *path, int bytes);
   111	#endif
   112	
   113	int 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_0
   118	OSSL_DEPRECATEDIN_1_1_0 void RAND_screen(void);
   119	OSSL_DEPRECATEDIN_1_1_0 int RAND_event(UINT, WPARAM, LPARAM);
   120	#endif
   121	#endif
   122	
   123	int 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 0
   127	#define OSSL_PROV_RANDOM_PRIVATE 1
   128	
   129	#ifdef __cplusplus
   130	}
   131	#endif
   132	
   133	#endif