• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

randombit / botan / 13258120944

11 Feb 2025 07:48AM UTC coverage: 91.661% (+0.002%) from 91.659%
13258120944

Pull #4647

github

web-flow
Merge 311224e67 into f372b5a9e
Pull Request #4647: Avoid using mem_ops.h or assert.h in public headers

94869 of 103500 relevant lines covered (91.66%)

11332192.06 hits per line

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

96.95
/src/lib/math/bigint/divide.cpp
1
/*
2
* Division Algorithms
3
* (C) 1999-2007,2012,2018,2021 Jack Lloyd
4
*
5
* Botan is released under the Simplified BSD License (see license.txt)
6
*/
7

8
#include <botan/internal/divide.h>
9

10
#include <botan/internal/bit_ops.h>
11
#include <botan/internal/ct_utils.h>
12
#include <botan/internal/mp_core.h>
13

14
namespace Botan {
15

16
namespace {
17

18
/*
19
* Handle signed operands, if necessary
20
*/
21
void sign_fixup(const BigInt& x, const BigInt& y, BigInt& q, BigInt& r) {
351,923✔
22
   q.cond_flip_sign(x.sign() != y.sign());
351,923✔
23

24
   if(x.is_negative() && r.is_nonzero()) {
353,506✔
25
      q -= 1;
1,579✔
26
      r = y.abs() - r;
1,579✔
27
   }
28
}
351,923✔
29

30
inline bool division_check(word q, word y2, word y1, word x3, word x2, word x1) {
2,818,426✔
31
   /*
32
   Compute (y3,y2,y1) = (y2,y1) * q
33
   and return true if (y3,y2,y1) > (x3,x2,x1)
34
   */
35

36
   word y3 = 0;
2,818,426✔
37
   y1 = word_madd2(q, y1, &y3);
2,818,426✔
38
   y2 = word_madd2(q, y2, &y3);
2,818,426✔
39

40
   const word x[3] = {x1, x2, x3};
2,818,426✔
41
   const word y[3] = {y1, y2, y3};
2,818,426✔
42

43
   return bigint_ct_is_lt(x, 3, y, 3).as_bool();
2,818,426✔
44
}
45

46
}  // namespace
47

48
void ct_divide(const BigInt& x, const BigInt& y, BigInt& q_out, BigInt& r_out) {
6,660✔
49
   if(y.is_zero()) {
11,285✔
50
      throw Invalid_Argument("ct_divide: cannot divide by zero");
×
51
   }
52

53
   const size_t x_words = x.sig_words();
6,660✔
54
   const size_t y_words = y.sig_words();
6,660✔
55

56
   const size_t x_bits = x.bits();
6,660✔
57

58
   BigInt q = BigInt::with_capacity(x_words);
6,660✔
59
   BigInt r = BigInt::with_capacity(y_words);
6,660✔
60
   BigInt t = BigInt::with_capacity(y_words);  // a temporary
6,660✔
61

62
   for(size_t i = 0; i != x_bits; ++i) {
6,077,177✔
63
      const size_t b = x_bits - 1 - i;
6,070,517✔
64
      const bool x_b = x.get_bit(b);
6,070,517✔
65

66
      r <<= 1;
6,070,517✔
67
      r.conditionally_set_bit(0, x_b);
6,070,517✔
68

69
      const bool r_gte_y = bigint_sub3(t.mutable_data(), r._data(), r.size(), y._data(), y_words) == 0;
6,070,517✔
70

71
      q.conditionally_set_bit(b, r_gte_y);
6,070,517✔
72
      r.ct_cond_swap(r_gte_y, t);
6,070,517✔
73
   }
74

75
   sign_fixup(x, y, q, r);
6,660✔
76
   r_out = r;
6,660✔
77
   q_out = q;
6,660✔
78
}
6,660✔
79

80
BigInt ct_divide_pow2k(size_t k, const BigInt& y) {
113,105✔
81
   BOTAN_ARG_CHECK(!y.is_zero(), "Cannot divide by zero");
113,483✔
82
   BOTAN_ARG_CHECK(!y.is_negative(), "Negative divisor not supported");
113,105✔
83
   BOTAN_ARG_CHECK(k > 1, "Invalid k");
113,105✔
84

85
   const size_t x_bits = k + 1;
113,105✔
86
   const size_t y_bits = y.bits();
113,105✔
87

88
   if(x_bits < y_bits) {
113,105✔
89
      return BigInt::zero();
252✔
90
   }
91

92
   BOTAN_ASSERT_NOMSG(y_bits >= 1);
112,853✔
93
   const size_t x_words = (x_bits + WordInfo<word>::bits - 1) / WordInfo<word>::bits;
112,853✔
94
   const size_t y_words = y.sig_words();
112,853✔
95

96
   BigInt q = BigInt::with_capacity(x_words);
112,853✔
97
   BigInt r = BigInt::with_capacity(y_words + 1);
112,853✔
98
   BigInt t = BigInt::with_capacity(y_words + 1);  // a temporary
112,853✔
99

100
   r.set_bit(y_bits - 1);
112,853✔
101
   for(size_t i = y_bits - 1; i != x_bits; ++i) {
33,762,936✔
102
      const size_t b = x_bits - 1 - i;
33,650,083✔
103

104
      if(i >= y_bits) {
33,650,083✔
105
         bigint_shl1(r.mutable_data(), r.size(), r.size(), 1);
33,537,230✔
106
      }
107

108
      const bool r_gte_y = bigint_sub3(t.mutable_data(), r._data(), r.size(), y._data(), y_words) == 0;
33,650,083✔
109

110
      q.conditionally_set_bit(b, r_gte_y);
33,650,083✔
111

112
      bigint_cnd_swap(static_cast<word>(r_gte_y), r.mutable_data(), t.mutable_data(), y_words + 1);
33,650,083✔
113
   }
114

115
   // No need for sign fixup
116

117
   return q;
112,853✔
118
}
112,853✔
119

120
void ct_divide_word(const BigInt& x, word y, BigInt& q_out, word& r_out) {
589,717✔
121
   if(y == 0) {
589,717✔
122
      throw Invalid_Argument("ct_divide_word: cannot divide by zero");
×
123
   }
124

125
   const size_t x_words = x.sig_words();
589,717✔
126
   const size_t x_bits = x.bits();
589,717✔
127

128
   BigInt q = BigInt::with_capacity(x_words);
589,717✔
129
   word r = 0;
130

131
   for(size_t i = 0; i != x_bits; ++i) {
58,629,598✔
132
      const size_t b = x_bits - 1 - i;
58,039,881✔
133
      const bool x_b = x.get_bit(b);
58,039,881✔
134

135
      const auto r_carry = CT::Mask<word>::expand_top_bit(r);
58,039,881✔
136

137
      r <<= 1;
58,039,881✔
138
      r += x_b;
58,039,881✔
139

140
      const auto r_gte_y = CT::Mask<word>::is_gte(r, y) | r_carry;
58,039,881✔
141
      q.conditionally_set_bit(b, r_gte_y.as_bool());
58,039,881✔
142
      r = r_gte_y.select(r - y, r);
58,039,881✔
143
   }
144

145
   if(x.is_negative()) {
589,717✔
146
      q.flip_sign();
19✔
147
      if(r != 0) {
19✔
148
         --q;
15✔
149
         r = y - r;
15✔
150
      }
151
   }
152

153
   r_out = r;
589,717✔
154
   q_out = q;
589,717✔
155
}
589,717✔
156

157
BigInt ct_divide_word(const BigInt& x, word y) {
4,333✔
158
   BigInt q;
4,333✔
159
   word r;
4,333✔
160
   ct_divide_word(x, y, q, r);
4,333✔
161
   BOTAN_UNUSED(r);
4,333✔
162
   return q;
4,333✔
163
}
×
164

165
word ct_mod_word(const BigInt& x, word y) {
4,333✔
166
   BOTAN_ARG_CHECK(x.is_positive(), "The argument x must be positive");
4,333✔
167
   BOTAN_ARG_CHECK(y != 0, "Cannot divide by zero");
4,333✔
168

169
   const size_t x_bits = x.bits();
4,333✔
170

171
   word r = 0;
4,333✔
172

173
   for(size_t i = 0; i != x_bits; ++i) {
3,027,571✔
174
      const size_t b = x_bits - 1 - i;
3,023,238✔
175
      const bool x_b = x.get_bit(b);
3,023,238✔
176

177
      const auto r_carry = CT::Mask<word>::expand_top_bit(r);
3,023,238✔
178

179
      r <<= 1;
3,023,238✔
180
      r += x_b;
3,023,238✔
181

182
      const auto r_gte_y = CT::Mask<word>::is_gte(r, y) | r_carry;
3,023,238✔
183
      r = r_gte_y.select(r - y, r);
3,023,238✔
184
   }
185

186
   return r;
4,333✔
187
}
188

189
BigInt ct_modulo(const BigInt& x, const BigInt& y) {
7,059✔
190
   if(y.is_negative() || y.is_zero()) {
14,118✔
191
      throw Invalid_Argument("ct_modulo requires y > 0");
×
192
   }
193

194
   const size_t y_words = y.sig_words();
7,059✔
195

196
   const size_t x_bits = x.bits();
7,059✔
197

198
   BigInt r = BigInt::with_capacity(y_words);
7,059✔
199
   BigInt t = BigInt::with_capacity(y_words);
7,059✔
200

201
   for(size_t i = 0; i != x_bits; ++i) {
9,219,744✔
202
      const size_t b = x_bits - 1 - i;
9,212,685✔
203
      const bool x_b = x.get_bit(b);
9,212,685✔
204

205
      r <<= 1;
9,212,685✔
206
      r.conditionally_set_bit(0, x_b);
9,212,685✔
207

208
      const bool r_gte_y = bigint_sub3(t.mutable_data(), r._data(), r.size(), y._data(), y_words) == 0;
9,212,685✔
209

210
      r.ct_cond_swap(r_gte_y, t);
9,212,685✔
211
   }
212

213
   if(x.is_negative()) {
7,059✔
214
      if(r.is_nonzero()) {
1,312✔
215
         r = y - r;
654✔
216
      }
217
   }
218

219
   return r;
7,059✔
220
}
7,059✔
221

222
/*
223
* Solve x = q * y + r
224
*
225
* See Handbook of Applied Cryptography section 14.2.5
226
*/
227
void vartime_divide(const BigInt& x, const BigInt& y_arg, BigInt& q_out, BigInt& r_out) {
345,263✔
228
   if(y_arg.is_zero()) {
345,340✔
229
      throw Invalid_Argument("vartime_divide: cannot divide by zero");
×
230
   }
231

232
   const size_t y_words = y_arg.sig_words();
345,263✔
233

234
   BOTAN_ASSERT_NOMSG(y_words > 0);
345,263✔
235

236
   BigInt y = y_arg;
345,263✔
237

238
   BigInt r = x;
345,263✔
239
   BigInt q = BigInt::zero();
345,263✔
240
   secure_vector<word> ws;
345,263✔
241

242
   r.set_sign(BigInt::Positive);
345,263✔
243
   y.set_sign(BigInt::Positive);
345,263✔
244

245
   // Calculate shifts needed to normalize y with high bit set
246
   const size_t shifts = y.top_bits_free();
345,263✔
247

248
   y <<= shifts;
345,263✔
249
   r <<= shifts;
345,263✔
250

251
   // we know y has not changed size, since we only shifted up to set high bit
252
   const size_t t = y_words - 1;
345,263✔
253
   const size_t n = std::max(y_words, r.sig_words()) - 1;  // r may have changed size however
690,526✔
254

255
   BOTAN_ASSERT_NOMSG(n >= t);
345,263✔
256

257
   q.grow_to(n - t + 1);
345,263✔
258

259
   word* q_words = q.mutable_data();
345,263✔
260

261
   BigInt shifted_y = y << (WordInfo<word>::bits * (n - t));
345,263✔
262

263
   // Set q_{n-t} to number of times r > shifted_y
264
   q_words[n - t] = r.reduce_below(shifted_y, ws);
345,263✔
265

266
   const word y_t0 = y.word_at(t);
345,263✔
267
   const word y_t1 = y.word_at(t - 1);
345,263✔
268
   BOTAN_DEBUG_ASSERT((y_t0 >> (WordInfo<word>::bits - 1)) == 1);
345,263✔
269

270
   for(size_t j = n; j != t; --j) {
1,754,476✔
271
      const word x_j0 = r.word_at(j);
1,409,213✔
272
      const word x_j1 = r.word_at(j - 1);
1,409,213✔
273
      const word x_j2 = r.word_at(j - 2);
1,409,213✔
274

275
      word qjt = bigint_divop_vartime(x_j0, x_j1, y_t0);
1,409,213✔
276

277
      qjt = CT::Mask<word>::is_equal(x_j0, y_t0).select(WordInfo<word>::max, qjt);
1,409,213✔
278

279
      // Per HAC 14.23, this operation is required at most twice
280
      qjt -= division_check(qjt, y_t0, y_t1, x_j0, x_j1, x_j2);
1,409,213✔
281
      qjt -= division_check(qjt, y_t0, y_t1, x_j0, x_j1, x_j2);
1,409,213✔
282
      BOTAN_DEBUG_ASSERT(division_check(qjt, y_t0, y_t1, x_j0, x_j1, x_j2) == false);
1,409,213✔
283

284
      shifted_y >>= WordInfo<word>::bits;
1,409,213✔
285
      // Now shifted_y == y << (WordInfo<word>::bits * (j-t-1))
286

287
      // TODO this sequence could be better
288
      r -= qjt * shifted_y;
1,409,213✔
289
      qjt -= r.is_negative();
1,409,213✔
290
      r += static_cast<word>(r.is_negative()) * shifted_y;
1,409,213✔
291

292
      q_words[j - t - 1] = qjt;
1,409,213✔
293
   }
294

295
   r >>= shifts;
345,263✔
296

297
   sign_fixup(x, y_arg, q, r);
345,263✔
298

299
   r_out = r;
345,263✔
300
   q_out = q;
345,263✔
301
}
690,526✔
302

303
}  // namespace Botan
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc