Coverage Report

Created: 2025-06-13 06:56

/src/openssl/crypto/bn/bn_recp.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Copyright 1995-2023 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 "bn_local.h"
12
13
void BN_RECP_CTX_init(BN_RECP_CTX *recp)
14
0
{
15
0
    memset(recp, 0, sizeof(*recp));
16
0
    bn_init(&(recp->N));
17
0
    bn_init(&(recp->Nr));
18
0
}
19
20
BN_RECP_CTX *BN_RECP_CTX_new(void)
21
0
{
22
0
    BN_RECP_CTX *ret;
23
24
0
    if ((ret = OPENSSL_zalloc(sizeof(*ret))) == NULL)
25
0
        return NULL;
26
27
0
    bn_init(&(ret->N));
28
0
    bn_init(&(ret->Nr));
29
0
    ret->flags = BN_FLG_MALLOCED;
30
0
    return ret;
31
0
}
32
33
void BN_RECP_CTX_free(BN_RECP_CTX *recp)
34
0
{
35
0
    if (recp == NULL)
36
0
        return;
37
0
    BN_free(&recp->N);
38
0
    BN_free(&recp->Nr);
39
0
    if (recp->flags & BN_FLG_MALLOCED)
40
0
        OPENSSL_free(recp);
41
0
}
42
43
int BN_RECP_CTX_set(BN_RECP_CTX *recp, const BIGNUM *d, BN_CTX *ctx)
44
0
{
45
0
    if (BN_is_zero(d) || !BN_copy(&(recp->N), d))
46
0
        return 0;
47
0
    BN_zero(&(recp->Nr));
48
0
    recp->num_bits = BN_num_bits(d);
49
0
    recp->shift = 0;
50
0
    return 1;
51
0
}
52
53
int BN_mod_mul_reciprocal(BIGNUM *r, const BIGNUM *x, const BIGNUM *y,
54
                          BN_RECP_CTX *recp, BN_CTX *ctx)
55
0
{
56
0
    int ret = 0;
57
0
    BIGNUM *a;
58
0
    const BIGNUM *ca;
59
60
0
    BN_CTX_start(ctx);
61
0
    if ((a = BN_CTX_get(ctx)) == NULL)
62
0
        goto err;
63
0
    if (y != NULL) {
64
0
        if (x == y) {
65
0
            if (!BN_sqr(a, x, ctx))
66
0
                goto err;
67
0
        } else {
68
0
            if (!BN_mul(a, x, y, ctx))
69
0
                goto err;
70
0
        }
71
0
        ca = a;
72
0
    } else
73
0
        ca = x;                 /* Just do the mod */
74
75
0
    ret = BN_div_recp(NULL, r, ca, recp, ctx);
76
0
 err:
77
0
    BN_CTX_end(ctx);
78
0
    bn_check_top(r);
79
0
    return ret;
80
0
}
81
82
int BN_div_recp(BIGNUM *dv, BIGNUM *rem, const BIGNUM *m,
83
                BN_RECP_CTX *recp, BN_CTX *ctx)
84
0
{
85
0
    int i, j, ret = 0;
86
0
    BIGNUM *a, *b, *d, *r;
87
88
0
    BN_CTX_start(ctx);
89
0
    d = (dv != NULL) ? dv : BN_CTX_get(ctx);
90
0
    r = (rem != NULL) ? rem : BN_CTX_get(ctx);
91
0
    a = BN_CTX_get(ctx);
92
0
    b = BN_CTX_get(ctx);
93
0
    if (b == NULL)
94
0
        goto err;
95
96
0
    if (BN_ucmp(m, &(recp->N)) < 0) {
97
0
        BN_zero(d);
98
0
        if (!BN_copy(r, m)) {
99
0
            BN_CTX_end(ctx);
100
0
            return 0;
101
0
        }
102
0
        BN_CTX_end(ctx);
103
0
        return 1;
104
0
    }
105
106
    /*
107
     * We want the remainder Given input of ABCDEF / ab we need multiply
108
     * ABCDEF by 3 digests of the reciprocal of ab
109
     */
110
111
    /* i := max(BN_num_bits(m), 2*BN_num_bits(N)) */
112
0
    i = BN_num_bits(m);
113
0
    j = recp->num_bits << 1;
114
0
    if (j > i)
115
0
        i = j;
116
117
    /* Nr := round(2^i / N) */
118
0
    if (i != recp->shift)
119
0
        recp->shift = BN_reciprocal(&(recp->Nr), &(recp->N), i, ctx);
120
    /* BN_reciprocal could have returned -1 for an error */
121
0
    if (recp->shift == -1)
122
0
        goto err;
123
124
    /*-
125
     * d := |round(round(m / 2^BN_num_bits(N)) * recp->Nr / 2^(i - BN_num_bits(N)))|
126
     *    = |round(round(m / 2^BN_num_bits(N)) * round(2^i / N) / 2^(i - BN_num_bits(N)))|
127
     *   <= |(m / 2^BN_num_bits(N)) * (2^i / N) * (2^BN_num_bits(N) / 2^i)|
128
     *    = |m/N|
129
     */
130
0
    if (!BN_rshift(a, m, recp->num_bits))
131
0
        goto err;
132
0
    if (!BN_mul(b, a, &(recp->Nr), ctx))
133
0
        goto err;
134
0
    if (!BN_rshift(d, b, i - recp->num_bits))
135
0
        goto err;
136
0
    d->neg = 0;
137
138
0
    if (!BN_mul(b, &(recp->N), d, ctx))
139
0
        goto err;
140
0
    if (!BN_usub(r, m, b))
141
0
        goto err;
142
0
    r->neg = 0;
143
144
0
    j = 0;
145
0
    while (BN_ucmp(r, &(recp->N)) >= 0) {
146
0
        if (j++ > 2) {
147
0
            ERR_raise(ERR_LIB_BN, BN_R_BAD_RECIPROCAL);
148
0
            goto err;
149
0
        }
150
0
        if (!BN_usub(r, r, &(recp->N)))
151
0
            goto err;
152
0
        if (!BN_add_word(d, 1))
153
0
            goto err;
154
0
    }
155
156
0
    r->neg = BN_is_zero(r) ? 0 : m->neg;
157
0
    d->neg = m->neg ^ recp->N.neg;
158
0
    ret = 1;
159
0
 err:
160
0
    BN_CTX_end(ctx);
161
0
    bn_check_top(dv);
162
0
    bn_check_top(rem);
163
0
    return ret;
164
0
}
165
166
/*
167
 * len is the expected size of the result We actually calculate with an extra
168
 * word of precision, so we can do faster division if the remainder is not
169
 * required.
170
 */
171
/* r := 2^len / m */
172
int BN_reciprocal(BIGNUM *r, const BIGNUM *m, int len, BN_CTX *ctx)
173
0
{
174
0
    int ret = -1;
175
0
    BIGNUM *t;
176
177
0
    BN_CTX_start(ctx);
178
0
    if ((t = BN_CTX_get(ctx)) == NULL)
179
0
        goto err;
180
181
0
    if (!BN_set_bit(t, len))
182
0
        goto err;
183
184
0
    if (!BN_div(r, NULL, t, m, ctx))
185
0
        goto err;
186
187
0
    ret = len;
188
0
 err:
189
0
    bn_check_top(r);
190
0
    BN_CTX_end(ctx);
191
0
    return ret;
192
0
}