xref: /openbmc/linux/crypto/xts.c (revision 91addaf5) 
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /* XTS: as defined in IEEE1619/D16
3  *	http://grouper.ieee.org/groups/1619/email/pdf00086.pdf
4  *
5  * Copyright (c) 2007 Rik Snel <rsnel@cube.dyndns.org>
6  *
7  * Based on ecb.c
8  * Copyright (c) 2006 Herbert Xu <herbert@gondor.apana.org.au>
9  */
10 #include <crypto/internal/cipher.h>
11 #include <crypto/internal/skcipher.h>
12 #include <crypto/scatterwalk.h>
13 #include <linux/err.h>
14 #include <linux/init.h>
15 #include <linux/kernel.h>
16 #include <linux/module.h>
17 #include <linux/scatterlist.h>
18 #include <linux/slab.h>
19 
20 #include <crypto/xts.h>
21 #include <crypto/b128ops.h>
22 #include <crypto/gf128mul.h>
23 
24 struct xts_tfm_ctx {
25 	struct crypto_skcipher *child;
26 	struct crypto_cipher *tweak;
27 };
28 
29 struct xts_instance_ctx {
30 	struct crypto_skcipher_spawn spawn;
31 	struct crypto_cipher_spawn tweak_spawn;
32 };
33 
34 struct xts_request_ctx {
35 	le128 t;
36 	struct scatterlist *tail;
37 	struct scatterlist sg[2];
38 	struct skcipher_request subreq;
39 };
40 
41 static int xts_setkey(struct crypto_skcipher *parent, const u8 *key,
42 		      unsigned int keylen)
43 {
44 	struct xts_tfm_ctx *ctx = crypto_skcipher_ctx(parent);
45 	struct crypto_skcipher *child;
46 	struct crypto_cipher *tweak;
47 	int err;
48 
49 	err = xts_verify_key(parent, key, keylen);
50 	if (err)
51 		return err;
52 
53 	keylen /= 2;
54 
55 	/* we need two cipher instances: one to compute the initial 'tweak'
56 	 * by encrypting the IV (usually the 'plain' iv) and the other
57 	 * one to encrypt and decrypt the data */
58 
59 	/* tweak cipher, uses Key2 i.e. the second half of *key */
60 	tweak = ctx->tweak;
61 	crypto_cipher_clear_flags(tweak, CRYPTO_TFM_REQ_MASK);
62 	crypto_cipher_set_flags(tweak, crypto_skcipher_get_flags(parent) &
63 				       CRYPTO_TFM_REQ_MASK);
64 	err = crypto_cipher_setkey(tweak, key + keylen, keylen);
65 	if (err)
66 		return err;
67 
68 	/* data cipher, uses Key1 i.e. the first half of *key */
69 	child = ctx->child;
70 	crypto_skcipher_clear_flags(child, CRYPTO_TFM_REQ_MASK);
71 	crypto_skcipher_set_flags(child, crypto_skcipher_get_flags(parent) &
72 					 CRYPTO_TFM_REQ_MASK);
73 	return crypto_skcipher_setkey(child, key, keylen);
74 }
75 
76 /*
77  * We compute the tweak masks twice (both before and after the ECB encryption or
78  * decryption) to avoid having to allocate a temporary buffer and/or make
79  * mutliple calls to the 'ecb(..)' instance, which usually would be slower than
80  * just doing the gf128mul_x_ble() calls again.
81  */
82 static int xts_xor_tweak(struct skcipher_request *req, bool second_pass,
83 			 bool enc)
84 {
85 	struct xts_request_ctx *rctx = skcipher_request_ctx(req);
86 	struct crypto_skcipher *tfm = crypto_skcipher_reqtfm(req);
87 	const bool cts = (req->cryptlen % XTS_BLOCK_SIZE);
88 	const int bs = XTS_BLOCK_SIZE;
89 	struct skcipher_walk w;
90 	le128 t = rctx->t;
91 	int err;
92 
93 	if (second_pass) {
94 		req = &rctx->subreq;
95 		/* set to our TFM to enforce correct alignment: */
96 		skcipher_request_set_tfm(req, tfm);
97 	}
98 	err = skcipher_walk_virt(&w, req, false);
99 
100 	while (w.nbytes) {
101 		unsigned int avail = w.nbytes;
102 		le128 *wsrc;
103 		le128 *wdst;
104 
105 		wsrc = w.src.virt.addr;
106 		wdst = w.dst.virt.addr;
107 
108 		do {
109 			if (unlikely(cts) &&
110 			    w.total - w.nbytes + avail < 2 * XTS_BLOCK_SIZE) {
111 				if (!enc) {
112 					if (second_pass)
113 						rctx->t = t;
114 					gf128mul_x_ble(&t, &t);
115 				}
116 				le128_xor(wdst, &t, wsrc);
117 				if (enc && second_pass)
118 					gf128mul_x_ble(&rctx->t, &t);
119 				skcipher_walk_done(&w, avail - bs);
120 				return 0;
121 			}
122 
123 			le128_xor(wdst++, &t, wsrc++);
124 			gf128mul_x_ble(&t, &t);
125 		} while ((avail -= bs) >= bs);
126 
127 		err = skcipher_walk_done(&w, avail);
128 	}
129 
130 	return err;
131 }
132 
133 static int xts_xor_tweak_pre(struct skcipher_request *req, bool enc)
134 {
135 	return xts_xor_tweak(req, false, enc);
136 }
137 
138 static int xts_xor_tweak_post(struct skcipher_request *req, bool enc)
139 {
140 	return xts_xor_tweak(req, true, enc);
141 }
142 
143 static void xts_cts_done(void *data, int err)
144 {
145 	struct skcipher_request *req = data;
146 	le128 b;
147 
148 	if (!err) {
149 		struct xts_request_ctx *rctx = skcipher_request_ctx(req);
150 
151 		scatterwalk_map_and_copy(&b, rctx->tail, 0, XTS_BLOCK_SIZE, 0);
152 		le128_xor(&b, &rctx->t, &b);
153 		scatterwalk_map_and_copy(&b, rctx->tail, 0, XTS_BLOCK_SIZE, 1);
154 	}
155 
156 	skcipher_request_complete(req, err);
157 }
158 
159 static int xts_cts_final(struct skcipher_request *req,
160 			 int (*crypt)(struct skcipher_request *req))
161 {
162 	const struct xts_tfm_ctx *ctx =
163 		crypto_skcipher_ctx(crypto_skcipher_reqtfm(req));
164 	int offset = req->cryptlen & ~(XTS_BLOCK_SIZE - 1);
165 	struct xts_request_ctx *rctx = skcipher_request_ctx(req);
166 	struct skcipher_request *subreq = &rctx->subreq;
167 	int tail = req->cryptlen % XTS_BLOCK_SIZE;
168 	le128 b[2];
169 	int err;
170 
171 	rctx->tail = scatterwalk_ffwd(rctx->sg, req->dst,
172 				      offset - XTS_BLOCK_SIZE);
173 
174 	scatterwalk_map_and_copy(b, rctx->tail, 0, XTS_BLOCK_SIZE, 0);
175 	b[1] = b[0];
176 	scatterwalk_map_and_copy(b, req->src, offset, tail, 0);
177 
178 	le128_xor(b, &rctx->t, b);
179 
180 	scatterwalk_map_and_copy(b, rctx->tail, 0, XTS_BLOCK_SIZE + tail, 1);
181 
182 	skcipher_request_set_tfm(subreq, ctx->child);
183 	skcipher_request_set_callback(subreq, req->base.flags, xts_cts_done,
184 				      req);
185 	skcipher_request_set_crypt(subreq, rctx->tail, rctx->tail,
186 				   XTS_BLOCK_SIZE, NULL);
187 
188 	err = crypt(subreq);
189 	if (err)
190 		return err;
191 
192 	scatterwalk_map_and_copy(b, rctx->tail, 0, XTS_BLOCK_SIZE, 0);
193 	le128_xor(b, &rctx->t, b);
194 	scatterwalk_map_and_copy(b, rctx->tail, 0, XTS_BLOCK_SIZE, 1);
195 
196 	return 0;
197 }
198 
199 static void xts_encrypt_done(void *data, int err)
200 {
201 	struct skcipher_request *req = data;
202 
203 	if (!err) {
204 		struct xts_request_ctx *rctx = skcipher_request_ctx(req);
205 
206 		rctx->subreq.base.flags &= CRYPTO_TFM_REQ_MAY_BACKLOG;
207 		err = xts_xor_tweak_post(req, true);
208 
209 		if (!err && unlikely(req->cryptlen % XTS_BLOCK_SIZE)) {
210 			err = xts_cts_final(req, crypto_skcipher_encrypt);
211 			if (err == -EINPROGRESS || err == -EBUSY)
212 				return;
213 		}
214 	}
215 
216 	skcipher_request_complete(req, err);
217 }
218 
219 static void xts_decrypt_done(void *data, int err)
220 {
221 	struct skcipher_request *req = data;
222 
223 	if (!err) {
224 		struct xts_request_ctx *rctx = skcipher_request_ctx(req);
225 
226 		rctx->subreq.base.flags &= CRYPTO_TFM_REQ_MAY_BACKLOG;
227 		err = xts_xor_tweak_post(req, false);
228 
229 		if (!err && unlikely(req->cryptlen % XTS_BLOCK_SIZE)) {
230 			err = xts_cts_final(req, crypto_skcipher_decrypt);
231 			if (err == -EINPROGRESS || err == -EBUSY)
232 				return;
233 		}
234 	}
235 
236 	skcipher_request_complete(req, err);
237 }
238 
239 static int xts_init_crypt(struct skcipher_request *req,
240 			  crypto_completion_t compl)
241 {
242 	const struct xts_tfm_ctx *ctx =
243 		crypto_skcipher_ctx(crypto_skcipher_reqtfm(req));
244 	struct xts_request_ctx *rctx = skcipher_request_ctx(req);
245 	struct skcipher_request *subreq = &rctx->subreq;
246 
247 	if (req->cryptlen < XTS_BLOCK_SIZE)
248 		return -EINVAL;
249 
250 	skcipher_request_set_tfm(subreq, ctx->child);
251 	skcipher_request_set_callback(subreq, req->base.flags, compl, req);
252 	skcipher_request_set_crypt(subreq, req->dst, req->dst,
253 				   req->cryptlen & ~(XTS_BLOCK_SIZE - 1), NULL);
254 
255 	/* calculate first value of T */
256 	crypto_cipher_encrypt_one(ctx->tweak, (u8 *)&rctx->t, req->iv);
257 
258 	return 0;
259 }
260 
261 static int xts_encrypt(struct skcipher_request *req)
262 {
263 	struct xts_request_ctx *rctx = skcipher_request_ctx(req);
264 	struct skcipher_request *subreq = &rctx->subreq;
265 	int err;
266 
267 	err = xts_init_crypt(req, xts_encrypt_done) ?:
268 	      xts_xor_tweak_pre(req, true) ?:
269 	      crypto_skcipher_encrypt(subreq) ?:
270 	      xts_xor_tweak_post(req, true);
271 
272 	if (err || likely((req->cryptlen % XTS_BLOCK_SIZE) == 0))
273 		return err;
274 
275 	return xts_cts_final(req, crypto_skcipher_encrypt);
276 }
277 
278 static int xts_decrypt(struct skcipher_request *req)
279 {
280 	struct xts_request_ctx *rctx = skcipher_request_ctx(req);
281 	struct skcipher_request *subreq = &rctx->subreq;
282 	int err;
283 
284 	err = xts_init_crypt(req, xts_decrypt_done) ?:
285 	      xts_xor_tweak_pre(req, false) ?:
286 	      crypto_skcipher_decrypt(subreq) ?:
287 	      xts_xor_tweak_post(req, false);
288 
289 	if (err || likely((req->cryptlen % XTS_BLOCK_SIZE) == 0))
290 		return err;
291 
292 	return xts_cts_final(req, crypto_skcipher_decrypt);
293 }
294 
295 static int xts_init_tfm(struct crypto_skcipher *tfm)
296 {
297 	struct skcipher_instance *inst = skcipher_alg_instance(tfm);
298 	struct xts_instance_ctx *ictx = skcipher_instance_ctx(inst);
299 	struct xts_tfm_ctx *ctx = crypto_skcipher_ctx(tfm);
300 	struct crypto_skcipher *child;
301 	struct crypto_cipher *tweak;
302 
303 	child = crypto_spawn_skcipher(&ictx->spawn);
304 	if (IS_ERR(child))
305 		return PTR_ERR(child);
306 
307 	ctx->child = child;
308 
309 	tweak = crypto_spawn_cipher(&ictx->tweak_spawn);
310 	if (IS_ERR(tweak)) {
311 		crypto_free_skcipher(ctx->child);
312 		return PTR_ERR(tweak);
313 	}
314 
315 	ctx->tweak = tweak;
316 
317 	crypto_skcipher_set_reqsize(tfm, crypto_skcipher_reqsize(child) +
318 					 sizeof(struct xts_request_ctx));
319 
320 	return 0;
321 }
322 
323 static void xts_exit_tfm(struct crypto_skcipher *tfm)
324 {
325 	struct xts_tfm_ctx *ctx = crypto_skcipher_ctx(tfm);
326 
327 	crypto_free_skcipher(ctx->child);
328 	crypto_free_cipher(ctx->tweak);
329 }
330 
331 static void xts_free_instance(struct skcipher_instance *inst)
332 {
333 	struct xts_instance_ctx *ictx = skcipher_instance_ctx(inst);
334 
335 	crypto_drop_skcipher(&ictx->spawn);
336 	crypto_drop_cipher(&ictx->tweak_spawn);
337 	kfree(inst);
338 }
339 
340 static int xts_create(struct crypto_template *tmpl, struct rtattr **tb)
341 {
342 	char name[CRYPTO_MAX_ALG_NAME];
343 	struct skcipher_instance *inst;
344 	struct xts_instance_ctx *ctx;
345 	struct skcipher_alg *alg;
346 	const char *cipher_name;
347 	u32 mask;
348 	int err;
349 
350 	err = crypto_check_attr_type(tb, CRYPTO_ALG_TYPE_SKCIPHER, &mask);
351 	if (err)
352 		return err;
353 
354 	cipher_name = crypto_attr_alg_name(tb[1]);
355 	if (IS_ERR(cipher_name))
356 		return PTR_ERR(cipher_name);
357 
358 	inst = kzalloc(sizeof(*inst) + sizeof(*ctx), GFP_KERNEL);
359 	if (!inst)
360 		return -ENOMEM;
361 
362 	ctx = skcipher_instance_ctx(inst);
363 
364 	err = crypto_grab_skcipher(&ctx->spawn, skcipher_crypto_instance(inst),
365 				   cipher_name, 0, mask);
366 	if (err == -ENOENT) {
367 		err = -ENAMETOOLONG;
368 		if (snprintf(name, CRYPTO_MAX_ALG_NAME, "ecb(%s)",
369 			     cipher_name) >= CRYPTO_MAX_ALG_NAME)
370 			goto err_free_inst;
371 
372 		err = crypto_grab_skcipher(&ctx->spawn,
373 					   skcipher_crypto_instance(inst),
374 					   name, 0, mask);
375 	}
376 
377 	if (err)
378 		goto err_free_inst;
379 
380 	alg = crypto_skcipher_spawn_alg(&ctx->spawn);
381 
382 	err = -EINVAL;
383 	if (alg->base.cra_blocksize != XTS_BLOCK_SIZE)
384 		goto err_free_inst;
385 
386 	if (crypto_skcipher_alg_ivsize(alg))
387 		goto err_free_inst;
388 
389 	err = crypto_inst_setname(skcipher_crypto_instance(inst), "xts",
390 				  &alg->base);
391 	if (err)
392 		goto err_free_inst;
393 
394 	err = -EINVAL;
395 	cipher_name = alg->base.cra_name;
396 
397 	/* Alas we screwed up the naming so we have to mangle the
398 	 * cipher name.
399 	 */
400 	if (!strncmp(cipher_name, "ecb(", 4)) {
401 		int len;
402 
403 		len = strscpy(name, cipher_name + 4, sizeof(name));
404 		if (len < 2)
405 			goto err_free_inst;
406 
407 		if (name[len - 1] != ')')
408 			goto err_free_inst;
409 
410 		name[len - 1] = 0;
411 
412 		if (snprintf(inst->alg.base.cra_name, CRYPTO_MAX_ALG_NAME,
413 			     "xts(%s)", name) >= CRYPTO_MAX_ALG_NAME) {
414 			err = -ENAMETOOLONG;
415 			goto err_free_inst;
416 		}
417 	} else
418 		goto err_free_inst;
419 
420 	err = crypto_grab_cipher(&ctx->tweak_spawn,
421 				 skcipher_crypto_instance(inst), name, 0, mask);
422 	if (err)
423 		goto err_free_inst;
424 
425 	inst->alg.base.cra_priority = alg->base.cra_priority;
426 	inst->alg.base.cra_blocksize = XTS_BLOCK_SIZE;
427 	inst->alg.base.cra_alignmask = alg->base.cra_alignmask |
428 				       (__alignof__(u64) - 1);
429 
430 	inst->alg.ivsize = XTS_BLOCK_SIZE;
431 	inst->alg.min_keysize = crypto_skcipher_alg_min_keysize(alg) * 2;
432 	inst->alg.max_keysize = crypto_skcipher_alg_max_keysize(alg) * 2;
433 
434 	inst->alg.base.cra_ctxsize = sizeof(struct xts_tfm_ctx);
435 
436 	inst->alg.init = xts_init_tfm;
437 	inst->alg.exit = xts_exit_tfm;
438 
439 	inst->alg.setkey = xts_setkey;
440 	inst->alg.encrypt = xts_encrypt;
441 	inst->alg.decrypt = xts_decrypt;
442 
443 	inst->free = xts_free_instance;
444 
445 	err = skcipher_register_instance(tmpl, inst);
446 	if (err) {
447 err_free_inst:
448 		xts_free_instance(inst);
449 	}
450 	return err;
451 }
452 
453 static struct crypto_template xts_tmpl = {
454 	.name = "xts",
455 	.create = xts_create,
456 	.module = THIS_MODULE,
457 };
458 
459 static int __init xts_module_init(void)
460 {
461 	return crypto_register_template(&xts_tmpl);
462 }
463 
464 static void __exit xts_module_exit(void)
465 {
466 	crypto_unregister_template(&xts_tmpl);
467 }
468 
469 subsys_initcall(xts_module_init);
470 module_exit(xts_module_exit);
471 
472 MODULE_LICENSE("GPL");
473 MODULE_DESCRIPTION("XTS block cipher mode");
474 MODULE_ALIAS_CRYPTO("xts");
475 MODULE_IMPORT_NS(CRYPTO_INTERNAL);
476 MODULE_SOFTDEP("pre: ecb");
477