ca7eceb37d88e23daabe5485dc777a9a898fc9b5
[openssl.git] / include / openssl / rand.h
1 /*
2  * Copyright 1995-2018 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
24 #ifdef  __cplusplus
25 extern "C" {
26 #endif
27
28 struct rand_meth_st {
29     int (*seed) (const void *buf, int num);
30     int (*bytes) (unsigned char *buf, int num);
31     void (*cleanup) (void);
32     int (*add) (const void *buf, int num, double randomness);
33     int (*pseudorand) (unsigned char *buf, int num);
34     int (*status) (void);
35 };
36
37 int RAND_set_rand_method(const RAND_METHOD *meth);
38 const RAND_METHOD *RAND_get_rand_method(void);
39 # ifndef OPENSSL_NO_ENGINE
40 int RAND_set_rand_engine(ENGINE *engine);
41 # endif
42
43 RAND_METHOD *RAND_OpenSSL(void);
44
45 # if !OPENSSL_API_1_1_0
46 #   define RAND_cleanup() while(0) continue
47 # endif
48 int RAND_bytes(unsigned char *buf, int num);
49 int RAND_priv_bytes(unsigned char *buf, int num);
50 DEPRECATEDIN_1_1_0(int RAND_pseudo_bytes(unsigned char *buf, int num))
51
52 void RAND_seed(const void *buf, int num);
53 void RAND_keep_random_devices_open(int keep);
54
55 # if defined(__ANDROID__) && defined(__NDK_FPABI__)
56 __NDK_FPABI__   /* __attribute__((pcs("aapcs"))) on ARM */
57 # endif
58 void RAND_add(const void *buf, int num, double randomness);
59 int RAND_load_file(const char *file, long max_bytes);
60 int RAND_write_file(const char *file);
61 const char *RAND_file_name(char *file, size_t num);
62 int RAND_status(void);
63
64 # ifndef OPENSSL_NO_EGD
65 int RAND_query_egd_bytes(const char *path, unsigned char *buf, int bytes);
66 int RAND_egd(const char *path);
67 int RAND_egd_bytes(const char *path, int bytes);
68 # endif
69
70 int RAND_poll(void);
71
72 # if defined(_WIN32) && (defined(BASETYPES) || defined(_WINDEF_H))
73 /* application has to include <windows.h> in order to use these */
74 DEPRECATEDIN_1_1_0(void RAND_screen(void))
75 DEPRECATEDIN_1_1_0(int RAND_event(UINT, WPARAM, LPARAM))
76 # endif
77
78
79 #ifdef  __cplusplus
80 }
81 #endif
82
83 #endif