src/third_party/boringssl/src/include/openssl/rand.h

   1 /* Copyright (c) 2014, Google Inc.
   2  *
   3  * Permission to use, copy, modify, and/or distribute this software for any
   4  * purpose with or without fee is hereby granted, provided that the above
   5  * copyright notice and this permission notice appear in all copies.
   6  *
   7  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
   8  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
   9  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
  10  * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  11  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
  12  * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
  13  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */
  14
  15 #ifndef OPENSSL_HEADER_RAND_H
  16 #define OPENSSL_HEADER_RAND_H
  17
  18 #include <openssl/base.h>
  19
  20 #if defined(__cplusplus)
  21 extern "C" {
  22 #endif
  23
  24
  25 /* RAND_bytes writes |len| bytes of random data to |buf|. It returns one on
  26  * success and zero on otherwise. */
  27 OPENSSL_EXPORT int RAND_bytes(uint8_t *buf, size_t len);
  28
  29 /* RAND_cleanup frees any resources used by the RNG. This is not safe if other
  30  * threads might still be calling |RAND_bytes|. */
  31 OPENSSL_EXPORT void RAND_cleanup(void);
  32
  33
  34 /* Deprecated functions */
  35
  36 /* RAND_pseudo_bytes is a wrapper around |RAND_bytes|. */
  37 OPENSSL_EXPORT int RAND_pseudo_bytes(uint8_t *buf, size_t len);
  38
  39 /* RAND_seed does nothing. */
  40 OPENSSL_EXPORT void RAND_seed(const void *buf, int num);
  41
  42 /* RAND_add does nothing. */
  43 OPENSSL_EXPORT void RAND_add(const void *buf, int num, double entropy);
  44
  45 /* RAND_poll returns one. */
  46 OPENSSL_EXPORT int RAND_poll(void);
  47
  48
  49 #if defined(__cplusplus)
  50 }  /* extern C */
  51 #endif
  52
  53 #endif  /* OPENSSL_HEADER_RAND_H */