21753596263

Committed 06 Feb 2026 02:13PM UTC coverage: 90.063% (-0.01%) from 90.073%

Build # 21753596263

Build Type

Pull #5289

github

Committed by

web-flow

Commit Message

Merge 587099284 into 8ea0ca252

Pull Request Pull Request #5289: Further misc header reductions, forward declarations, etc

Run Details

102237 of 113517 relevant lines covered (90.06%)

11402137.11 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

87.5

/src/lib/math/numbertheory/make_prm.cpp

/*
* Prime Generation
* (C) 1999-2007,2018,2019 Jack Lloyd
*
* Botan is released under the Simplified BSD License (see license.txt)
*/

#include <botan/internal/primality.h>

#include <botan/exceptn.h>
#include <botan/numthry.h>
#include <botan/rng.h>
#include <botan/internal/barrett.h>
#include <botan/internal/bit_ops.h>
#include <botan/internal/ct_utils.h>
#include <botan/internal/divide.h>
#include <botan/internal/loadstor.h>

namespace Botan {

namespace {

class Prime_Sieve final {
   public:
      Prime_Sieve(const BigInt& init_value, size_t sieve_size, word step, bool check_2p1) :
            m_sieve(std::min(sieve_size, PRIME_TABLE_SIZE)), m_step(step), m_check_2p1(check_2p1) {
         for(size_t i = 0; i != m_sieve.size(); ++i) {
            m_sieve[i] = ct_mod_word(init_value, PRIMES[i]);
         }
      }

      size_t sieve_size() const { return m_sieve.size(); }

      bool check_2p1() const { return m_check_2p1; }

      bool next() {
         auto passes = CT::Mask<word>::set();
         for(size_t i = 0; i != m_sieve.size(); ++i) {
            m_sieve[i] = sieve_step_incr(m_sieve[i], m_step, PRIMES[i]);

            // If m_sieve[i] == 0 then val % p == 0 -> not prime
            passes &= CT::Mask<word>::expand(m_sieve[i]);

            if(this->check_2p1()) {
               /*
               If v % p == (p-1)/2 then 2*v+1 == 0 (mod p)

               So if potentially generating a safe prime, we want to
               avoid this value because 2*v+1 will certainly not be prime.

               See "Safe Prime Generation with a Combined Sieve" M. Wiener
               https://eprint.iacr.org/2003/186.pdf
               */
               passes &= ~CT::Mask<word>::is_equal(m_sieve[i], (PRIMES[i] - 1) / 2);
            }
         }

         return passes.as_bool();
      }

   private:
      // Return (v + step) % mod
      //
      // This assumes v is already < mod, which is an invariant of the sieve
      static constexpr word sieve_step_incr(word v, word step, word mod) {
         BOTAN_DEBUG_ASSERT(v < mod);
         // The sieve step and primes are public so this modulo is ok
         const word stepmod = (step >= mod) ? (step % mod) : step;

         // This sum is at most 2*(mod-1)
         const word next = (v + stepmod);
         return next - CT::Mask<word>::is_gte(next, mod).if_set_return(mod);
      }

