Security Scol plugin
|
Interface for random number generators. More...
#include <cryptlib.h>
Public Member Functions | |
virtual void | IncorporateEntropy (const byte *input, size_t length) |
Update RNG state with additional unpredictable values. | |
virtual bool | CanIncorporateEntropy () const |
Determines if a generator can accept additional entropy. | |
virtual byte | GenerateByte () |
Generate new random byte and return it. | |
virtual unsigned int | GenerateBit () |
Generate new random bit and return it. | |
virtual word32 | GenerateWord32 (word32 min=0, word32 max=0xffffffffUL) |
Generate a random 32 bit word in the range min to max, inclusive. | |
virtual void | GenerateBlock (byte *output, size_t size) |
Generate random array of bytes. | |
virtual void | GenerateIntoBufferedTransformation (BufferedTransformation &target, const std::string &channel, lword length) |
Generate random bytes into a BufferedTransformation. | |
virtual void | DiscardBytes (size_t n) |
Generate and discard n bytes. | |
template<class IT > | |
void | Shuffle (IT begin, IT end) |
Randomly shuffle the specified array. | |
Public Member Functions inherited from Algorithm | |
Algorithm (bool checkSelfTestStatus=true) | |
Interface for all crypto algorithms. | |
virtual std::string | AlgorithmName () const |
Provides the name of this algorithm. | |
virtual std::string | AlgorithmProvider () const |
Retrieve the provider of this algorithm. | |
Public Member Functions inherited from Clonable | |
virtual Clonable * | Clone () const |
Copies this object. | |
Interface for random number generators.
The library provides a number of random number generators, from software based to hardware based generators.
All generated values are uniformly distributed over the range specified.
Definition at line 1434 of file cryptlib.h.
|
inlinevirtual |
Definition at line 1437 of file cryptlib.h.
|
inlinevirtual |
Determines if a generator can accept additional entropy.
Reimplemented in NIST_DRBG, MersenneTwister< K, M, N, F, S >, RandomPool, and OldRandomPool.
Definition at line 1455 of file cryptlib.h.
|
virtual |
Generate and discard n bytes.
n | the number of bytes to generate and discard |
Reimplemented in Weak1::ARC4_Base, DARN, MersenneTwister< K, M, N, F, S >, PadlockRNG, RDRAND, and RDSEED.
Definition at line 319 of file cryptlib.cpp.
|
virtual |
Generate new random bit and return it.
The default implementation calls GenerateByte() and return its lowest bit.
All generated values are uniformly distributed over the range specified within the the constraints of a particular generator.
Reimplemented in PublicBlumBlumShub.
Definition at line 271 of file cryptlib.cpp.
|
virtual |
Generate random array of bytes.
output | the byte buffer |
size | the length of the buffer, in bytes |
All generated values are uniformly distributed over the range specified within the the constraints of a particular generator.
Reimplemented in Weak1::ARC4_Base, PublicBlumBlumShub, ClassNullRNG, DARN, Hash_DRBG< HASH, STRENGTH, SEEDLENGTH >, HMAC_DRBG< HASH, STRENGTH, SEEDLENGTH >, KDF2_RNG, MersenneTwister< K, M, N, F, S >, PadlockRNG, OldRandomPool, RDRAND, RDSEED, LC_RNG, AdditiveCipherTemplate< BASE >, AdditiveCipherTemplate< AbstractPolicyHolder< AdditiveCipherAbstractPolicy, CTR_ModePolicy > >, and NIST_DRBG.
Definition at line 311 of file cryptlib.cpp.
|
virtual |
Generate new random byte and return it.
Default implementation calls GenerateBlock() with one byte.
All generated values are uniformly distributed over the range specified within the the constraints of a particular generator.
Reimplemented in PublicBlumBlumShub, and OldRandomPool.
Definition at line 276 of file cryptlib.cpp.
|
virtual |
Generate random bytes into a BufferedTransformation.
target | the BufferedTransformation object which receives the bytes |
channel | the channel on which the bytes should be pumped |
length | the number of bytes to generate |
The default implementation calls GenerateBlock() and pumps the result into the DEFAULT_CHANNEL of the target.
All generated values are uniformly distributed over the range specified within the the constraints of a particular generator.
Reimplemented in RandomPool, OldRandomPool, and X917RNG.
Definition at line 324 of file cryptlib.cpp.
Generate a random 32 bit word in the range min to max, inclusive.
min | the lower bound of the range |
max | the upper bound of the range |
The default implementation calls Crop() on the difference between max and min, and then returns the result added to min.
All generated values are uniformly distributed over the range specified within the the constraints of a particular generator.
Reimplemented in MersenneTwister< K, M, N, F, S >, and OldRandomPool.
Definition at line 283 of file cryptlib.cpp.
|
inlinevirtual |
Update RNG state with additional unpredictable values.
input | the entropy to add to the generator |
length | the size of the input buffer |
NotImplemented |
A generator may or may not accept additional entropy. Call CanIncorporateEntropy() to test for the ability to use additional entropy.
If a derived class does not override IncorporateEntropy(), then the base class throws NotImplemented.
Reimplemented in DARN, Hash_DRBG< HASH, STRENGTH, SEEDLENGTH >, HMAC_DRBG< HASH, STRENGTH, SEEDLENGTH >, MersenneTwister< K, M, N, F, S >, PadlockRNG, RandomPool, OldRandomPool, RDRAND, RDSEED, and NIST_DRBG.
Definition at line 1447 of file cryptlib.h.
|
inline |
Randomly shuffle the specified array.
begin | an iterator to the first element in the array |
end | an iterator beyond the last element in the array |
The resulting permutation is uniformly distributed.
Definition at line 1510 of file cryptlib.h.