Coverage Report

Created: 2025-06-13 06:58

/src/openssl31/crypto/ec/curve448/scalar.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Copyright 2017-2021 The OpenSSL Project Authors. All Rights Reserved.
3
 * Copyright 2015-2016 Cryptography Research, Inc.
4
 *
5
 * Licensed under the Apache License 2.0 (the "License").  You may not use
6
 * this file except in compliance with the License.  You can obtain a copy
7
 * in the file LICENSE in the source distribution or at
8
 * https://www.openssl.org/source/license.html
9
 *
10
 * Originally written by Mike Hamburg
11
 */
12
#include <openssl/crypto.h>
13
14
#include "word.h"
15
#include "point_448.h"
16
17
static const c448_word_t MONTGOMERY_FACTOR = (c448_word_t) 0x3bd440fae918bc5ULL;
18
static const curve448_scalar_t sc_p = {
19
    {
20
        {
21
            SC_LIMB(0x2378c292ab5844f3ULL), SC_LIMB(0x216cc2728dc58f55ULL),
22
            SC_LIMB(0xc44edb49aed63690ULL), SC_LIMB(0xffffffff7cca23e9ULL),
23
            SC_LIMB(0xffffffffffffffffULL), SC_LIMB(0xffffffffffffffffULL),
24
            SC_LIMB(0x3fffffffffffffffULL)
25
        }
26
    }
27
}, sc_r2 = {
28
    {
29
        {
30
31
            SC_LIMB(0xe3539257049b9b60ULL), SC_LIMB(0x7af32c4bc1b195d9ULL),
32
            SC_LIMB(0x0d66de2388ea1859ULL), SC_LIMB(0xae17cf725ee4d838ULL),
33
            SC_LIMB(0x1a9cc14ba3c47c44ULL), SC_LIMB(0x2052bcb7e4d070afULL),
34
            SC_LIMB(0x3402a939f823b729ULL)
35
        }
36
    }
37
};
38
39
96.2k
#define WBITS C448_WORD_BITS   /* NB this may be different from ARCH_WORD_BITS */
40
41
const curve448_scalar_t ossl_curve448_scalar_one = {{{1}}};
42
const curve448_scalar_t ossl_curve448_scalar_zero = {{{0}}};
43
44
/*
45
 * {extra,accum} - sub +? p
46
 * Must have extra <= 1
47
 */
48
static void sc_subx(curve448_scalar_t out,
49
                    const c448_word_t accum[C448_SCALAR_LIMBS],
50
                    const curve448_scalar_t sub,
51
                    const curve448_scalar_t p, c448_word_t extra)
52
1.07k
{
53
1.07k
    c448_dsword_t chain = 0;
54
1.07k
    unsigned int i;
55
1.07k
    c448_word_t borrow;
56
57
8.59k
    for (i = 0; i < C448_SCALAR_LIMBS; i++) {
58
7.51k
        chain = (chain + accum[i]) - sub->limb[i];
59
7.51k
        out->limb[i] = (c448_word_t)chain;
60
7.51k
        chain >>= WBITS;
61
7.51k
    }
62
1.07k
    borrow = (c448_word_t)chain + extra;     /* = 0 or -1 */
63
64
1.07k
    chain = 0;
65
8.59k
    for (i = 0; i < C448_SCALAR_LIMBS; i++) {
66
7.51k
        chain = (chain + out->limb[i]) + (p->limb[i] & borrow);
67
7.51k
        out->limb[i] = (c448_word_t)chain;
68
7.51k
        chain >>= WBITS;
69
7.51k
    }
70
1.07k
}
71
72
static void sc_montmul(curve448_scalar_t out, const curve448_scalar_t a,
73
                       const curve448_scalar_t b)
74
726
{
75
726
    unsigned int i, j;
76
726
    c448_word_t accum[C448_SCALAR_LIMBS + 1] = { 0 };
77
726
    c448_word_t hi_carry = 0;
78
79
5.80k
    for (i = 0; i < C448_SCALAR_LIMBS; i++) {
80
5.08k
        c448_word_t mand = a->limb[i];
81
5.08k
        const c448_word_t *mier = b->limb;
82
83
5.08k
        c448_dword_t chain = 0;
84
40.6k
        for (j = 0; j < C448_SCALAR_LIMBS; j++) {
85
35.5k
            chain += ((c448_dword_t) mand) * mier[j] + accum[j];
86
35.5k
            accum[j] = (c448_word_t)chain;
87
35.5k
            chain >>= WBITS;
88
35.5k
        }
89
5.08k
        accum[j] = (c448_word_t)chain;
90
91
5.08k
        mand = accum[0] * MONTGOMERY_FACTOR;
92
5.08k
        chain = 0;
93
5.08k
        mier = sc_p->limb;
94
40.6k
        for (j = 0; j < C448_SCALAR_LIMBS; j++) {
95
35.5k
            chain += (c448_dword_t) mand *mier[j] + accum[j];
96
35.5k
            if (j)
97
30.4k
                accum[j - 1] = (c448_word_t)chain;
98
35.5k
            chain >>= WBITS;
99
35.5k
        }
100
5.08k
        chain += accum[j];
101
5.08k
        chain += hi_carry;
102
5.08k
        accum[j - 1] = (c448_word_t)chain;
103
5.08k
        hi_carry = chain >> WBITS;
104
5.08k
    }
105
106
726
    sc_subx(out, accum, sc_p, sc_p, hi_carry);
107
726
}
108
109
void ossl_curve448_scalar_mul(curve448_scalar_t out, const curve448_scalar_t a,
110
                              const curve448_scalar_t b)
