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"
37 typedef struct BlockCrypto BlockCrypto
;
44 static int block_crypto_probe_generic(QCryptoBlockFormat format
,
49 if (qcrypto_block_has_format(format
, buf
, buf_size
)) {
57 static ssize_t
block_crypto_read_func(QCryptoBlock
*block
,
64 BlockDriverState
*bs
= opaque
;
67 ret
= bdrv_pread(bs
->file
->bs
, offset
, buf
, buflen
);
69 error_setg_errno(errp
, -ret
, "Could not read encryption header");
76 struct BlockCryptoCreateData
{
84 static ssize_t
block_crypto_write_func(QCryptoBlock
*block
,
91 struct BlockCryptoCreateData
*data
= opaque
;
94 ret
= blk_pwrite(data
->blk
, offset
, buf
, buflen
, 0);
96 error_setg_errno(errp
, -ret
, "Could not write encryption header");
103 static ssize_t
block_crypto_init_func(QCryptoBlock
*block
,
108 struct BlockCryptoCreateData
*data
= opaque
;
111 /* User provided size should reflect amount of space made
112 * available to the guest, so we must take account of that
113 * which will be used by the crypto header
115 data
->size
+= headerlen
;
117 qemu_opt_set_number(data
->opts
, BLOCK_OPT_SIZE
, data
->size
, &error_abort
);
118 ret
= bdrv_create_file(data
->filename
, data
->opts
, errp
);
123 data
->blk
= blk_new_open(data
->filename
, NULL
, NULL
,
124 BDRV_O_RDWR
| BDRV_O_PROTOCOL
, errp
);
133 static QemuOptsList block_crypto_runtime_opts_luks
= {
135 .head
= QTAILQ_HEAD_INITIALIZER(block_crypto_runtime_opts_luks
.head
),
138 .name
= BLOCK_CRYPTO_OPT_LUKS_KEY_SECRET
,
139 .type
= QEMU_OPT_STRING
,
140 .help
= "ID of the secret that provides the encryption key",
142 { /* end of list */ }
147 static QemuOptsList block_crypto_create_opts_luks
= {
149 .head
= QTAILQ_HEAD_INITIALIZER(block_crypto_create_opts_luks
.head
),
152 .name
= BLOCK_OPT_SIZE
,
153 .type
= QEMU_OPT_SIZE
,
154 .help
= "Virtual disk size"
157 .name
= BLOCK_CRYPTO_OPT_LUKS_KEY_SECRET
,
158 .type
= QEMU_OPT_STRING
,
159 .help
= "ID of the secret that provides the encryption key",
162 .name
= BLOCK_CRYPTO_OPT_LUKS_CIPHER_ALG
,
163 .type
= QEMU_OPT_STRING
,
164 .help
= "Name of encryption cipher algorithm",
167 .name
= BLOCK_CRYPTO_OPT_LUKS_CIPHER_MODE
,
168 .type
= QEMU_OPT_STRING
,
169 .help
= "Name of encryption cipher mode",
172 .name
= BLOCK_CRYPTO_OPT_LUKS_IVGEN_ALG
,
173 .type
= QEMU_OPT_STRING
,
174 .help
= "Name of IV generator algorithm",
177 .name
= BLOCK_CRYPTO_OPT_LUKS_IVGEN_HASH_ALG
,
178 .type
= QEMU_OPT_STRING
,
179 .help
= "Name of IV generator hash algorithm",
182 .name
= BLOCK_CRYPTO_OPT_LUKS_HASH_ALG
,
183 .type
= QEMU_OPT_STRING
,
184 .help
= "Name of encryption hash algorithm",
186 { /* end of list */ }
191 static QCryptoBlockOpenOptions
*
192 block_crypto_open_opts_init(QCryptoBlockFormat format
,
197 QCryptoBlockOpenOptions
*ret
= NULL
;
198 Error
*local_err
= NULL
;
200 ret
= g_new0(QCryptoBlockOpenOptions
, 1);
201 ret
->format
= format
;
203 ov
= opts_visitor_new(opts
);
205 visit_start_struct(opts_get_visitor(ov
),
206 NULL
, NULL
, 0, &local_err
);
212 case Q_CRYPTO_BLOCK_FORMAT_LUKS
:
213 visit_type_QCryptoBlockOptionsLUKS_members(
214 opts_get_visitor(ov
), &ret
->u
.luks
, &local_err
);
218 error_setg(&local_err
, "Unsupported block format %d", format
);
222 visit_check_struct(opts_get_visitor(ov
), &local_err
);
225 visit_end_struct(opts_get_visitor(ov
));
229 error_propagate(errp
, local_err
);
230 qapi_free_QCryptoBlockOpenOptions(ret
);
233 opts_visitor_cleanup(ov
);
238 static QCryptoBlockCreateOptions
*
239 block_crypto_create_opts_init(QCryptoBlockFormat format
,
244 QCryptoBlockCreateOptions
*ret
= NULL
;
245 Error
*local_err
= NULL
;
247 ret
= g_new0(QCryptoBlockCreateOptions
, 1);
248 ret
->format
= format
;
250 ov
= opts_visitor_new(opts
);
252 visit_start_struct(opts_get_visitor(ov
),
253 NULL
, NULL
, 0, &local_err
);
259 case Q_CRYPTO_BLOCK_FORMAT_LUKS
:
260 visit_type_QCryptoBlockCreateOptionsLUKS_members(
261 opts_get_visitor(ov
), &ret
->u
.luks
, &local_err
);
265 error_setg(&local_err
, "Unsupported block format %d", format
);
269 visit_check_struct(opts_get_visitor(ov
), &local_err
);
272 visit_end_struct(opts_get_visitor(ov
));
276 error_propagate(errp
, local_err
);
277 qapi_free_QCryptoBlockCreateOptions(ret
);
280 opts_visitor_cleanup(ov
);
285 static int block_crypto_open_generic(QCryptoBlockFormat format
,
286 QemuOptsList
*opts_spec
,
287 BlockDriverState
*bs
,
292 BlockCrypto
*crypto
= bs
->opaque
;
293 QemuOpts
*opts
= NULL
;
294 Error
*local_err
= NULL
;
296 QCryptoBlockOpenOptions
*open_opts
= NULL
;
297 unsigned int cflags
= 0;
299 opts
= qemu_opts_create(opts_spec
, NULL
, 0, &error_abort
);
300 qemu_opts_absorb_qdict(opts
, options
, &local_err
);
302 error_propagate(errp
, local_err
);
306 open_opts
= block_crypto_open_opts_init(format
, opts
, errp
);
311 if (flags
& BDRV_O_NO_IO
) {
312 cflags
|= QCRYPTO_BLOCK_OPEN_NO_IO
;
314 crypto
->block
= qcrypto_block_open(open_opts
,
315 block_crypto_read_func
,
320 if (!crypto
->block
) {
330 qapi_free_QCryptoBlockOpenOptions(open_opts
);
335 static int block_crypto_create_generic(QCryptoBlockFormat format
,
336 const char *filename
,
341 QCryptoBlockCreateOptions
*create_opts
= NULL
;
342 QCryptoBlock
*crypto
= NULL
;
343 struct BlockCryptoCreateData data
= {
344 .size
= ROUND_UP(qemu_opt_get_size_del(opts
, BLOCK_OPT_SIZE
, 0),
347 .filename
= filename
,
350 create_opts
= block_crypto_create_opts_init(format
, opts
, errp
);
355 crypto
= qcrypto_block_create(create_opts
,
356 block_crypto_init_func
,
357 block_crypto_write_func
,
368 qcrypto_block_free(crypto
);
370 qapi_free_QCryptoBlockCreateOptions(create_opts
);
374 static int block_crypto_truncate(BlockDriverState
*bs
, int64_t offset
)
376 BlockCrypto
*crypto
= bs
->opaque
;
377 size_t payload_offset
=
378 qcrypto_block_get_payload_offset(crypto
->block
);
380 offset
+= payload_offset
;
382 return bdrv_truncate(bs
->file
->bs
, offset
);
385 static void block_crypto_close(BlockDriverState
*bs
)
387 BlockCrypto
*crypto
= bs
->opaque
;
388 qcrypto_block_free(crypto
->block
);
392 #define BLOCK_CRYPTO_MAX_SECTORS 32
394 static coroutine_fn
int
395 block_crypto_co_readv(BlockDriverState
*bs
, int64_t sector_num
,
396 int remaining_sectors
, QEMUIOVector
*qiov
)
398 BlockCrypto
*crypto
= bs
->opaque
;
399 int cur_nr_sectors
; /* number of sectors in current iteration */
400 uint64_t bytes_done
= 0;
401 uint8_t *cipher_data
= NULL
;
402 QEMUIOVector hd_qiov
;
404 size_t payload_offset
=
405 qcrypto_block_get_payload_offset(crypto
->block
) / 512;
407 qemu_iovec_init(&hd_qiov
, qiov
->niov
);
409 /* Bounce buffer so we have a linear mem region for
410 * entire sector. XXX optimize so we avoid bounce
411 * buffer in case that qiov->niov == 1
414 qemu_try_blockalign(bs
->file
->bs
, MIN(BLOCK_CRYPTO_MAX_SECTORS
* 512,
416 if (cipher_data
== NULL
) {
421 while (remaining_sectors
) {
422 cur_nr_sectors
= remaining_sectors
;
424 if (cur_nr_sectors
> BLOCK_CRYPTO_MAX_SECTORS
) {
425 cur_nr_sectors
= BLOCK_CRYPTO_MAX_SECTORS
;
428 qemu_iovec_reset(&hd_qiov
);
429 qemu_iovec_add(&hd_qiov
, cipher_data
, cur_nr_sectors
* 512);
431 ret
= bdrv_co_readv(bs
->file
->bs
,
432 payload_offset
+ sector_num
,
433 cur_nr_sectors
, &hd_qiov
);
438 if (qcrypto_block_decrypt(crypto
->block
,
440 cipher_data
, cur_nr_sectors
* 512,
446 qemu_iovec_from_buf(qiov
, bytes_done
,
447 cipher_data
, cur_nr_sectors
* 512);
449 remaining_sectors
-= cur_nr_sectors
;
450 sector_num
+= cur_nr_sectors
;
451 bytes_done
+= cur_nr_sectors
* 512;
455 qemu_iovec_destroy(&hd_qiov
);
456 qemu_vfree(cipher_data
);
462 static coroutine_fn
int
463 block_crypto_co_writev(BlockDriverState
*bs
, int64_t sector_num
,
464 int remaining_sectors
, QEMUIOVector
*qiov
)
466 BlockCrypto
*crypto
= bs
->opaque
;
467 int cur_nr_sectors
; /* number of sectors in current iteration */
468 uint64_t bytes_done
= 0;
469 uint8_t *cipher_data
= NULL
;
470 QEMUIOVector hd_qiov
;
472 size_t payload_offset
=
473 qcrypto_block_get_payload_offset(crypto
->block
) / 512;
475 qemu_iovec_init(&hd_qiov
, qiov
->niov
);
477 /* Bounce buffer so we have a linear mem region for
478 * entire sector. XXX optimize so we avoid bounce
479 * buffer in case that qiov->niov == 1
482 qemu_try_blockalign(bs
->file
->bs
, MIN(BLOCK_CRYPTO_MAX_SECTORS
* 512,
484 if (cipher_data
== NULL
) {
489 while (remaining_sectors
) {
490 cur_nr_sectors
= remaining_sectors
;
492 if (cur_nr_sectors
> BLOCK_CRYPTO_MAX_SECTORS
) {
493 cur_nr_sectors
= BLOCK_CRYPTO_MAX_SECTORS
;
496 qemu_iovec_to_buf(qiov
, bytes_done
,
497 cipher_data
, cur_nr_sectors
* 512);
499 if (qcrypto_block_encrypt(crypto
->block
,
501 cipher_data
, cur_nr_sectors
* 512,
507 qemu_iovec_reset(&hd_qiov
);
508 qemu_iovec_add(&hd_qiov
, cipher_data
, cur_nr_sectors
* 512);
510 ret
= bdrv_co_writev(bs
->file
->bs
,
511 payload_offset
+ sector_num
,
512 cur_nr_sectors
, &hd_qiov
);
517 remaining_sectors
-= cur_nr_sectors
;
518 sector_num
+= cur_nr_sectors
;
519 bytes_done
+= cur_nr_sectors
* 512;
523 qemu_iovec_destroy(&hd_qiov
);
524 qemu_vfree(cipher_data
);
530 static int64_t block_crypto_getlength(BlockDriverState
*bs
)
532 BlockCrypto
*crypto
= bs
->opaque
;
533 int64_t len
= bdrv_getlength(bs
->file
->bs
);
535 ssize_t offset
= qcrypto_block_get_payload_offset(crypto
->block
);
543 static int block_crypto_probe_luks(const uint8_t *buf
,
545 const char *filename
) {
546 return block_crypto_probe_generic(Q_CRYPTO_BLOCK_FORMAT_LUKS
,
547 buf
, buf_size
, filename
);
550 static int block_crypto_open_luks(BlockDriverState
*bs
,
555 return block_crypto_open_generic(Q_CRYPTO_BLOCK_FORMAT_LUKS
,
556 &block_crypto_runtime_opts_luks
,
557 bs
, options
, flags
, errp
);
560 static int block_crypto_create_luks(const char *filename
,
564 return block_crypto_create_generic(Q_CRYPTO_BLOCK_FORMAT_LUKS
,
565 filename
, opts
, errp
);
568 BlockDriver bdrv_crypto_luks
= {
569 .format_name
= "luks",
570 .instance_size
= sizeof(BlockCrypto
),
571 .bdrv_probe
= block_crypto_probe_luks
,
572 .bdrv_open
= block_crypto_open_luks
,
573 .bdrv_close
= block_crypto_close
,
574 .bdrv_create
= block_crypto_create_luks
,
575 .bdrv_truncate
= block_crypto_truncate
,
576 .create_opts
= &block_crypto_create_opts_luks
,
578 .bdrv_co_readv
= block_crypto_co_readv
,
579 .bdrv_co_writev
= block_crypto_co_writev
,
580 .bdrv_getlength
= block_crypto_getlength
,
583 static void block_crypto_init(void)
585 bdrv_register(&bdrv_crypto_luks
);
588 block_init(block_crypto_init
);