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-visit.h"
28 #include "qapi/error.h"
30 #define BLOCK_CRYPTO_OPT_LUKS_KEY_SECRET "key-secret"
31 #define BLOCK_CRYPTO_OPT_LUKS_CIPHER_ALG "cipher-alg"
32 #define BLOCK_CRYPTO_OPT_LUKS_CIPHER_MODE "cipher-mode"
33 #define BLOCK_CRYPTO_OPT_LUKS_IVGEN_ALG "ivgen-alg"
34 #define BLOCK_CRYPTO_OPT_LUKS_IVGEN_HASH_ALG "ivgen-hash-alg"
35 #define BLOCK_CRYPTO_OPT_LUKS_HASH_ALG "hash-alg"
36 #define BLOCK_CRYPTO_OPT_LUKS_ITER_TIME "iter-time"
38 typedef struct BlockCrypto BlockCrypto
;
45 static int block_crypto_probe_generic(QCryptoBlockFormat format
,
50 if (qcrypto_block_has_format(format
, buf
, buf_size
)) {
58 static ssize_t
block_crypto_read_func(QCryptoBlock
*block
,
65 BlockDriverState
*bs
= opaque
;
68 ret
= bdrv_pread(bs
->file
, offset
, buf
, buflen
);
70 error_setg_errno(errp
, -ret
, "Could not read encryption header");
77 struct BlockCryptoCreateData
{
85 static ssize_t
block_crypto_write_func(QCryptoBlock
*block
,
92 struct BlockCryptoCreateData
*data
= opaque
;
95 ret
= blk_pwrite(data
->blk
, offset
, buf
, buflen
, 0);
97 error_setg_errno(errp
, -ret
, "Could not write encryption header");
104 static ssize_t
block_crypto_init_func(QCryptoBlock
*block
,
109 struct BlockCryptoCreateData
*data
= opaque
;
112 /* User provided size should reflect amount of space made
113 * available to the guest, so we must take account of that
114 * which will be used by the crypto header
116 data
->size
+= headerlen
;
118 qemu_opt_set_number(data
->opts
, BLOCK_OPT_SIZE
, data
->size
, &error_abort
);
119 ret
= bdrv_create_file(data
->filename
, data
->opts
, errp
);
124 data
->blk
= blk_new_open(data
->filename
, NULL
, NULL
,
125 BDRV_O_RDWR
| BDRV_O_PROTOCOL
, errp
);
134 static QemuOptsList block_crypto_runtime_opts_luks
= {
136 .head
= QTAILQ_HEAD_INITIALIZER(block_crypto_runtime_opts_luks
.head
),
139 .name
= BLOCK_CRYPTO_OPT_LUKS_KEY_SECRET
,
140 .type
= QEMU_OPT_STRING
,
141 .help
= "ID of the secret that provides the encryption key",
143 { /* end of list */ }
148 static QemuOptsList block_crypto_create_opts_luks
= {
150 .head
= QTAILQ_HEAD_INITIALIZER(block_crypto_create_opts_luks
.head
),
153 .name
= BLOCK_OPT_SIZE
,
154 .type
= QEMU_OPT_SIZE
,
155 .help
= "Virtual disk size"
158 .name
= BLOCK_CRYPTO_OPT_LUKS_KEY_SECRET
,
159 .type
= QEMU_OPT_STRING
,
160 .help
= "ID of the secret that provides the encryption key",
163 .name
= BLOCK_CRYPTO_OPT_LUKS_CIPHER_ALG
,
164 .type
= QEMU_OPT_STRING
,
165 .help
= "Name of encryption cipher algorithm",
168 .name
= BLOCK_CRYPTO_OPT_LUKS_CIPHER_MODE
,
169 .type
= QEMU_OPT_STRING
,
170 .help
= "Name of encryption cipher mode",
173 .name
= BLOCK_CRYPTO_OPT_LUKS_IVGEN_ALG
,
174 .type
= QEMU_OPT_STRING
,
175 .help
= "Name of IV generator algorithm",
178 .name
= BLOCK_CRYPTO_OPT_LUKS_IVGEN_HASH_ALG
,
179 .type
= QEMU_OPT_STRING
,
180 .help
= "Name of IV generator hash algorithm",
183 .name
= BLOCK_CRYPTO_OPT_LUKS_HASH_ALG
,
184 .type
= QEMU_OPT_STRING
,
185 .help
= "Name of encryption hash algorithm",
188 .name
= BLOCK_CRYPTO_OPT_LUKS_ITER_TIME
,
189 .type
= QEMU_OPT_NUMBER
,
190 .help
= "Time to spend in PBKDF in milliseconds",
192 { /* end of list */ }
197 static QCryptoBlockOpenOptions
*
198 block_crypto_open_opts_init(QCryptoBlockFormat format
,
203 QCryptoBlockOpenOptions
*ret
= NULL
;
204 Error
*local_err
= NULL
;
206 ret
= g_new0(QCryptoBlockOpenOptions
, 1);
207 ret
->format
= format
;
209 v
= opts_visitor_new(opts
);
211 visit_start_struct(v
, NULL
, NULL
, 0, &local_err
);
217 case Q_CRYPTO_BLOCK_FORMAT_LUKS
:
218 visit_type_QCryptoBlockOptionsLUKS_members(
219 v
, &ret
->u
.luks
, &local_err
);
223 error_setg(&local_err
, "Unsupported block format %d", format
);
227 visit_check_struct(v
, &local_err
);
230 visit_end_struct(v
, NULL
);
234 error_propagate(errp
, local_err
);
235 qapi_free_QCryptoBlockOpenOptions(ret
);
243 static QCryptoBlockCreateOptions
*
244 block_crypto_create_opts_init(QCryptoBlockFormat format
,
249 QCryptoBlockCreateOptions
*ret
= NULL
;
250 Error
*local_err
= NULL
;
252 ret
= g_new0(QCryptoBlockCreateOptions
, 1);
253 ret
->format
= format
;
255 v
= opts_visitor_new(opts
);
257 visit_start_struct(v
, NULL
, NULL
, 0, &local_err
);
263 case Q_CRYPTO_BLOCK_FORMAT_LUKS
:
264 visit_type_QCryptoBlockCreateOptionsLUKS_members(
265 v
, &ret
->u
.luks
, &local_err
);
269 error_setg(&local_err
, "Unsupported block format %d", format
);
273 visit_check_struct(v
, &local_err
);
276 visit_end_struct(v
, NULL
);
280 error_propagate(errp
, local_err
);
281 qapi_free_QCryptoBlockCreateOptions(ret
);
289 static int block_crypto_open_generic(QCryptoBlockFormat format
,
290 QemuOptsList
*opts_spec
,
291 BlockDriverState
*bs
,
296 BlockCrypto
*crypto
= bs
->opaque
;
297 QemuOpts
*opts
= NULL
;
298 Error
*local_err
= NULL
;
300 QCryptoBlockOpenOptions
*open_opts
= NULL
;
301 unsigned int cflags
= 0;
303 bs
->file
= bdrv_open_child(NULL
, options
, "file", bs
, &child_file
,
309 opts
= qemu_opts_create(opts_spec
, NULL
, 0, &error_abort
);
310 qemu_opts_absorb_qdict(opts
, options
, &local_err
);
312 error_propagate(errp
, local_err
);
316 open_opts
= block_crypto_open_opts_init(format
, opts
, errp
);
321 if (flags
& BDRV_O_NO_IO
) {
322 cflags
|= QCRYPTO_BLOCK_OPEN_NO_IO
;
324 crypto
->block
= qcrypto_block_open(open_opts
,
325 block_crypto_read_func
,
330 if (!crypto
->block
) {
335 bs
->encrypted
= true;
336 bs
->valid_key
= true;
340 qapi_free_QCryptoBlockOpenOptions(open_opts
);
345 static int block_crypto_create_generic(QCryptoBlockFormat format
,
346 const char *filename
,
351 QCryptoBlockCreateOptions
*create_opts
= NULL
;
352 QCryptoBlock
*crypto
= NULL
;
353 struct BlockCryptoCreateData data
= {
354 .size
= ROUND_UP(qemu_opt_get_size_del(opts
, BLOCK_OPT_SIZE
, 0),
357 .filename
= filename
,
360 create_opts
= block_crypto_create_opts_init(format
, opts
, errp
);
365 crypto
= qcrypto_block_create(create_opts
,
366 block_crypto_init_func
,
367 block_crypto_write_func
,
378 qcrypto_block_free(crypto
);
380 qapi_free_QCryptoBlockCreateOptions(create_opts
);
384 static int block_crypto_truncate(BlockDriverState
*bs
, int64_t offset
)
386 BlockCrypto
*crypto
= bs
->opaque
;
387 size_t payload_offset
=
388 qcrypto_block_get_payload_offset(crypto
->block
);
390 offset
+= payload_offset
;
392 return bdrv_truncate(bs
->file
, offset
);
395 static void block_crypto_close(BlockDriverState
*bs
)
397 BlockCrypto
*crypto
= bs
->opaque
;
398 qcrypto_block_free(crypto
->block
);
402 #define BLOCK_CRYPTO_MAX_SECTORS 32
404 static coroutine_fn
int
405 block_crypto_co_readv(BlockDriverState
*bs
, int64_t sector_num
,
406 int remaining_sectors
, QEMUIOVector
*qiov
)
408 BlockCrypto
*crypto
= bs
->opaque
;
409 int cur_nr_sectors
; /* number of sectors in current iteration */
410 uint64_t bytes_done
= 0;
411 uint8_t *cipher_data
= NULL
;
412 QEMUIOVector hd_qiov
;
414 size_t payload_offset
=
415 qcrypto_block_get_payload_offset(crypto
->block
) / 512;
417 qemu_iovec_init(&hd_qiov
, qiov
->niov
);
419 /* Bounce buffer so we have a linear mem region for
420 * entire sector. XXX optimize so we avoid bounce
421 * buffer in case that qiov->niov == 1
424 qemu_try_blockalign(bs
->file
->bs
, MIN(BLOCK_CRYPTO_MAX_SECTORS
* 512,
426 if (cipher_data
== NULL
) {
431 while (remaining_sectors
) {
432 cur_nr_sectors
= remaining_sectors
;
434 if (cur_nr_sectors
> BLOCK_CRYPTO_MAX_SECTORS
) {
435 cur_nr_sectors
= BLOCK_CRYPTO_MAX_SECTORS
;
438 qemu_iovec_reset(&hd_qiov
);
439 qemu_iovec_add(&hd_qiov
, cipher_data
, cur_nr_sectors
* 512);
441 ret
= bdrv_co_readv(bs
->file
,
442 payload_offset
+ sector_num
,
443 cur_nr_sectors
, &hd_qiov
);
448 if (qcrypto_block_decrypt(crypto
->block
,
450 cipher_data
, cur_nr_sectors
* 512,
456 qemu_iovec_from_buf(qiov
, bytes_done
,
457 cipher_data
, cur_nr_sectors
* 512);
459 remaining_sectors
-= cur_nr_sectors
;
460 sector_num
+= cur_nr_sectors
;
461 bytes_done
+= cur_nr_sectors
* 512;
465 qemu_iovec_destroy(&hd_qiov
);
466 qemu_vfree(cipher_data
);
472 static coroutine_fn
int
473 block_crypto_co_writev(BlockDriverState
*bs
, int64_t sector_num
,
474 int remaining_sectors
, QEMUIOVector
*qiov
)
476 BlockCrypto
*crypto
= bs
->opaque
;
477 int cur_nr_sectors
; /* number of sectors in current iteration */
478 uint64_t bytes_done
= 0;
479 uint8_t *cipher_data
= NULL
;
480 QEMUIOVector hd_qiov
;
482 size_t payload_offset
=
483 qcrypto_block_get_payload_offset(crypto
->block
) / 512;
485 qemu_iovec_init(&hd_qiov
, qiov
->niov
);
487 /* Bounce buffer so we have a linear mem region for
488 * entire sector. XXX optimize so we avoid bounce
489 * buffer in case that qiov->niov == 1
492 qemu_try_blockalign(bs
->file
->bs
, MIN(BLOCK_CRYPTO_MAX_SECTORS
* 512,
494 if (cipher_data
== NULL
) {
499 while (remaining_sectors
) {
500 cur_nr_sectors
= remaining_sectors
;
502 if (cur_nr_sectors
> BLOCK_CRYPTO_MAX_SECTORS
) {
503 cur_nr_sectors
= BLOCK_CRYPTO_MAX_SECTORS
;
506 qemu_iovec_to_buf(qiov
, bytes_done
,
507 cipher_data
, cur_nr_sectors
* 512);
509 if (qcrypto_block_encrypt(crypto
->block
,
511 cipher_data
, cur_nr_sectors
* 512,
517 qemu_iovec_reset(&hd_qiov
);
518 qemu_iovec_add(&hd_qiov
, cipher_data
, cur_nr_sectors
* 512);
520 ret
= bdrv_co_writev(bs
->file
,
521 payload_offset
+ sector_num
,
522 cur_nr_sectors
, &hd_qiov
);
527 remaining_sectors
-= cur_nr_sectors
;
528 sector_num
+= cur_nr_sectors
;
529 bytes_done
+= cur_nr_sectors
* 512;
533 qemu_iovec_destroy(&hd_qiov
);
534 qemu_vfree(cipher_data
);
540 static int64_t block_crypto_getlength(BlockDriverState
*bs
)
542 BlockCrypto
*crypto
= bs
->opaque
;
543 int64_t len
= bdrv_getlength(bs
->file
->bs
);
545 ssize_t offset
= qcrypto_block_get_payload_offset(crypto
->block
);
553 static int block_crypto_probe_luks(const uint8_t *buf
,
555 const char *filename
) {
556 return block_crypto_probe_generic(Q_CRYPTO_BLOCK_FORMAT_LUKS
,
557 buf
, buf_size
, filename
);
560 static int block_crypto_open_luks(BlockDriverState
*bs
,
565 return block_crypto_open_generic(Q_CRYPTO_BLOCK_FORMAT_LUKS
,
566 &block_crypto_runtime_opts_luks
,
567 bs
, options
, flags
, errp
);
570 static int block_crypto_create_luks(const char *filename
,
574 return block_crypto_create_generic(Q_CRYPTO_BLOCK_FORMAT_LUKS
,
575 filename
, opts
, errp
);
578 static int block_crypto_get_info_luks(BlockDriverState
*bs
,
579 BlockDriverInfo
*bdi
)
581 BlockDriverInfo subbdi
;
584 ret
= bdrv_get_info(bs
->file
->bs
, &subbdi
);
589 bdi
->unallocated_blocks_are_zero
= false;
590 bdi
->can_write_zeroes_with_unmap
= false;
591 bdi
->cluster_size
= subbdi
.cluster_size
;
596 static ImageInfoSpecific
*
597 block_crypto_get_specific_info_luks(BlockDriverState
*bs
)
599 BlockCrypto
*crypto
= bs
->opaque
;
600 ImageInfoSpecific
*spec_info
;
601 QCryptoBlockInfo
*info
;
603 info
= qcrypto_block_get_info(crypto
->block
, NULL
);
607 if (info
->format
!= Q_CRYPTO_BLOCK_FORMAT_LUKS
) {
608 qapi_free_QCryptoBlockInfo(info
);
612 spec_info
= g_new(ImageInfoSpecific
, 1);
613 spec_info
->type
= IMAGE_INFO_SPECIFIC_KIND_LUKS
;
614 spec_info
->u
.luks
.data
= g_new(QCryptoBlockInfoLUKS
, 1);
615 *spec_info
->u
.luks
.data
= info
->u
.luks
;
617 /* Blank out pointers we've just stolen to avoid double free */
618 memset(&info
->u
.luks
, 0, sizeof(info
->u
.luks
));
620 qapi_free_QCryptoBlockInfo(info
);
625 BlockDriver bdrv_crypto_luks
= {
626 .format_name
= "luks",
627 .instance_size
= sizeof(BlockCrypto
),
628 .bdrv_probe
= block_crypto_probe_luks
,
629 .bdrv_open
= block_crypto_open_luks
,
630 .bdrv_close
= block_crypto_close
,
631 .bdrv_child_perm
= bdrv_format_default_perms
,
632 .bdrv_create
= block_crypto_create_luks
,
633 .bdrv_truncate
= block_crypto_truncate
,
634 .create_opts
= &block_crypto_create_opts_luks
,
636 .bdrv_co_readv
= block_crypto_co_readv
,
637 .bdrv_co_writev
= block_crypto_co_writev
,
638 .bdrv_getlength
= block_crypto_getlength
,
639 .bdrv_get_info
= block_crypto_get_info_luks
,
640 .bdrv_get_specific_info
= block_crypto_get_specific_info_luks
,
643 static void block_crypto_init(void)
645 bdrv_register(&bdrv_crypto_luks
);
648 block_init(block_crypto_init
);