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 "sysemu/block-backend.h"
25 #include "crypto/block.h"
26 #include "qapi/opts-visitor.h"
27 #include "qapi/qobject-input-visitor.h"
28 #include "qapi-visit.h"
29 #include "qapi/error.h"
30 #include "block/crypto.h"
32 typedef struct BlockCrypto BlockCrypto;
39 static int block_crypto_probe_generic(QCryptoBlockFormat format,
44 if (qcrypto_block_has_format(format, buf, buf_size)) {
52 static ssize_t block_crypto_read_func(QCryptoBlock *block,
59 BlockDriverState *bs = opaque;
62 ret = bdrv_pread(bs->file, offset, buf, buflen);
64 error_setg_errno(errp, -ret, "Could not read encryption header");
71 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;
106 /* User provided size should reflect amount of space made
107 * available to the guest, so we must take account of that
108 * which will be used by the crypto header
110 data->size += headerlen;
112 qemu_opt_set_number(data->opts, BLOCK_OPT_SIZE, data->size, &error_abort);
113 ret = bdrv_create_file(data->filename, data->opts, errp);
118 data->blk = blk_new_open(data->filename, NULL, NULL,
119 BDRV_O_RDWR | BDRV_O_PROTOCOL, errp);
128 static QemuOptsList block_crypto_runtime_opts_luks = {
130 .head = QTAILQ_HEAD_INITIALIZER(block_crypto_runtime_opts_luks.head),
132 BLOCK_CRYPTO_OPT_DEF_LUKS_KEY_SECRET(""),
133 { /* end of list */ }
138 static QemuOptsList block_crypto_create_opts_luks = {
140 .head = QTAILQ_HEAD_INITIALIZER(block_crypto_create_opts_luks.head),
143 .name = BLOCK_OPT_SIZE,
144 .type = QEMU_OPT_SIZE,
145 .help = "Virtual disk size"
147 BLOCK_CRYPTO_OPT_DEF_LUKS_KEY_SECRET(""),
148 BLOCK_CRYPTO_OPT_DEF_LUKS_CIPHER_ALG(""),
149 BLOCK_CRYPTO_OPT_DEF_LUKS_CIPHER_MODE(""),
150 BLOCK_CRYPTO_OPT_DEF_LUKS_IVGEN_ALG(""),
151 BLOCK_CRYPTO_OPT_DEF_LUKS_IVGEN_HASH_ALG(""),
152 BLOCK_CRYPTO_OPT_DEF_LUKS_HASH_ALG(""),
153 BLOCK_CRYPTO_OPT_DEF_LUKS_ITER_TIME(""),
154 { /* end of list */ }
159 QCryptoBlockOpenOptions *
160 block_crypto_open_opts_init(QCryptoBlockFormat format,
165 QCryptoBlockOpenOptions *ret = NULL;
166 Error *local_err = NULL;
168 ret = g_new0(QCryptoBlockOpenOptions, 1);
169 ret->format = format;
171 v = qobject_input_visitor_new_keyval(QOBJECT(opts));
173 visit_start_struct(v, NULL, NULL, 0, &local_err);
179 case Q_CRYPTO_BLOCK_FORMAT_LUKS:
180 visit_type_QCryptoBlockOptionsLUKS_members(
181 v, &ret->u.luks, &local_err);
184 case Q_CRYPTO_BLOCK_FORMAT_QCOW:
185 visit_type_QCryptoBlockOptionsQCow_members(
186 v, &ret->u.qcow, &local_err);
190 error_setg(&local_err, "Unsupported block format %d", format);
194 visit_check_struct(v, &local_err);
197 visit_end_struct(v, NULL);
201 error_propagate(errp, local_err);
202 qapi_free_QCryptoBlockOpenOptions(ret);
210 QCryptoBlockCreateOptions *
211 block_crypto_create_opts_init(QCryptoBlockFormat format,
216 QCryptoBlockCreateOptions *ret = NULL;
217 Error *local_err = NULL;
219 ret = g_new0(QCryptoBlockCreateOptions, 1);
220 ret->format = format;
222 v = qobject_input_visitor_new_keyval(QOBJECT(opts));
224 visit_start_struct(v, NULL, NULL, 0, &local_err);
230 case Q_CRYPTO_BLOCK_FORMAT_LUKS:
231 visit_type_QCryptoBlockCreateOptionsLUKS_members(
232 v, &ret->u.luks, &local_err);
235 case Q_CRYPTO_BLOCK_FORMAT_QCOW:
236 visit_type_QCryptoBlockOptionsQCow_members(
237 v, &ret->u.qcow, &local_err);
241 error_setg(&local_err, "Unsupported block format %d", format);
245 visit_check_struct(v, &local_err);
248 visit_end_struct(v, NULL);
252 error_propagate(errp, local_err);
253 qapi_free_QCryptoBlockCreateOptions(ret);
261 static int block_crypto_open_generic(QCryptoBlockFormat format,
262 QemuOptsList *opts_spec,
263 BlockDriverState *bs,
268 BlockCrypto *crypto = bs->opaque;
269 QemuOpts *opts = NULL;
270 Error *local_err = NULL;
272 QCryptoBlockOpenOptions *open_opts = NULL;
273 unsigned int cflags = 0;
274 QDict *cryptoopts = NULL;
276 bs->file = bdrv_open_child(NULL, options, "file", bs, &child_file,
282 bs->supported_write_flags = BDRV_REQ_FUA &
283 bs->file->bs->supported_write_flags;
285 opts = qemu_opts_create(opts_spec, NULL, 0, &error_abort);
286 qemu_opts_absorb_qdict(opts, options, &local_err);
288 error_propagate(errp, local_err);
292 cryptoopts = qemu_opts_to_qdict(opts, NULL);
294 open_opts = block_crypto_open_opts_init(format, cryptoopts, errp);
299 if (flags & BDRV_O_NO_IO) {
300 cflags |= QCRYPTO_BLOCK_OPEN_NO_IO;
302 crypto->block = qcrypto_block_open(open_opts, NULL,
303 block_crypto_read_func,
308 if (!crypto->block) {
313 bs->encrypted = true;
318 qapi_free_QCryptoBlockOpenOptions(open_opts);
323 static int block_crypto_create_generic(QCryptoBlockFormat format,
324 const char *filename,
329 QCryptoBlockCreateOptions *create_opts = NULL;
330 QCryptoBlock *crypto = NULL;
331 struct BlockCryptoCreateData data = {
332 .size = ROUND_UP(qemu_opt_get_size_del(opts, BLOCK_OPT_SIZE, 0),
335 .filename = filename,
339 cryptoopts = qemu_opts_to_qdict(opts, NULL);
341 create_opts = block_crypto_create_opts_init(format, cryptoopts, errp);
346 crypto = qcrypto_block_create(create_opts, NULL,
347 block_crypto_init_func,
348 block_crypto_write_func,
360 qcrypto_block_free(crypto);
362 qapi_free_QCryptoBlockCreateOptions(create_opts);
366 static int block_crypto_truncate(BlockDriverState *bs, int64_t offset,
367 PreallocMode prealloc, Error **errp)
369 BlockCrypto *crypto = bs->opaque;
370 uint64_t payload_offset =
371 qcrypto_block_get_payload_offset(crypto->block);
372 assert(payload_offset < (INT64_MAX - offset));
374 offset += payload_offset;
376 return bdrv_truncate(bs->file, offset, prealloc, errp);
379 static void block_crypto_close(BlockDriverState *bs)
381 BlockCrypto *crypto = bs->opaque;
382 qcrypto_block_free(crypto->block);
387 * 1 MB bounce buffer gives good performance / memory tradeoff
388 * when using cache=none|directsync.
390 #define BLOCK_CRYPTO_MAX_IO_SIZE (1024 * 1024)
392 static coroutine_fn int
393 block_crypto_co_preadv(BlockDriverState *bs, uint64_t offset, uint64_t bytes,
394 QEMUIOVector *qiov, int flags)
396 BlockCrypto *crypto = bs->opaque;
397 uint64_t cur_bytes; /* number of bytes in current iteration */
398 uint64_t bytes_done = 0;
399 uint8_t *cipher_data = NULL;
400 QEMUIOVector hd_qiov;
402 uint64_t sector_size = qcrypto_block_get_sector_size(crypto->block);
403 uint64_t payload_offset = qcrypto_block_get_payload_offset(crypto->block);
406 assert(payload_offset < INT64_MAX);
407 assert(QEMU_IS_ALIGNED(offset, sector_size));
408 assert(QEMU_IS_ALIGNED(bytes, sector_size));
410 qemu_iovec_init(&hd_qiov, qiov->niov);
412 /* Bounce buffer because we don't wish to expose cipher text
413 * in qiov which points to guest memory.
416 qemu_try_blockalign(bs->file->bs, MIN(BLOCK_CRYPTO_MAX_IO_SIZE,
418 if (cipher_data == NULL) {
424 cur_bytes = MIN(bytes, BLOCK_CRYPTO_MAX_IO_SIZE);
426 qemu_iovec_reset(&hd_qiov);
427 qemu_iovec_add(&hd_qiov, cipher_data, cur_bytes);
429 ret = bdrv_co_preadv(bs->file, payload_offset + offset + bytes_done,
430 cur_bytes, &hd_qiov, 0);
435 if (qcrypto_block_decrypt(crypto->block, offset + bytes_done,
436 cipher_data, cur_bytes, NULL) < 0) {
441 qemu_iovec_from_buf(qiov, bytes_done, cipher_data, cur_bytes);
444 bytes_done += cur_bytes;
448 qemu_iovec_destroy(&hd_qiov);
449 qemu_vfree(cipher_data);
455 static coroutine_fn int
456 block_crypto_co_pwritev(BlockDriverState *bs, uint64_t offset, uint64_t bytes,
457 QEMUIOVector *qiov, int flags)
459 BlockCrypto *crypto = bs->opaque;
460 uint64_t cur_bytes; /* number of bytes in current iteration */
461 uint64_t bytes_done = 0;
462 uint8_t *cipher_data = NULL;
463 QEMUIOVector hd_qiov;
465 uint64_t sector_size = qcrypto_block_get_sector_size(crypto->block);
466 uint64_t payload_offset = qcrypto_block_get_payload_offset(crypto->block);
468 assert(!(flags & ~BDRV_REQ_FUA));
469 assert(payload_offset < INT64_MAX);
470 assert(QEMU_IS_ALIGNED(offset, sector_size));
471 assert(QEMU_IS_ALIGNED(bytes, sector_size));
473 qemu_iovec_init(&hd_qiov, qiov->niov);
475 /* Bounce buffer because we're not permitted to touch
476 * contents of qiov - it points to guest memory.
479 qemu_try_blockalign(bs->file->bs, MIN(BLOCK_CRYPTO_MAX_IO_SIZE,
481 if (cipher_data == NULL) {
487 cur_bytes = MIN(bytes, BLOCK_CRYPTO_MAX_IO_SIZE);
489 qemu_iovec_to_buf(qiov, bytes_done, cipher_data, cur_bytes);
491 if (qcrypto_block_encrypt(crypto->block, offset + bytes_done,
492 cipher_data, cur_bytes, NULL) < 0) {
497 qemu_iovec_reset(&hd_qiov);
498 qemu_iovec_add(&hd_qiov, cipher_data, cur_bytes);
500 ret = bdrv_co_pwritev(bs->file, payload_offset + offset + bytes_done,
501 cur_bytes, &hd_qiov, flags);
507 bytes_done += cur_bytes;
511 qemu_iovec_destroy(&hd_qiov);
512 qemu_vfree(cipher_data);
517 static void block_crypto_refresh_limits(BlockDriverState *bs, Error **errp)
519 BlockCrypto *crypto = bs->opaque;
520 uint64_t sector_size = qcrypto_block_get_sector_size(crypto->block);
521 bs->bl.request_alignment = sector_size; /* No sub-sector I/O */
525 static int64_t block_crypto_getlength(BlockDriverState *bs)
527 BlockCrypto *crypto = bs->opaque;
528 int64_t len = bdrv_getlength(bs->file->bs);
530 uint64_t offset = qcrypto_block_get_payload_offset(crypto->block);
531 assert(offset < INT64_MAX);
532 assert(offset < len);
540 static int block_crypto_probe_luks(const uint8_t *buf,
542 const char *filename) {
543 return block_crypto_probe_generic(Q_CRYPTO_BLOCK_FORMAT_LUKS,
544 buf, buf_size, filename);
547 static int block_crypto_open_luks(BlockDriverState *bs,
552 return block_crypto_open_generic(Q_CRYPTO_BLOCK_FORMAT_LUKS,
553 &block_crypto_runtime_opts_luks,
554 bs, options, flags, errp);
557 static int block_crypto_create_luks(const char *filename,
561 return block_crypto_create_generic(Q_CRYPTO_BLOCK_FORMAT_LUKS,
562 filename, opts, errp);
565 static int block_crypto_get_info_luks(BlockDriverState *bs,
566 BlockDriverInfo *bdi)
568 BlockDriverInfo subbdi;
571 ret = bdrv_get_info(bs->file->bs, &subbdi);
576 bdi->unallocated_blocks_are_zero = false;
577 bdi->can_write_zeroes_with_unmap = false;
578 bdi->cluster_size = subbdi.cluster_size;
583 static ImageInfoSpecific *
584 block_crypto_get_specific_info_luks(BlockDriverState *bs)
586 BlockCrypto *crypto = bs->opaque;
587 ImageInfoSpecific *spec_info;
588 QCryptoBlockInfo *info;
590 info = qcrypto_block_get_info(crypto->block, NULL);
594 if (info->format != Q_CRYPTO_BLOCK_FORMAT_LUKS) {
595 qapi_free_QCryptoBlockInfo(info);
599 spec_info = g_new(ImageInfoSpecific, 1);
600 spec_info->type = IMAGE_INFO_SPECIFIC_KIND_LUKS;
601 spec_info->u.luks.data = g_new(QCryptoBlockInfoLUKS, 1);
602 *spec_info->u.luks.data = info->u.luks;
604 /* Blank out pointers we've just stolen to avoid double free */
605 memset(&info->u.luks, 0, sizeof(info->u.luks));
607 qapi_free_QCryptoBlockInfo(info);
612 BlockDriver bdrv_crypto_luks = {
613 .format_name = "luks",
614 .instance_size = sizeof(BlockCrypto),
615 .bdrv_probe = block_crypto_probe_luks,
616 .bdrv_open = block_crypto_open_luks,
617 .bdrv_close = block_crypto_close,
618 .bdrv_child_perm = bdrv_format_default_perms,
619 .bdrv_create = block_crypto_create_luks,
620 .bdrv_truncate = block_crypto_truncate,
621 .create_opts = &block_crypto_create_opts_luks,
623 .bdrv_refresh_limits = block_crypto_refresh_limits,
624 .bdrv_co_preadv = block_crypto_co_preadv,
625 .bdrv_co_pwritev = block_crypto_co_pwritev,
626 .bdrv_getlength = block_crypto_getlength,
627 .bdrv_get_info = block_crypto_get_info_luks,
628 .bdrv_get_specific_info = block_crypto_get_specific_info_luks,
631 static void block_crypto_init(void)
633 bdrv_register(&bdrv_crypto_luks);
636 block_init(block_crypto_init);