1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0-or-later
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun * Cryptographic API.
4*4882a593Smuzhiyun *
5*4882a593Smuzhiyun * SHA-3, as specified in
6*4882a593Smuzhiyun * https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.202.pdf
7*4882a593Smuzhiyun *
8*4882a593Smuzhiyun * SHA-3 code by Jeff Garzik <jeff@garzik.org>
9*4882a593Smuzhiyun * Ard Biesheuvel <ard.biesheuvel@linaro.org>
10*4882a593Smuzhiyun */
11*4882a593Smuzhiyun #include <crypto/internal/hash.h>
12*4882a593Smuzhiyun #include <linux/init.h>
13*4882a593Smuzhiyun #include <linux/module.h>
14*4882a593Smuzhiyun #include <linux/types.h>
15*4882a593Smuzhiyun #include <crypto/sha3.h>
16*4882a593Smuzhiyun #include <asm/unaligned.h>
17*4882a593Smuzhiyun
18*4882a593Smuzhiyun /*
19*4882a593Smuzhiyun * On some 32-bit architectures (h8300), GCC ends up using
20*4882a593Smuzhiyun * over 1 KB of stack if we inline the round calculation into the loop
21*4882a593Smuzhiyun * in keccakf(). On the other hand, on 64-bit architectures with plenty
22*4882a593Smuzhiyun * of [64-bit wide] general purpose registers, not inlining it severely
23*4882a593Smuzhiyun * hurts performance. So let's use 64-bitness as a heuristic to decide
24*4882a593Smuzhiyun * whether to inline or not.
25*4882a593Smuzhiyun */
26*4882a593Smuzhiyun #ifdef CONFIG_64BIT
27*4882a593Smuzhiyun #define SHA3_INLINE inline
28*4882a593Smuzhiyun #else
29*4882a593Smuzhiyun #define SHA3_INLINE noinline
30*4882a593Smuzhiyun #endif
31*4882a593Smuzhiyun
32*4882a593Smuzhiyun #define KECCAK_ROUNDS 24
33*4882a593Smuzhiyun
34*4882a593Smuzhiyun static const u64 keccakf_rndc[24] = {
35*4882a593Smuzhiyun 0x0000000000000001ULL, 0x0000000000008082ULL, 0x800000000000808aULL,
36*4882a593Smuzhiyun 0x8000000080008000ULL, 0x000000000000808bULL, 0x0000000080000001ULL,
37*4882a593Smuzhiyun 0x8000000080008081ULL, 0x8000000000008009ULL, 0x000000000000008aULL,
38*4882a593Smuzhiyun 0x0000000000000088ULL, 0x0000000080008009ULL, 0x000000008000000aULL,
39*4882a593Smuzhiyun 0x000000008000808bULL, 0x800000000000008bULL, 0x8000000000008089ULL,
40*4882a593Smuzhiyun 0x8000000000008003ULL, 0x8000000000008002ULL, 0x8000000000000080ULL,
41*4882a593Smuzhiyun 0x000000000000800aULL, 0x800000008000000aULL, 0x8000000080008081ULL,
42*4882a593Smuzhiyun 0x8000000000008080ULL, 0x0000000080000001ULL, 0x8000000080008008ULL
43*4882a593Smuzhiyun };
44*4882a593Smuzhiyun
45*4882a593Smuzhiyun /* update the state with given number of rounds */
46*4882a593Smuzhiyun
keccakf_round(u64 st[25])47*4882a593Smuzhiyun static SHA3_INLINE void keccakf_round(u64 st[25])
48*4882a593Smuzhiyun {
49*4882a593Smuzhiyun u64 t[5], tt, bc[5];
50*4882a593Smuzhiyun
51*4882a593Smuzhiyun /* Theta */
52*4882a593Smuzhiyun bc[0] = st[0] ^ st[5] ^ st[10] ^ st[15] ^ st[20];
53*4882a593Smuzhiyun bc[1] = st[1] ^ st[6] ^ st[11] ^ st[16] ^ st[21];
54*4882a593Smuzhiyun bc[2] = st[2] ^ st[7] ^ st[12] ^ st[17] ^ st[22];
55*4882a593Smuzhiyun bc[3] = st[3] ^ st[8] ^ st[13] ^ st[18] ^ st[23];
56*4882a593Smuzhiyun bc[4] = st[4] ^ st[9] ^ st[14] ^ st[19] ^ st[24];
57*4882a593Smuzhiyun
58*4882a593Smuzhiyun t[0] = bc[4] ^ rol64(bc[1], 1);
59*4882a593Smuzhiyun t[1] = bc[0] ^ rol64(bc[2], 1);
60*4882a593Smuzhiyun t[2] = bc[1] ^ rol64(bc[3], 1);
61*4882a593Smuzhiyun t[3] = bc[2] ^ rol64(bc[4], 1);
62*4882a593Smuzhiyun t[4] = bc[3] ^ rol64(bc[0], 1);
63*4882a593Smuzhiyun
64*4882a593Smuzhiyun st[0] ^= t[0];
65*4882a593Smuzhiyun
66*4882a593Smuzhiyun /* Rho Pi */
67*4882a593Smuzhiyun tt = st[1];
68*4882a593Smuzhiyun st[ 1] = rol64(st[ 6] ^ t[1], 44);
69*4882a593Smuzhiyun st[ 6] = rol64(st[ 9] ^ t[4], 20);
70*4882a593Smuzhiyun st[ 9] = rol64(st[22] ^ t[2], 61);
71*4882a593Smuzhiyun st[22] = rol64(st[14] ^ t[4], 39);
72*4882a593Smuzhiyun st[14] = rol64(st[20] ^ t[0], 18);
73*4882a593Smuzhiyun st[20] = rol64(st[ 2] ^ t[2], 62);
74*4882a593Smuzhiyun st[ 2] = rol64(st[12] ^ t[2], 43);
75*4882a593Smuzhiyun st[12] = rol64(st[13] ^ t[3], 25);
76*4882a593Smuzhiyun st[13] = rol64(st[19] ^ t[4], 8);
77*4882a593Smuzhiyun st[19] = rol64(st[23] ^ t[3], 56);
78*4882a593Smuzhiyun st[23] = rol64(st[15] ^ t[0], 41);
79*4882a593Smuzhiyun st[15] = rol64(st[ 4] ^ t[4], 27);
80*4882a593Smuzhiyun st[ 4] = rol64(st[24] ^ t[4], 14);
81*4882a593Smuzhiyun st[24] = rol64(st[21] ^ t[1], 2);
82*4882a593Smuzhiyun st[21] = rol64(st[ 8] ^ t[3], 55);
83*4882a593Smuzhiyun st[ 8] = rol64(st[16] ^ t[1], 45);
84*4882a593Smuzhiyun st[16] = rol64(st[ 5] ^ t[0], 36);
85*4882a593Smuzhiyun st[ 5] = rol64(st[ 3] ^ t[3], 28);
86*4882a593Smuzhiyun st[ 3] = rol64(st[18] ^ t[3], 21);
87*4882a593Smuzhiyun st[18] = rol64(st[17] ^ t[2], 15);
88*4882a593Smuzhiyun st[17] = rol64(st[11] ^ t[1], 10);
89*4882a593Smuzhiyun st[11] = rol64(st[ 7] ^ t[2], 6);
90*4882a593Smuzhiyun st[ 7] = rol64(st[10] ^ t[0], 3);
91*4882a593Smuzhiyun st[10] = rol64( tt ^ t[1], 1);
92*4882a593Smuzhiyun
93*4882a593Smuzhiyun /* Chi */
94*4882a593Smuzhiyun bc[ 0] = ~st[ 1] & st[ 2];
95*4882a593Smuzhiyun bc[ 1] = ~st[ 2] & st[ 3];
96*4882a593Smuzhiyun bc[ 2] = ~st[ 3] & st[ 4];
97*4882a593Smuzhiyun bc[ 3] = ~st[ 4] & st[ 0];
98*4882a593Smuzhiyun bc[ 4] = ~st[ 0] & st[ 1];
99*4882a593Smuzhiyun st[ 0] ^= bc[ 0];
100*4882a593Smuzhiyun st[ 1] ^= bc[ 1];
101*4882a593Smuzhiyun st[ 2] ^= bc[ 2];
102*4882a593Smuzhiyun st[ 3] ^= bc[ 3];
103*4882a593Smuzhiyun st[ 4] ^= bc[ 4];
104*4882a593Smuzhiyun
105*4882a593Smuzhiyun bc[ 0] = ~st[ 6] & st[ 7];
106*4882a593Smuzhiyun bc[ 1] = ~st[ 7] & st[ 8];
107*4882a593Smuzhiyun bc[ 2] = ~st[ 8] & st[ 9];
108*4882a593Smuzhiyun bc[ 3] = ~st[ 9] & st[ 5];
109*4882a593Smuzhiyun bc[ 4] = ~st[ 5] & st[ 6];
110*4882a593Smuzhiyun st[ 5] ^= bc[ 0];
111*4882a593Smuzhiyun st[ 6] ^= bc[ 1];
112*4882a593Smuzhiyun st[ 7] ^= bc[ 2];
113*4882a593Smuzhiyun st[ 8] ^= bc[ 3];
114*4882a593Smuzhiyun st[ 9] ^= bc[ 4];
115*4882a593Smuzhiyun
116*4882a593Smuzhiyun bc[ 0] = ~st[11] & st[12];
117*4882a593Smuzhiyun bc[ 1] = ~st[12] & st[13];
118*4882a593Smuzhiyun bc[ 2] = ~st[13] & st[14];
119*4882a593Smuzhiyun bc[ 3] = ~st[14] & st[10];
120*4882a593Smuzhiyun bc[ 4] = ~st[10] & st[11];
121*4882a593Smuzhiyun st[10] ^= bc[ 0];
122*4882a593Smuzhiyun st[11] ^= bc[ 1];
123*4882a593Smuzhiyun st[12] ^= bc[ 2];
124*4882a593Smuzhiyun st[13] ^= bc[ 3];
125*4882a593Smuzhiyun st[14] ^= bc[ 4];
126*4882a593Smuzhiyun
127*4882a593Smuzhiyun bc[ 0] = ~st[16] & st[17];
128*4882a593Smuzhiyun bc[ 1] = ~st[17] & st[18];
129*4882a593Smuzhiyun bc[ 2] = ~st[18] & st[19];
130*4882a593Smuzhiyun bc[ 3] = ~st[19] & st[15];
131*4882a593Smuzhiyun bc[ 4] = ~st[15] & st[16];
132*4882a593Smuzhiyun st[15] ^= bc[ 0];
133*4882a593Smuzhiyun st[16] ^= bc[ 1];
134*4882a593Smuzhiyun st[17] ^= bc[ 2];
135*4882a593Smuzhiyun st[18] ^= bc[ 3];
136*4882a593Smuzhiyun st[19] ^= bc[ 4];
137*4882a593Smuzhiyun
138*4882a593Smuzhiyun bc[ 0] = ~st[21] & st[22];
139*4882a593Smuzhiyun bc[ 1] = ~st[22] & st[23];
140*4882a593Smuzhiyun bc[ 2] = ~st[23] & st[24];
141*4882a593Smuzhiyun bc[ 3] = ~st[24] & st[20];
142*4882a593Smuzhiyun bc[ 4] = ~st[20] & st[21];
143*4882a593Smuzhiyun st[20] ^= bc[ 0];
144*4882a593Smuzhiyun st[21] ^= bc[ 1];
145*4882a593Smuzhiyun st[22] ^= bc[ 2];
146*4882a593Smuzhiyun st[23] ^= bc[ 3];
147*4882a593Smuzhiyun st[24] ^= bc[ 4];
148*4882a593Smuzhiyun }
149*4882a593Smuzhiyun
keccakf(u64 st[25])150*4882a593Smuzhiyun static void keccakf(u64 st[25])
151*4882a593Smuzhiyun {
152*4882a593Smuzhiyun int round;
153*4882a593Smuzhiyun
154*4882a593Smuzhiyun for (round = 0; round < KECCAK_ROUNDS; round++) {
155*4882a593Smuzhiyun keccakf_round(st);
156*4882a593Smuzhiyun /* Iota */
157*4882a593Smuzhiyun st[0] ^= keccakf_rndc[round];
158*4882a593Smuzhiyun }
159*4882a593Smuzhiyun }
160*4882a593Smuzhiyun
crypto_sha3_init(struct shash_desc * desc)161*4882a593Smuzhiyun int crypto_sha3_init(struct shash_desc *desc)
162*4882a593Smuzhiyun {
163*4882a593Smuzhiyun struct sha3_state *sctx = shash_desc_ctx(desc);
164*4882a593Smuzhiyun unsigned int digest_size = crypto_shash_digestsize(desc->tfm);
165*4882a593Smuzhiyun
166*4882a593Smuzhiyun sctx->rsiz = 200 - 2 * digest_size;
167*4882a593Smuzhiyun sctx->rsizw = sctx->rsiz / 8;
168*4882a593Smuzhiyun sctx->partial = 0;
169*4882a593Smuzhiyun
170*4882a593Smuzhiyun memset(sctx->st, 0, sizeof(sctx->st));
171*4882a593Smuzhiyun return 0;
172*4882a593Smuzhiyun }
173*4882a593Smuzhiyun EXPORT_SYMBOL(crypto_sha3_init);
174*4882a593Smuzhiyun
crypto_sha3_update(struct shash_desc * desc,const u8 * data,unsigned int len)175*4882a593Smuzhiyun int crypto_sha3_update(struct shash_desc *desc, const u8 *data,
176*4882a593Smuzhiyun unsigned int len)
177*4882a593Smuzhiyun {
178*4882a593Smuzhiyun struct sha3_state *sctx = shash_desc_ctx(desc);
179*4882a593Smuzhiyun unsigned int done;
180*4882a593Smuzhiyun const u8 *src;
181*4882a593Smuzhiyun
182*4882a593Smuzhiyun done = 0;
183*4882a593Smuzhiyun src = data;
184*4882a593Smuzhiyun
185*4882a593Smuzhiyun if ((sctx->partial + len) > (sctx->rsiz - 1)) {
186*4882a593Smuzhiyun if (sctx->partial) {
187*4882a593Smuzhiyun done = -sctx->partial;
188*4882a593Smuzhiyun memcpy(sctx->buf + sctx->partial, data,
189*4882a593Smuzhiyun done + sctx->rsiz);
190*4882a593Smuzhiyun src = sctx->buf;
191*4882a593Smuzhiyun }
192*4882a593Smuzhiyun
193*4882a593Smuzhiyun do {
194*4882a593Smuzhiyun unsigned int i;
195*4882a593Smuzhiyun
196*4882a593Smuzhiyun for (i = 0; i < sctx->rsizw; i++)
197*4882a593Smuzhiyun sctx->st[i] ^= get_unaligned_le64(src + 8 * i);
198*4882a593Smuzhiyun keccakf(sctx->st);
199*4882a593Smuzhiyun
200*4882a593Smuzhiyun done += sctx->rsiz;
201*4882a593Smuzhiyun src = data + done;
202*4882a593Smuzhiyun } while (done + (sctx->rsiz - 1) < len);
203*4882a593Smuzhiyun
204*4882a593Smuzhiyun sctx->partial = 0;
205*4882a593Smuzhiyun }
206*4882a593Smuzhiyun memcpy(sctx->buf + sctx->partial, src, len - done);
207*4882a593Smuzhiyun sctx->partial += (len - done);
208*4882a593Smuzhiyun
209*4882a593Smuzhiyun return 0;
210*4882a593Smuzhiyun }
211*4882a593Smuzhiyun EXPORT_SYMBOL(crypto_sha3_update);
212*4882a593Smuzhiyun
crypto_sha3_final(struct shash_desc * desc,u8 * out)213*4882a593Smuzhiyun int crypto_sha3_final(struct shash_desc *desc, u8 *out)
214*4882a593Smuzhiyun {
215*4882a593Smuzhiyun struct sha3_state *sctx = shash_desc_ctx(desc);
216*4882a593Smuzhiyun unsigned int i, inlen = sctx->partial;
217*4882a593Smuzhiyun unsigned int digest_size = crypto_shash_digestsize(desc->tfm);
218*4882a593Smuzhiyun __le64 *digest = (__le64 *)out;
219*4882a593Smuzhiyun
220*4882a593Smuzhiyun sctx->buf[inlen++] = 0x06;
221*4882a593Smuzhiyun memset(sctx->buf + inlen, 0, sctx->rsiz - inlen);
222*4882a593Smuzhiyun sctx->buf[sctx->rsiz - 1] |= 0x80;
223*4882a593Smuzhiyun
224*4882a593Smuzhiyun for (i = 0; i < sctx->rsizw; i++)
225*4882a593Smuzhiyun sctx->st[i] ^= get_unaligned_le64(sctx->buf + 8 * i);
226*4882a593Smuzhiyun
227*4882a593Smuzhiyun keccakf(sctx->st);
228*4882a593Smuzhiyun
229*4882a593Smuzhiyun for (i = 0; i < digest_size / 8; i++)
230*4882a593Smuzhiyun put_unaligned_le64(sctx->st[i], digest++);
231*4882a593Smuzhiyun
232*4882a593Smuzhiyun if (digest_size & 4)
233*4882a593Smuzhiyun put_unaligned_le32(sctx->st[i], (__le32 *)digest);
234*4882a593Smuzhiyun
235*4882a593Smuzhiyun memset(sctx, 0, sizeof(*sctx));
236*4882a593Smuzhiyun return 0;
237*4882a593Smuzhiyun }
238*4882a593Smuzhiyun EXPORT_SYMBOL(crypto_sha3_final);
239*4882a593Smuzhiyun
240*4882a593Smuzhiyun static struct shash_alg algs[] = { {
241*4882a593Smuzhiyun .digestsize = SHA3_224_DIGEST_SIZE,
242*4882a593Smuzhiyun .init = crypto_sha3_init,
243*4882a593Smuzhiyun .update = crypto_sha3_update,
244*4882a593Smuzhiyun .final = crypto_sha3_final,
245*4882a593Smuzhiyun .descsize = sizeof(struct sha3_state),
246*4882a593Smuzhiyun .base.cra_name = "sha3-224",
247*4882a593Smuzhiyun .base.cra_driver_name = "sha3-224-generic",
248*4882a593Smuzhiyun .base.cra_blocksize = SHA3_224_BLOCK_SIZE,
249*4882a593Smuzhiyun .base.cra_module = THIS_MODULE,
250*4882a593Smuzhiyun }, {
251*4882a593Smuzhiyun .digestsize = SHA3_256_DIGEST_SIZE,
252*4882a593Smuzhiyun .init = crypto_sha3_init,
253*4882a593Smuzhiyun .update = crypto_sha3_update,
254*4882a593Smuzhiyun .final = crypto_sha3_final,
255*4882a593Smuzhiyun .descsize = sizeof(struct sha3_state),
256*4882a593Smuzhiyun .base.cra_name = "sha3-256",
257*4882a593Smuzhiyun .base.cra_driver_name = "sha3-256-generic",
258*4882a593Smuzhiyun .base.cra_blocksize = SHA3_256_BLOCK_SIZE,
259*4882a593Smuzhiyun .base.cra_module = THIS_MODULE,
260*4882a593Smuzhiyun }, {
261*4882a593Smuzhiyun .digestsize = SHA3_384_DIGEST_SIZE,
262*4882a593Smuzhiyun .init = crypto_sha3_init,
263*4882a593Smuzhiyun .update = crypto_sha3_update,
264*4882a593Smuzhiyun .final = crypto_sha3_final,
265*4882a593Smuzhiyun .descsize = sizeof(struct sha3_state),
266*4882a593Smuzhiyun .base.cra_name = "sha3-384",
267*4882a593Smuzhiyun .base.cra_driver_name = "sha3-384-generic",
268*4882a593Smuzhiyun .base.cra_blocksize = SHA3_384_BLOCK_SIZE,
269*4882a593Smuzhiyun .base.cra_module = THIS_MODULE,
270*4882a593Smuzhiyun }, {
271*4882a593Smuzhiyun .digestsize = SHA3_512_DIGEST_SIZE,
272*4882a593Smuzhiyun .init = crypto_sha3_init,
273*4882a593Smuzhiyun .update = crypto_sha3_update,
274*4882a593Smuzhiyun .final = crypto_sha3_final,
275*4882a593Smuzhiyun .descsize = sizeof(struct sha3_state),
276*4882a593Smuzhiyun .base.cra_name = "sha3-512",
277*4882a593Smuzhiyun .base.cra_driver_name = "sha3-512-generic",
278*4882a593Smuzhiyun .base.cra_blocksize = SHA3_512_BLOCK_SIZE,
279*4882a593Smuzhiyun .base.cra_module = THIS_MODULE,
280*4882a593Smuzhiyun } };
281*4882a593Smuzhiyun
sha3_generic_mod_init(void)282*4882a593Smuzhiyun static int __init sha3_generic_mod_init(void)
283*4882a593Smuzhiyun {
284*4882a593Smuzhiyun return crypto_register_shashes(algs, ARRAY_SIZE(algs));
285*4882a593Smuzhiyun }
286*4882a593Smuzhiyun
sha3_generic_mod_fini(void)287*4882a593Smuzhiyun static void __exit sha3_generic_mod_fini(void)
288*4882a593Smuzhiyun {
289*4882a593Smuzhiyun crypto_unregister_shashes(algs, ARRAY_SIZE(algs));
290*4882a593Smuzhiyun }
291*4882a593Smuzhiyun
292*4882a593Smuzhiyun subsys_initcall(sha3_generic_mod_init);
293*4882a593Smuzhiyun module_exit(sha3_generic_mod_fini);
294*4882a593Smuzhiyun
295*4882a593Smuzhiyun MODULE_LICENSE("GPL");
296*4882a593Smuzhiyun MODULE_DESCRIPTION("SHA-3 Secure Hash Algorithm");
297*4882a593Smuzhiyun
298*4882a593Smuzhiyun MODULE_ALIAS_CRYPTO("sha3-224");
299*4882a593Smuzhiyun MODULE_ALIAS_CRYPTO("sha3-224-generic");
300*4882a593Smuzhiyun MODULE_ALIAS_CRYPTO("sha3-256");
301*4882a593Smuzhiyun MODULE_ALIAS_CRYPTO("sha3-256-generic");
302*4882a593Smuzhiyun MODULE_ALIAS_CRYPTO("sha3-384");
303*4882a593Smuzhiyun MODULE_ALIAS_CRYPTO("sha3-384-generic");
304*4882a593Smuzhiyun MODULE_ALIAS_CRYPTO("sha3-512");
305*4882a593Smuzhiyun MODULE_ALIAS_CRYPTO("sha3-512-generic");
306