      std::vector<word> m_sieve;
      const word m_step;
      const bool m_check_2p1;
};

#if defined(BOTAN_ENABLE_DEBUG_ASSERTS)

bool no_small_multiples(const BigInt& v, const Prime_Sieve& sieve) {
   const size_t sieve_size = sieve.sieve_size();
   const bool check_2p1 = sieve.check_2p1();

   if(v.is_even())
      return false;

   const BigInt v_x2_p1 = 2 * v + 1;

   for(size_t i = 0; i != sieve_size; ++i) {
      if((v % PRIMES[i]) == 0)
         return false;

      if(check_2p1) {
         if(v_x2_p1 % PRIMES[i] == 0)
            return false;
      }
   }

   return true;
}

#endif

}  // namespace

/*
* Generate a random prime
*/
BigInt random_prime(
   RandomNumberGenerator& rng, size_t bits, const BigInt& coprime, size_t equiv, size_t modulo, size_t prob) {
   if(bits <= 1) {
      throw Invalid_Argument("random_prime: Can't make a prime of " + std::to_string(bits) + " bits");
   }
   if(coprime.is_negative() || (!coprime.is_zero() && coprime.is_even()) || coprime.bits() >= bits) {
      throw Invalid_Argument("random_prime: invalid coprime");
   }
   // TODO(Botan4) reduce this to ~1000
   if(modulo == 0 || modulo >= 100000) {
      throw Invalid_Argument("random_prime: Invalid modulo value");
   }

   equiv %= modulo;

   if(equiv == 0) {
      throw Invalid_Argument("random_prime Invalid value for equiv/modulo");
   }

   // Handle small values:

   if(bits <= 16) {
      if(equiv != 1 || modulo != 2 || coprime != 0) {
         throw Not_Implemented("random_prime equiv/modulo/coprime options not usable for small primes");
      }

      if(bits == 2) {
         return BigInt::from_word(((rng.next_byte() % 2) == 0 ? 2 : 3));
      } else if(bits == 3) {
         return BigInt::from_word(((rng.next_byte() % 2) == 0 ? 5 : 7));
      } else if(bits == 4) {
         return BigInt::from_word(((rng.next_byte() % 2) == 0 ? 11 : 13));
      } else {
         for(;;) {
            // This is slightly biased, but for small primes it does not seem to matter
            uint8_t b[4] = {0};
            rng.randomize(b, 4);
            const size_t idx = load_le<uint32_t>(b, 0) % PRIME_TABLE_SIZE;
            const uint16_t small_prime = PRIMES[idx];

            if(high_bit(small_prime) == bits) {
               return BigInt::from_word(small_prime);
            }
         }
      }
   }

   const size_t MAX_ATTEMPTS = 32 * 1024;

   const size_t mr_trials = miller_rabin_test_iterations(bits, prob, true);

   while(true) {
      BigInt p(rng, bits);

      // Force lowest and two top bits on
      p.set_bit(bits - 1);
      p.set_bit(bits - 2);
      p.set_bit(0);

      // Force p to be equal to equiv mod modulo
      p += (modulo - (p % modulo)) + equiv;

      Prime_Sieve sieve(p, bits, modulo, true);

      for(size_t attempt = 0; attempt <= MAX_ATTEMPTS; ++attempt) {
         p += modulo;

         if(!sieve.next()) {
            continue;
         }

         // here p can be even if modulo is odd, continue on in that case
         if(p.is_even()) {
            continue;
         }

         BOTAN_DEBUG_ASSERT(no_small_multiples(p, sieve));

         auto mod_p = Barrett_Reduction::for_secret_modulus(p);

         if(coprime > 1) {
            /*
            First do a single M-R iteration to quickly eliminate most non-primes,
            before doing the coprimality check which is expensive
            */
            if(!is_miller_rabin_probable_prime(p, mod_p, rng, 1)) {
               continue;
            }

            /*
            * Check if p - 1 and coprime are relatively prime, using gcd.
            * The gcd computation is const-time
            */
            if(gcd(p - 1, coprime) > 1) {
               continue;
            }
         }

         if(p.bits() > bits) {
            break;
         }

         if(!is_miller_rabin_probable_prime(p, mod_p, rng, mr_trials)) {
            continue;
         }

         if(prob > 32 && !is_lucas_probable_prime(p, mod_p)) {
            continue;
         }

         return p;
      }
   }
}

BigInt generate_rsa_prime(RandomNumberGenerator& keygen_rng,
                          RandomNumberGenerator& prime_test_rng,
                          size_t bits,
                          const BigInt& coprime,
                          size_t prob) {
   if(bits < 512) {
      throw Invalid_Argument("generate_rsa_prime bits too small");
   }

   /*
   * The restriction on coprime <= 64 bits is arbitrary but generally speaking
   * very large RSA public exponents are a bad idea both for performance and due
   * to attacks on small d.
   */
   if(coprime <= 1 || coprime.is_even() || coprime.bits() > 64) {
      throw Invalid_Argument("generate_rsa_prime coprime must be small odd positive integer");
   }

   const size_t MAX_ATTEMPTS = 32 * 1024;

   const size_t mr_trials = miller_rabin_test_iterations(bits, prob, true);

   while(true) {
      BigInt p(keygen_rng, bits);

      auto scope = CT::scoped_poison(p);

      /*
      Force high two bits so multiplication always results in expected n bit integer

      Force the two low bits, and step by 4, so the generated prime is always == 3 (mod 4).
      This way when we perform the inversion modulo phi(n) it is always of the form 2*o
      with o odd, which allows a fastpath and avoids leaking any information about the
      structure of the prime.
      */
      p.set_bit(bits - 1);
      p.set_bit(bits - 2);
      p.set_bit(1);
      p.set_bit(0);

      const word step = 4;

      Prime_Sieve sieve(p, bits, step, false);

      for(size_t attempt = 0; attempt <= MAX_ATTEMPTS; ++attempt) {
         p += step;

         if(!sieve.next()) {
            continue;
         }

         BOTAN_DEBUG_ASSERT(no_small_multiples(p, sieve));

         auto mod_p = Barrett_Reduction::for_secret_modulus(p);

         /*
         * Do a single primality test first before checking coprimality, since
         * currently a single Miller-Rabin test is faster than computing gcd,
         * and this eliminates almost all wasted gcd computations.
         */
         if(!is_miller_rabin_probable_prime(p, mod_p, prime_test_rng, 1)) {
            continue;
         }

         /*
         * Check if p - 1 and coprime are relatively prime.
         */
         if(gcd(p - 1, coprime) > 1) {
            continue;
         }

         if(p.bits() > bits) {
            break;
         }

         if(is_miller_rabin_probable_prime(p, mod_p, prime_test_rng, mr_trials)) {
            return p;
         }
      }
   }
}

/*
* Generate a random safe prime
*/
BigInt random_safe_prime(RandomNumberGenerator& rng, size_t bits) {
   if(bits <= 64) {
      throw Invalid_Argument("random_safe_prime: Can't make a prime of " + std::to_string(bits) + " bits");
   }

   const size_t error_bound = 128;

   BigInt q;
   BigInt p;
   for(;;) {
      /*
      Generate q == 2 (mod 3), since otherwise [in the case of q == 1 (mod 3)],
      2*q+1 == 3 (mod 3) and so certainly not prime.
      */
      q = random_prime(rng, bits - 1, BigInt::zero(), 2, 3, error_bound);
      p = (q << 1) + 1;

      if(is_prime(p, rng, error_bound, true)) {
         return p;
      }
   }
}

}  // namespace Botan

