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

#include <rdseed.h>

Inheritance diagram for Botan::Intel_Rdseed:
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 rdseed instruction first introduced on Intel's Broadwell architecture.

Definition at line 19 of file rdseed.h.

Member Function Documentation

◆ create()

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 63 of file entropy_srcs.cpp.

References BOTAN_UNUSED, Botan::Entropy_Source::name(), and Botan::OS::running_in_privileged_state().

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

64  {
65 #if defined(BOTAN_HAS_SYSTEM_RNG)
66  if(name == "system_rng" || name == "win32_cryptoapi")
67  {
68  return std::unique_ptr<Entropy_Source>(new System_RNG_EntropySource);
69  }
70 #endif
71 
72 #if defined(BOTAN_HAS_ENTROPY_SRC_RDRAND)
73  if(name == "rdrand")
74  {
75  return std::unique_ptr<Entropy_Source>(new Intel_Rdrand);
76  }
77 #endif
78 
79 #if defined(BOTAN_HAS_ENTROPY_SRC_RDSEED)
80  if(name == "rdseed")
81  {
82  return std::unique_ptr<Entropy_Source>(new Intel_Rdseed);
83  }
84 #endif
85 
86 #if defined(BOTAN_HAS_ENTROPY_SRC_GETENTROPY)
87  if(name == "getentropy")
88  {
89  return std::unique_ptr<Entropy_Source>(new Getentropy);
90  }
91 #endif
92 
93 #if defined(BOTAN_HAS_ENTROPY_SRC_DEV_RANDOM)
94  if(name == "dev_random")
95  {
96  return std::unique_ptr<Entropy_Source>(new Device_EntropySource(BOTAN_SYSTEM_RNG_POLL_DEVICES));
97  }
98 #endif
99 
100 #if defined(BOTAN_HAS_ENTROPY_SRC_PROC_WALKER)
101  if(name == "proc_walk" && OS::running_in_privileged_state() == false)
102  {
103  const std::string root_dir = BOTAN_ENTROPY_PROC_FS_PATH;
104  if(!root_dir.empty())
105  return std::unique_ptr<Entropy_Source>(new ProcWalking_EntropySource(root_dir));
106  }
107 #endif
108 
109 #if defined(BOTAN_HAS_ENTROPY_SRC_WIN32)
110  if(name == "system_stats")
111  {
112  return std::unique_ptr<Entropy_Source>(new Win32_EntropySource);
113  }
114 #endif
115 
117  return std::unique_ptr<Entropy_Source>();
118  }
virtual std::string name() const =0
bool running_in_privileged_state()
Definition: os_utils.cpp:83
#define BOTAN_UNUSED(...)
Definition: assert.h:142

◆ name()

std::string Botan::Intel_Rdseed::name ( ) const
inlineoverridevirtual
Returns
name identifying this entropy source

Implements Botan::Entropy_Source.

Definition at line 22 of file rdseed.h.

22 { return "rdseed"; }

◆ poll()

size_t Botan::Intel_Rdseed::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 18 of file rdseed.cpp.

19  {
20  if(CPUID::has_rdseed())
21  {
22  for(size_t p = 0; p != BOTAN_ENTROPY_INTEL_RNG_POLLS; ++p)
23  {
24  for(size_t i = 0; i != BOTAN_ENTROPY_RDSEED_RETRIES; ++i)
25  {
26  uint32_t r = 0;
27 
28 #if defined(BOTAN_USE_GCC_INLINE_ASM)
29  int cf = 0;
30 
31  // Encoding of rdseed %eax
32  asm(".byte 0x0F, 0xC7, 0xF8; adcl $0,%1" :
33  "=a" (r), "=r" (cf) : "0" (r), "1" (cf) : "cc");
34 #else
35  int cf = _rdseed32_step(&r);
36 #endif
37  if(1 == cf)
38  {
39  rng.add_entropy_T(r);
40  break;
41  }
42  }
43  }
44  }
45 
46  return 0;
47  }

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