/src/openssl/crypto/ec/curve448/f_generic.c
Line  | Count  | Source (jump to first uncovered line)  | 
1  |  | /*  | 
2  |  |  * Copyright 2017-2023 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 "field.h"  | 
13  |  |  | 
14  |  | static const gf MODULUS = { | 
15  |  |     FIELD_LITERAL(0xffffffffffffffULL, 0xffffffffffffffULL, 0xffffffffffffffULL,  | 
16  |  |                   0xffffffffffffffULL, 0xfffffffffffffeULL, 0xffffffffffffffULL,  | 
17  |  |                   0xffffffffffffffULL, 0xffffffffffffffULL)  | 
18  |  | };  | 
19  |  |  | 
20  |  | /* Serialize to wire format. */  | 
21  |  | void gf_serialize(uint8_t serial[SER_BYTES], const gf x, int with_hibit)  | 
22  | 0  | { | 
23  | 0  |     unsigned int j = 0, fill = 0;  | 
24  | 0  |     dword_t buffer = 0;  | 
25  | 0  |     int i;  | 
26  | 0  |     gf red;  | 
27  |  | 
  | 
28  | 0  |     gf_copy(red, x);  | 
29  | 0  |     gf_strong_reduce(red);  | 
30  | 0  |     if (!with_hibit)  | 
31  | 0  |         assert(gf_hibit(red) == 0);  | 
32  |  |  | 
33  | 0  |     for (i = 0; i < (with_hibit ? X_SER_BYTES : SER_BYTES); i++) { | 
34  | 0  |         if (fill < 8 && j < NLIMBS) { | 
35  | 0  |             buffer |= ((dword_t) red->limb[LIMBPERM(j)]) << fill;  | 
36  | 0  |             fill += LIMB_PLACE_VALUE(LIMBPERM(j));  | 
37  | 0  |             j++;  | 
38  | 0  |         }  | 
39  | 0  |         serial[i] = (uint8_t)buffer;  | 
40  | 0  |         fill -= 8;  | 
41  | 0  |         buffer >>= 8;  | 
42  | 0  |     }  | 
43  | 0  | }  | 
44  |  |  | 
45  |  | /* Return high bit of x = low bit of 2x mod p */  | 
46  |  | mask_t gf_hibit(const gf x)  | 
47  | 0  | { | 
48  | 0  |     gf y;  | 
49  |  | 
  | 
50  | 0  |     gf_add(y, x, x);  | 
51  | 0  |     gf_strong_reduce(y);  | 
52  | 0  |     return 0 - (y->limb[0] & 1);  | 
53  | 0  | }  | 
54  |  |  | 
55  |  | /* Return high bit of x = low bit of 2x mod p */  | 
56  |  | mask_t gf_lobit(const gf x)  | 
57  | 0  | { | 
58  | 0  |     gf y;  | 
59  |  | 
  | 
60  | 0  |     gf_copy(y, x);  | 
61  | 0  |     gf_strong_reduce(y);  | 
62  | 0  |     return 0 - (y->limb[0] & 1);  | 
63  | 0  | }  | 
64  |  |  | 
65  |  | /* Deserialize from wire format; return -1 on success and 0 on failure. */  | 
66  |  | mask_t gf_deserialize(gf x, const uint8_t serial[SER_BYTES], int with_hibit,  | 
67  |  |                       uint8_t hi_nmask)  | 
68  | 0  | { | 
69  | 0  |     unsigned int j = 0, fill = 0;  | 
70  | 0  |     dword_t buffer = 0;  | 
71  | 0  |     dsword_t scarry = 0;  | 
72  | 0  |     const unsigned nbytes = with_hibit ? X_SER_BYTES : SER_BYTES;  | 
73  | 0  |     unsigned int i;  | 
74  | 0  |     mask_t succ;  | 
75  |  | 
  | 
76  | 0  |     for (i = 0; i < NLIMBS; i++) { | 
77  | 0  |         while (fill < LIMB_PLACE_VALUE(LIMBPERM(i)) && j < nbytes) { | 
78  | 0  |             uint8_t sj;  | 
79  |  | 
  | 
80  | 0  |             sj = serial[j];  | 
81  | 0  |             if (j == nbytes - 1)  | 
82  | 0  |                 sj &= ~hi_nmask;  | 
83  | 0  |             buffer |= ((dword_t) sj) << fill;  | 
84  | 0  |             fill += 8;  | 
85  | 0  |             j++;  | 
86  | 0  |         }  | 
87  | 0  |         x->limb[LIMBPERM(i)] = (word_t)  | 
88  | 0  |             ((i < NLIMBS - 1) ? buffer & LIMB_MASK(LIMBPERM(i)) : buffer);  | 
89  | 0  |         fill -= LIMB_PLACE_VALUE(LIMBPERM(i));  | 
90  | 0  |         buffer >>= LIMB_PLACE_VALUE(LIMBPERM(i));  | 
91  | 0  |         scarry =  | 
92  | 0  |             (scarry + x->limb[LIMBPERM(i)] -  | 
93  | 0  |              MODULUS->limb[LIMBPERM(i)]) >> (8 * sizeof(word_t));  | 
94  | 0  |     }  | 
95  | 0  |     succ = with_hibit ? 0 - (mask_t) 1 : ~gf_hibit(x);  | 
96  | 0  |     return succ & word_is_zero((word_t)buffer) & ~word_is_zero((word_t)scarry);  | 
97  | 0  | }  | 
98  |  |  | 
99  |  | /* Reduce to canonical form. */  | 
100  |  | void gf_strong_reduce(gf a)  | 
101  | 0  | { | 
102  | 0  |     dsword_t scarry;  | 
103  | 0  |     word_t scarry_0;  | 
104  | 0  |     dword_t carry = 0;  | 
105  | 0  |     unsigned int i;  | 
106  |  |  | 
107  |  |     /* first, clear high */  | 
108  | 0  |     gf_weak_reduce(a);          /* Determined to have negligible perf impact. */  | 
109  |  |  | 
110  |  |     /* now the total is less than 2p */  | 
111  |  |  | 
112  |  |     /* compute total_value - p.  No need to reduce mod p. */  | 
113  | 0  |     scarry = 0;  | 
114  | 0  |     for (i = 0; i < NLIMBS; i++) { | 
115  | 0  |         scarry = scarry + a->limb[LIMBPERM(i)] - MODULUS->limb[LIMBPERM(i)];  | 
116  | 0  |         a->limb[LIMBPERM(i)] = scarry & LIMB_MASK(LIMBPERM(i));  | 
117  | 0  |         scarry >>= LIMB_PLACE_VALUE(LIMBPERM(i));  | 
118  | 0  |     }  | 
119  |  |  | 
120  |  |     /*  | 
121  |  |      * uncommon case: it was >= p, so now scarry = 0 and this = x common case:  | 
122  |  |      * it was < p, so now scarry = -1 and this = x - p + 2^255 so let's add  | 
123  |  |      * back in p.  will carry back off the top for 2^255.  | 
124  |  |      */  | 
125  | 0  |     assert(scarry == 0 || scarry == -1);  | 
126  |  |  | 
127  | 0  |     scarry_0 = (word_t)scarry;  | 
128  |  |  | 
129  |  |     /* add it back */  | 
130  | 0  |     for (i = 0; i < NLIMBS; i++) { | 
131  | 0  |         carry =  | 
132  | 0  |             carry + a->limb[LIMBPERM(i)] +  | 
133  | 0  |             (scarry_0 & MODULUS->limb[LIMBPERM(i)]);  | 
134  | 0  |         a->limb[LIMBPERM(i)] = carry & LIMB_MASK(LIMBPERM(i));  | 
135  | 0  |         carry >>= LIMB_PLACE_VALUE(LIMBPERM(i));  | 
136  | 0  |     }  | 
137  |  | 
  | 
138  | 0  |     assert(carry < 2 && ((word_t)carry + scarry_0) == 0);  | 
139  | 0  | }  | 
140  |  |  | 
141  |  | /* Subtract two gf elements d=a-b */  | 
142  |  | void gf_sub(gf d, const gf a, const gf b)  | 
143  | 0  | { | 
144  | 0  |     gf_sub_RAW(d, a, b);  | 
145  | 0  |     gf_bias(d, 2);  | 
146  | 0  |     gf_weak_reduce(d);  | 
147  | 0  | }  | 
148  |  |  | 
149  |  | /* Add two field elements d = a+b */  | 
150  |  | void gf_add(gf d, const gf a, const gf b)  | 
151  | 0  | { | 
152  | 0  |     gf_add_RAW(d, a, b);  | 
153  | 0  |     gf_weak_reduce(d);  | 
154  | 0  | }  | 
155  |  |  | 
156  |  | /* Compare a==b */  | 
157  |  | mask_t gf_eq(const gf a, const gf b)  | 
158  | 0  | { | 
159  | 0  |     gf c;  | 
160  | 0  |     mask_t ret = 0;  | 
161  | 0  |     unsigned int i;  | 
162  |  | 
  | 
163  | 0  |     gf_sub(c, a, b);  | 
164  | 0  |     gf_strong_reduce(c);  | 
165  |  | 
  | 
166  | 0  |     for (i = 0; i < NLIMBS; i++)  | 
167  | 0  |         ret |= c->limb[LIMBPERM(i)];  | 
168  |  | 
  | 
169  | 0  |     return word_is_zero(ret);  | 
170  | 0  | }  | 
171  |  |  | 
172  |  | mask_t gf_isr(gf a, const gf x)  | 
173  | 0  | { | 
174  | 0  |     gf L0, L1, L2;  | 
175  |  | 
  | 
176  | 0  |     ossl_gf_sqr(L1, x);  | 
177  | 0  |     ossl_gf_mul(L2, x, L1);  | 
178  | 0  |     ossl_gf_sqr(L1, L2);  | 
179  | 0  |     ossl_gf_mul(L2, x, L1);  | 
180  | 0  |     gf_sqrn(L1, L2, 3);  | 
181  | 0  |     ossl_gf_mul(L0, L2, L1);  | 
182  | 0  |     gf_sqrn(L1, L0, 3);  | 
183  | 0  |     ossl_gf_mul(L0, L2, L1);  | 
184  | 0  |     gf_sqrn(L2, L0, 9);  | 
185  | 0  |     ossl_gf_mul(L1, L0, L2);  | 
186  | 0  |     ossl_gf_sqr(L0, L1);  | 
187  | 0  |     ossl_gf_mul(L2, x, L0);  | 
188  | 0  |     gf_sqrn(L0, L2, 18);  | 
189  | 0  |     ossl_gf_mul(L2, L1, L0);  | 
190  | 0  |     gf_sqrn(L0, L2, 37);  | 
191  | 0  |     ossl_gf_mul(L1, L2, L0);  | 
192  | 0  |     gf_sqrn(L0, L1, 37);  | 
193  | 0  |     ossl_gf_mul(L1, L2, L0);  | 
194  | 0  |     gf_sqrn(L0, L1, 111);  | 
195  | 0  |     ossl_gf_mul(L2, L1, L0);  | 
196  | 0  |     ossl_gf_sqr(L0, L2);  | 
197  | 0  |     ossl_gf_mul(L1, x, L0);  | 
198  | 0  |     gf_sqrn(L0, L1, 223);  | 
199  | 0  |     ossl_gf_mul(L1, L2, L0);  | 
200  | 0  |     ossl_gf_sqr(L2, L1);  | 
201  | 0  |     ossl_gf_mul(L0, L2, x);  | 
202  | 0  |     gf_copy(a, L1);  | 
203  | 0  |     return gf_eq(L0, ONE);  | 
204  | 0  | }  |