111
268
{
112
268
    sc_montmul(out, a, b);
113
268
    sc_montmul(out, out, sc_r2);
114
268
}
115
116
void
117
ossl_curve448_scalar_sub(curve448_scalar_t out, const curve448_scalar_t a,
118
                         const curve448_scalar_t b)
119
55
{
120
55
    sc_subx(out, a->limb, b, sc_p, 0);
121
55
}
122
123
void
124
ossl_curve448_scalar_add(curve448_scalar_t out, const curve448_scalar_t a,
125
                         const curve448_scalar_t b)
126
293
{
127
293
    c448_dword_t chain = 0;
128
293
    unsigned int i;
129
130
2.34k
    for (i = 0; i < C448_SCALAR_LIMBS; i++) {
131
2.05k
        chain = (chain + a->limb[i]) + b->limb[i];
132
2.05k
        out->limb[i] = (c448_word_t)chain;
133
2.05k
        chain >>= WBITS;
134
2.05k
    }
135
293
    sc_subx(out, out->limb, sc_p, sc_p, (c448_word_t)chain);
136
293
}
137
138
static ossl_inline void scalar_decode_short(curve448_scalar_t s,
139
                                            const unsigned char *ser,
140
                                            size_t nbytes)
141
403
{
142
403
    size_t i, j, k = 0;
143
144
3.22k
    for (i = 0; i < C448_SCALAR_LIMBS; i++) {
145
2.82k
        c448_word_t out = 0;
146
147
18.0k
        for (j = 0; j < sizeof(c448_word_t) && k < nbytes; j++, k++)
148
15.1k
            out |= ((c448_word_t) ser[k]) << (8 * j);
149
2.82k
        s->limb[i] = out;
150
2.82k
    }
151
403
}
152
153
c448_error_t
154
ossl_curve448_scalar_decode(curve448_scalar_t s,
155
                            const unsigned char ser[C448_SCALAR_BYTES])
156
190
{
157
190
    unsigned int i;
158
190
    c448_dsword_t accum = 0;
159
160
190
    scalar_decode_short(s, ser, C448_SCALAR_BYTES);
161
1.52k
    for (i = 0; i < C448_SCALAR_LIMBS; i++)
162
1.33k
        accum = (accum + s->limb[i] - sc_p->limb[i]) >> WBITS;
163
    /* Here accum == 0 or -1 */
164
165
190
    ossl_curve448_scalar_mul(s, s, ossl_curve448_scalar_one); /* ham-handed reduce */
166
167
190
    return c448_succeed_if(~word_is_zero((uint32_t)accum));
168
190
}
169
170
void ossl_curve448_scalar_destroy(curve448_scalar_t scalar)
171
373
{
172
373
    OPENSSL_cleanse(scalar, sizeof(curve448_scalar_t));
173
373
}
174
175
void
176
ossl_curve448_scalar_decode_long(curve448_scalar_t s,
177
                                 const unsigned char *ser, size_t ser_len)
178
213
{
179
213
    size_t i;
180
213
    curve448_scalar_t t1, t2;
181
182
213
    if (ser_len == 0) {
183
0
        curve448_scalar_copy(s, ossl_curve448_scalar_zero);
184
0
        return;
185
0
    }
186
187
213
    i = ser_len - (ser_len % C448_SCALAR_BYTES);
188
213
    if (i == ser_len)
189
78
        i -= C448_SCALAR_BYTES;
190
191
213
    scalar_decode_short(t1, &ser[i], ser_len - i);
192
193
213
    if (ser_len == sizeof(curve448_scalar_t)) {
194
78
        assert(i == 0);
195
        /* ham-handed reduce */
196
78
        ossl_curve448_scalar_mul(s, t1, ossl_curve448_scalar_one);
197
78
        ossl_curve448_scalar_destroy(t1);
198
78
        return;
199
78
    }
200
201
325
    while (i) {
202
190
        i -= C448_SCALAR_BYTES;
203
190
        sc_montmul(t1, t1, sc_r2);
204
190
        (void)ossl_curve448_scalar_decode(t2, ser + i);
205
190
        ossl_curve448_scalar_add(t1, t1, t2);
206
190
    }
207
208
135
    curve448_scalar_copy(s, t1);
209
135
    ossl_curve448_scalar_destroy(t1);
210
135
    ossl_curve448_scalar_destroy(t2);
211
135
}
212
213
void
214
ossl_curve448_scalar_encode(unsigned char ser[C448_SCALAR_BYTES],
215
                            const curve448_scalar_t s)
216
0
{
217
0
    unsigned int i, j, k = 0;
218
219
0
    for (i = 0; i < C448_SCALAR_LIMBS; i++) {
220
0
        for (j = 0; j < sizeof(c448_word_t); j++, k++)
221
0
            ser[k] = s->limb[i] >> (8 * j);
222
0
    }
223
0
}
224
225
void
226
ossl_curve448_scalar_halve(curve448_scalar_t out, const curve448_scalar_t a)
227
231
{
228
231
    c448_word_t mask = 0 - (a->limb[0] & 1);
229
231
    c448_dword_t chain = 0;
230
231
    unsigned int i;
231
232
1.84k
    for (i = 0; i < C448_SCALAR_LIMBS; i++) {
233
1.61k
        chain = (chain + a->limb[i]) + (sc_p->limb[i] & mask);
234
1.61k
        out->limb[i] = (c448_word_t)chain;
235
1.61k
        chain >>= C448_WORD_BITS;
236
1.61k
    }
237
1.61k
    for (i = 0; i < C448_SCALAR_LIMBS - 1; i++)
238
1.38k
        out->limb[i] = out->limb[i] >> 1 | out->limb[i + 1] << (WBITS - 1);
239
231
    out->limb[i] = out->limb[i] >> 1 | (c448_word_t)(chain << (WBITS - 1));
240
231
}