2 * QEMU block full disk encryption
4 * Copyright (c) 2015-2016 Red Hat, Inc.
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
21 #include "qemu/osdep.h"
23 #include "block/block_int.h"
24 #include "block/qdict.h"
25 #include "sysemu/block-backend.h"
26 #include "crypto/block.h"
27 #include "qapi/opts-visitor.h"
28 #include "qapi/qapi-visit-crypto.h"
29 #include "qapi/qobject-input-visitor.h"
30 #include "qapi/error.h"
31 #include "qemu/option.h"
34 typedef struct BlockCrypto BlockCrypto;
41 static int block_crypto_probe_generic(QCryptoBlockFormat format,
46 if (qcrypto_block_has_format(format, buf, buf_size)) {
54 static ssize_t block_crypto_read_func(QCryptoBlock *block,
61 BlockDriverState *bs = opaque;
64 ret = bdrv_pread(bs->file, offset, buf, buflen);
66 error_setg_errno(errp, -ret, "Could not read encryption header");
73 struct BlockCryptoCreateData {
79 static ssize_t block_crypto_write_func(QCryptoBlock *block,
86 struct BlockCryptoCreateData *data = opaque;
89 ret = blk_pwrite(data->blk, offset, buf, buflen, 0);
91 error_setg_errno(errp, -ret, "Could not write encryption header");
98 static ssize_t block_crypto_init_func(QCryptoBlock *block,
103 struct BlockCryptoCreateData *data = opaque;
105 if (data->size > INT64_MAX || headerlen > INT64_MAX - data->size) {
106 error_setg(errp, "The requested file size is too large");
110 /* User provided size should reflect amount of space made
111 * available to the guest, so we must take account of that
112 * which will be used by the crypto header
114 return blk_truncate(data->blk, data->size + headerlen, PREALLOC_MODE_OFF,
119 static QemuOptsList block_crypto_runtime_opts_luks = {
121 .head = QTAILQ_HEAD_INITIALIZER(block_crypto_runtime_opts_luks.head),
123 BLOCK_CRYPTO_OPT_DEF_LUKS_KEY_SECRET(""),
124 { /* end of list */ }
129 static QemuOptsList block_crypto_create_opts_luks = {
131 .head = QTAILQ_HEAD_INITIALIZER(block_crypto_create_opts_luks.head),
134 .name = BLOCK_OPT_SIZE,
135 .type = QEMU_OPT_SIZE,
136 .help = "Virtual disk size"
138 BLOCK_CRYPTO_OPT_DEF_LUKS_KEY_SECRET(""),
139 BLOCK_CRYPTO_OPT_DEF_LUKS_CIPHER_ALG(""),
140 BLOCK_CRYPTO_OPT_DEF_LUKS_CIPHER_MODE(""),
141 BLOCK_CRYPTO_OPT_DEF_LUKS_IVGEN_ALG(""),
142 BLOCK_CRYPTO_OPT_DEF_LUKS_IVGEN_HASH_ALG(""),
143 BLOCK_CRYPTO_OPT_DEF_LUKS_HASH_ALG(""),
144 BLOCK_CRYPTO_OPT_DEF_LUKS_ITER_TIME(""),
145 { /* end of list */ }
150 QCryptoBlockOpenOptions *
151 block_crypto_open_opts_init(QDict *opts, Error **errp)
154 QCryptoBlockOpenOptions *ret;
156 v = qobject_input_visitor_new_flat_confused(opts, errp);
161 visit_type_QCryptoBlockOpenOptions(v, NULL, &ret, errp);
168 QCryptoBlockCreateOptions *
169 block_crypto_create_opts_init(QDict *opts, Error **errp)
172 QCryptoBlockCreateOptions *ret;
174 v = qobject_input_visitor_new_flat_confused(opts, errp);
179 visit_type_QCryptoBlockCreateOptions(v, NULL, &ret, errp);
186 static int block_crypto_open_generic(QCryptoBlockFormat format,
187 QemuOptsList *opts_spec,
188 BlockDriverState *bs,
193 BlockCrypto *crypto = bs->opaque;
194 QemuOpts *opts = NULL;
195 Error *local_err = NULL;
197 QCryptoBlockOpenOptions *open_opts = NULL;
198 unsigned int cflags = 0;
199 QDict *cryptoopts = NULL;
201 bs->file = bdrv_open_child(NULL, options, "file", bs, &child_file,
207 bs->supported_write_flags = BDRV_REQ_FUA &
208 bs->file->bs->supported_write_flags;
210 opts = qemu_opts_create(opts_spec, NULL, 0, &error_abort);
211 qemu_opts_absorb_qdict(opts, options, &local_err);
213 error_propagate(errp, local_err);
217 cryptoopts = qemu_opts_to_qdict(opts, NULL);
218 qdict_put_str(cryptoopts, "format", QCryptoBlockFormat_str(format));
220 open_opts = block_crypto_open_opts_init(cryptoopts, errp);
225 if (flags & BDRV_O_NO_IO) {
226 cflags |= QCRYPTO_BLOCK_OPEN_NO_IO;
228 crypto->block = qcrypto_block_open(open_opts, NULL,
229 block_crypto_read_func,
235 if (!crypto->block) {
240 bs->encrypted = true;
244 qobject_unref(cryptoopts);
245 qapi_free_QCryptoBlockOpenOptions(open_opts);
250 static int block_crypto_co_create_generic(BlockDriverState *bs,
252 QCryptoBlockCreateOptions *opts,
257 QCryptoBlock *crypto = NULL;
258 struct BlockCryptoCreateData data;
260 blk = blk_new(bdrv_get_aio_context(bs),
261 BLK_PERM_WRITE | BLK_PERM_RESIZE, BLK_PERM_ALL);
263 ret = blk_insert_bs(blk, bs, errp);
268 data = (struct BlockCryptoCreateData) {
273 crypto = qcrypto_block_create(opts, NULL,
274 block_crypto_init_func,
275 block_crypto_write_func,
286 qcrypto_block_free(crypto);
291 static int coroutine_fn
292 block_crypto_co_truncate(BlockDriverState *bs, int64_t offset,
293 PreallocMode prealloc, Error **errp)
295 BlockCrypto *crypto = bs->opaque;
296 uint64_t payload_offset =
297 qcrypto_block_get_payload_offset(crypto->block);
299 if (payload_offset > INT64_MAX - offset) {
300 error_setg(errp, "The requested file size is too large");
304 offset += payload_offset;
306 return bdrv_co_truncate(bs->file, offset, prealloc, errp);
309 static void block_crypto_close(BlockDriverState *bs)
311 BlockCrypto *crypto = bs->opaque;
312 qcrypto_block_free(crypto->block);
315 static int block_crypto_reopen_prepare(BDRVReopenState *state,
316 BlockReopenQueue *queue, Error **errp)
318 /* nothing needs checking */
323 * 1 MB bounce buffer gives good performance / memory tradeoff
324 * when using cache=none|directsync.
326 #define BLOCK_CRYPTO_MAX_IO_SIZE (1024 * 1024)
328 static coroutine_fn int
329 block_crypto_co_preadv(BlockDriverState *bs, uint64_t offset, uint64_t bytes,
330 QEMUIOVector *qiov, int flags)
332 BlockCrypto *crypto = bs->opaque;
333 uint64_t cur_bytes; /* number of bytes in current iteration */
334 uint64_t bytes_done = 0;
335 uint8_t *cipher_data = NULL;
336 QEMUIOVector hd_qiov;
338 uint64_t sector_size = qcrypto_block_get_sector_size(crypto->block);
339 uint64_t payload_offset = qcrypto_block_get_payload_offset(crypto->block);
342 assert(payload_offset < INT64_MAX);
343 assert(QEMU_IS_ALIGNED(offset, sector_size));
344 assert(QEMU_IS_ALIGNED(bytes, sector_size));
346 qemu_iovec_init(&hd_qiov, qiov->niov);
348 /* Bounce buffer because we don't wish to expose cipher text
349 * in qiov which points to guest memory.
352 qemu_try_blockalign(bs->file->bs, MIN(BLOCK_CRYPTO_MAX_IO_SIZE,
354 if (cipher_data == NULL) {
360 cur_bytes = MIN(bytes, BLOCK_CRYPTO_MAX_IO_SIZE);
362 qemu_iovec_reset(&hd_qiov);
363 qemu_iovec_add(&hd_qiov, cipher_data, cur_bytes);
365 ret = bdrv_co_preadv(bs->file, payload_offset + offset + bytes_done,
366 cur_bytes, &hd_qiov, 0);
371 if (qcrypto_block_decrypt(crypto->block, offset + bytes_done,
372 cipher_data, cur_bytes, NULL) < 0) {
377 qemu_iovec_from_buf(qiov, bytes_done, cipher_data, cur_bytes);
380 bytes_done += cur_bytes;
384 qemu_iovec_destroy(&hd_qiov);
385 qemu_vfree(cipher_data);
391 static coroutine_fn int
392 block_crypto_co_pwritev(BlockDriverState *bs, uint64_t offset, uint64_t bytes,
393 QEMUIOVector *qiov, int flags)
395 BlockCrypto *crypto = bs->opaque;
396 uint64_t cur_bytes; /* number of bytes in current iteration */
397 uint64_t bytes_done = 0;
398 uint8_t *cipher_data = NULL;
399 QEMUIOVector hd_qiov;
401 uint64_t sector_size = qcrypto_block_get_sector_size(crypto->block);
402 uint64_t payload_offset = qcrypto_block_get_payload_offset(crypto->block);
404 assert(!(flags & ~BDRV_REQ_FUA));
405 assert(payload_offset < INT64_MAX);
406 assert(QEMU_IS_ALIGNED(offset, sector_size));
407 assert(QEMU_IS_ALIGNED(bytes, sector_size));
409 qemu_iovec_init(&hd_qiov, qiov->niov);
411 /* Bounce buffer because we're not permitted to touch
412 * contents of qiov - it points to guest memory.
415 qemu_try_blockalign(bs->file->bs, MIN(BLOCK_CRYPTO_MAX_IO_SIZE,
417 if (cipher_data == NULL) {
423 cur_bytes = MIN(bytes, BLOCK_CRYPTO_MAX_IO_SIZE);
425 qemu_iovec_to_buf(qiov, bytes_done, cipher_data, cur_bytes);
427 if (qcrypto_block_encrypt(crypto->block, offset + bytes_done,
428 cipher_data, cur_bytes, NULL) < 0) {
433 qemu_iovec_reset(&hd_qiov);
434 qemu_iovec_add(&hd_qiov, cipher_data, cur_bytes);
436 ret = bdrv_co_pwritev(bs->file, payload_offset + offset + bytes_done,
437 cur_bytes, &hd_qiov, flags);
443 bytes_done += cur_bytes;
447 qemu_iovec_destroy(&hd_qiov);
448 qemu_vfree(cipher_data);
453 static void block_crypto_refresh_limits(BlockDriverState *bs, Error **errp)
455 BlockCrypto *crypto = bs->opaque;
456 uint64_t sector_size = qcrypto_block_get_sector_size(crypto->block);
457 bs->bl.request_alignment = sector_size; /* No sub-sector I/O */
461 static int64_t block_crypto_getlength(BlockDriverState *bs)
463 BlockCrypto *crypto = bs->opaque;
464 int64_t len = bdrv_getlength(bs->file->bs);
466 uint64_t offset = qcrypto_block_get_payload_offset(crypto->block);
467 assert(offset < INT64_MAX);
479 static int block_crypto_probe_luks(const uint8_t *buf,
481 const char *filename) {
482 return block_crypto_probe_generic(Q_CRYPTO_BLOCK_FORMAT_LUKS,
483 buf, buf_size, filename);
486 static int block_crypto_open_luks(BlockDriverState *bs,
491 return block_crypto_open_generic(Q_CRYPTO_BLOCK_FORMAT_LUKS,
492 &block_crypto_runtime_opts_luks,
493 bs, options, flags, errp);
496 static int coroutine_fn
497 block_crypto_co_create_luks(BlockdevCreateOptions *create_options, Error **errp)
499 BlockdevCreateOptionsLUKS *luks_opts;
500 BlockDriverState *bs = NULL;
501 QCryptoBlockCreateOptions create_opts;
504 assert(create_options->driver == BLOCKDEV_DRIVER_LUKS);
505 luks_opts = &create_options->u.luks;
507 bs = bdrv_open_blockdev_ref(luks_opts->file, errp);
512 create_opts = (QCryptoBlockCreateOptions) {
513 .format = Q_CRYPTO_BLOCK_FORMAT_LUKS,
514 .u.luks = *qapi_BlockdevCreateOptionsLUKS_base(luks_opts),
517 ret = block_crypto_co_create_generic(bs, luks_opts->size, &create_opts,
529 static int coroutine_fn block_crypto_co_create_opts_luks(const char *filename,
533 QCryptoBlockCreateOptions *create_opts = NULL;
534 BlockDriverState *bs = NULL;
540 size = qemu_opt_get_size_del(opts, BLOCK_OPT_SIZE, 0);
542 cryptoopts = qemu_opts_to_qdict_filtered(opts, NULL,
543 &block_crypto_create_opts_luks,
546 qdict_put_str(cryptoopts, "format", "luks");
547 create_opts = block_crypto_create_opts_init(cryptoopts, errp);
553 /* Create protocol layer */
554 ret = bdrv_create_file(filename, opts, errp);
559 bs = bdrv_open(filename, NULL, NULL,
560 BDRV_O_RDWR | BDRV_O_RESIZE | BDRV_O_PROTOCOL, errp);
566 /* Create format layer */
567 ret = block_crypto_co_create_generic(bs, size, create_opts, errp);
575 qapi_free_QCryptoBlockCreateOptions(create_opts);
576 qobject_unref(cryptoopts);
580 static int block_crypto_get_info_luks(BlockDriverState *bs,
581 BlockDriverInfo *bdi)
583 BlockDriverInfo subbdi;
586 ret = bdrv_get_info(bs->file->bs, &subbdi);
591 bdi->unallocated_blocks_are_zero = false;
592 bdi->cluster_size = subbdi.cluster_size;
597 static ImageInfoSpecific *
598 block_crypto_get_specific_info_luks(BlockDriverState *bs, Error **errp)
600 BlockCrypto *crypto = bs->opaque;
601 ImageInfoSpecific *spec_info;
602 QCryptoBlockInfo *info;
604 info = qcrypto_block_get_info(crypto->block, errp);
608 assert(info->format == Q_CRYPTO_BLOCK_FORMAT_LUKS);
610 spec_info = g_new(ImageInfoSpecific, 1);
611 spec_info->type = IMAGE_INFO_SPECIFIC_KIND_LUKS;
612 spec_info->u.luks.data = g_new(QCryptoBlockInfoLUKS, 1);
613 *spec_info->u.luks.data = info->u.luks;
615 /* Blank out pointers we've just stolen to avoid double free */
616 memset(&info->u.luks, 0, sizeof(info->u.luks));
618 qapi_free_QCryptoBlockInfo(info);
623 static const char *const block_crypto_strong_runtime_opts[] = {
624 BLOCK_CRYPTO_OPT_LUKS_KEY_SECRET,
629 static BlockDriver bdrv_crypto_luks = {
630 .format_name = "luks",
631 .instance_size = sizeof(BlockCrypto),
632 .bdrv_probe = block_crypto_probe_luks,
633 .bdrv_open = block_crypto_open_luks,
634 .bdrv_close = block_crypto_close,
635 /* This driver doesn't modify LUKS metadata except when creating image.
636 * Allow share-rw=on as a special case. */
637 .bdrv_child_perm = bdrv_filter_default_perms,
638 .bdrv_co_create = block_crypto_co_create_luks,
639 .bdrv_co_create_opts = block_crypto_co_create_opts_luks,
640 .bdrv_co_truncate = block_crypto_co_truncate,
641 .create_opts = &block_crypto_create_opts_luks,
643 .bdrv_reopen_prepare = block_crypto_reopen_prepare,
644 .bdrv_refresh_limits = block_crypto_refresh_limits,
645 .bdrv_co_preadv = block_crypto_co_preadv,
646 .bdrv_co_pwritev = block_crypto_co_pwritev,
647 .bdrv_getlength = block_crypto_getlength,
648 .bdrv_get_info = block_crypto_get_info_luks,
649 .bdrv_get_specific_info = block_crypto_get_specific_info_luks,
651 .strong_runtime_opts = block_crypto_strong_runtime_opts,
654 static void block_crypto_init(void)
656 bdrv_register(&bdrv_crypto_luks);
659 block_init(block_crypto_init);