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