include/library/crandom.hpp

   1 #ifndef _library__random__hpp__included__
   2 #define _library__random__hpp__included__
   3
   4 #include <cstdlib>
   5 #include <cstdint>
   6
   7 namespace crandom
   8 {
   9 /**
  10  * Initialize random number generator.
  11  *
  12  * Throws std::runtime_error: Can't initialize RNG.
  13  */
  14         void init();
  15 /**
  16  * Generate random bits. Automatically initializes the generator if not already initialized.
  17  *
  18  * Parameter buffer: The buffer to fill.
  19  * Parameter buffersize: Number of bytes to fill.
  20  * Throws std::runtime_error: Can't initialize RNG.
  21  */
  22         void generate(void* buffer, size_t buffersize);
  23 /**
  24  * Get random number from arch-specific RNG.
  25  *
  26  * Returns: Random number, or 0 if not supported.
  27  *
  28  * Note: Beware, the random numbers might be weak.
  29  */
  30         uint64_t arch_get_random();
  31 /**
  32  * Get processor TSC.
  33  *
  34  * Returns: TSC, or 0 if not supported.
  35  */
  36         uint64_t arch_get_tsc();
  37 }
  38
  39 #endif