Coverage Report

Created: 2026-08-18 07:24

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/openssl/crypto/bn/bn_exp.c
Line
Count
Source
1
/*
2
 * Copyright 1995-2025 The OpenSSL Project Authors. All Rights Reserved.
3
 *
4
 * Licensed under the Apache License 2.0 (the "License").  You may not use
5
 * this file except in compliance with the License.  You can obtain a copy
6
 * in the file LICENSE in the source distribution or at
7
 * https://www.openssl.org/source/license.html
8
 */
9
10
#include "internal/cryptlib.h"
11
#include "internal/constant_time.h"
12
#include "bn_local.h"
13
14
#include <stdlib.h>
15
#ifdef _WIN32
16
#include <malloc.h>
17
#ifndef alloca
18
#define alloca _alloca
19
#endif
20
#elif defined(__GNUC__)
21
#ifndef alloca
22
#define alloca(s) __builtin_alloca((s))
23
#endif
24
#elif defined(__sun)
25
#include <alloca.h>
26
#endif
27
28
#include "rsaz_exp.h"
29
30
#undef SPARC_T4_MONT
31
#if defined(OPENSSL_BN_ASM_MONT) && (defined(__sparc__) || defined(__sparc))
32
#include "arch/sparc_arch.h"
33
#define SPARC_T4_MONT
34
#endif
35
36
/* maximum precomputation table size for *variable* sliding windows */
37
#define TABLE_SIZE 32
38
39
/*
40
 * Beyond this limit the constant time code is disabled due to
41
 * the possible overflow in the computation of powerbufLen in
42
 * BN_mod_exp_mont_consttime.
43
 * When this limit is exceeded, the computation will be done using
44
 * non-constant time code, but it will take very long.
45
 */
