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
);