Botan::Null_RNG Class Reference

#include <rng.h>

Inheritance diagram for Botan::Null_RNG:

Public Member Functions
void	add_entropy (const byte[], size_t)
void	add_entropy_source (EntropySource *es)
void	clear ()
bool	is_seeded () const
std::string	name () const
byte	next_byte ()
secure_vector< byte >	random_vec (size_t bytes)
void	randomize (byte[], size_t)
void	reseed (size_t)

Static Public Member Functions
static RandomNumberGenerator *	make_rng ()

Detailed Description

Null/stub RNG - fails if you try to use it for anything

Definition at line 100 of file rng.h.

Member Function Documentation

void Botan::Null_RNG::add_entropy ( const byte  in[], size_t  length  )

inlinevirtual

Add entropy to this RNG.

Parameters

in	a byte array containg the entropy to be added
length	the length of the byte array in

Implements Botan::RandomNumberGenerator.

Definition at line 109 of file rng.h.

{}

void Botan::Null_RNG::add_entropy_source ( EntropySource *  source )

inlinevirtual

Add this entropy source to the RNG object

Parameters

source

the entropy source which will be retained and used by RNG

Implements Botan::RandomNumberGenerator.

Definition at line 110 of file rng.h.

{ delete es; }

void Botan::Null_RNG::clear ( )

inlinevirtual

Clear all internally held values of this RNG.

Implements Botan::RandomNumberGenerator.

Definition at line 104 of file rng.h.

{}

bool Botan::Null_RNG::is_seeded ( ) const

inlinevirtual

Check whether this RNG is seeded.

Returns

true if this RNG was already seeded, false otherwise.

Reimplemented from Botan::RandomNumberGenerator.

Definition at line 108 of file rng.h.

{ return false; }

RandomNumberGenerator * Botan::RandomNumberGenerator::make_rng ( )

staticinherited

Create a seeded and active RNG object for general application use

Definition at line 29 of file rng.cpp.

   {
#if defined(BOTAN_HAS_AUTO_SEEDING_RNG)
   return new AutoSeeded_RNG;
#endif

   throw Algorithm_Not_Found("RandomNumberGenerator::make_rng - no RNG found");
   }

std::string Botan::Null_RNG::name ( ) const

inlinevirtual

Return the name of this object

Implements Botan::RandomNumberGenerator.

Definition at line 105 of file rng.h.

{ return "Null_RNG"; }

byte Botan::RandomNumberGenerator::next_byte ( )

inherited

Return a random byte

Returns

random byte

Definition at line 19 of file rng.cpp.

References Botan::RandomNumberGenerator::randomize().

Referenced by Botan::random_prime().

   {
   byte out;
   this->randomize(&out, 1);
   return out;
   }

secure_vector<byte> Botan::RandomNumberGenerator::random_vec ( size_t  bytes )

inlineinherited

Return a random vector

Parameters

bytes

number of bytes in the result

Returns

randomized vector of length bytes

Definition at line 40 of file rng.h.

Referenced by Botan::TLS::Client_Key_Exchange::Client_Key_Exchange(), Botan::CryptoBox::encrypt(), Botan::KeyPair::encryption_consistency_check(), Botan::generate_bcrypt(), Botan::OctetString::OctetString(), Botan::BigInt::randomize(), Botan::TLS::Session_Manager_SQLite::Session_Manager_SQLite(), and Botan::KeyPair::signature_consistency_check().

         {
         secure_vector<byte> output(bytes);
         randomize(&output[0], output.size());
         return output;
         }

void Botan::Null_RNG::randomize ( byte  output[], size_t  length  )

inlinevirtual

Randomize a byte array.

Parameters

output	the byte array to hold the random output.
length	the length of the byte array output.

Implements Botan::RandomNumberGenerator.

Definition at line 103 of file rng.h.

{ throw PRNG_Unseeded("Null_RNG"); }

void Botan::Null_RNG::reseed ( size_t  bits_to_collect )

inlinevirtual

Seed this RNG using the entropy sources it contains.

Parameters

bits_to_collect

is the number of bits of entropy to attempt to gather from the entropy sources

Implements Botan::RandomNumberGenerator.

Definition at line 107 of file rng.h.

{}

---

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

• src/rng/rng.h