46
0
#define BN_CONSTTIME_SIZE_LIMIT (INT_MAX / BN_BYTES / 256)
47
48
/* this one works - simple but works */
49
int BN_exp(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, BN_CTX *ctx)
50
0
{
51
0
    int i, bits, ret = 0;
52
0
    BIGNUM *v, *rr;
53
54
0
    if (BN_get_flags(p, BN_FLG_CONSTTIME) != 0
55
0
        || BN_get_flags(a, BN_FLG_CONSTTIME) != 0) {
56
        /* BN_FLG_CONSTTIME only supported by BN_mod_exp_mont() */
57
0
        ERR_raise(ERR_LIB_BN, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
58
0
        return 0;
59
0
    }
60
61
0
    BN_CTX_start(ctx);
62
0
    rr = ((r == a) || (r == p)) ? BN_CTX_get(ctx) : r;
63
0
    v = BN_CTX_get(ctx);
64
0
    if (rr == NULL || v == NULL)
65
0
        goto err;
66
67
0
    if (BN_copy(v, a) == NULL)
68
0
        goto err;
69
0
    bits = BN_num_bits(p);
70
71
0
    if (BN_is_odd(p)) {
72
0
        if (BN_copy(rr, a) == NULL)
73
0
            goto err;
74
0
    } else {
75
0
        if (!BN_one(rr))
76
0
            goto err;
77
0
    }
78
79
0
    for (i = 1; i < bits; i++) {
80
0
        if (!BN_sqr(v, v, ctx))
81
0
            goto err;
82
0
        if (BN_is_bit_set(p, i)) {
83
0
            if (!BN_mul(rr, rr, v, ctx))
84
0
                goto err;
85
0
        }
86
0
    }
87
0
    if (r != rr && BN_copy(r, rr) == NULL)
88
0
        goto err;
89
90
0
    ret = 1;
91
0
err:
92
0
    BN_CTX_end(ctx);
93
0
    bn_check_top(r);
94
0
    return ret;
95
0
}
96
97
int BN_mod_exp(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, const BIGNUM *m,
98
    BN_CTX *ctx)
99
0
{
100
0
    int ret;
101
102
0
    bn_check_top(a);
103
0
    bn_check_top(p);
104
0
    bn_check_top(m);
105
106
    /*-
107
     * For even modulus  m = 2^k*m_odd, it might make sense to compute
108
     * a^p mod m_odd  and  a^p mod 2^k  separately (with Montgomery
109
     * exponentiation for the odd part), using appropriate exponent
110
     * reductions, and combine the results using the CRT.
111
     *
112
     * For now, we use Montgomery only if the modulus is odd; otherwise,
113
     * exponentiation using the reciprocal-based quick remaindering
114
     * algorithm is used.
115
     *
116
     * (Timing obtained with expspeed.c [computations  a^p mod m
117
     * where  a, p, m  are of the same length: 256, 512, 1024, 2048,
118
     * 4096, 8192 bits], compared to the running time of the
119
     * standard algorithm:
120
     *
121
     *   BN_mod_exp_mont   33 .. 40 %  [AMD K6-2, Linux, debug configuration]
122
     *                     55 .. 77 %  [UltraSparc processor, but
123
     *                                  debug-solaris-sparcv8-gcc conf.]
124
     *
125
     *   BN_mod_exp_recp   50 .. 70 %  [AMD K6-2, Linux, debug configuration]
126
     *                     62 .. 118 % [UltraSparc, debug-solaris-sparcv8-gcc]
127
     *
128
     * On the Sparc, BN_mod_exp_recp was faster than BN_mod_exp_mont
129
     * at 2048 and more bits, but at 512 and 1024 bits, it was
130
     * slower even than the standard algorithm!
131
     *
132
     * "Real" timings [linux-elf, solaris-sparcv9-gcc configurations]
133
     * should be obtained when the new Montgomery reduction code
134
     * has been integrated into OpenSSL.)
135
     */
136
137
0
#define MONT_MUL_MOD
138
0
#define MONT_EXP_WORD
139
0
#define RECP_MUL_MOD
140
141
0
#ifdef MONT_MUL_MOD
142
0
    if (BN_is_odd(m)) {
143
0
#ifdef MONT_EXP_WORD
144
0
        if (a->top == 1 && !a->neg
145
0
            && (BN_get_flags(p, BN_FLG_CONSTTIME) == 0)
146
0
            && (BN_get_flags(a, BN_FLG_CONSTTIME) == 0)
147
0
            && (BN_get_flags(m, BN_FLG_CONSTTIME) == 0)) {
148
0
            BN_ULONG A = a->d[0];
149
0
            ret = BN_mod_exp_mont_word(r, A, p, m, ctx, NULL);
150
0
        } else
151
0
#endif
152
0
            ret = BN_mod_exp_mont(r, a, p, m, ctx, NULL);
153
0
    } else
154
0
#endif
155
0
#ifdef RECP_MUL_MOD
156
0
    {
157
0
        ret = BN_mod_exp_recp(r, a, p, m, ctx);
158
0
    }
159
#else
160
    {
161
        ret = BN_mod_exp_simple(r, a, p, m, ctx);
162
    }
163
#endif
164
165
0
    bn_check_top(r);
166
0
    return ret;
167
0
}
168
169
int BN_mod_exp_recp(BIGNUM *r, const BIGNUM *a, const BIGNUM *p,
170
    const BIGNUM *m, BN_CTX *ctx)
171
0
{
172
0
    int i, j, bits, ret = 0, wstart, wend, window;
173
0
    int start = 1;
174
0
    BIGNUM *aa;
175
    /* Table of variables obtained from 'ctx' */
176
0
    BIGNUM *val[TABLE_SIZE];
177
0
    BN_RECP_CTX recp;
178
179
0
    if (BN_get_flags(p, BN_FLG_CONSTTIME) != 0
180
0
        || BN_get_flags(a, BN_FLG_CONSTTIME) != 0
181
0
        || BN_get_flags(m, BN_FLG_CONSTTIME) != 0) {
182
        /* BN_FLG_CONSTTIME only supported by BN_mod_exp_mont() */
183
0
        ERR_raise(ERR_LIB_BN, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
184
0
        return 0;
185
0
    }
186
187
0
    bits = BN_num_bits(p);
188
0
    if (bits == 0) {
189
        /* x**0 mod 1, or x**0 mod -1 is still zero. */
190
0
        if (BN_abs_is_word(m, 1)) {
191
0
            ret = 1;
192
0
            BN_zero(r);
193
0
        } else {
194
0
            ret = BN_one(r);
195
0
        }
196
0
        return ret;
197
0
    }
198
199
0
    BN_RECP_CTX_init(&recp);
200
201
0
    BN_CTX_start(ctx);
202
0
    aa = BN_CTX_get(ctx);
203
0
    val[0] = BN_CTX_get(ctx);
204
0
    if (val[0] == NULL)
205
0
        goto err;
206
207
0
    if (m->neg) {
208
        /* ignore sign of 'm' */
209
0
        if (BN_copy(aa, m) == NULL)
210
0
            goto err;
211
0
        aa->neg = 0;
212
0
        if (BN_RECP_CTX_set(&recp, aa, ctx) <= 0)
213
0
            goto err;
214
0
    } else {
215
0
        if (BN_RECP_CTX_set(&recp, m, ctx) <= 0)
216
0
            goto err;
217
0
    }
218
219
0
    if (!BN_nnmod(val[0], a, m, ctx))
220
0
        goto err; /* 1 */
221
0
    if (BN_is_zero(val[0])) {
222
0
        BN_zero(r);
223
0
        ret = 1;
224
0
        goto err;
225
0
    }
226
227
0
    window = BN_window_bits_for_exponent_size(bits);
228
0
    if (window > 1) {
229
0
        if (!BN_mod_mul_reciprocal(aa, val[0], val[0], &recp, ctx))
230
0
            goto err; /* 2 */
231
0
        j = 1 << (window - 1);
232
0
        for (i = 1; i < j; i++) {
233
0
            if (((val[i] = BN_CTX_get(ctx)) == NULL) || !BN_mod_mul_reciprocal(val[i], val[i - 1], aa, &recp, ctx))
234
0
                goto err;
235
0
        }
236
0
    }
237
238
0
    start = 1; /* This is used to avoid multiplication etc
239
                * when there is only the value '1' in the
240
                * buffer. */
241
0
    wstart = bits - 1; /* The top bit of the window */
242
0
    wend = 0; /* The bottom bit of the window */
243
244
0
    if (r == p) {
245
0
        BIGNUM *p_dup = BN_CTX_get(ctx);
246
247
0
        if (p_dup == NULL || BN_copy(p_dup, p) == NULL)
248
0
            goto err;
249
0
        p = p_dup;
250
0
    }
251
252
0
    if (!BN_one(r))
253
0
        goto err;
254
255
0
    for (;;) {
256
0
        int wvalue; /* The 'value' of the window */
257
258
0
        if (BN_is_bit_set(p, wstart) == 0) {
259
0
            if (!start)
260
0
                if (!BN_mod_mul_reciprocal(r, r, r, &recp, ctx))
261
0
                    goto err;
262
0
            if (wstart == 0)
263
0
                break;
264
0
            wstart--;
265
0
            continue;
266
0
        }
267
        /*
268
         * We now have wstart on a 'set' bit, we now need to work out how bit
269
         * a window to do.  To do this we need to scan forward until the last
270
         * set bit before the end of the window
271
         */
272
0
        wvalue = 1;
273
0
        wend = 0;
274
0
        for (i = 1; i < window; i++) {
275
0
            if (wstart - i < 0)
276
0
                break;
277
0
            if (BN_is_bit_set(p, wstart - i)) {
278
0
                wvalue <<= (i - wend);
279
0
                wvalue |= 1;
280
0
                wend = i;
281
0
            }
282
0
        }
283
284
        /* wend is the size of the current window */
285
0
        j = wend + 1;
286
        /* add the 'bytes above' */
287
0
        if (!start)
288
0
            for (i = 0; i < j; i++) {
289
0
                if (!BN_mod_mul_reciprocal(r, r, r, &recp, ctx))
290
0
                    goto err;
291
0
            }
292
293
        /* wvalue will be an odd number < 2^window */
294
0
        if (!BN_mod_mul_reciprocal(r, r, val[wvalue >> 1], &recp, ctx))
295
0
            goto err;
296
297
        /* move the 'window' down further */
298
0
        wstart -= wend + 1;
299
0
        start = 0;
300
0
        if (wstart < 0)
301
0
            break;
302
0
    }
303
0
    ret = 1;
304
0
err:
305
0
    BN_CTX_end(ctx);
306
0
    BN_RECP_CTX_free(&recp);
307
0
    bn_check_top(r);
308
0
    return ret;
309
0
}
310
311
int BN_mod_exp_mont(BIGNUM *rr, const BIGNUM *a, const BIGNUM *p,
312
    const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *in_mont)
313
0
{
314
0
    int i, j, bits, ret = 0, wstart, wend, window;
315
0
    int start = 1;
316
0
    BIGNUM *d, *r;
317
0
    const BIGNUM *aa;
318
    /* Table of variables obtained from 'ctx' */
319
0
    BIGNUM *val[TABLE_SIZE];
320
0
    BN_MONT_CTX *mont = NULL;
321
322
0
    bn_check_top(a);
323
0
    bn_check_top(p);
324
0
    bn_check_top(m);
325
326
0
    if (!BN_is_odd(m)) {
327
0
        ERR_raise(ERR_LIB_BN, BN_R_CALLED_WITH_EVEN_MODULUS);
328
0
        return 0;
329
0
    }
330
331
0
    if (m->top <= BN_CONSTTIME_SIZE_LIMIT
332
0
        && (BN_get_flags(p, BN_FLG_CONSTTIME) != 0
333
0
            || BN_get_flags(a, BN_FLG_CONSTTIME) != 0
334
0
            || BN_get_flags(m, BN_FLG_CONSTTIME) != 0)) {
335
0
        return BN_mod_exp_mont_consttime(rr, a, p, m, ctx, in_mont);
336
0
    }
337
338
0
    bits = BN_num_bits(p);
339
0
    if (bits == 0) {
340
        /* x**0 mod 1, or x**0 mod -1 is still zero. */
341
0
        if (BN_abs_is_word(m, 1)) {
342
0
            ret = 1;
343
0
            BN_zero(rr);
344
0
        } else {
345
0
            ret = BN_one(rr);
346
0
        }
347
0
        return ret;
348
0
    }
349
350
0
    BN_CTX_start(ctx);
351
0
    d = BN_CTX_get(ctx);
352
0
    r = BN_CTX_get(ctx);
353
0
    val[0] = BN_CTX_get(ctx);
354
0
    if (val[0] == NULL)
355
0
        goto err;
356
357
    /*
358
     * If this is not done, things will break in the montgomery part
359
     */
360
361
0
    if (in_mont != NULL)
362
0
        mont = in_mont;
363
0
    else {
364
0
        if ((mont = BN_MONT_CTX_new()) == NULL)
365
0
            goto err;
366
0
        if (!BN_MONT_CTX_set(mont, m, ctx))
367
0
            goto err;
368
0
    }
369
370
0
    if (a->neg || BN_ucmp(a, m) >= 0) {
371
0
        if (!BN_nnmod(val[0], a, m, ctx))
372
0
            goto err;
373
0
        aa = val[0];
374
0
    } else
375
0
        aa = a;
376
0
    if (!bn_to_mont_fixed_top(val[0], aa, mont, ctx))
377
0
        goto err; /* 1 */
378
379
0
    window = BN_window_bits_for_exponent_size(bits);
380
0
    if (window > 1) {
381
0
        if (!bn_mul_mont_fixed_top(d, val[0], val[0], mont, ctx))
382
0
            goto err; /* 2 */
383
0
        j = 1 << (window - 1);
384
0
        for (i = 1; i < j; i++) {
385
0
            if (((val[i] = BN_CTX_get(ctx)) == NULL) || !bn_mul_mont_fixed_top(val[i], val[i - 1], d, mont, ctx))
386
0
                goto err;
387
0
        }
388
0
    }
389
390
0
    start = 1; /* This is used to avoid multiplication etc
391
                * when there is only the value '1' in the
392
                * buffer. */
393
0
    wstart = bits - 1; /* The top bit of the window */
394
0
    wend = 0; /* The bottom bit of the window */
395
396
0
#if 1 /* by Shay Gueron's suggestion */
397
0
    j = m->top; /* borrow j */
398
0
    if (m->d[j - 1] & (((BN_ULONG)1) << (BN_BITS2 - 1))) {
399
0
        if (bn_wexpand(r, j) == NULL)
400
0
            goto err;
401
        /* 2^(top*BN_BITS2) - m */
402
0
        r->d[0] = (0 - m->d[0]) & BN_MASK2;
403
0
        for (i = 1; i < j; i++)
404
0
            r->d[i] = (~m->d[i]) & BN_MASK2;
405
0
        r->top = j;
406
0
        r->flags |= BN_FLG_FIXED_TOP;
407
0
    } else
408
0
#endif
409
0
        if (!bn_to_mont_fixed_top(r, BN_value_one(), mont, ctx))
410
0
        goto err;
411
0
    for (;;) {
412
0
        int wvalue; /* The 'value' of the window */
413
414
0
        if (BN_is_bit_set(p, wstart) == 0) {
415
0
            if (!start) {
416
0
                if (!bn_mul_mont_fixed_top(r, r, r, mont, ctx))
417
0
                    goto err;
418
0
            }
419
0
            if (wstart == 0)
420
0
                break;
421
0
            wstart--;
422
0
            continue;
423
0
        }
424
        /*
425
         * We now have wstart on a 'set' bit, we now need to work out how bit
426
         * a window to do.  To do this we need to scan forward until the last
427
         * set bit before the end of the window
428
         */
429
0
        wvalue = 1;
430
0
        wend = 0;
431
0
        for (i = 1; i < window; i++) {
432
0
            if (wstart - i < 0)
433
0
                break;
434
0
            if (BN_is_bit_set(p, wstart - i)) {
435
0
                wvalue <<= (i - wend);
436
0
                wvalue |= 1;
437
0
                wend = i;
438
0
            }
439
0
        }
440
441
        /* wend is the size of the current window */
442
0
        j = wend + 1;
443
        /* add the 'bytes above' */
444
0
        if (!start)
445
0
            for (i = 0; i < j; i++) {
446
0
                if (!bn_mul_mont_fixed_top(r, r, r, mont, ctx))
447
0
                    goto err;
448
0
            }
449
450
        /* wvalue will be an odd number < 2^window */
451
0
        if (!bn_mul_mont_fixed_top(r, r, val[wvalue >> 1], mont, ctx))
452
0
            goto err;
453
454
        /* move the 'window' down further */
455
0
        wstart -= wend + 1;
456
0
        start = 0;
457
0
        if (wstart < 0)
458
0
            break;
459
0
    }
460
    /*
461
     * Done with zero-padded intermediate BIGNUMs. Final BN_from_montgomery
462
     * removes padding [if any] and makes return value suitable for public
463
     * API consumer.
464
     */
465
#if defined(SPARC_T4_MONT)
466
    if (OPENSSL_sparcv9cap_P[0] & (SPARCV9_VIS3 | SPARCV9_PREFER_FPU)) {
467
        j = mont->N.top; /* borrow j */
468
        val[0]->d[0] = 1; /* borrow val[0] */
469
        for (i = 1; i < j; i++)
470
            val[0]->d[i] = 0;
471
        val[0]->top = j;
472
        if (!BN_mod_mul_montgomery(rr, r, val[0], mont, ctx))
473
            goto err;
474
    } else
475
#endif
476
0
        if (!BN_from_montgomery(rr, r, mont, ctx))
477
0
        goto err;
478
0
    ret = 1;
479
0
err:
480
0
    if (in_mont == NULL)
481
0
        BN_MONT_CTX_free(mont);
482
0
    BN_CTX_end(ctx);
483
0
    bn_check_top(rr);
484
0
    return ret;
485
0
}
486
487
static BN_ULONG bn_get_bits(const BIGNUM *a, int bitpos)
488
0
{
489
0
    BN_ULONG ret = 0;
490
0
    int wordpos;
491
492
0
    wordpos = bitpos / BN_BITS2;
493
0
    bitpos %= BN_BITS2;
494
0
    if (wordpos >= 0 && wordpos < a->top) {
495
0
        ret = a->d[wordpos] & BN_MASK2;
496
0
        if (bitpos) {
497
0
            ret >>= bitpos;
498
0
            if (++wordpos < a->top)
499
0
                ret |= a->d[wordpos] << (BN_BITS2 - bitpos);
500
0
        }
501
0
    }
502
503
0
    return ret & BN_MASK2;
504
0
}
505
506
/*
507
 * BN_mod_exp_mont_consttime() stores the precomputed powers in a specific
508
 * layout so that accessing any of these table values shows the same access
509
 * pattern as far as cache lines are concerned.  The following functions are
510
 * used to transfer a BIGNUM from/to that table.
511
 */
512
513
static int MOD_EXP_CTIME_COPY_TO_PREBUF(const BIGNUM *b, int top,
514
    unsigned char *buf, int idx,
515
    int window)
516
0
{
517
0
    int i, j;
518
0
    int width = 1 << window;
519
0
    BN_ULONG *table = (BN_ULONG *)buf;
520
521
0
    if (top > b->top)
522
0
        top = b->top; /* this works because 'buf' is explicitly
523
                       * zeroed */
524
0
    for (i = 0, j = idx; i < top; i++, j += width) {
525
0
        table[j] = b->d[i];
526
0
    }
527
528
0
    return 1;
529
0
}
530
531
static int MOD_EXP_CTIME_COPY_FROM_PREBUF(BIGNUM *b, int top,
532
    unsigned char *buf, int idx,
533
    int window)
534
0
{
535
0
    int i, j;
536
0
    int width = 1 << window;
537
    /*
538
     * We declare table 'volatile' in order to discourage compiler
539
     * from reordering loads from the table. Concern is that if
540
     * reordered in specific manner loads might give away the
541
     * information we are trying to conceal. Some would argue that
542
     * compiler can reorder them anyway, but it can as well be
543
     * argued that doing so would be violation of standard...
544
     */
545
0
    volatile BN_ULONG *table = (volatile BN_ULONG *)buf;
546
547
0
    if (bn_wexpand(b, top) == NULL)
548
0
        return 0;
549
550
0
    if (window <= 3) {
551
0
        for (i = 0; i < top; i++, table += width) {
552
0
            BN_ULONG acc = 0;
553
554
0
            for (j = 0; j < width; j++) {
555
0
                acc |= table[j] & value_barrier_bn((BN_ULONG)0 - (constant_time_eq_int(j, idx) & 1));
556
0
            }
557
558
0
            b->d[i] = acc;
559
0
        }
560
0
    } else {
561
0
        int xstride = 1 << (window - 2);
562
0
        BN_ULONG y0, y1, y2, y3;
563
564
0
        i = idx >> (window - 2); /* equivalent of idx / xstride */
565
0
        idx &= xstride - 1; /* equivalent of idx % xstride */
566
567
0
        y0 = (BN_ULONG)0 - (constant_time_eq_int(i, 0) & 1);
568
0
        y1 = (BN_ULONG)0 - (constant_time_eq_int(i, 1) & 1);
569
0
        y2 = (BN_ULONG)0 - (constant_time_eq_int(i, 2) & 1);
570
0
        y3 = (BN_ULONG)0 - (constant_time_eq_int(i, 3) & 1);
571
572
0
        for (i = 0; i < top; i++, table += width) {
573
0
            BN_ULONG acc = 0;
574
575
0
            for (j = 0; j < xstride; j++) {
576
0
                acc |= ((table[j + 0 * xstride] & value_barrier_bn(y0)) | (table[j + 1 * xstride] & value_barrier_bn(y1))
577
0
                           | (table[j + 2 * xstride] & value_barrier_bn(y2)) | (table[j + 3 * xstride] & value_barrier_bn(y3)))
578
0
                    & value_barrier_bn((BN_ULONG)0 - (constant_time_eq_int(j, idx) & 1));
579
0
            }
580
581
0
            b->d[i] = acc;
582
0
        }
583
0
    }
584
585
0
    b->top = top;
586
0
    b->flags |= BN_FLG_FIXED_TOP;
587
0
    return 1;
588
0
}
589
590
/*
591
 * Given a pointer value, compute the next address that is a cache line
592
 * multiple.
593
 */
594
#define MOD_EXP_CTIME_ALIGN(x_) \
595
0
    ((unsigned char *)(x_) + (MOD_EXP_CTIME_MIN_CACHE_LINE_WIDTH - (((size_t)(x_)) & (MOD_EXP_CTIME_MIN_CACHE_LINE_MASK))))
596
597
/*
598
 * This variant of BN_mod_exp_mont() uses fixed windows and the special
599
 * precomputation memory layout to limit data-dependency to a minimum to
600
 * protect secret exponents (cf. the hyper-threading timing attacks pointed
601
 * out by Colin Percival,
602
 * http://www.daemonology.net/hyperthreading-considered-harmful/)
603
 */
604
int bn_mod_exp_mont_fixed_top(BIGNUM *rr, const BIGNUM *a, const BIGNUM *p,
605
    const BIGNUM *m, BN_CTX *ctx,
606
    BN_MONT_CTX *in_mont)
607
0
{
608
0
    int i, bits, ret = 0, window, wvalue, wmask, window0;
609
0
    int top;
610
0
    BN_MONT_CTX *mont = NULL;
611
612
0
    int numPowers;
613
0
    unsigned char *powerbufFree = NULL;
614
0
    int powerbufLen = 0;
615
0
    unsigned char *powerbuf = NULL;
616
0
    BIGNUM tmp, am;
617
#if defined(SPARC_T4_MONT)
618
    unsigned int t4 = 0;
619
#endif
620
621
0
    if (!BN_is_odd(m)) {
622
0
        ERR_raise(ERR_LIB_BN, BN_R_CALLED_WITH_EVEN_MODULUS);
623
0
        return 0;
624
0
    }
625
626
0
    top = m->top;
627
628
0
    if (top > BN_CONSTTIME_SIZE_LIMIT) {
629
        /* Prevent overflowing the powerbufLen computation below */
630
0
        return BN_mod_exp_mont(rr, a, p, m, ctx, in_mont);
631
0
    }
632
633
    /*
634
     * Use all bits stored in |p|, rather than |BN_num_bits|, so we do not leak
635
     * whether the top bits are zero.
636
     */
637
0
    bits = p->top * BN_BITS2;
638
0
    if (bits == 0) {
639
        /* x**0 mod 1, or x**0 mod -1 is still zero. */
640
0
        if (BN_abs_is_word(m, 1)) {
641
0
            ret = 1;
642
0
            BN_zero(rr);
643
0
        } else {
644
0
            ret = BN_one(rr);
645
0
        }
646
0
        return ret;
647
0
    }
648
649
0
    BN_CTX_start(ctx);
650
651
    /*
652
     * Allocate a montgomery context if it was not supplied by the caller. If
653
     * this is not done, things will break in the montgomery part.
654
     */
655
0
    if (in_mont != NULL)
656
0
        mont = in_mont;
657
0
    else {
658
0
        if ((mont = BN_MONT_CTX_new()) == NULL)
659
0
            goto err;
660
0
        if (!BN_MONT_CTX_set(mont, m, ctx))
661
0
            goto err;
662
0
    }
663
664
0
    if (a->neg || BN_ucmp(a, m) >= 0) {
665
0
        BIGNUM *reduced = BN_CTX_get(ctx);
666
0
        if (reduced == NULL
667
0
            || !BN_nnmod(reduced, a, m, ctx)) {
668
0
            goto err;
669
0
        }
670
0
        a = reduced;
671
0
    }
672
673
0
#ifdef RSAZ_ENABLED
674
    /*
675
     * If the size of the operands allow it, perform the optimized
676
     * RSAZ exponentiation. For further information see
677
     * crypto/bn/rsaz_exp.c and accompanying assembly modules.
678
     */
679
0
    if ((16 == a->top) && (16 == p->top) && (BN_num_bits(m) == 1024)
680
0
        && rsaz_avx2_eligible()) {
681
0
        if (NULL == bn_wexpand(rr, 16))
682
0
            goto err;
683
0
        RSAZ_1024_mod_exp_avx2(rr->d, a->d, p->d, m->d, mont->RR.d,
684
0
            mont->n0[0]);
685
0
        rr->top = 16;
686
0
        rr->neg = 0;
687
0
        bn_correct_top(rr);
688
0
        ret = 1;
689
0
        goto err;
690
0
    } else if ((8 == a->top) && (8 == p->top) && (BN_num_bits(m) == 512)) {
691
0
        if (NULL == bn_wexpand(rr, 8))
692
0
            goto err;
693
0
        RSAZ_512_mod_exp(rr->d, a->d, p->d, m->d, mont->n0[0], mont->RR.d);
694
0
        rr->top = 8;
695
0
        rr->neg = 0;
696
0
        bn_correct_top(rr);
697
0
        ret = 1;
698
0
        goto err;
699
0
    }
700
0
#endif
701
702
    /* Get the window size to use with size of p. */
703
0
    window = BN_window_bits_for_ctime_exponent_size(bits);
704
#if defined(SPARC_T4_MONT)
705
    if (window >= 5 && (top & 15) == 0 && top <= 64 && (OPENSSL_sparcv9cap_P[1] & (CFR_MONTMUL | CFR_MONTSQR)) == (CFR_MONTMUL | CFR_MONTSQR) && (t4 = OPENSSL_sparcv9cap_P[0]))
706
        window = 5;
707
    else
708
#endif
709
0
#if defined(OPENSSL_BN_ASM_MONT5)
710
0
        if (window >= 5 && top <= BN_SOFT_LIMIT) {
711
0
        window = 5; /* ~5% improvement for RSA2048 sign, and even
712
                     * for RSA4096 */
713
        /* reserve space for mont->N.d[] copy */
714
0
        powerbufLen += top * sizeof(mont->N.d[0]);
715
0
    }
716
0
#endif
717
0
    (void)0;
718
719
    /*
720
     * Allocate a buffer large enough to hold all of the pre-computed powers
721
     * of am, am itself and tmp.
722
     */
723
0
    numPowers = 1 << window;
724
0
    powerbufLen += sizeof(m->d[0]) * (top * numPowers + ((2 * top) > numPowers ? (2 * top) : numPowers));
725
0
#ifdef alloca
726
0
    if (powerbufLen < 3072)
727
0
        powerbufFree = alloca(powerbufLen + MOD_EXP_CTIME_MIN_CACHE_LINE_WIDTH);
728
0
    else
729
0
#endif
730
0
        if ((powerbufFree = OPENSSL_malloc(powerbufLen + MOD_EXP_CTIME_MIN_CACHE_LINE_WIDTH))
731
0
            == NULL)
732
0
        goto err;
733
734
0
    powerbuf = MOD_EXP_CTIME_ALIGN(powerbufFree);
735
0
    memset(powerbuf, 0, powerbufLen);
736
737
0
#ifdef alloca
738
0
    if (powerbufLen < 3072)
739
0
        powerbufFree = NULL;
740
0
#endif
741
742
    /* lay down tmp and am right after powers table */
743
0
    tmp.d = (BN_ULONG *)(powerbuf + sizeof(m->d[0]) * top * numPowers);
744
0
    am.d = tmp.d + top;
745
0
    tmp.top = am.top = 0;
746
0
    tmp.dmax = am.dmax = top;
747
0
    tmp.neg = am.neg = 0;
748
0
    tmp.flags = am.flags = BN_FLG_STATIC_DATA;
749
750
    /* prepare a^0 in Montgomery domain */
751
0
#if 1 /* by Shay Gueron's suggestion */
752
0
    if (m->d[top - 1] & (((BN_ULONG)1) << (BN_BITS2 - 1))) {
753
        /* 2^(top*BN_BITS2) - m */
754
0
        tmp.d[0] = (0 - m->d[0]) & BN_MASK2;
755
0
        for (i = 1; i < top; i++)
756
0
            tmp.d[i] = (~m->d[i]) & BN_MASK2;
757
0
        tmp.top = top;
758
0
        tmp.flags |= BN_FLG_FIXED_TOP;
759
0
    } else
760
0
#endif
761
0
        if (!bn_to_mont_fixed_top(&tmp, BN_value_one(), mont, ctx))
762
0
        goto err;
763
764
    /* prepare a^1 in Montgomery domain */
765
0
    if (!bn_to_mont_fixed_top(&am, a, mont, ctx))
766
0
        goto err;
767
768
0
    if (top > BN_SOFT_LIMIT)
769
0
        goto fallback;
770
771
#if defined(SPARC_T4_MONT)
772
    if (t4) {
773
        typedef int (*bn_pwr5_mont_f)(BN_ULONG *tp, const BN_ULONG *np,
774
            const BN_ULONG *n0, const void *table,
775
            int power, int bits);
776
        int bn_pwr5_mont_t4_8(BN_ULONG *tp, const BN_ULONG *np,
777
            const BN_ULONG *n0, const void *table,
778
            int power, int bits);
779
        int bn_pwr5_mont_t4_16(BN_ULONG *tp, const BN_ULONG *np,
780
            const BN_ULONG *n0, const void *table,
781
            int power, int bits);
782
        int bn_pwr5_mont_t4_24(BN_ULONG *tp, const BN_ULONG *np,
783
            const BN_ULONG *n0, const void *table,
784
            int power, int bits);
785
        int bn_pwr5_mont_t4_32(BN_ULONG *tp, const BN_ULONG *np,
786
            const BN_ULONG *n0, const void *table,
787
            int power, int bits);
788
        static const bn_pwr5_mont_f pwr5_funcs[4] = {
789
            bn_pwr5_mont_t4_8, bn_pwr5_mont_t4_16,
790
            bn_pwr5_mont_t4_24, bn_pwr5_mont_t4_32
791
        };
792
        bn_pwr5_mont_f pwr5_worker = pwr5_funcs[top / 16 - 1];
793
794
        typedef int (*bn_mul_mont_f)(BN_ULONG *rp, const BN_ULONG *ap,
795
            const void *bp, const BN_ULONG *np,
796
            const BN_ULONG *n0);
797
        int bn_mul_mont_t4_8(BN_ULONG *rp, const BN_ULONG *ap, const void *bp,
798
            const BN_ULONG *np, const BN_ULONG *n0);
799
        int bn_mul_mont_t4_16(BN_ULONG *rp, const BN_ULONG *ap,
800
            const void *bp, const BN_ULONG *np,
801
            const BN_ULONG *n0);
802
        int bn_mul_mont_t4_24(BN_ULONG *rp, const BN_ULONG *ap,
803
            const void *bp, const BN_ULONG *np,
804
            const BN_ULONG *n0);
805
        int bn_mul_mont_t4_32(BN_ULONG *rp, const BN_ULONG *ap,
806
            const void *bp, const BN_ULONG *np,
807
            const BN_ULONG *n0);
808
        static const bn_mul_mont_f mul_funcs[4] = {
809
            bn_mul_mont_t4_8, bn_mul_mont_t4_16,
810
            bn_mul_mont_t4_24, bn_mul_mont_t4_32
811
        };
812
        bn_mul_mont_f mul_worker = mul_funcs[top / 16 - 1];
813
814
        void bn_mul_mont_vis3(BN_ULONG *rp, const BN_ULONG *ap,
815
            const void *bp, const BN_ULONG *np,
816
            const BN_ULONG *n0, int num);
817
        void bn_mul_mont_t4(BN_ULONG *rp, const BN_ULONG *ap,
818
            const void *bp, const BN_ULONG *np,
819
            const BN_ULONG *n0, int num);
820
        void bn_mul_mont_gather5_t4(BN_ULONG *rp, const BN_ULONG *ap,
821
            const void *table, const BN_ULONG *np,
822
            const BN_ULONG *n0, int num, int power);
823
        void bn_flip_n_scatter5_t4(const BN_ULONG *inp, size_t num,
824
            void *table, size_t power);
825
        void bn_gather5_t4(BN_ULONG *out, size_t num,
826
            void *table, size_t power);
827
        void bn_flip_t4(BN_ULONG *dst, BN_ULONG *src, size_t num);
828
829
        BN_ULONG *np = mont->N.d, *n0 = mont->n0;
830
        int stride = 5 * (6 - (top / 16 - 1)); /* multiple of 5, but less
831
                                                * than 32 */
832
833
        /*
834
         * BN_to_montgomery can contaminate words above .top [in
835
         * BN_DEBUG build...
836
         */
837
        for (i = am.top; i < top; i++)
838
            am.d[i] = 0;
839
        for (i = tmp.top; i < top; i++)
840
            tmp.d[i] = 0;
841
842
        bn_flip_n_scatter5_t4(tmp.d, top, powerbuf, 0);
843
        bn_flip_n_scatter5_t4(am.d, top, powerbuf, 1);
844
        if (!(*mul_worker)(tmp.d, am.d, am.d, np, n0) && !(*mul_worker)(tmp.d, am.d, am.d, np, n0))
845
            bn_mul_mont_vis3(tmp.d, am.d, am.d, np, n0, top);
846
        bn_flip_n_scatter5_t4(tmp.d, top, powerbuf, 2);
847
848
        for (i = 3; i < 32; i++) {
849
            /* Calculate a^i = a^(i-1) * a */
850
            if (!(*mul_worker)(tmp.d, tmp.d, am.d, np, n0) && !(*mul_worker)(tmp.d, tmp.d, am.d, np, n0))
851
                bn_mul_mont_vis3(tmp.d, tmp.d, am.d, np, n0, top);
852
            bn_flip_n_scatter5_t4(tmp.d, top, powerbuf, i);
853
        }
854
855
        /* switch to 64-bit domain */
856
        np = alloca(top * sizeof(BN_ULONG));
857
        top /= 2;
858
        bn_flip_t4(np, mont->N.d, top);
859
860
        /*
861
         * The exponent may not have a whole number of fixed-size windows.
862
         * To simplify the main loop, the initial window has between 1 and
863
         * full-window-size bits such that what remains is always a whole
864
         * number of windows
865
         */
866
        window0 = (bits - 1) % 5 + 1;
867
        wmask = (1 << window0) - 1;
868
        bits -= window0;
869
        wvalue = bn_get_bits(p, bits) & wmask;
870
        bn_gather5_t4(tmp.d, top, powerbuf, wvalue);
871
872
        /*
873
         * Scan the exponent one window at a time starting from the most
874
         * significant bits.
875
         */
876
        while (bits > 0) {
877
            if (bits < stride)
878
                stride = bits;
879
            bits -= stride;
880
            wvalue = bn_get_bits(p, bits);
881
882
            if ((*pwr5_worker)(tmp.d, np, n0, powerbuf, wvalue, stride))
883
                continue;
884
            /* retry once and fall back */
885
            if ((*pwr5_worker)(tmp.d, np, n0, powerbuf, wvalue, stride))
886
                continue;
887
888
            bits += stride - 5;
889
            wvalue >>= stride - 5;
890
            wvalue &= 31;
891
            bn_mul_mont_t4(tmp.d, tmp.d, tmp.d, np, n0, top);
892
            bn_mul_mont_t4(tmp.d, tmp.d, tmp.d, np, n0, top);
893
            bn_mul_mont_t4(tmp.d, tmp.d, tmp.d, np, n0, top);
894
            bn_mul_mont_t4(tmp.d, tmp.d, tmp.d, np, n0, top);
895
            bn_mul_mont_t4(tmp.d, tmp.d, tmp.d, np, n0, top);
896
            bn_mul_mont_gather5_t4(tmp.d, tmp.d, powerbuf, np, n0, top,
897
                wvalue);
898
        }
899
900
        bn_flip_t4(tmp.d, tmp.d, top);
901
        top *= 2;
902
        /* back to 32-bit domain */
903
        tmp.top = top;
904
        bn_correct_top(&tmp);
905
        OPENSSL_cleanse(np, top * sizeof(BN_ULONG));
906
    } else
907
#endif
908
0
#if defined(OPENSSL_BN_ASM_MONT5)
909
0
        if (window == 5 && top > 1) {
910
        /*
911
         * This optimization uses ideas from https://eprint.iacr.org/2011/239,
912
         * specifically optimization of cache-timing attack countermeasures,
913
         * pre-computation optimization, and Almost Montgomery Multiplication.
914
         *
915
         * The paper discusses a 4-bit window to optimize 512-bit modular
916
         * exponentiation, used in RSA-1024 with CRT, but RSA-1024 is no longer
917
         * important.
918
         *
919
         * |bn_mul_mont_gather5| and |bn_power5| implement the "almost"
920
         * reduction variant, so the values here may not be fully reduced.
921
         * They are bounded by R (i.e. they fit in |top| words), not |m|.
922
         * Additionally, we pass these "almost" reduced inputs into
923
         * |bn_mul_mont|, which implements the normal reduction variant.
924
         * Given those inputs, |bn_mul_mont| may not give reduced
925
         * output, but it will still produce "almost" reduced output.
926
         */
927
0
        void bn_mul_mont_gather5(BN_ULONG *rp, const BN_ULONG *ap,
928
0
            const void *table, const BN_ULONG *np,
929
0
            const BN_ULONG *n0, int num, int power);
930
0
        void bn_scatter5(const BN_ULONG *inp, size_t num,
931
0
            void *table, size_t power);
932
0
        void bn_gather5(BN_ULONG *out, size_t num, void *table, size_t power);
933
0
        void bn_power5(BN_ULONG *rp, const BN_ULONG *ap,
934
0
            const void *table, const BN_ULONG *np,
935
0
            const BN_ULONG *n0, int num, int power);
936
0
        int bn_get_bits5(const BN_ULONG *ap, int off);
937
938
0
        BN_ULONG *n0 = mont->n0, *np;
939
940
        /*
941
         * BN_to_montgomery can contaminate words above .top [in
942
         * BN_DEBUG build...
943
         */
944
0
        for (i = am.top; i < top; i++)
945
0
            am.d[i] = 0;
946
0
        for (i = tmp.top; i < top; i++)
947
0
            tmp.d[i] = 0;
948
949
        /*
950
         * copy mont->N.d[] to improve cache locality
951
         */
952
0
        for (np = am.d + top, i = 0; i < top; i++)
953
0
            np[i] = mont->N.d[i];
954
955
0
        bn_scatter5(tmp.d, top, powerbuf, 0);
956
0
        bn_scatter5(am.d, am.top, powerbuf, 1);
957
0
        bn_mul_mont(tmp.d, am.d, am.d, np, n0, top);
958
0
        bn_scatter5(tmp.d, top, powerbuf, 2);
959
960
#if 0
961
        for (i = 3; i < 32; i++) {
962
            /* Calculate a^i = a^(i-1) * a */
963
            bn_mul_mont_gather5(tmp.d, am.d, powerbuf, np, n0, top, i - 1);
964
            bn_scatter5(tmp.d, top, powerbuf, i);
965
        }
966
#else
967
        /* same as above, but uses squaring for 1/2 of operations */
968
0
        for (i = 4; i < 32; i *= 2) {
969
0
            bn_mul_mont(tmp.d, tmp.d, tmp.d, np, n0, top);
970
0
            bn_scatter5(tmp.d, top, powerbuf, i);
971
0
        }
972
0
        for (i = 3; i < 8; i += 2) {
973
0
            int j;
974
0
            bn_mul_mont_gather5(tmp.d, am.d, powerbuf, np, n0, top, i - 1);
975
0
            bn_scatter5(tmp.d, top, powerbuf, i);
976
0
            for (j = 2 * i; j < 32; j *= 2) {
977
0
                bn_mul_mont(tmp.d, tmp.d, tmp.d, np, n0, top);
978
0
                bn_scatter5(tmp.d, top, powerbuf, j);
979
0
            }
980
0
        }
981
0
        for (; i < 16; i += 2) {
982
0
            bn_mul_mont_gather5(tmp.d, am.d, powerbuf, np, n0, top, i - 1);
983
0
            bn_scatter5(tmp.d, top, powerbuf, i);
984
0
            bn_mul_mont(tmp.d, tmp.d, tmp.d, np, n0, top);
985
0
            bn_scatter5(tmp.d, top, powerbuf, 2 * i);
986
0
        }
987
0
        for (; i < 32; i += 2) {
988
0
            bn_mul_mont_gather5(tmp.d, am.d, powerbuf, np, n0, top, i - 1);
989
0
            bn_scatter5(tmp.d, top, powerbuf, i);
990
0
        }
991
0
#endif
992
        /*
993
         * The exponent may not have a whole number of fixed-size windows.
994
         * To simplify the main loop, the initial window has between 1 and
995
         * full-window-size bits such that what remains is always a whole
996
         * number of windows
997
         */
998
0
        window0 = (bits - 1) % 5 + 1;
999
0
        wmask = (1 << window0) - 1;
1000
0
        bits -= window0;
1001
0
        wvalue = bn_get_bits(p, bits) & wmask;
1002
0
        bn_gather5(tmp.d, top, powerbuf, wvalue);
1003
1004
        /*
1005
         * Scan the exponent one window at a time starting from the most
1006
         * significant bits.
1007
         */
1008
0
        if (top & 7) {
1009
0
            while (bits > 0) {
1010
0
                bn_mul_mont(tmp.d, tmp.d, tmp.d, np, n0, top);
1011
0
                bn_mul_mont(tmp.d, tmp.d, tmp.d, np, n0, top);
1012
0
                bn_mul_mont(tmp.d, tmp.d, tmp.d, np, n0, top);
1013
0
                bn_mul_mont(tmp.d, tmp.d, tmp.d, np, n0, top);
1014
0
                bn_mul_mont(tmp.d, tmp.d, tmp.d, np, n0, top);
1015
0
                bn_mul_mont_gather5(tmp.d, tmp.d, powerbuf, np, n0, top,
1016
0
                    bn_get_bits5(p->d, bits -= 5));
1017
0
            }
1018
0
        } else {
1019
0
            while (bits > 0) {
1020
0
                bn_power5(tmp.d, tmp.d, powerbuf, np, n0, top,
1021
0
                    bn_get_bits5(p->d, bits -= 5));
1022
0
            }
1023
0
        }
1024
1025
0
        tmp.top = top;
1026
        /*
1027
         * The result is now in |tmp| in Montgomery form, but it may not be
1028
         * fully reduced. This is within bounds for |BN_from_montgomery|
1029
         * (tmp < R <= m*R) so it will, when converting from Montgomery form,
1030
         * produce a fully reduced result.
1031
         *
1032
         * This differs from Figure 2 of the paper, which uses AMM(h, 1) to
1033
         * convert from Montgomery form with unreduced output, followed by an
1034
         * extra reduction step. In the paper's terminology, we replace
1035
         * steps 9 and 10 with MM(h, 1).
1036
         */
1037
0
    } else
1038
0
#endif
1039
0
    {
1040
0
    fallback:
1041
0
        if (!MOD_EXP_CTIME_COPY_TO_PREBUF(&tmp, top, powerbuf, 0, window))
1042
0
            goto err;
1043
0
        if (!MOD_EXP_CTIME_COPY_TO_PREBUF(&am, top, powerbuf, 1, window))
1044
0
            goto err;
1045
1046
        /*
1047
         * If the window size is greater than 1, then calculate
1048
         * val[i=2..2^winsize-1]. Powers are computed as a*a^(i-1) (even
1049
         * powers could instead be computed as (a^(i/2))^2 to use the slight
1050
         * performance advantage of sqr over mul).
1051
         */
1052
0
        if (window > 1) {
1053
0
            if (!bn_mul_mont_fixed_top(&tmp, &am, &am, mont, ctx))
1054
0
                goto err;
1055
0
            if (!MOD_EXP_CTIME_COPY_TO_PREBUF(&tmp, top, powerbuf, 2,
1056
0
                    window))
1057
0
                goto err;
1058
0
            for (i = 3; i < numPowers; i++) {
1059
                /* Calculate a^i = a^(i-1) * a */
1060
0
                if (!bn_mul_mont_fixed_top(&tmp, &am, &tmp, mont, ctx))
1061
0
                    goto err;
1062
0
                if (!MOD_EXP_CTIME_COPY_TO_PREBUF(&tmp, top, powerbuf, i,
1063
0
                        window))
1064
0
                    goto err;
1065
0
            }
1066
0
        }
1067
1068
        /*
1069
         * The exponent may not have a whole number of fixed-size windows.
1070
         * To simplify the main loop, the initial window has between 1 and
1071
         * full-window-size bits such that what remains is always a whole
1072
         * number of windows
1073
         */
1074
0
        window0 = (bits - 1) % window + 1;
1075
0
        wmask = (1 << window0) - 1;
1076
0
        bits -= window0;
1077
0
        wvalue = bn_get_bits(p, bits) & wmask;
1078
0
        if (!MOD_EXP_CTIME_COPY_FROM_PREBUF(&tmp, top, powerbuf, wvalue,
1079
0
                window))
1080
0
            goto err;
1081
1082
0
        wmask = (1 << window) - 1;
1083
        /*
1084
         * Scan the exponent one window at a time starting from the most
1085
         * significant bits.
1086
         */
1087
0
        while (bits > 0) {
1088
1089
            /* Square the result window-size times */
1090
0
            for (i = 0; i < window; i++)
1091
0
                if (!bn_mul_mont_fixed_top(&tmp, &tmp, &tmp, mont, ctx))
1092
0
                    goto err;
1093
1094
            /*
1095
             * Get a window's worth of bits from the exponent
1096
             * This avoids calling BN_is_bit_set for each bit, which
1097
             * is not only slower but also makes each bit vulnerable to
1098
             * EM (and likely other) side-channel attacks like One&Done
1099
             * (for details see "One&Done: A Single-Decryption EM-Based
1100
             *  Attack on OpenSSL's Constant-Time Blinded RSA" by M. Alam,
1101
             *  H. Khan, M. Dey, N. Sinha, R. Callan, A. Zajic, and
1102
             *  M. Prvulovic, in USENIX Security'18)
1103
             */
1104
0
            bits -= window;
1105
0
            wvalue = bn_get_bits(p, bits) & wmask;
1106
            /*
1107
             * Fetch the appropriate pre-computed value from the pre-buf
1108
             */
1109
0
            if (!MOD_EXP_CTIME_COPY_FROM_PREBUF(&am, top, powerbuf, wvalue,
1110
0
                    window))
1111
0
                goto err;
1112
1113
            /* Multiply the result into the intermediate result */
1114
0
            if (!bn_mul_mont_fixed_top(&tmp, &tmp, &am, mont, ctx))
1115
0
                goto err;
1116
0
        }
1117
0
    }
1118
1119
    /*
1120
     * Done with zero-padded intermediate BIGNUMs. Final BN_from_montgomery
1121
     * removes padding [if any] and makes return value suitable for public
1122
     * API consumer.
1123
     */
1124
#if defined(SPARC_T4_MONT)
1125
    if (OPENSSL_sparcv9cap_P[0] & (SPARCV9_VIS3 | SPARCV9_PREFER_FPU)) {
1126
        am.d[0] = 1; /* borrow am */
1127
        for (i = 1; i < top; i++)
1128
            am.d[i] = 0;
1129
        if (!BN_mod_mul_montgomery(rr, &tmp, &am, mont, ctx))
1130
            goto err;
1131
    } else
1132
#endif
1133
0
        if (!bn_from_mont_fixed_top(rr, &tmp, mont, ctx))
1134
0
        goto err;
1135
0
    ret = 1;
1136
0
err:
1137
0
    if (in_mont == NULL)
1138
0
        BN_MONT_CTX_free(mont);
1139
0
    if (powerbuf != NULL) {
1140
0
        OPENSSL_cleanse(powerbuf, powerbufLen);
1141
0
        OPENSSL_free(powerbufFree);
1142
0
    }
1143
0
    BN_CTX_end(ctx);
1144
0
    return ret;
1145
0
}
1146
1147
int BN_mod_exp_mont_consttime(BIGNUM *rr, const BIGNUM *a, const BIGNUM *p,
1148
    const BIGNUM *m, BN_CTX *ctx,
1149
    BN_MONT_CTX *in_mont)
1150
0
{
1151
0
    bn_check_top(a);
1152
0
    bn_check_top(p);
1153
0
    bn_check_top(m);
1154
0
    if (!bn_mod_exp_mont_fixed_top(rr, a, p, m, ctx, in_mont))
1155
0
        return 0;
1156
0
    bn_correct_top(rr);
1157
0
    return 1;
1158
0
}
1159
1160
int BN_mod_exp_mont_word(BIGNUM *rr, BN_ULONG a, const BIGNUM *p,
1161
    const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *in_mont)
1162
0
{
1163
0
    BN_MONT_CTX *mont = NULL;
1164
0
    int b, bits, ret = 0;
1165
0
    int r_is_one;
1166
0
    BN_ULONG w, next_w;
1167
0
    BIGNUM *r, *t;
1168
0
    BIGNUM *swap_tmp;
1169
0
#define BN_MOD_MUL_WORD(r, w, m)                            \
1170
0
    (BN_mul_word(r, (w)) && (/* BN_ucmp(r, (m)) < 0 ? 1 :*/ \
1171
0
         (BN_mod(t, r, m, ctx) && (swap_tmp = r, r = t, t = swap_tmp, 1))))
1172
    /*
1173
     * BN_MOD_MUL_WORD is only used with 'w' large, so the BN_ucmp test is
1174
     * probably more overhead than always using BN_mod (which uses BN_copy if
1175
     * a similar test returns true).
1176
     */
1177
    /*
1178
     * We can use BN_mod and do not need BN_nnmod because our accumulator is
1179
     * never negative (the result of BN_mod does not depend on the sign of
1180
     * the modulus).
1181
     */
1182
0
#define BN_TO_MONTGOMERY_WORD(r, w, mont) \
1183
0
    (BN_set_word(r, (w)) && BN_to_montgomery(r, r, (mont), ctx))
1184
1185
0
    if (BN_get_flags(p, BN_FLG_CONSTTIME) != 0
1186
0
        || BN_get_flags(m, BN_FLG_CONSTTIME) != 0) {
1187
        /* BN_FLG_CONSTTIME only supported by BN_mod_exp_mont() */
1188
0
        ERR_raise(ERR_LIB_BN, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1189
0
        return 0;
1190
0
    }
1191
1192
0
    bn_check_top(p);
1193
0
    bn_check_top(m);
1194
1195
0
    if (!BN_is_odd(m)) {
1196
0
        ERR_raise(ERR_LIB_BN, BN_R_CALLED_WITH_EVEN_MODULUS);
1197
0
        return 0;
1198
0
    }
1199
0
    if (m->top == 1)
1200
0
        a %= m->d[0]; /* make sure that 'a' is reduced */
1201
1202
0
    bits = BN_num_bits(p);
1203
0
    if (bits == 0) {
1204
        /* x**0 mod 1, or x**0 mod -1 is still zero. */
1205
0
        if (BN_abs_is_word(m, 1)) {
1206
0
            ret = 1;
1207
0
            BN_zero(rr);
1208
0
        } else {
1209
0
            ret = BN_one(rr);
1210
0
        }
1211
0
        return ret;
1212
0
    }
1213
0
    if (a == 0) {
1214
0
        BN_zero(rr);
1215
0
        ret = 1;
1216
0
        return ret;
1217
0
    }
1218
1219
0
    BN_CTX_start(ctx);
1220
0
    r = BN_CTX_get(ctx);
1221
0
    t = BN_CTX_get(ctx);
1222
0
    if (t == NULL)
1223
0
        goto err;
1224
1225
0
    if (in_mont != NULL)
1226
0
        mont = in_mont;
1227
0
    else {
1228
0
        if ((mont = BN_MONT_CTX_new()) == NULL)
1229
0
            goto err;
1230
0
        if (!BN_MONT_CTX_set(mont, m, ctx))
1231
0
            goto err;
1232
0
    }
1233
1234
0
    r_is_one = 1; /* except for Montgomery factor */
1235
1236
    /* bits-1 >= 0 */
1237
1238
    /* The result is accumulated in the product r*w. */
1239
0
    w = a; /* bit 'bits-1' of 'p' is always set */
1240
0
    for (b = bits - 2; b >= 0; b--) {
1241
        /* First, square r*w. */
1242
0
        next_w = w * w;
1243
0
        if ((next_w / w) != w) { /* overflow */
1244
0
            if (r_is_one) {
1245
0
                if (!BN_TO_MONTGOMERY_WORD(r, w, mont))
1246
0
                    goto err;
1247
0
                r_is_one = 0;
1248
0
            } else {
1249
0
                if (!BN_MOD_MUL_WORD(r, w, m))
1250
0
                    goto err;
1251
0
            }
1252
0
            next_w = 1;
1253
0
        }
1254
0
        w = next_w;
1255
0
        if (!r_is_one) {
1256
0
            if (!BN_mod_mul_montgomery(r, r, r, mont, ctx))
1257
0
                goto err;
1258
0
        }
1259
1260
        /* Second, multiply r*w by 'a' if exponent bit is set. */
1261
0
        if (BN_is_bit_set(p, b)) {
1262
0
            next_w = w * a;
1263
0
            if ((next_w / a) != w) { /* overflow */
1264
0
                if (r_is_one) {
1265
0
                    if (!BN_TO_MONTGOMERY_WORD(r, w, mont))
1266
0
                        goto err;
1267
0
                    r_is_one = 0;
1268
0
                } else {
1269
0
                    if (!BN_MOD_MUL_WORD(r, w, m))
1270
0
                        goto err;
1271
0
                }
1272
0
                next_w = a;
1273
0
            }
1274
0
            w = next_w;
1275
0
        }
1276
0
    }
1277
1278
    /* Finally, set r:=r*w. */
1279
0
    if (w != 1) {
1280
0
        if (r_is_one) {
1281
0
            if (!BN_TO_MONTGOMERY_WORD(r, w, mont))
1282
0
                goto err;
1283
0
            r_is_one = 0;
1284
0
        } else {
1285
0
            if (!BN_MOD_MUL_WORD(r, w, m))
1286
0
                goto err;
1287
0
        }
1288
0
    }
1289
1290
0
    if (r_is_one) { /* can happen only if a == 1 */
1291
0
        if (!BN_one(rr))
1292
0
            goto err;
1293
0
    } else {
1294
0
        if (!BN_from_montgomery(rr, r, mont, ctx))
1295
0
            goto err;
1296
0
    }
1297
0
    ret = 1;
1298
0
err:
1299
0
    if (in_mont == NULL)
1300
0
        BN_MONT_CTX_free(mont);
1301
0
    BN_CTX_end(ctx);
1302
0
    bn_check_top(rr);
1303
0
    return ret;
1304
0
}
1305
1306
/* The old fallback, simple version :-) */
1307
int BN_mod_exp_simple(BIGNUM *r, const BIGNUM *a, const BIGNUM *p,
1308
    const BIGNUM *m, BN_CTX *ctx)
1309
0
{
1310
0
    int i, j, bits, ret = 0, wstart, wend, window;
1311
0
    int start = 1;
1312
0
    BIGNUM *d;
1313
    /* Table of variables obtained from 'ctx' */
1314
0
    BIGNUM *val[TABLE_SIZE];
1315
1316
0
    if (BN_get_flags(p, BN_FLG_CONSTTIME) != 0
1317
0
        || BN_get_flags(a, BN_FLG_CONSTTIME) != 0
1318
0
        || BN_get_flags(m, BN_FLG_CONSTTIME) != 0) {
1319
        /* BN_FLG_CONSTTIME only supported by BN_mod_exp_mont() */
1320
0
        ERR_raise(ERR_LIB_BN, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1321
0
        return 0;
1322
0
    }
1323
1324
0
    if (r == m) {
1325
0
        ERR_raise(ERR_LIB_BN, ERR_R_PASSED_INVALID_ARGUMENT);
1326
0
        return 0;
1327
0
    }
1328
1329
0
    bits = BN_num_bits(p);
1330
0
    if (bits == 0) {
1331
        /* x**0 mod 1, or x**0 mod -1 is still zero. */
1332
0
        if (BN_abs_is_word(m, 1)) {
1333
0
            ret = 1;
1334
0
            BN_zero(r);
1335
0
        } else {
1336
0
            ret = BN_one(r);
1337
0
        }
1338
0
        return ret;
1339
0
    }
1340
1341
0
    BN_CTX_start(ctx);
1342
0
    d = BN_CTX_get(ctx);
1343
0
    val[0] = BN_CTX_get(ctx);
1344
0
    if (val[0] == NULL)
1345
0
        goto err;
1346
1347
0
    if (!BN_nnmod(val[0], a, m, ctx))
1348
0
        goto err; /* 1 */
1349
0
    if (BN_is_zero(val[0])) {
1350
0
        BN_zero(r);
1351
0
        ret = 1;
1352
0
        goto err;
1353
0
    }
1354
1355
0
    window = BN_window_bits_for_exponent_size(bits);
1356
0
    if (window > 1) {
1357
0
        if (!BN_mod_mul(d, val[0], val[0], m, ctx))
1358
0
            goto err; /* 2 */
1359
0
        j = 1 << (window - 1);
1360
0
        for (i = 1; i < j; i++) {
1361
0
            if (((val[i] = BN_CTX_get(ctx)) == NULL) || !BN_mod_mul(val[i], val[i - 1], d, m, ctx))
1362
0
                goto err;
1363
0
        }
1364
0
    }
1365
1366
0
    start = 1; /* This is used to avoid multiplication etc
1367
                * when there is only the value '1' in the
1368
                * buffer. */
1369
0
    wstart = bits - 1; /* The top bit of the window */
1370
0
    wend = 0; /* The bottom bit of the window */
1371
1372
0
    if (r == p) {
1373
0
        BIGNUM *p_dup = BN_CTX_get(ctx);
1374
1375
0
        if (p_dup == NULL || BN_copy(p_dup, p) == NULL)
1376
0
            goto err;
1377
0
        p = p_dup;
1378
0
    }
1379
1380
0
    if (!BN_one(r))
1381
0
        goto err;
1382
1383
0
    for (;;) {
1384
0
        int wvalue; /* The 'value' of the window */
1385
1386
0
        if (BN_is_bit_set(p, wstart) == 0) {
1387
0
            if (!start)
1388
0
                if (!BN_mod_mul(r, r, r, m, ctx))
1389
0
                    goto err;
1390
0
            if (wstart == 0)
1391
0
                break;
1392
0
            wstart--;
1393
0
            continue;
1394
0
        }
1395
        /*
1396
         * We now have wstart on a 'set' bit, we now need to work out how bit
1397
         * a window to do.  To do this we need to scan forward until the last
1398
         * set bit before the end of the window
1399
         */
1400
0
        wvalue = 1;
1401
0
        wend = 0;
1402
0
        for (i = 1; i < window; i++) {
1403
0
            if (wstart - i < 0)
1404
0
                break;
1405
0
            if (BN_is_bit_set(p, wstart - i)) {
1406
0
                wvalue <<= (i - wend);
1407
0
                wvalue |= 1;
1408
0
                wend = i;
1409
0
            }
1410
0
        }
1411
1412
        /* wend is the size of the current window */
1413
0
        j = wend + 1;
1414
        /* add the 'bytes above' */
1415
0
        if (!start)
1416
0
            for (i = 0; i < j; i++) {
1417
0
                if (!BN_mod_mul(r, r, r, m, ctx))
1418
0
                    goto err;
1419
0
            }
1420
1421
        /* wvalue will be an odd number < 2^window */
1422
0
        if (!BN_mod_mul(r, r, val[wvalue >> 1], m, ctx))
1423
0
            goto err;
1424
1425
        /* move the 'window' down further */
1426
0
        wstart -= wend + 1;
1427
0
        start = 0;
1428
0
        if (wstart < 0)
1429
0
            break;
1430
0
    }
1431
0
    ret = 1;
1432
0
err:
1433
0
    BN_CTX_end(ctx);
1434
0
    bn_check_top(r);
1435
0
    return ret;
1436
0
}
1437
1438
/*
1439
 * This is a variant of modular exponentiation optimization that does
1440
 * parallel 2-primes exponentiation using 256-bit (AVX512VL) AVX512_IFMA ISA
1441
 * or AVX_IFMA ISA in 52-bit binary redundant representation.
1442
 * If such instructions are not available, or input data size is not supported,
1443
 * it falls back to two BN_mod_exp_mont_consttime() calls.
1444
 */
1445
int BN_mod_exp_mont_consttime_x2(BIGNUM *rr1, const BIGNUM *a1, const BIGNUM *p1,
1446
    const BIGNUM *m1, BN_MONT_CTX *in_mont1,
1447
    BIGNUM *rr2, const BIGNUM *a2, const BIGNUM *p2,
1448
    const BIGNUM *m2, BN_MONT_CTX *in_mont2,
1449
    BN_CTX *ctx)
1450
0
{
1451
0
    int ret = 0;
1452
1453
0
#ifdef RSAZ_ENABLED
1454
0
    BN_MONT_CTX *mont1 = NULL;
1455
0
    BN_MONT_CTX *mont2 = NULL;
1456
1457
0
    if ((ossl_rsaz_avx512ifma_eligible() || ossl_rsaz_avxifma_eligible()) && (((a1->top == 16) && (p1->top == 16) && (BN_num_bits(m1) == 1024) && (a2->top == 16) && (p2->top == 16) && (BN_num_bits(m2) == 1024)) || ((a1->top == 24) && (p1->top == 24) && (BN_num_bits(m1) == 1536) && (a2->top == 24) && (p2->top == 24) && (BN_num_bits(m2) == 1536)) || ((a1->top == 32) && (p1->top == 32) && (BN_num_bits(m1) == 2048) && (a2->top == 32) && (p2->top == 32) && (BN_num_bits(m2) == 2048)))) {
1458
1459
0
        int topn = a1->top;
1460
        /* Modulus bits of |m1| and |m2| are equal */
1461
0
        int mod_bits = BN_num_bits(m1);
1462
1463
0
        if (bn_wexpand(rr1, topn) == NULL)
1464
0
            goto err;
1465
0
        if (bn_wexpand(rr2, topn) == NULL)
1466
0
            goto err;
1467
1468
        /*  Ensure that montgomery contexts are initialized */
1469
0
        if (in_mont1 != NULL) {
1470
0
            mont1 = in_mont1;
1471
0
        } else {
1472
0
            if ((mont1 = BN_MONT_CTX_new()) == NULL)
1473
0
                goto err;
1474
0
            if (!BN_MONT_CTX_set(mont1, m1, ctx))
1475
0
                goto err;
1476
0
        }
1477
0
        if (in_mont2 != NULL) {
1478
0
            mont2 = in_mont2;
1479
0
        } else {
1480
0
            if ((mont2 = BN_MONT_CTX_new()) == NULL)
1481
0
                goto err;
1482
0
            if (!BN_MONT_CTX_set(mont2, m2, ctx))
1483
0
                goto err;
1484
0
        }
1485
1486
0
        ret = ossl_rsaz_mod_exp_avx512_x2(rr1->d, a1->d, p1->d, m1->d,
1487
0
            mont1->RR.d, mont1->n0[0],
1488
0
            rr2->d, a2->d, p2->d, m2->d,
1489
0
            mont2->RR.d, mont2->n0[0],
1490
0
            mod_bits);
1491
1492
0
        rr1->top = topn;
1493
0
        rr1->neg = 0;
1494
0
        bn_correct_top(rr1);
1495
0
        bn_check_top(rr1);
1496
1497
0
        rr2->top = topn;
1498
0
        rr2->neg = 0;
1499
0
        bn_correct_top(rr2);
1500
0
        bn_check_top(rr2);
1501
1502
0
        goto err;
1503
0
    }
1504
0
#endif
1505
1506
    /* rr1 = a1^p1 mod m1 */
1507
0
    ret = BN_mod_exp_mont_consttime(rr1, a1, p1, m1, ctx, in_mont1);
1508
    /* rr2 = a2^p2 mod m2 */
1509
0
    ret &= BN_mod_exp_mont_consttime(rr2, a2, p2, m2, ctx, in_mont2);
1510
1511
0
#ifdef RSAZ_ENABLED
1512
0
err:
1513
0
    if (in_mont2 == NULL)
1514
0
        BN_MONT_CTX_free(mont2);
1515
0
    if (in_mont1 == NULL)
1516
0
        BN_MONT_CTX_free(mont1);
1517
0
#endif
1518
1519
0
    return ret;
1520
0
}