1 /* XTS: as defined in IEEE1619/D16
2 * http://grouper.ieee.org/groups/1619/email/pdf00086.pdf
3 * (sector sizes which are not a multiple of 16 bytes are,
4 * however currently unsupported)
6 * Copyright (c) 2007 Rik Snel <rsnel@cube.dyndns.org>
9 * Copyright (c) 2006 Herbert Xu <herbert@gondor.apana.org.au>
11 * This program is free software; you can redistribute it and/or modify it
12 * under the terms of the GNU General Public License as published by the Free
13 * Software Foundation; either version 2 of the License, or (at your option)
16 #include <crypto/internal/skcipher.h>
17 #include <crypto/scatterwalk.h>
18 #include <linux/err.h>
19 #include <linux/init.h>
20 #include <linux/kernel.h>
21 #include <linux/module.h>
22 #include <linux/scatterlist.h>
23 #include <linux/slab.h>
25 #include <crypto/xts.h>
26 #include <crypto/b128ops.h>
27 #include <crypto/gf128mul.h>
29 #define XTS_BUFFER_SIZE 128u
32 struct crypto_skcipher *child;
33 struct crypto_cipher *tweak;
36 struct xts_instance_ctx {
37 struct crypto_skcipher_spawn spawn;
38 char name[CRYPTO_MAX_ALG_NAME];
42 be128 buf[XTS_BUFFER_SIZE / sizeof(be128)];
48 struct scatterlist srcbuf[2];
49 struct scatterlist dstbuf[2];
50 struct scatterlist *src;
51 struct scatterlist *dst;
55 struct skcipher_request subreq;
58 static int setkey(struct crypto_skcipher *parent, const u8 *key,
61 struct priv *ctx = crypto_skcipher_ctx(parent);
62 struct crypto_skcipher *child;
63 struct crypto_cipher *tweak;
66 err = xts_verify_key(parent, key, keylen);
72 /* we need two cipher instances: one to compute the initial 'tweak'
73 * by encrypting the IV (usually the 'plain' iv) and the other
74 * one to encrypt and decrypt the data */
76 /* tweak cipher, uses Key2 i.e. the second half of *key */
78 crypto_cipher_clear_flags(tweak, CRYPTO_TFM_REQ_MASK);
79 crypto_cipher_set_flags(tweak, crypto_skcipher_get_flags(parent) &
81 err = crypto_cipher_setkey(tweak, key + keylen, keylen);
82 crypto_skcipher_set_flags(parent, crypto_cipher_get_flags(tweak) &
87 /* data cipher, uses Key1 i.e. the first half of *key */
89 crypto_skcipher_clear_flags(child, CRYPTO_TFM_REQ_MASK);
90 crypto_skcipher_set_flags(child, crypto_skcipher_get_flags(parent) &
92 err = crypto_skcipher_setkey(child, key, keylen);
93 crypto_skcipher_set_flags(parent, crypto_skcipher_get_flags(child) &
99 static int post_crypt(struct skcipher_request *req)
101 struct rctx *rctx = skcipher_request_ctx(req);
102 be128 *buf = rctx->ext ?: rctx->buf;
103 struct skcipher_request *subreq;
104 const int bs = XTS_BLOCK_SIZE;
105 struct skcipher_walk w;
106 struct scatterlist *sg;
110 subreq = &rctx->subreq;
111 err = skcipher_walk_virt(&w, subreq, false);
114 unsigned int avail = w.nbytes;
117 wdst = w.dst.virt.addr;
120 be128_xor(wdst, buf++, wdst);
122 } while ((avail -= bs) >= bs);
124 err = skcipher_walk_done(&w, avail);
127 rctx->left -= subreq->cryptlen;
129 if (err || !rctx->left)
132 rctx->dst = rctx->dstbuf;
134 scatterwalk_done(&w.out, 0, 1);
136 offset = w.out.offset;
138 if (rctx->dst != sg) {
140 sg_unmark_end(rctx->dst);
141 scatterwalk_crypto_chain(rctx->dst, sg_next(sg), 0, 2);
143 rctx->dst[0].length -= offset - sg->offset;
144 rctx->dst[0].offset = offset;
150 static int pre_crypt(struct skcipher_request *req)
152 struct rctx *rctx = skcipher_request_ctx(req);
153 be128 *buf = rctx->ext ?: rctx->buf;
154 struct skcipher_request *subreq;
155 const int bs = XTS_BLOCK_SIZE;
156 struct skcipher_walk w;
157 struct scatterlist *sg;
163 subreq = &rctx->subreq;
164 cryptlen = subreq->cryptlen;
166 more = rctx->left > cryptlen;
168 cryptlen = rctx->left;
170 skcipher_request_set_crypt(subreq, rctx->src, rctx->dst,
173 err = skcipher_walk_virt(&w, subreq, false);
176 unsigned int avail = w.nbytes;
180 wsrc = w.src.virt.addr;
181 wdst = w.dst.virt.addr;
185 be128_xor(wdst++, &rctx->t, wsrc++);
186 gf128mul_x_ble(&rctx->t, &rctx->t);
187 } while ((avail -= bs) >= bs);
189 err = skcipher_walk_done(&w, avail);
192 skcipher_request_set_crypt(subreq, rctx->dst, rctx->dst,
198 rctx->src = rctx->srcbuf;
200 scatterwalk_done(&w.in, 0, 1);
202 offset = w.in.offset;
204 if (rctx->src != sg) {
206 sg_unmark_end(rctx->src);
207 scatterwalk_crypto_chain(rctx->src, sg_next(sg), 0, 2);
209 rctx->src[0].length -= offset - sg->offset;
210 rctx->src[0].offset = offset;
216 static int init_crypt(struct skcipher_request *req, crypto_completion_t done)
218 struct priv *ctx = crypto_skcipher_ctx(crypto_skcipher_reqtfm(req));
219 struct rctx *rctx = skcipher_request_ctx(req);
220 struct skcipher_request *subreq;
223 subreq = &rctx->subreq;
224 skcipher_request_set_tfm(subreq, ctx->child);
225 skcipher_request_set_callback(subreq, req->base.flags, done, req);
227 gfp = req->base.flags & CRYPTO_TFM_REQ_MAY_SLEEP ? GFP_KERNEL :
231 subreq->cryptlen = XTS_BUFFER_SIZE;
232 if (req->cryptlen > XTS_BUFFER_SIZE) {
233 subreq->cryptlen = min(req->cryptlen, (unsigned)PAGE_SIZE);
234 rctx->ext = kmalloc(subreq->cryptlen, gfp);
237 rctx->src = req->src;
238 rctx->dst = req->dst;
239 rctx->left = req->cryptlen;
241 /* calculate first value of T */
242 crypto_cipher_encrypt_one(ctx->tweak, (u8 *)&rctx->t, req->iv);
247 static void exit_crypt(struct skcipher_request *req)
249 struct rctx *rctx = skcipher_request_ctx(req);
257 static int do_encrypt(struct skcipher_request *req, int err)
259 struct rctx *rctx = skcipher_request_ctx(req);
260 struct skcipher_request *subreq;
262 subreq = &rctx->subreq;
264 while (!err && rctx->left) {
265 err = pre_crypt(req) ?:
266 crypto_skcipher_encrypt(subreq) ?:
269 if (err == -EINPROGRESS ||
271 req->base.flags & CRYPTO_TFM_REQ_MAY_BACKLOG))
279 static void encrypt_done(struct crypto_async_request *areq, int err)
281 struct skcipher_request *req = areq->data;
282 struct skcipher_request *subreq;
285 rctx = skcipher_request_ctx(req);
286 subreq = &rctx->subreq;
287 subreq->base.flags &= CRYPTO_TFM_REQ_MAY_BACKLOG;
289 err = do_encrypt(req, err ?: post_crypt(req));
293 skcipher_request_complete(req, err);
296 static int encrypt(struct skcipher_request *req)
298 return do_encrypt(req, init_crypt(req, encrypt_done));
301 static int do_decrypt(struct skcipher_request *req, int err)
303 struct rctx *rctx = skcipher_request_ctx(req);
304 struct skcipher_request *subreq;
306 subreq = &rctx->subreq;
308 while (!err && rctx->left) {
309 err = pre_crypt(req) ?:
310 crypto_skcipher_decrypt(subreq) ?:
313 if (err == -EINPROGRESS ||
315 req->base.flags & CRYPTO_TFM_REQ_MAY_BACKLOG))
323 static void decrypt_done(struct crypto_async_request *areq, int err)
325 struct skcipher_request *req = areq->data;
326 struct skcipher_request *subreq;
329 rctx = skcipher_request_ctx(req);
330 subreq = &rctx->subreq;
331 subreq->base.flags &= CRYPTO_TFM_REQ_MAY_BACKLOG;
333 err = do_decrypt(req, err ?: post_crypt(req));
337 skcipher_request_complete(req, err);
340 static int decrypt(struct skcipher_request *req)
342 return do_decrypt(req, init_crypt(req, decrypt_done));
345 int xts_crypt(struct blkcipher_desc *desc, struct scatterlist *sdst,
346 struct scatterlist *ssrc, unsigned int nbytes,
347 struct xts_crypt_req *req)
349 const unsigned int bsize = XTS_BLOCK_SIZE;
350 const unsigned int max_blks = req->tbuflen / bsize;
351 struct blkcipher_walk walk;
352 unsigned int nblocks;
353 be128 *src, *dst, *t;
354 be128 *t_buf = req->tbuf;
357 BUG_ON(max_blks < 1);
359 blkcipher_walk_init(&walk, sdst, ssrc, nbytes);
361 err = blkcipher_walk_virt(desc, &walk);
362 nbytes = walk.nbytes;
366 nblocks = min(nbytes / bsize, max_blks);
367 src = (be128 *)walk.src.virt.addr;
368 dst = (be128 *)walk.dst.virt.addr;
370 /* calculate first value of T */
371 req->tweak_fn(req->tweak_ctx, (u8 *)&t_buf[0], walk.iv);
378 for (i = 0; i < nblocks; i++) {
379 gf128mul_x_ble(&t_buf[i], t);
384 be128_xor(dst + i, t, src + i);
387 /* CC <- E(Key2,PP) */
388 req->crypt_fn(req->crypt_ctx, (u8 *)dst,
392 for (i = 0; i < nblocks; i++)
393 be128_xor(dst + i, dst + i, &t_buf[i]);
397 nbytes -= nblocks * bsize;
398 nblocks = min(nbytes / bsize, max_blks);
399 } while (nblocks > 0);
401 *(be128 *)walk.iv = *t;
403 err = blkcipher_walk_done(desc, &walk, nbytes);
404 nbytes = walk.nbytes;
408 nblocks = min(nbytes / bsize, max_blks);
409 src = (be128 *)walk.src.virt.addr;
410 dst = (be128 *)walk.dst.virt.addr;
415 EXPORT_SYMBOL_GPL(xts_crypt);
417 static int init_tfm(struct crypto_skcipher *tfm)
419 struct skcipher_instance *inst = skcipher_alg_instance(tfm);
420 struct xts_instance_ctx *ictx = skcipher_instance_ctx(inst);
421 struct priv *ctx = crypto_skcipher_ctx(tfm);
422 struct crypto_skcipher *child;
423 struct crypto_cipher *tweak;
425 child = crypto_spawn_skcipher(&ictx->spawn);
427 return PTR_ERR(child);
431 tweak = crypto_alloc_cipher(ictx->name, 0, 0);
433 crypto_free_skcipher(ctx->child);
434 return PTR_ERR(tweak);
439 crypto_skcipher_set_reqsize(tfm, crypto_skcipher_reqsize(child) +
440 sizeof(struct rctx));
445 static void exit_tfm(struct crypto_skcipher *tfm)
447 struct priv *ctx = crypto_skcipher_ctx(tfm);
449 crypto_free_skcipher(ctx->child);
450 crypto_free_cipher(ctx->tweak);
453 static void free(struct skcipher_instance *inst)
455 crypto_drop_skcipher(skcipher_instance_ctx(inst));
459 static int create(struct crypto_template *tmpl, struct rtattr **tb)
461 struct skcipher_instance *inst;
462 struct crypto_attr_type *algt;
463 struct xts_instance_ctx *ctx;
464 struct skcipher_alg *alg;
465 const char *cipher_name;
469 algt = crypto_get_attr_type(tb);
471 return PTR_ERR(algt);
473 if ((algt->type ^ CRYPTO_ALG_TYPE_SKCIPHER) & algt->mask)
476 cipher_name = crypto_attr_alg_name(tb[1]);
477 if (IS_ERR(cipher_name))
478 return PTR_ERR(cipher_name);
480 inst = kzalloc(sizeof(*inst) + sizeof(*ctx), GFP_KERNEL);
484 ctx = skcipher_instance_ctx(inst);
486 crypto_set_skcipher_spawn(&ctx->spawn, skcipher_crypto_instance(inst));
488 mask = crypto_requires_off(algt->type, algt->mask,
489 CRYPTO_ALG_NEED_FALLBACK |
492 err = crypto_grab_skcipher(&ctx->spawn, cipher_name, 0, mask);
493 if (err == -ENOENT) {
495 if (snprintf(ctx->name, CRYPTO_MAX_ALG_NAME, "ecb(%s)",
496 cipher_name) >= CRYPTO_MAX_ALG_NAME)
499 err = crypto_grab_skcipher(&ctx->spawn, ctx->name, 0, mask);
505 alg = crypto_skcipher_spawn_alg(&ctx->spawn);
508 if (alg->base.cra_blocksize != XTS_BLOCK_SIZE)
511 if (crypto_skcipher_alg_ivsize(alg))
514 err = crypto_inst_setname(skcipher_crypto_instance(inst), "xts",
520 cipher_name = alg->base.cra_name;
522 /* Alas we screwed up the naming so we have to mangle the
525 if (!strncmp(cipher_name, "ecb(", 4)) {
528 len = strlcpy(ctx->name, cipher_name + 4, sizeof(ctx->name));
529 if (len < 2 || len >= sizeof(ctx->name))
532 if (ctx->name[len - 1] != ')')
535 ctx->name[len - 1] = 0;
537 if (snprintf(inst->alg.base.cra_name, CRYPTO_MAX_ALG_NAME,
538 "xts(%s)", ctx->name) >= CRYPTO_MAX_ALG_NAME)
539 return -ENAMETOOLONG;
543 inst->alg.base.cra_flags = alg->base.cra_flags & CRYPTO_ALG_ASYNC;
544 inst->alg.base.cra_priority = alg->base.cra_priority;
545 inst->alg.base.cra_blocksize = XTS_BLOCK_SIZE;
546 inst->alg.base.cra_alignmask = alg->base.cra_alignmask |
547 (__alignof__(u64) - 1);
549 inst->alg.ivsize = XTS_BLOCK_SIZE;
550 inst->alg.min_keysize = crypto_skcipher_alg_min_keysize(alg) * 2;
551 inst->alg.max_keysize = crypto_skcipher_alg_max_keysize(alg) * 2;
553 inst->alg.base.cra_ctxsize = sizeof(struct priv);
555 inst->alg.init = init_tfm;
556 inst->alg.exit = exit_tfm;
558 inst->alg.setkey = setkey;
559 inst->alg.encrypt = encrypt;
560 inst->alg.decrypt = decrypt;
564 err = skcipher_register_instance(tmpl, inst);
572 crypto_drop_skcipher(&ctx->spawn);
578 static struct crypto_template crypto_tmpl = {
581 .module = THIS_MODULE,
584 static int __init crypto_module_init(void)
586 return crypto_register_template(&crypto_tmpl);
589 static void __exit crypto_module_exit(void)
591 crypto_unregister_template(&crypto_tmpl);
594 module_init(crypto_module_init);
595 module_exit(crypto_module_exit);
597 MODULE_LICENSE("GPL");
598 MODULE_DESCRIPTION("XTS block cipher mode");
599 MODULE_ALIAS_CRYPTO("xts");