Botan  2.1.0
Crypto and TLS for C++11
Public Member Functions | Static Public Member Functions | List of all members
Botan::Intel_Rdrand Class Referencefinal

#include <rdrand.h>

Inheritance diagram for Botan::Intel_Rdrand:
Botan::Entropy_Source

Public Member Functions

std::string name () const override
 
size_t poll (RandomNumberGenerator &rng) override
 

Static Public Member Functions

static std::unique_ptr< Entropy_Sourcecreate (const std::string &type)
 

Detailed Description

Entropy source using the rdrand instruction first introduced on Intel's Ivy Bridge architecture.

Definition at line 19 of file rdrand.h.

Member Function Documentation

std::unique_ptr< Entropy_Source > Botan::Entropy_Source::create ( const std::string &  type)
staticinherited

Return a new entropy source of a particular type, or null Each entropy source may require substantial resources (eg, a file handle or socket instance), so try to share them among multiple RNGs, or just use the preconfigured global list accessed by Entropy_Sources::global_sources()

Definition at line 45 of file entropy_srcs.cpp.

Referenced by Botan::Entropy_Sources::Entropy_Sources().

46  {
47  if(name == "rdrand")
48  {
49 #if defined(BOTAN_HAS_ENTROPY_SRC_RDRAND)
50  return std::unique_ptr<Entropy_Source>(new Intel_Rdrand);
51 #endif
52  }
53 
54  if(name == "rdseed")
55  {
56 #if defined(BOTAN_HAS_ENTROPY_SRC_RDSEED)
57  return std::unique_ptr<Entropy_Source>(new Intel_Rdseed);
58 #endif
59  }
60 
61  if(name == "darwin_secrandom")
62  {
63 #if defined(BOTAN_HAS_ENTROPY_SRC_DARWIN_SECRANDOM)
64  return std::unique_ptr<Entropy_Source>(new Darwin_SecRandom);
65 #endif
66  }
67 
68  if(name == "getentropy")
69  {
70 #if defined(BOTAN_HAS_ENTROPY_SRC_GETENTROPY)
71  return std::unique_ptr<Entropy_Source>(new Getentropy);
72 #endif
73  }
74 
75  if(name == "dev_random")
76  {
77 #if defined(BOTAN_HAS_ENTROPY_SRC_DEV_RANDOM)
78  return std::unique_ptr<Entropy_Source>(new Device_EntropySource(BOTAN_SYSTEM_RNG_POLL_DEVICES));
79 #endif
80  }
81 
82  if(name == "win32_cryptoapi")
83  {
84 #if defined(BOTAN_HAS_ENTROPY_SRC_CAPI)
85  return std::unique_ptr<Entropy_Source>(new Win32_CAPI_EntropySource("RSA_FULL"));
86 #endif
87  }
88 
89  if(name == "proc_walk")
90  {
91 #if defined(BOTAN_HAS_ENTROPY_SRC_PROC_WALKER)
92  const std::string root_dir = BOTAN_ENTROPY_PROC_FS_PATH;
93  if(!root_dir.empty())
94  return std::unique_ptr<Entropy_Source>(new ProcWalking_EntropySource(root_dir));
95 #endif
96  }
97 
98  if(name == "system_stats")
99  {
100 #if defined(BOTAN_HAS_ENTROPY_SRC_WIN32)
101  return std::unique_ptr<Entropy_Source>(new Win32_EntropySource);
102 #endif
103  }
104 
105  return std::unique_ptr<Entropy_Source>();
106  }
virtual std::string name() const =0
std::string Botan::Intel_Rdrand::name ( ) const
inlineoverridevirtual
Returns
name identifying this entropy source

Implements Botan::Entropy_Source.

Definition at line 22 of file rdrand.h.

22 { return "rdrand"; }
size_t Botan::Intel_Rdrand::poll ( RandomNumberGenerator rng)
overridevirtual

Perform an entropy gathering poll

Parameters
rngwill be provided with entropy via calls to add_entropy
Returns
conservative estimate of actual entropy added to rng during poll

Implements Botan::Entropy_Source.

Definition at line 16 of file rdrand.cpp.

References Botan::RandomNumberGenerator::add_entropy(), and Botan::RDRAND_RNG::randomize().

16  {
17  if(CPUID::has_rdrand() && BOTAN_ENTROPY_INTEL_RNG_POLLS > 0)
18  {
19  RDRAND_RNG rdrand_rng;
20  secure_vector<uint8_t> buf(4 * BOTAN_ENTROPY_INTEL_RNG_POLLS);
21 
22  rdrand_rng.randomize(buf.data(), buf.size());
23  rng.add_entropy(buf.data(), buf.size());
24  }
25 
26  // RDRAND is used but not trusted
27  return 0;
28  }

The documentation for this class was generated from the following files: