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

#include <getentropy.h>

Inheritance diagram for Botan::Getentropy:
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 getentropy(2) system call first introduced in OpenBSD 5.6 and added to Solaris 11.3.

Definition at line 19 of file getentropy.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 66 of file entropy_srcs.cpp.

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

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

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

◆ name()

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

Implements Botan::Entropy_Source.

Definition at line 22 of file getentropy.h.

22 { return "getentropy"; }

◆ poll()

size_t Botan::Getentropy::poll ( RandomNumberGenerator rng)
overridevirtual

Gather 256 bytes entropy from getentropy(2). Note that maximum buffer size is limited to 256 bytes. On OpenBSD this does neither block nor fail.

Implements Botan::Entropy_Source.

Definition at line 23 of file getentropy.cpp.

References Botan::RandomNumberGenerator::add_entropy().

24  {
25  secure_vector<uint8_t> buf(256);
26 
27  if(::getentropy(buf.data(), buf.size()) == 0)
28  {
29  rng.add_entropy(buf.data(), buf.size());
30  return buf.size() * 8;
31  }
32 
33  return 0;
34  }

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