1	/*
2	* Prime Generation
3	* (C) 1999-2007,2018,2019 Jack Lloyd
4	*
5	* Botan is released under the Simplified BSD License (see license.txt)
6	*/
7
8	#include <botan/internal/primality.h>
9
10	#include <botan/exceptn.h>
11	#include <botan/numthry.h>
12	#include <botan/rng.h>
13	#include <botan/internal/barrett.h>
14	#include <botan/internal/bit_ops.h>
15	#include <botan/internal/ct_utils.h>
16	#include <botan/internal/divide.h>
17	#include <botan/internal/loadstor.h>
18
19	namespace Botan {
20
21	namespace {
22
23	class Prime_Sieve final {	×
24	public:
25	Prime_Sieve(const BigInt& init_value, size_t sieve_size, word step, bool check_2p1) :	668✔
26	m_sieve(std::min(sieve_size, PRIME_TABLE_SIZE)), m_step(step), m_check_2p1(check_2p1) {	668✔
27	for(size_t i = 0; i != m_sieve.size(); ++i) {	236,329✔
28	m_sieve[i] = ct_mod_word(init_value, PRIMES[i]);	235,661✔
29	}
30	}	668✔
31
32	size_t sieve_size() const { return m_sieve.size(); }
33
34	bool check_2p1() const { return m_check_2p1; }	231,441,727✔
35
36	bool next() {	575,903✔
37	auto passes = CT::Mask<word>::set();	575,903✔
38	for(size_t i = 0; i != m_sieve.size(); ++i) {	232,017,630✔
39	m_sieve[i] = sieve_step_incr(m_sieve[i], m_step, PRIMES[i]);	231,441,727✔
40
41	// If m_sieve[i] == 0 then val % p == 0 -> not prime
42	passes &= CT::Mask<word>::expand(m_sieve[i]);	231,441,727✔
43
44	if(this->check_2p1()) {	231,441,727✔
45	/*
46	If v % p == (p-1)/2 then 2*v+1 == 0 (mod p)
47
48	So if potentially generating a safe prime, we want to
49	avoid this value because 2*v+1 will certainly not be prime.
50
51	See "Safe Prime Generation with a Combined Sieve" M. Wiener
52	https://eprint.iacr.org/2003/186.pdf
53	*/
54	passes &= ~CT::Mask<word>::is_equal(m_sieve[i], (PRIMES[i] - 1) / 2);	206,867,391✔
55	}
56	}
57
58	return passes.as_bool();	575,903✔
59	}
60
61	private:
62	// Return (v + step) % mod
63	//
64	// This assumes v is already < mod, which is an invariant of the sieve
65	static constexpr word sieve_step_incr(word v, word step, word mod) {	231,441,727✔
66	BOTAN_DEBUG_ASSERT(v < mod);	231,441,727✔
67	// The sieve step and primes are public so this modulo is ok
68	const word stepmod = (step >= mod) ? (step % mod) : step;	231,441,727✔
69
70	// This sum is at most 2*(mod-1)
71	const word next = (v + stepmod);	231,441,727✔
72	return next - CT::Mask<word>::is_gte(next, mod).if_set_return(mod);	231,441,727✔
73	}
74
75	std::vector<word> m_sieve;
76	const word m_step;
77	const bool m_check_2p1;
78	};
79
80	#if defined(BOTAN_ENABLE_DEBUG_ASSERTS)
81
82	bool no_small_multiples(const BigInt& v, const Prime_Sieve& sieve) {
83	const size_t sieve_size = sieve.sieve_size();
84	const bool check_2p1 = sieve.check_2p1();
85
86	if(v.is_even())
87	return false;
88
89	const BigInt v_x2_p1 = 2 * v + 1;
90
91	for(size_t i = 0; i != sieve_size; ++i) {
92	if((v % PRIMES[i]) == 0)
93	return false;
94
95	if(check_2p1) {
96	if(v_x2_p1 % PRIMES[i] == 0)
97	return false;
98	}
99	}
100
101	return true;
102	}
103
104	#endif
105
106	} // namespace
107
108	/*
109	* Generate a random prime
110	*/
111	BigInt random_prime(	558✔
112	RandomNumberGenerator& rng, size_t bits, const BigInt& coprime, size_t equiv, size_t modulo, size_t prob) {
113	if(bits <= 1) {	558✔
114	throw Invalid_Argument("random_prime: Can't make a prime of " + std::to_string(bits) + " bits");	8✔
115	}
116	if(coprime.is_negative() \|\| (!coprime.is_zero() && coprime.is_even()) \|\| coprime.bits() >= bits) {	1,113✔
117	throw Invalid_Argument("random_prime: invalid coprime");	×
118	}
119	// TODO(Botan4) reduce this to ~1000
120	if(modulo == 0 \|\| modulo >= 100000) {	556✔
121	throw Invalid_Argument("random_prime: Invalid modulo value");	×
122	}
123
124	equiv %= modulo;	556✔
125
126	if(equiv == 0) {	556✔
127	throw Invalid_Argument("random_prime Invalid value for equiv/modulo");	1✔
128	}
129
130	// Handle small values:
131
132	if(bits <= 16) {	555✔
133	if(equiv != 1 \|\| modulo != 2 \|\| coprime != 0) {	38✔
134	throw Not_Implemented("random_prime equiv/modulo/coprime options not usable for small primes");	×
135	}
136
137	if(bits == 2) {	19✔
138	return BigInt::from_word(((rng.next_byte() % 2) == 0 ? 2 : 3));	2✔
139	} else if(bits == 3) {	18✔
140	return BigInt::from_word(((rng.next_byte() % 2) == 0 ? 5 : 7));	2✔
141	} else if(bits == 4) {	17✔
142	return BigInt::from_word(((rng.next_byte() % 2) == 0 ? 11 : 13));	2✔
143	} else {
144	for(;;) {	12,818✔
145	// This is slightly biased, but for small primes it does not seem to matter
146	uint8_t b[4] = {0};	6,417✔
147	rng.randomize(b, 4);	6,417✔
148	const size_t idx = load_le<uint32_t>(b, 0) % PRIME_TABLE_SIZE;	6,417✔
149	const uint16_t small_prime = PRIMES[idx];	6,417✔
150
151	if(high_bit(small_prime) == bits) {	12,834✔
152	return BigInt::from_word(small_prime);	16✔
153	}
154	}	6,401✔
155	}
156	}
157
158	const size_t MAX_ATTEMPTS = 32 * 1024;	536✔
159
160	const size_t mr_trials = miller_rabin_test_iterations(bits, prob, true);	536✔
161
162	while(true) {	×
163	BigInt p(rng, bits);	536✔
164
165	// Force lowest and two top bits on
166	p.set_bit(bits - 1);	536✔
167	p.set_bit(bits - 2);	536✔
168	p.set_bit(0);	536✔
169
170	// Force p to be equal to equiv mod modulo
171	p += (modulo - (p % modulo)) + equiv;	536✔
172
173	Prime_Sieve sieve(p, bits, modulo, true);	536✔
174
175	for(size_t attempt = 0; attempt <= MAX_ATTEMPTS; ++attempt) {	535,434✔
176	p += modulo;	535,434✔
177
178	if(!sieve.next()) {	535,434✔
179	continue;	534,898✔
180	}
181
182	// here p can be even if modulo is odd, continue on in that case
183	if(p.is_even()) {	15,982✔
184	continue;	359✔
185	}
186
187	BOTAN_DEBUG_ASSERT(no_small_multiples(p, sieve));	7,632✔
188
189	auto mod_p = Barrett_Reduction::for_secret_modulus(p);	7,632✔
190
191	if(coprime > 1) {	7,632✔
192	/*
193	First do a single M-R iteration to quickly eliminate most non-primes,
194	before doing the coprimality check which is expensive
195	*/
196	if(!is_miller_rabin_probable_prime(p, mod_p, rng, 1)) {	×
197	continue;	×
198	}
199
200	/*
201	* Check if p - 1 and coprime are relatively prime, using gcd.
202	* The gcd computation is const-time
203	*/
204	if(gcd(p - 1, coprime) > 1) {	×
205	continue;	×
206	}
207	}
208
209	if(p.bits() > bits) {	7,632✔
210	break;
211	}
212
213	if(!is_miller_rabin_probable_prime(p, mod_p, rng, mr_trials)) {	7,632✔
214	continue;	7,096✔
215	}
216
217	if(prob > 32 && !is_lucas_probable_prime(p, mod_p)) {	536✔
218	continue;	×
219	}
220
221	return p;	536✔
222	}	7,632✔
223	}	536✔
224	}
225
226	BigInt generate_rsa_prime(RandomNumberGenerator& keygen_rng,	132✔
227	RandomNumberGenerator& prime_test_rng,
228	size_t bits,
229	const BigInt& coprime,
230	size_t prob) {
231	if(bits < 512) {	132✔
232	throw Invalid_Argument("generate_rsa_prime bits too small");	×
233	}
234
235	/*
236	* The restriction on coprime <= 64 bits is arbitrary but generally speaking
237	* very large RSA public exponents are a bad idea both for performance and due
238	* to attacks on small d.
239	*/
240	if(coprime <= 1 \|\| coprime.is_even() \|\| coprime.bits() > 64) {	264✔
241	throw Invalid_Argument("generate_rsa_prime coprime must be small odd positive integer");	×
242	}
243
244	const size_t MAX_ATTEMPTS = 32 * 1024;	132✔
245
246	const size_t mr_trials = miller_rabin_test_iterations(bits, prob, true);	132✔
247
248	while(true) {	×
249	BigInt p(keygen_rng, bits);	132✔
250
251	auto scope = CT::scoped_poison(p);	132✔
252
253	/*
254	Force high two bits so multiplication always results in expected n bit integer
255
256	Force the two low bits, and step by 4, so the generated prime is always == 3 (mod 4).
257	This way when we perform the inversion modulo phi(n) it is always of the form 2*o
258	with o odd, which allows a fastpath and avoids leaking any information about the
259	structure of the prime.
260	*/
261	p.set_bit(bits - 1);	132✔
262	p.set_bit(bits - 2);	132✔
263	p.set_bit(1);	132✔
264	p.set_bit(0);	132✔
265
266	const word step = 4;	132✔
267
268	Prime_Sieve sieve(p, bits, step, false);	132✔
269
270	for(size_t attempt = 0; attempt <= MAX_ATTEMPTS; ++attempt) {	40,469✔
271	p += step;	40,469✔
272
273	if(!sieve.next()) {	40,469✔
274	continue;	40,337✔
275	}
276
277	BOTAN_DEBUG_ASSERT(no_small_multiples(p, sieve));	5,509✔
278
279	auto mod_p = Barrett_Reduction::for_secret_modulus(p);	5,509✔
280
281	/*
282	* Do a single primality test first before checking coprimality, since
283	* currently a single Miller-Rabin test is faster than computing gcd,
284	* and this eliminates almost all wasted gcd computations.
285	*/
286	if(!is_miller_rabin_probable_prime(p, mod_p, prime_test_rng, 1)) {	5,509✔
287	continue;	5,377✔
288	}
289
290	/*
291	* Check if p - 1 and coprime are relatively prime.
292	*/
293	if(gcd(p - 1, coprime) > 1) {	264✔
294	continue;	×
295	}
296
297	if(p.bits() > bits) {	132✔
298	break;
299	}
300
301	if(is_miller_rabin_probable_prime(p, mod_p, prime_test_rng, mr_trials)) {	132✔
302	return p;	264✔
303	}
304	}	5,509✔
305	}	264✔
306	}
307
308	/*
309	* Generate a random safe prime
310	*/
311	BigInt random_safe_prime(RandomNumberGenerator& rng, size_t bits) {	2✔
312	if(bits <= 64) {	2✔
313	throw Invalid_Argument("random_safe_prime: Can't make a prime of " + std::to_string(bits) + " bits");	×
314	}
315
316	const size_t error_bound = 128;	2✔
317
318	BigInt q;	2✔
319	BigInt p;	2✔
320	for(;;) {	14✔
321	/*
322	Generate q == 2 (mod 3), since otherwise [in the case of q == 1 (mod 3)],
323	2*q+1 == 3 (mod 3) and so certainly not prime.
324	*/
325	q = random_prime(rng, bits - 1, BigInt::zero(), 2, 3, error_bound);	14✔
326	p = (q << 1) + 1;	28✔
327
328	if(is_prime(p, rng, error_bound, true)) {	14✔
329	return p;	2✔
330	}
331	}
332	}	2✔
333
334	} // namespace Botan

randombit / botan / 21753596263

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous