/src/openssl/crypto/ec/curve448/f_generic.c
Line | Count | Source |
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)((i < NLIMBS - 1) ? buffer & LIMB_MASK(LIMBPERM(i)) : buffer); |
88 | 0 | fill -= LIMB_PLACE_VALUE(LIMBPERM(i)); |
89 | 0 | buffer >>= LIMB_PLACE_VALUE(LIMBPERM(i)); |
90 | 0 | scarry = (scarry + x->limb[LIMBPERM(i)] - MODULUS->limb[LIMBPERM(i)]) >> (8 * sizeof(word_t)); |
91 | 0 | } |
92 | 0 | succ = with_hibit ? 0 - (mask_t)1 : ~gf_hibit(x); |
93 | 0 | return succ & word_is_zero((word_t)buffer) & ~word_is_zero((word_t)scarry); |
94 | 0 | } |
95 | | |
96 | | /* Reduce to canonical form. */ |
97 | | void gf_strong_reduce(gf a) |
98 | 0 | { |
99 | 0 | dsword_t scarry; |
100 | 0 | word_t scarry_0; |
101 | 0 | dword_t carry = 0; |
102 | 0 | unsigned int i; |
103 | | |
104 | | /* first, clear high */ |
105 | 0 | gf_weak_reduce(a); /* Determined to have negligible perf impact. */ |
106 | | |
107 | | /* now the total is less than 2p */ |
108 | | |
109 | | /* compute total_value - p. No need to reduce mod p. */ |
110 | 0 | scarry = 0; |
111 | 0 | for (i = 0; i < NLIMBS; i++) { |
112 | 0 | scarry = scarry + a->limb[LIMBPERM(i)] - MODULUS->limb[LIMBPERM(i)]; |
113 | 0 | a->limb[LIMBPERM(i)] = scarry & LIMB_MASK(LIMBPERM(i)); |
114 | 0 | scarry >>= LIMB_PLACE_VALUE(LIMBPERM(i)); |
115 | 0 | } |
116 | | |
117 | | /* |
118 | | * uncommon case: it was >= p, so now scarry = 0 and this = x common case: |
119 | | * it was < p, so now scarry = -1 and this = x - p + 2^255 so let's add |
120 | | * back in p. will carry back off the top for 2^255. |
121 | | */ |
122 | 0 | assert(scarry == 0 || scarry == -1); |
123 | |
|
124 | 0 | scarry_0 = (word_t)scarry; |
125 | | |
126 | | /* add it back */ |
127 | 0 | for (i = 0; i < NLIMBS; i++) { |
128 | 0 | carry = carry + a->limb[LIMBPERM(i)] + (scarry_0 & MODULUS->limb[LIMBPERM(i)]); |
129 | 0 | a->limb[LIMBPERM(i)] = carry & LIMB_MASK(LIMBPERM(i)); |
130 | 0 | carry >>= LIMB_PLACE_VALUE(LIMBPERM(i)); |
131 | 0 | } |
132 | |
|
133 | 0 | assert(carry < 2 && ((word_t)carry + scarry_0) == 0); |
134 | 0 | } |
135 | | |
136 | | /* Subtract two gf elements d=a-b */ |
137 | | void gf_sub(gf d, const gf a, const gf b) |
138 | 0 | { |
139 | 0 | gf_sub_RAW(d, a, b); |
140 | 0 | gf_bias(d, 2); |
141 | 0 | gf_weak_reduce(d); |
142 | 0 | } |
143 | | |
144 | | /* Add two field elements d = a+b */ |
145 | | void gf_add(gf d, const gf a, const gf b) |
146 | 0 | { |
147 | 0 | gf_add_RAW(d, a, b); |
148 | 0 | gf_weak_reduce(d); |
149 | 0 | } |
150 | | |
151 | | /* Compare a==b */ |
152 | | mask_t gf_eq(const gf a, const gf b) |
153 | 0 | { |
154 | 0 | gf c; |
155 | 0 | mask_t ret = 0; |
156 | 0 | unsigned int i; |
157 | |
|
158 | 0 | gf_sub(c, a, b); |
159 | 0 | gf_strong_reduce(c); |
160 | |
|
161 | 0 | for (i = 0; i < NLIMBS; i++) |
162 | 0 | ret |= c->limb[LIMBPERM(i)]; |
163 | |
|
164 | 0 | return word_is_zero(ret); |
165 | 0 | } |
166 | | |
167 | | mask_t gf_isr(gf a, const gf x) |
168 | 0 | { |
169 | 0 | gf L0, L1, L2; |
170 | |
|
171 | 0 | ossl_gf_sqr(L1, x); |
172 | 0 | ossl_gf_mul(L2, x, L1); |
173 | 0 | ossl_gf_sqr(L1, L2); |
174 | 0 | ossl_gf_mul(L2, x, L1); |
175 | 0 | gf_sqrn(L1, L2, 3); |
176 | 0 | ossl_gf_mul(L0, L2, L1); |
177 | 0 | gf_sqrn(L1, L0, 3); |
178 | 0 | ossl_gf_mul(L0, L2, L1); |
179 | 0 | gf_sqrn(L2, L0, 9); |
180 | 0 | ossl_gf_mul(L1, L0, L2); |
181 | 0 | ossl_gf_sqr(L0, L1); |
182 | 0 | ossl_gf_mul(L2, x, L0); |
183 | 0 | gf_sqrn(L0, L2, 18); |
184 | 0 | ossl_gf_mul(L2, L1, L0); |
185 | 0 | gf_sqrn(L0, L2, 37); |
186 | 0 | ossl_gf_mul(L1, L2, L0); |
187 | 0 | gf_sqrn(L0, L1, 37); |
188 | 0 | ossl_gf_mul(L1, L2, L0); |
189 | 0 | gf_sqrn(L0, L1, 111); |
190 | 0 | ossl_gf_mul(L2, L1, L0); |
191 | 0 | ossl_gf_sqr(L0, L2); |
192 | 0 | ossl_gf_mul(L1, x, L0); |
193 | 0 | gf_sqrn(L0, L1, 223); |
194 | 0 | ossl_gf_mul(L1, L2, L0); |
195 | 0 | ossl_gf_sqr(L2, L1); |
196 | 0 | ossl_gf_mul(L0, L2, x); |
197 | 0 | gf_copy(a, L1); |
198 | 0 | return gf_eq(L0, ONE); |
199 | 0 | } |