/src/openssl/crypto/ec/curve448/f_generic.c
Line | Count | Source (jump to first uncovered line) |
1 | | /* |
2 | | * Copyright 2017-2018 The OpenSSL Project Authors. All Rights Reserved. |
3 | | * Copyright 2015-2016 Cryptography Research, Inc. |
4 | | * |
5 | | * Licensed under the OpenSSL license (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(0xffffffffffffff, 0xffffffffffffff, 0xffffffffffffff, |
16 | | 0xffffffffffffff, 0xfffffffffffffe, 0xffffffffffffff, |
17 | | 0xffffffffffffff, 0xffffffffffffff) |
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 | 0 |
|
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 | 0 |
|
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 | 0 |
|
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 | 0 |
|
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 | 0 |
|
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 | 0 |
|
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 | 0 |
|
107 | 0 | /* first, clear high */ |
108 | 0 | gf_weak_reduce(a); /* Determined to have negligible perf impact. */ |
109 | 0 |
|
110 | 0 | /* now the total is less than 2p */ |
111 | 0 |
|
112 | 0 | /* 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 | 0 |
|
120 | 0 | /* |
121 | 0 | * uncommon case: it was >= p, so now scarry = 0 and this = x common case: |
122 | 0 | * it was < p, so now scarry = -1 and this = x - p + 2^255 so let's add |
123 | 0 | * back in p. will carry back off the top for 2^255. |
124 | 0 | */ |
125 | 0 | assert(scarry == 0 || scarry == -1); |
126 | 0 |
|
127 | 0 | scarry_0 = (word_t)scarry; |
128 | 0 |
|
129 | 0 | /* 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 | 0 |
|
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 | 0 |
|
163 | 0 | gf_sub(c, a, b); |
164 | 0 | gf_strong_reduce(c); |
165 | 0 |
|
166 | 0 | for (i = 0; i < NLIMBS; i++) |
167 | 0 | ret |= c->limb[LIMBPERM(i)]; |
168 | 0 |
|
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 | 0 |
|
176 | 0 | gf_sqr(L1, x); |
177 | 0 | gf_mul(L2, x, L1); |
178 | 0 | gf_sqr(L1, L2); |
179 | 0 | gf_mul(L2, x, L1); |
180 | 0 | gf_sqrn(L1, L2, 3); |
181 | 0 | gf_mul(L0, L2, L1); |
182 | 0 | gf_sqrn(L1, L0, 3); |
183 | 0 | gf_mul(L0, L2, L1); |
184 | 0 | gf_sqrn(L2, L0, 9); |
185 | 0 | gf_mul(L1, L0, L2); |
186 | 0 | gf_sqr(L0, L1); |
187 | 0 | gf_mul(L2, x, L0); |
188 | 0 | gf_sqrn(L0, L2, 18); |
189 | 0 | gf_mul(L2, L1, L0); |
190 | 0 | gf_sqrn(L0, L2, 37); |
191 | 0 | gf_mul(L1, L2, L0); |
192 | 0 | gf_sqrn(L0, L1, 37); |
193 | 0 | gf_mul(L1, L2, L0); |
194 | 0 | gf_sqrn(L0, L1, 111); |
195 | 0 | gf_mul(L2, L1, L0); |
196 | 0 | gf_sqr(L0, L2); |
197 | 0 | gf_mul(L1, x, L0); |
198 | 0 | gf_sqrn(L0, L1, 223); |
199 | 0 | gf_mul(L1, L2, L0); |
200 | 0 | gf_sqr(L2, L1); |
201 | 0 | gf_mul(L0, L2, x); |
202 | 0 | gf_copy(a, L1); |
203 | 0 | return gf_eq(L0, ONE); |
204 | 0 | } |