1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
|
/*
* RandomNumberGenerator
* (C) 1999-2009 Jack Lloyd
*
* Distributed under the terms of the Botan license
*/
#ifndef BOTAN_RANDOM_NUMBER_GENERATOR_H__
#define BOTAN_RANDOM_NUMBER_GENERATOR_H__
#include <botan/entropy_src.h>
#include <botan/exceptn.h>
#include <string>
#include <mutex>
namespace Botan {
/**
* This class represents a random number (RNG) generator object.
*/
class BOTAN_DLL RandomNumberGenerator
{
public:
/**
* Create a seeded and active RNG object for general application use
* Added in 1.8.0
*/
static RandomNumberGenerator* make_rng();
/**
* Create a seeded and active RNG object for general application use
* Added in 1.11.5
*/
static std::unique_ptr<RandomNumberGenerator> make_rng(class Algorithm_Factory& af);
/**
* Randomize a byte array.
* @param output the byte array to hold the random output.
* @param length the length of the byte array output.
*/
virtual void randomize(byte output[], size_t length) = 0;
/**
* Return a random vector
* @param bytes number of bytes in the result
* @return randomized vector of length bytes
*/
secure_vector<byte> random_vec(size_t bytes)
{
secure_vector<byte> output(bytes);
randomize(&output[0], output.size());
return output;
}
/**
* Return a random byte
* @return random byte
*/
byte next_byte()
{
byte out;
this->randomize(&out, 1);
return out;
}
/**
* Check whether this RNG is seeded.
* @return true if this RNG was already seeded, false otherwise.
*/
virtual bool is_seeded() const = 0;
/**
* Clear all internally held values of this RNG.
*/
virtual void clear() = 0;
/**
* Return the name of this object
*/
virtual std::string name() const = 0;
/**
* Seed this RNG using the entropy sources it contains.
* @param bits_to_collect is the number of bits of entropy to
attempt to gather from the entropy sources
*/
virtual void reseed(size_t bits_to_collect) = 0;
/**
* Add entropy to this RNG.
* @param in a byte array containg the entropy to be added
* @param length the length of the byte array in
*/
virtual void add_entropy(const byte in[], size_t length) = 0;
/*
* Never copy a RNG, create a new one
*/
RandomNumberGenerator(const RandomNumberGenerator& rng) = delete;
RandomNumberGenerator& operator=(const RandomNumberGenerator& rng) = delete;
RandomNumberGenerator() {}
virtual ~RandomNumberGenerator() {}
};
/**
* Null/stub RNG - fails if you try to use it for anything
*/
class BOTAN_DLL Null_RNG : public RandomNumberGenerator
{
public:
void randomize(byte[], size_t) override { throw PRNG_Unseeded("Null_RNG"); }
void clear() override {}
std::string name() const override { return "Null_RNG"; }
void reseed(size_t) override {}
bool is_seeded() const override { return false; }
void add_entropy(const byte[], size_t) override {}
};
/**
* Wraps access to a RNG in a mutex
*/
class BOTAN_DLL Serialized_RNG : public RandomNumberGenerator
{
public:
void randomize(byte out[], size_t len)
{
std::lock_guard<std::mutex> lock(m_mutex);
m_rng->randomize(out, len);
}
bool is_seeded() const
{
std::lock_guard<std::mutex> lock(m_mutex);
return m_rng->is_seeded();
}
void clear()
{
std::lock_guard<std::mutex> lock(m_mutex);
m_rng->clear();
}
std::string name() const
{
std::lock_guard<std::mutex> lock(m_mutex);
return m_rng->name();
}
void reseed(size_t poll_bits)
{
std::lock_guard<std::mutex> lock(m_mutex);
m_rng->reseed(poll_bits);
}
void add_entropy(const byte in[], size_t len)
{
std::lock_guard<std::mutex> lock(m_mutex);
m_rng->add_entropy(in, len);
}
Serialized_RNG() : m_rng(RandomNumberGenerator::make_rng()) {}
private:
mutable std::mutex m_mutex;
std::unique_ptr<RandomNumberGenerator> m_rng;
};
}
#endif
|
