All headers

Random number generation.

  1. RAND_bytes
  2. RAND_cleanup
  3. Obscure functions
  4. RAND_enable_fork_unsafe_buffering
  5. RAND_reset_for_fuzzing
  6. Deprecated functions
  7. RAND_pseudo_bytes
  8. RAND_seed
  9. RAND_load_file
  10. RAND_file_name
  11. RAND_add
  12. RAND_egd
  13. RAND_poll
  14. RAND_status
  15. rand_meth_st
  16. RAND_SSLeay
  17. RAND_OpenSSL
  18. RAND_get_rand_method
  19. RAND_set_rand_method

RAND_bytes writes len bytes of random data to buf and returns one.

OPENSSL_EXPORT int RAND_bytes(uint8_t *buf, size_t len);

RAND_cleanup frees any resources used by the RNG. This is not safe if other threads might still be calling RAND_bytes.

OPENSSL_EXPORT void RAND_cleanup(void);

Obscure functions.

#if !defined(OPENSSL_WINDOWS)

RAND_enable_fork_unsafe_buffering enables efficient buffered reading of /dev/urandom. It adds an overhead of a few KB of memory per thread. It must be called before the first call to RAND_bytes.

fd must be -1. We no longer support setting the file descriptor with this function.

It has an unusual name because the buffer is unsafe across calls to fork. Hence, this function should never be called by libraries.

OPENSSL_EXPORT void RAND_enable_fork_unsafe_buffering(int fd);

RAND_reset_for_fuzzing resets the fuzzer-only deterministic RNG. This function is only defined in the fuzzer-only build configuration.

OPENSSL_EXPORT void RAND_reset_for_fuzzing(void);

Deprecated functions

RAND_pseudo_bytes is a wrapper around RAND_bytes.

OPENSSL_EXPORT int RAND_pseudo_bytes(uint8_t *buf, size_t len);

RAND_seed reads a single byte of random data to ensure that any file descriptors etc are opened.

OPENSSL_EXPORT void RAND_seed(const void *buf, int num);

RAND_load_file returns a nonnegative number.

OPENSSL_EXPORT int RAND_load_file(const char *path, long num);

RAND_file_name returns NULL.

OPENSSL_EXPORT const char *RAND_file_name(char *buf, size_t num);

RAND_add does nothing.

OPENSSL_EXPORT void RAND_add(const void *buf, int num, double entropy);

RAND_egd returns 255.

OPENSSL_EXPORT int RAND_egd(const char *);

RAND_poll returns one.

OPENSSL_EXPORT int RAND_poll(void);

RAND_status returns one.

OPENSSL_EXPORT int RAND_status(void);

rand_meth_st is typedefed to RAND_METHOD in base.h. It isn't used; it exists only to be the return type of RAND_SSLeay. It's external so that variables of this type can be initialized.

struct rand_meth_st {
  void (*seed) (const void *buf, int num);
  int (*bytes) (uint8_t *buf, size_t num);
  void (*cleanup) (void);
  void (*add) (const void *buf, int num, double entropy);
  int (*pseudorand) (uint8_t *buf, size_t num);
  int (*status) (void);

RAND_SSLeay returns a pointer to a dummy RAND_METHOD.


RAND_OpenSSL returns a pointer to a dummy RAND_METHOD.


RAND_get_rand_method returns RAND_SSLeay().

OPENSSL_EXPORT const RAND_METHOD *RAND_get_rand_method(void);

RAND_set_rand_method returns one.

OPENSSL_EXPORT int RAND_set_rand_method(const RAND_METHOD *);