stateful_rng.cpp

Go to the documentation of this file.

/*
* (C) 2016,2020 Jack Lloyd
*
* Botan is released under the Simplified BSD License (see license.txt)
*/
 
#include <botan/stateful_rng.h>
 
#include <botan/assert.h>
#include <botan/exceptn.h>
#include <botan/internal/os_utils.h>
 
namespace Botan {
 
void Stateful_RNG::clear() {
   const lock_guard_type<recursive_mutex_type> lock(m_mutex);
   m_reseed_counter = 0;
   m_last_pid = 0;
   clear_state();
}
 
void Stateful_RNG::force_reseed() {
   const lock_guard_type<recursive_mutex_type> lock(m_mutex);
   m_reseed_counter = 0;
}
 
bool Stateful_RNG::is_seeded() const {
   const lock_guard_type<recursive_mutex_type> lock(m_mutex);
   return m_reseed_counter > 0;
}
 
void Stateful_RNG::initialize_with(std::span<const uint8_t> input) {
   const lock_guard_type<recursive_mutex_type> lock(m_mutex);
 
   clear();
   add_entropy(input);
}
 
void Stateful_RNG::generate_batched_output(std::span<uint8_t> output, std::span<const uint8_t> input) {
   BOTAN_ASSERT_NOMSG(!output.empty());
 
   const size_t max_per_request = max_number_of_bytes_per_request();
 
   if(max_per_request == 0) {
      // no limit
      reseed_check();
      this->generate_output(output, input);
   } else {
      while(!output.empty()) {
         const size_t this_req = std::min(max_per_request, output.size());
 
         reseed_check();
         this->generate_output(output.subspan(0, this_req), input);
 
         // only include the input for the first iteration
         input = {};
 
         output = output.subspan(this_req);
      }
   }
}
 
void Stateful_RNG::fill_bytes_with_input(std::span<uint8_t> output, std::span<const uint8_t> input) {
   const lock_guard_type<recursive_mutex_type> lock(m_mutex);
 
   if(output.empty()) {
      // Special case for exclusively adding entropy to the stateful RNG.
      this->update(input);
 
      if(8 * input.size() >= security_level()) {
         reset_reseed_counter();
      }
   } else {
      generate_batched_output(output, input);
   }
}
 
size_t Stateful_RNG::reseed_from_sources(Entropy_Sources& srcs, size_t poll_bits) {
   const lock_guard_type<recursive_mutex_type> lock(m_mutex);
 
   const size_t bits_collected = RandomNumberGenerator::reseed_from_sources(srcs, poll_bits);
 
   if(bits_collected >= security_level()) {
      reset_reseed_counter();
   }
 
   return bits_collected;
}
 
void Stateful_RNG::reseed_from_rng(RandomNumberGenerator& rng, size_t poll_bits) {
   const lock_guard_type<recursive_mutex_type> lock(m_mutex);
 
   RandomNumberGenerator::reseed_from_rng(rng, poll_bits);
 
   if(poll_bits >= security_level()) {
      reset_reseed_counter();
   }
}
 
void Stateful_RNG::reset_reseed_counter() {
   // Lock is held whenever this function is called
   m_reseed_counter = 1;
}
 
void Stateful_RNG::reseed_check() {
   // Lock is held whenever this function is called
 
   const uint32_t cur_pid = OS::get_process_id();
 
   const bool fork_detected = (m_last_pid > 0) && (cur_pid != m_last_pid);
 
   if(is_seeded() == false || fork_detected || (m_reseed_interval > 0 && m_reseed_counter >= m_reseed_interval)) {
      m_reseed_counter = 0;
      m_last_pid = cur_pid;
 
      if(m_underlying_rng != nullptr) {
         reseed_from_rng(*m_underlying_rng, security_level());
      }
 
      if(m_entropy_sources != nullptr) {
         reseed_from_sources(*m_entropy_sources, security_level());
      }
 
      if(!is_seeded()) {
         if(fork_detected) {
            throw Invalid_State("Detected use of fork but cannot reseed DRBG");
         } else {
            throw PRNG_Unseeded(name());
         }
      }
   } else {
      BOTAN_ASSERT(m_reseed_counter != 0, "RNG is seeded");
      m_reseed_counter += 1;
   }
}
 
}  // namespace Botan