rand.h 5.6 KB

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