1*de0e0e4dSAntonio Huete Jimenez /* $OpenBSD: rand.h,v 1.23 2022/07/12 14:42:50 kn Exp $ */ 2f5b1c8a1SJohn Marino /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com) 3f5b1c8a1SJohn Marino * All rights reserved. 4f5b1c8a1SJohn Marino * 5f5b1c8a1SJohn Marino * This package is an SSL implementation written 6f5b1c8a1SJohn Marino * by Eric Young (eay@cryptsoft.com). 7f5b1c8a1SJohn Marino * The implementation was written so as to conform with Netscapes SSL. 8f5b1c8a1SJohn Marino * 9f5b1c8a1SJohn Marino * This library is free for commercial and non-commercial use as long as 10f5b1c8a1SJohn Marino * the following conditions are aheared to. The following conditions 11f5b1c8a1SJohn Marino * apply to all code found in this distribution, be it the RC4, RSA, 12f5b1c8a1SJohn Marino * lhash, DES, etc., code; not just the SSL code. The SSL documentation 13f5b1c8a1SJohn Marino * included with this distribution is covered by the same copyright terms 14f5b1c8a1SJohn Marino * except that the holder is Tim Hudson (tjh@cryptsoft.com). 15f5b1c8a1SJohn Marino * 16f5b1c8a1SJohn Marino * Copyright remains Eric Young's, and as such any Copyright notices in 17f5b1c8a1SJohn Marino * the code are not to be removed. 18f5b1c8a1SJohn Marino * If this package is used in a product, Eric Young should be given attribution 19f5b1c8a1SJohn Marino * as the author of the parts of the library used. 20f5b1c8a1SJohn Marino * This can be in the form of a textual message at program startup or 21f5b1c8a1SJohn Marino * in documentation (online or textual) provided with the package. 22f5b1c8a1SJohn Marino * 23f5b1c8a1SJohn Marino * Redistribution and use in source and binary forms, with or without 24f5b1c8a1SJohn Marino * modification, are permitted provided that the following conditions 25f5b1c8a1SJohn Marino * are met: 26f5b1c8a1SJohn Marino * 1. Redistributions of source code must retain the copyright 27f5b1c8a1SJohn Marino * notice, this list of conditions and the following disclaimer. 28f5b1c8a1SJohn Marino * 2. Redistributions in binary form must reproduce the above copyright 29f5b1c8a1SJohn Marino * notice, this list of conditions and the following disclaimer in the 30f5b1c8a1SJohn Marino * documentation and/or other materials provided with the distribution. 31f5b1c8a1SJohn Marino * 3. All advertising materials mentioning features or use of this software 32f5b1c8a1SJohn Marino * must display the following acknowledgement: 33f5b1c8a1SJohn Marino * "This product includes cryptographic software written by 34f5b1c8a1SJohn Marino * Eric Young (eay@cryptsoft.com)" 35f5b1c8a1SJohn Marino * The word 'cryptographic' can be left out if the rouines from the library 36f5b1c8a1SJohn Marino * being used are not cryptographic related :-). 37f5b1c8a1SJohn Marino * 4. If you include any Windows specific code (or a derivative thereof) from 38f5b1c8a1SJohn Marino * the apps directory (application code) you must include an acknowledgement: 39f5b1c8a1SJohn Marino * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)" 40f5b1c8a1SJohn Marino * 41f5b1c8a1SJohn Marino * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND 42f5b1c8a1SJohn Marino * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 43f5b1c8a1SJohn Marino * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 44f5b1c8a1SJohn Marino * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 45f5b1c8a1SJohn Marino * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 46f5b1c8a1SJohn Marino * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 47f5b1c8a1SJohn Marino * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 48f5b1c8a1SJohn Marino * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 49f5b1c8a1SJohn Marino * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 50f5b1c8a1SJohn Marino * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 51f5b1c8a1SJohn Marino * SUCH DAMAGE. 52f5b1c8a1SJohn Marino * 53f5b1c8a1SJohn Marino * The licence and distribution terms for any publically available version or 54f5b1c8a1SJohn Marino * derivative of this code cannot be changed. i.e. this code cannot simply be 55f5b1c8a1SJohn Marino * copied and put under another distribution licence 56f5b1c8a1SJohn Marino * [including the GNU Public Licence.] 57f5b1c8a1SJohn Marino */ 58f5b1c8a1SJohn Marino 59f5b1c8a1SJohn Marino #include <stdlib.h> 60f5b1c8a1SJohn Marino 61f5b1c8a1SJohn Marino #ifndef HEADER_RAND_H 62f5b1c8a1SJohn Marino #define HEADER_RAND_H 63f5b1c8a1SJohn Marino 64f5b1c8a1SJohn Marino #include <openssl/opensslconf.h> 65f5b1c8a1SJohn Marino 66f5b1c8a1SJohn Marino #include <openssl/ossl_typ.h> 67f5b1c8a1SJohn Marino 68f5b1c8a1SJohn Marino #ifdef __cplusplus 69f5b1c8a1SJohn Marino extern "C" { 70f5b1c8a1SJohn Marino #endif 71f5b1c8a1SJohn Marino 72f5b1c8a1SJohn Marino /* Already defined in ossl_typ.h */ 73f5b1c8a1SJohn Marino /* typedef struct rand_meth_st RAND_METHOD; */ 74f5b1c8a1SJohn Marino 75f5b1c8a1SJohn Marino struct rand_meth_st { 76f5b1c8a1SJohn Marino void (*seed)(const void *buf, int num); 77f5b1c8a1SJohn Marino int (*bytes)(unsigned char *buf, int num); 78f5b1c8a1SJohn Marino void (*cleanup)(void); 79f5b1c8a1SJohn Marino void (*add)(const void *buf, int num, double entropy); 80f5b1c8a1SJohn Marino int (*pseudorand)(unsigned char *buf, int num); 81f5b1c8a1SJohn Marino int (*status)(void); 82f5b1c8a1SJohn Marino }; 83f5b1c8a1SJohn Marino 84f5b1c8a1SJohn Marino int RAND_set_rand_method(const RAND_METHOD *meth); 85f5b1c8a1SJohn Marino const RAND_METHOD *RAND_get_rand_method(void); 86f5b1c8a1SJohn Marino #ifndef OPENSSL_NO_ENGINE 87f5b1c8a1SJohn Marino int RAND_set_rand_engine(ENGINE *engine); 88f5b1c8a1SJohn Marino #endif 89f5b1c8a1SJohn Marino RAND_METHOD *RAND_SSLeay(void); 90f5b1c8a1SJohn Marino 91f5b1c8a1SJohn Marino #ifndef LIBRESSL_INTERNAL 92f5b1c8a1SJohn Marino void RAND_cleanup(void ); 93f5b1c8a1SJohn Marino int RAND_bytes(unsigned char *buf, int num); 94f5b1c8a1SJohn Marino int RAND_pseudo_bytes(unsigned char *buf, int num); 95f5b1c8a1SJohn Marino void RAND_seed(const void *buf, int num); 96f5b1c8a1SJohn Marino void RAND_add(const void *buf, int num, double entropy); 97f5b1c8a1SJohn Marino int RAND_load_file(const char *file, long max_bytes); 98f5b1c8a1SJohn Marino int RAND_write_file(const char *file); 99f5b1c8a1SJohn Marino const char *RAND_file_name(char *file, size_t num); 100f5b1c8a1SJohn Marino int RAND_status(void); 101f5b1c8a1SJohn Marino int RAND_poll(void); 102f5b1c8a1SJohn Marino #endif 103f5b1c8a1SJohn Marino 104f5b1c8a1SJohn Marino void ERR_load_RAND_strings(void); 105f5b1c8a1SJohn Marino 106f5b1c8a1SJohn Marino /* Error codes for the RAND functions. (no longer used) */ 107f5b1c8a1SJohn Marino 108f5b1c8a1SJohn Marino /* Function codes. */ 109f5b1c8a1SJohn Marino #define RAND_F_RAND_GET_RAND_METHOD 101 110f5b1c8a1SJohn Marino #define RAND_F_RAND_INIT_FIPS 102 111f5b1c8a1SJohn Marino #define RAND_F_SSLEAY_RAND_BYTES 100 112f5b1c8a1SJohn Marino 113f5b1c8a1SJohn Marino /* Reason codes. */ 114f5b1c8a1SJohn Marino #define RAND_R_DUAL_EC_DRBG_DISABLED 104 115f5b1c8a1SJohn Marino #define RAND_R_ERROR_INITIALISING_DRBG 102 116f5b1c8a1SJohn Marino #define RAND_R_ERROR_INSTANTIATING_DRBG 103 117f5b1c8a1SJohn Marino #define RAND_R_NO_FIPS_RANDOM_METHOD_SET 101 118f5b1c8a1SJohn Marino #define RAND_R_PRNG_NOT_SEEDED 100 119f5b1c8a1SJohn Marino 120f5b1c8a1SJohn Marino #ifdef __cplusplus 121f5b1c8a1SJohn Marino } 122f5b1c8a1SJohn Marino #endif 123f5b1c8a1SJohn Marino #endif 124