1 From 19761ee4aa12da9a3e4028cc611a18d972559de0 Mon Sep 17 00:00:00 2001
2 From: Wolfgang Bumiller <w.bumiller@proxmox.com>
3 Date: Mon, 7 Aug 2017 08:51:16 +0200
4 Subject: [PATCH 28/28] adding old vma files
9 block/backup.c | 132 ++++---
10 block/replication.c | 1 +
11 blockdev.c | 250 +++++++++-----
13 include/block/block_int.h | 4 +
14 vma-reader.c | 857 ++++++++++++++++++++++++++++++++++++++++++++++
15 vma-writer.c | 771 +++++++++++++++++++++++++++++++++++++++++
16 vma.c | 757 ++++++++++++++++++++++++++++++++++++++++
18 11 files changed, 2802 insertions(+), 134 deletions(-)
19 create mode 100644 vma-reader.c
20 create mode 100644 vma-writer.c
21 create mode 100644 vma.c
22 create mode 100644 vma.h
24 diff --git a/Makefile b/Makefile
25 index 6c359b2f86..edbc8b50f0 100644
28 @@ -284,7 +284,7 @@ ifneq ($(wildcard config-host.mak),)
29 include $(SRC_PATH)/tests/Makefile.include
32 -all: $(DOCS) $(TOOLS) $(HELPERS-y) recurse-all modules
33 +all: $(DOCS) $(TOOLS) vma$(EXESUF) $(HELPERS-y) recurse-all modules
36 $(call quiet-command, \
37 @@ -377,6 +377,7 @@ qemu-img.o: qemu-img-cmds.h
38 qemu-img$(EXESUF): qemu-img.o $(block-obj-y) $(crypto-obj-y) $(io-obj-y) $(qom-obj-y) $(COMMON_LDADDS)
39 qemu-nbd$(EXESUF): qemu-nbd.o $(block-obj-y) $(crypto-obj-y) $(io-obj-y) $(qom-obj-y) $(COMMON_LDADDS)
40 qemu-io$(EXESUF): qemu-io.o $(block-obj-y) $(crypto-obj-y) $(io-obj-y) $(qom-obj-y) $(COMMON_LDADDS)
41 +vma$(EXESUF): vma.o vma-reader.o $(block-obj-y) $(crypto-obj-y) $(io-obj-y) $(qom-obj-y) $(COMMON_LDADDS)
43 qemu-bridge-helper$(EXESUF): qemu-bridge-helper.o $(COMMON_LDADDS)
45 diff --git a/Makefile.objs b/Makefile.objs
46 index fbfbbb7f70..f5f8dbab3b 100644
49 @@ -14,6 +14,7 @@ block-obj-y += block.o blockjob.o
51 block-obj-y += qemu-io-cmds.o
52 block-obj-$(CONFIG_REPLICATION) += replication.o
53 +block-obj-y += vma-writer.o
57 diff --git a/block/backup.c b/block/backup.c
58 index 1ede70c061..7c5febc434 100644
61 @@ -36,6 +36,7 @@ typedef struct BackupBlockJob {
62 BdrvDirtyBitmap *sync_bitmap;
63 MirrorSyncMode sync_mode;
65 + BackupDumpFunc *dump_cb;
66 BlockdevOnError on_source_error;
67 BlockdevOnError on_target_error;
68 CoRwlock flush_rwlock;
69 @@ -145,13 +146,24 @@ static int coroutine_fn backup_do_cow(BackupBlockJob *job,
73 + int64_t start_sec = start * sectors_per_cluster;
74 if (buffer_is_zero(iov.iov_base, iov.iov_len)) {
75 - ret = blk_co_pwrite_zeroes(job->target, start * job->cluster_size,
76 - bounce_qiov.size, BDRV_REQ_MAY_UNMAP);
78 + ret = job->dump_cb(job->common.opaque, job->target, start_sec, n, NULL);
81 + ret = blk_co_pwrite_zeroes(job->target, start * job->cluster_size,
82 + bounce_qiov.size, BDRV_REQ_MAY_UNMAP);
85 - ret = blk_co_pwritev(job->target, start * job->cluster_size,
86 - bounce_qiov.size, &bounce_qiov,
87 - job->compress ? BDRV_REQ_WRITE_COMPRESSED : 0);
89 + ret = job->dump_cb(job->common.opaque, job->target, start_sec, n, bounce_buffer);
92 + ret = blk_co_pwritev(job->target, start * job->cluster_size,
93 + bounce_qiov.size, &bounce_qiov,
94 + job->compress ? BDRV_REQ_WRITE_COMPRESSED : 0);
98 trace_backup_do_cow_write_fail(job, start, ret);
99 @@ -246,6 +258,9 @@ static void backup_abort(BlockJob *job)
100 static void backup_clean(BlockJob *job)
102 BackupBlockJob *s = container_of(job, BackupBlockJob, common);
107 blk_unref(s->target);
109 @@ -255,7 +270,9 @@ static void backup_attached_aio_context(BlockJob *job, AioContext *aio_context)
111 BackupBlockJob *s = container_of(job, BackupBlockJob, common);
113 - blk_set_aio_context(s->target, aio_context);
115 + blk_set_aio_context(s->target, aio_context);
119 void backup_do_checkpoint(BlockJob *job, Error **errp)
120 @@ -330,9 +347,11 @@ static BlockErrorAction backup_error_action(BackupBlockJob *job,
122 return block_job_error_action(&job->common, job->on_source_error,
125 + } else if (job->target) {
126 return block_job_error_action(&job->common, job->on_target_error,
129 + return BLOCK_ERROR_ACTION_REPORT;
133 @@ -557,6 +576,7 @@ BlockJob *backup_job_create(const char *job_id, BlockDriverState *bs,
134 BlockdevOnError on_source_error,
135 BlockdevOnError on_target_error,
137 + BackupDumpFunc *dump_cb,
138 BlockCompletionFunc *cb, void *opaque,
140 BlockJobTxn *txn, Error **errp)
141 @@ -567,7 +587,7 @@ BlockJob *backup_job_create(const char *job_id, BlockDriverState *bs,
146 + assert(target || dump_cb);
149 error_setg(errp, "Source and target cannot be the same");
150 @@ -580,13 +600,13 @@ BlockJob *backup_job_create(const char *job_id, BlockDriverState *bs,
154 - if (!bdrv_is_inserted(target)) {
155 + if (target && !bdrv_is_inserted(target)) {
156 error_setg(errp, "Device is not inserted: %s",
157 bdrv_get_device_name(target));
161 - if (compress && target->drv->bdrv_co_pwritev_compressed == NULL) {
162 + if (target && compress && target->drv->bdrv_co_pwritev_compressed == NULL) {
163 error_setg(errp, "Compression is not supported for this drive %s",
164 bdrv_get_device_name(target));
166 @@ -596,7 +616,7 @@ BlockJob *backup_job_create(const char *job_id, BlockDriverState *bs,
170 - if (bdrv_op_is_blocked(target, BLOCK_OP_TYPE_BACKUP_TARGET, errp)) {
171 + if (target && bdrv_op_is_blocked(target, BLOCK_OP_TYPE_BACKUP_TARGET, errp)) {
175 @@ -636,15 +656,18 @@ BlockJob *backup_job_create(const char *job_id, BlockDriverState *bs,
179 - /* The target must match the source in size, so no resize here either */
180 - job->target = blk_new(BLK_PERM_WRITE,
181 - BLK_PERM_CONSISTENT_READ | BLK_PERM_WRITE |
182 - BLK_PERM_WRITE_UNCHANGED | BLK_PERM_GRAPH_MOD);
183 - ret = blk_insert_bs(job->target, target, errp);
187 + /* The target must match the source in size, so no resize here either */
188 + job->target = blk_new(BLK_PERM_WRITE,
189 + BLK_PERM_CONSISTENT_READ | BLK_PERM_WRITE |
190 + BLK_PERM_WRITE_UNCHANGED | BLK_PERM_GRAPH_MOD);
191 + ret = blk_insert_bs(job->target, target, errp);
197 + job->dump_cb = dump_cb;
198 job->on_source_error = on_source_error;
199 job->on_target_error = on_target_error;
200 job->sync_mode = sync_mode;
201 @@ -652,38 +675,55 @@ BlockJob *backup_job_create(const char *job_id, BlockDriverState *bs,
203 job->compress = compress;
205 - /* If there is no backing file on the target, we cannot rely on COW if our
206 - * backup cluster size is smaller than the target cluster size. Even for
207 - * targets with a backing file, try to avoid COW if possible. */
208 - ret = bdrv_get_info(target, &bdi);
209 - if (ret == -ENOTSUP && !target->backing) {
210 - /* Cluster size is not defined */
211 - error_report("WARNING: The target block device doesn't provide "
212 - "information about the block size and it doesn't have a "
213 - "backing file. The default block size of %u bytes is "
214 - "used. If the actual block size of the target exceeds "
215 - "this default, the backup may be unusable",
216 - BACKUP_CLUSTER_SIZE_DEFAULT);
217 - job->cluster_size = BACKUP_CLUSTER_SIZE_DEFAULT;
218 - } else if (ret < 0 && !target->backing) {
219 - error_setg_errno(errp, -ret,
220 - "Couldn't determine the cluster size of the target image, "
221 - "which has no backing file");
222 - error_append_hint(errp,
223 - "Aborting, since this may create an unusable destination image\n");
225 - } else if (ret < 0 && target->backing) {
226 - /* Not fatal; just trudge on ahead. */
227 - job->cluster_size = BACKUP_CLUSTER_SIZE_DEFAULT;
229 + /* If there is no backing file on the target, we cannot rely on COW if our
230 + * backup cluster size is smaller than the target cluster size. Even for
231 + * targets with a backing file, try to avoid COW if possible. */
232 + ret = bdrv_get_info(target, &bdi);
233 + if (ret == -ENOTSUP && !target->backing) {
234 + /* Cluster size is not defined */
235 + error_report("WARNING: The target block device doesn't provide "
236 + "information about the block size and it doesn't have a "
237 + "backing file. The default block size of %u bytes is "
238 + "used. If the actual block size of the target exceeds "
239 + "this default, the backup may be unusable",
240 + BACKUP_CLUSTER_SIZE_DEFAULT);
241 + job->cluster_size = BACKUP_CLUSTER_SIZE_DEFAULT;
242 + } else if (ret < 0 && !target->backing) {
243 + error_setg_errno(errp, -ret,
244 + "Couldn't determine the cluster size of the target image, "
245 + "which has no backing file");
246 + error_append_hint(errp,
247 + "Aborting, since this may create an unusable destination image\n");
249 + } else if (ret < 0 && target->backing) {
250 + /* Not fatal; just trudge on ahead. */
251 + job->cluster_size = BACKUP_CLUSTER_SIZE_DEFAULT;
253 + job->cluster_size = MAX(BACKUP_CLUSTER_SIZE_DEFAULT, bdi.cluster_size);
256 - job->cluster_size = MAX(BACKUP_CLUSTER_SIZE_DEFAULT, bdi.cluster_size);
257 + ret = bdrv_get_info(bs, &bdi);
259 + job->cluster_size = BACKUP_CLUSTER_SIZE_DEFAULT;
261 + /* round down to nearest BACKUP_CLUSTER_SIZE_DEFAULT */
262 + job->cluster_size = (bdi.cluster_size / BACKUP_CLUSTER_SIZE_DEFAULT) * BACKUP_CLUSTER_SIZE_DEFAULT;
263 + if (job->cluster_size == 0) {
264 + /* but we can't go below it */
265 + job->cluster_size = BACKUP_CLUSTER_SIZE_DEFAULT;
270 - /* Required permissions are already taken with target's blk_new() */
271 - block_job_add_bdrv(&job->common, "target", target, 0, BLK_PERM_ALL,
274 + /* Required permissions are already taken with target's blk_new() */
275 + block_job_add_bdrv(&job->common, "target", target, 0, BLK_PERM_ALL,
278 + job->common.pause_count = pause_count;
280 job->common.len = len;
281 - job->common.pause_count = pause_count;
282 block_job_txn_add_job(txn, &job->common);
285 diff --git a/block/replication.c b/block/replication.c
286 index 1c41d9e6bf..60c6524417 100644
287 --- a/block/replication.c
288 +++ b/block/replication.c
289 @@ -531,6 +531,7 @@ static void replication_start(ReplicationState *rs, ReplicationMode mode,
290 0, MIRROR_SYNC_MODE_NONE, NULL, false,
291 BLOCKDEV_ON_ERROR_REPORT,
292 BLOCKDEV_ON_ERROR_REPORT, BLOCK_JOB_INTERNAL,
294 backup_job_completed, bs, 0, NULL, &local_err);
296 error_propagate(errp, local_err);
297 diff --git a/blockdev.c b/blockdev.c
298 index 981276692a..76a7103743 100644
304 #include "qemu/osdep.h"
305 -#include "qemu/uuid.h"
306 #include "sysemu/block-backend.h"
307 #include "sysemu/blockdev.h"
308 #include "hw/block/block.h"
310 #include "qemu/cutils.h"
311 #include "qemu/help_option.h"
312 #include "qemu/throttle-options.h"
315 static QTAILQ_HEAD(, BlockDriverState) monitor_bdrv_states =
316 QTAILQ_HEAD_INITIALIZER(monitor_bdrv_states);
317 @@ -2958,20 +2958,44 @@ out:
318 aio_context_release(aio_context);
321 +void block_job_event_cancelled(BlockJob *job);
322 +void block_job_event_completed(BlockJob *job, const char *msg);
323 +static void block_job_cb(void *opaque, int ret)
325 + /* Note that this function may be executed from another AioContext besides
326 + * the QEMU main loop. If you need to access anything that assumes the
327 + * QEMU global mutex, use a BH or introduce a mutex.
330 + BlockDriverState *bs = opaque;
331 + const char *msg = NULL;
336 + msg = strerror(-ret);
339 + if (block_job_is_cancelled(bs->job)) {
340 + block_job_event_cancelled(bs->job);
342 + block_job_event_completed(bs->job, msg);
346 /* PVE backup related function */
348 static struct PVEBackupState {
365 @@ -2981,6 +3005,7 @@ typedef struct PVEBackupDevInfo {
366 BlockDriverState *bs;
371 char targetfile[PATH_MAX];
372 BlockDriverState *target;
373 @@ -2988,13 +3013,79 @@ typedef struct PVEBackupDevInfo {
375 static void pvebackup_run_next_job(void);
377 +static int pvebackup_dump_cb(void *opaque, BlockBackend *target,
378 + int64_t sector_num, int n_sectors,
379 + unsigned char *buf)
381 + PVEBackupDevInfo *di = opaque;
383 + int size = n_sectors * BDRV_SECTOR_SIZE;
384 + if (backup_state.cancel) {
385 + return size; // return success
388 + if (sector_num & 0x7f) {
389 + if (!backup_state.error) {
390 + error_setg(&backup_state.error,
391 + "got unaligned write inside backup dump "
392 + "callback (sector %ld)", sector_num);
394 + return -1; // not aligned to cluster size
397 + int64_t cluster_num = sector_num >> 7;
401 + if (backup_state.vmaw) {
402 + size_t zero_bytes = 0;
403 + int64_t remaining = n_sectors * BDRV_SECTOR_SIZE;
404 + while (remaining > 0) {
405 + ret = vma_writer_write(backup_state.vmaw, di->dev_id, cluster_num,
409 + buf += VMA_CLUSTER_SIZE;
412 + if (!backup_state.error) {
413 + vma_writer_error_propagate(backup_state.vmaw, &backup_state.error);
415 + if (di->bs && di->bs->job) {
416 + block_job_cancel(di->bs->job);
420 + backup_state.zero_bytes += zero_bytes;
421 + if (remaining >= VMA_CLUSTER_SIZE) {
422 + backup_state.transferred += VMA_CLUSTER_SIZE;
424 + backup_state.transferred += remaining;
426 + remaining -= VMA_CLUSTER_SIZE;
431 + backup_state.zero_bytes += size;
433 + backup_state.transferred += size;
436 + // Note: always return success, because we want that writes succeed anyways.
441 static void pvebackup_cleanup(void)
443 backup_state.end_time = time(NULL);
445 - if (backup_state.vmaobj) {
446 - object_unparent(backup_state.vmaobj);
447 - backup_state.vmaobj = NULL;
448 + if (backup_state.vmaw) {
449 + Error *local_err = NULL;
450 + vma_writer_close(backup_state.vmaw, &local_err);
451 + error_propagate(&backup_state.error, local_err);
452 + backup_state.vmaw = NULL;
455 if (backup_state.di_list) {
456 @@ -3009,6 +3100,13 @@ static void pvebackup_cleanup(void)
460 +static void coroutine_fn backup_close_vma_stream(void *opaque)
462 + PVEBackupDevInfo *di = opaque;
464 + vma_writer_close_stream(backup_state.vmaw, di->dev_id);
467 static void pvebackup_complete_cb(void *opaque, int ret)
469 PVEBackupDevInfo *di = opaque;
470 @@ -3020,14 +3118,18 @@ static void pvebackup_complete_cb(void *opaque, int ret)
471 ret, strerror(-ret));
474 + BlockDriverState *bs = di->bs;
479 - if (backup_state.vmaobj) {
480 - object_unparent(backup_state.vmaobj);
481 - backup_state.vmaobj = NULL;
482 + if (backup_state.vmaw) {
483 + Coroutine *co = qemu_coroutine_create(backup_close_vma_stream, di);
484 + qemu_coroutine_enter(co);
487 + block_job_cb(bs, ret);
489 if (!backup_state.cancel) {
490 pvebackup_run_next_job();
492 @@ -3041,14 +3143,9 @@ static void pvebackup_cancel(void *opaque)
493 error_setg(&backup_state.error, "backup cancelled");
496 - if (backup_state.vmaobj) {
498 + if (backup_state.vmaw) {
499 /* make sure vma writer does not block anymore */
500 - if (!object_set_props(backup_state.vmaobj, &err, "blocked", "yes", NULL)) {
502 - error_report_err(err);
505 + vma_writer_set_error(backup_state.vmaw, "backup cancelled");
508 GList *l = backup_state.di_list;
509 @@ -3073,19 +3170,15 @@ void qmp_backup_cancel(Error **errp)
510 Coroutine *co = qemu_coroutine_create(pvebackup_cancel, NULL);
511 qemu_coroutine_enter(co);
513 - while (backup_state.vmaobj) {
514 - /* FIXME: Find something better for this */
515 + while (backup_state.vmaw) {
516 + /* vma writer use main aio context */
517 aio_poll(qemu_get_aio_context(), true);
521 -void vma_object_add_config_file(Object *obj, const char *name,
522 - const char *contents, size_t len,
524 static int config_to_vma(const char *file, BackupFormat format,
526 - const char *backup_dir,
528 + const char *backup_dir, VmaWriter *vmaw,
533 @@ -3098,12 +3191,17 @@ static int config_to_vma(const char *file, BackupFormat format,
534 char *basename = g_path_get_basename(file);
536 if (format == BACKUP_FORMAT_VMA) {
537 - vma_object_add_config_file(vmaobj, basename, cdata, clen, errp);
538 + if (vma_writer_add_config(vmaw, basename, cdata, clen) != 0) {
539 + error_setg(errp, "unable to add %s config data to vma archive", file);
544 } else if (format == BACKUP_FORMAT_DIR) {
545 char config_path[PATH_MAX];
546 snprintf(config_path, PATH_MAX, "%s/%s", backup_dir, basename);
547 if (!g_file_set_contents(config_path, cdata, clen, &err)) {
548 - error_setg(errp, "unable to write config file '%s'", config_path);
549 + error_setg(errp, "unable to write config file '%s'", config_path);
553 @@ -3113,35 +3211,37 @@ static int config_to_vma(const char *file, BackupFormat format,
561 +bool block_job_should_pause(BlockJob *job);
562 static void pvebackup_run_next_job(void)
564 - bool cancel = backup_state.error || backup_state.cancel;
565 -fprintf(stderr, "run next job: %zu\n", backup_state.next_job);
566 - GList *next = g_list_nth(backup_state.di_list, backup_state.next_job);
568 - PVEBackupDevInfo *di = (PVEBackupDevInfo *)next->data;
569 - backup_state.next_job++;
570 + GList *l = backup_state.di_list;
572 + PVEBackupDevInfo *di = (PVEBackupDevInfo *)l->data;
573 + l = g_list_next(l);
574 if (!di->completed && di->bs && di->bs->job) {
575 BlockJob *job = di->bs->job;
577 - block_job_cancel(job);
579 - block_job_resume(job);
580 + if (block_job_should_pause(job)) {
581 + bool cancel = backup_state.error || backup_state.cancel;
583 + block_job_cancel(job);
585 + block_job_resume(job);
590 - next = g_list_next(next);
596 UuidInfo *qmp_backup(const char *backup_file, bool has_format,
598 bool has_config_file, const char *config_file,
599 - bool has_firewall_file, const char *firewall_file,
600 + bool has_firewall_file, const char *firewall_file,
601 bool has_devlist, const char *devlist,
602 bool has_speed, int64_t speed, Error **errp)
604 @@ -3149,14 +3249,15 @@ UuidInfo *qmp_backup(const char *backup_file, bool has_format,
605 BlockDriverState *bs = NULL;
606 const char *backup_dir = NULL;
607 Error *local_err = NULL;
610 + VmaWriter *vmaw = NULL;
612 GList *di_list = NULL;
617 - if (backup_state.di_list || backup_state.vmaobj) {
618 + if (backup_state.di_list) {
619 error_set(errp, ERROR_CLASS_GENERIC_ERROR,
620 "previous backup not finished");
622 @@ -3231,40 +3332,28 @@ UuidInfo *qmp_backup(const char *backup_file, bool has_format,
626 - qemu_uuid_generate(&uuid);
627 + uuid_generate(uuid);
629 if (format == BACKUP_FORMAT_VMA) {
630 - char uuidstr[UUID_FMT_LEN+1];
631 - qemu_uuid_unparse(&uuid, uuidstr);
632 - uuidstr[UUID_FMT_LEN] = 0;
633 - backup_state.vmaobj =
634 - object_new_with_props("vma", object_get_objects_root(),
635 - "vma-backup-obj", &local_err,
636 - "filename", backup_file,
639 - if (!backup_state.vmaobj) {
640 + vmaw = vma_writer_create(backup_file, uuid, &local_err);
643 error_propagate(errp, local_err);
648 + /* register all devices for vma writer */
651 - QDict *options = qdict_new();
653 PVEBackupDevInfo *di = (PVEBackupDevInfo *)l->data;
656 const char *devname = bdrv_get_device_name(di->bs);
657 - snprintf(di->targetfile, PATH_MAX, "vma-backup-obj/%s.raw", devname);
659 - qdict_put(options, "driver", qstring_from_str("vma-drive"));
660 - qdict_put(options, "size", qint_from_int(di->size));
661 - di->target = bdrv_open(di->targetfile, NULL, options, BDRV_O_RDWR, &local_err);
663 - error_propagate(errp, local_err);
664 + di->dev_id = vma_writer_register_stream(vmaw, devname, di->size);
665 + if (di->dev_id <= 0) {
666 + error_set(errp, ERROR_CLASS_GENERIC_ERROR,
667 + "register_stream failed");
671 @@ -3305,15 +3394,15 @@ UuidInfo *qmp_backup(const char *backup_file, bool has_format,
673 /* add configuration file to archive */
674 if (has_config_file) {
675 - if(config_to_vma(config_file, format, backup_state.vmaobj, backup_dir, errp) != 0) {
677 + if(config_to_vma(config_file, format, backup_dir, vmaw, errp) != 0) {
682 /* add firewall file to archive */
683 if (has_firewall_file) {
684 - if(config_to_vma(firewall_file, format, backup_state.vmaobj, backup_dir, errp) != 0) {
686 + if(config_to_vma(firewall_file, format, backup_dir, vmaw, errp) != 0) {
690 /* initialize global backup_state now */
691 @@ -3335,11 +3424,12 @@ UuidInfo *qmp_backup(const char *backup_file, bool has_format,
693 backup_state.backup_file = g_strdup(backup_file);
695 - memcpy(&backup_state.uuid, &uuid, sizeof(uuid));
696 - qemu_uuid_unparse(&uuid, backup_state.uuid_str);
697 + backup_state.vmaw = vmaw;
699 + uuid_copy(backup_state.uuid, uuid);
700 + uuid_unparse_lower(uuid, backup_state.uuid_str);
702 backup_state.di_list = di_list;
703 - backup_state.next_job = 0;
705 backup_state.total = total;
706 backup_state.transferred = 0;
707 @@ -3350,21 +3440,16 @@ UuidInfo *qmp_backup(const char *backup_file, bool has_format,
709 PVEBackupDevInfo *di = (PVEBackupDevInfo *)l->data;
712 job = backup_job_create(NULL, di->bs, di->target, speed, MIRROR_SYNC_MODE_FULL, NULL,
713 false, BLOCKDEV_ON_ERROR_REPORT, BLOCKDEV_ON_ERROR_REPORT,
715 - pvebackup_complete_cb, di, 2, NULL, &local_err);
717 - bdrv_unref(di->target);
720 + pvebackup_dump_cb, pvebackup_complete_cb, di,
721 + 2, NULL, &local_err);
722 if (!job || local_err != NULL) {
723 error_setg(&backup_state.error, "backup_job_create failed");
724 pvebackup_cancel(NULL);
726 - block_job_start(job);
728 + block_job_start(job);
731 if (!backup_state.error) {
732 @@ -3398,9 +3483,10 @@ err:
736 - if (backup_state.vmaobj) {
737 - object_unparent(backup_state.vmaobj);
738 - backup_state.vmaobj = NULL;
741 + vma_writer_close(vmaw, &err);
742 + unlink(backup_file);
746 @@ -3772,7 +3858,7 @@ static BlockJob *do_drive_backup(DriveBackup *backup, BlockJobTxn *txn,
747 job = backup_job_create(backup->job_id, bs, target_bs, backup->speed,
748 backup->sync, bmap, backup->compress,
749 backup->on_source_error, backup->on_target_error,
750 - BLOCK_JOB_DEFAULT, NULL, NULL, 0, txn, &local_err);
751 + BLOCK_JOB_DEFAULT, NULL, NULL, NULL, 0, txn, &local_err);
752 bdrv_unref(target_bs);
753 if (local_err != NULL) {
754 error_propagate(errp, local_err);
755 @@ -3851,7 +3937,7 @@ BlockJob *do_blockdev_backup(BlockdevBackup *backup, BlockJobTxn *txn,
756 job = backup_job_create(backup->job_id, bs, target_bs, backup->speed,
757 backup->sync, NULL, backup->compress,
758 backup->on_source_error, backup->on_target_error,
759 - BLOCK_JOB_DEFAULT, NULL, NULL, 0, txn, &local_err);
760 + BLOCK_JOB_DEFAULT, NULL, NULL, NULL, 0, txn, &local_err);
761 if (local_err != NULL) {
762 error_propagate(errp, local_err);
764 diff --git a/blockjob.c b/blockjob.c
765 index 764d41863e..cb3741f6dd 100644
769 #include "qemu/timer.h"
770 #include "qapi-event.h"
772 -static void block_job_event_cancelled(BlockJob *job);
773 -static void block_job_event_completed(BlockJob *job, const char *msg);
774 +void block_job_event_cancelled(BlockJob *job);
775 +void block_job_event_completed(BlockJob *job, const char *msg);
777 /* Transactional group of block jobs */
779 @@ -473,7 +473,8 @@ void block_job_user_pause(BlockJob *job)
780 block_job_pause(job);
783 -static bool block_job_should_pause(BlockJob *job)
784 +bool block_job_should_pause(BlockJob *job);
785 +bool block_job_should_pause(BlockJob *job)
787 return job->pause_count > 0;
789 @@ -687,7 +688,7 @@ static void block_job_iostatus_set_err(BlockJob *job, int error)
793 -static void block_job_event_cancelled(BlockJob *job)
794 +void block_job_event_cancelled(BlockJob *job)
796 if (block_job_is_internal(job)) {
798 @@ -701,7 +702,7 @@ static void block_job_event_cancelled(BlockJob *job)
802 -static void block_job_event_completed(BlockJob *job, const char *msg)
803 +void block_job_event_completed(BlockJob *job, const char *msg)
805 if (block_job_is_internal(job)) {
807 diff --git a/include/block/block_int.h b/include/block/block_int.h
808 index 2b3ecd0575..278da161fb 100644
809 --- a/include/block/block_int.h
810 +++ b/include/block/block_int.h
813 #define BLOCK_PROBE_BUF_SIZE 512
815 +typedef int BackupDumpFunc(void *opaque, BlockBackend *be,
816 + int64_t sector_num, int n_sectors, unsigned char *buf);
818 enum BdrvTrackedRequestType {
821 @@ -877,6 +880,7 @@ BlockJob *backup_job_create(const char *job_id, BlockDriverState *bs,
822 BlockdevOnError on_source_error,
823 BlockdevOnError on_target_error,
825 + BackupDumpFunc *dump_cb,
826 BlockCompletionFunc *cb, void *opaque,
828 BlockJobTxn *txn, Error **errp);
829 diff --git a/vma-reader.c b/vma-reader.c
831 index 0000000000..2000889bd3
836 + * VMA: Virtual Machine Archive
838 + * Copyright (C) 2012 Proxmox Server Solutions
841 + * Dietmar Maurer (dietmar@proxmox.com)
843 + * This work is licensed under the terms of the GNU GPL, version 2 or later.
844 + * See the COPYING file in the top-level directory.
848 +#include "qemu/osdep.h"
850 +#include <uuid/uuid.h>
852 +#include "qemu-common.h"
853 +#include "qemu/timer.h"
854 +#include "qemu/ratelimit.h"
856 +#include "block/block.h"
857 +#include "sysemu/block-backend.h"
859 +static unsigned char zero_vma_block[VMA_BLOCK_SIZE];
861 +typedef struct VmaRestoreState {
862 + BlockBackend *target;
864 + unsigned long *bitmap;
870 + GChecksum *md5csum;
871 + GHashTable *blob_hash;
872 + unsigned char *head_data;
873 + VmaDeviceInfo devinfo[256];
874 + VmaRestoreState rstate[256];
876 + guint8 vmstate_stream;
877 + uint32_t vmstate_clusters;
878 + /* to show restore percentage if run with -v */
880 + int64_t cluster_count;
881 + int64_t clusters_read;
882 + int64_t zero_cluster_data;
883 + int64_t partial_zero_cluster_data;
884 + int clusters_read_per;
888 +g_int32_hash(gconstpointer v)
890 + return *(const uint32_t *)v;
894 +g_int32_equal(gconstpointer v1, gconstpointer v2)
896 + return *((const uint32_t *)v1) == *((const uint32_t *)v2);
899 +static int vma_reader_get_bitmap(VmaRestoreState *rstate, int64_t cluster_num)
902 + assert(rstate->bitmap);
904 + unsigned long val, idx, bit;
906 + idx = cluster_num / BITS_PER_LONG;
908 + assert(rstate->bitmap_size > idx);
910 + bit = cluster_num % BITS_PER_LONG;
911 + val = rstate->bitmap[idx];
913 + return !!(val & (1UL << bit));
916 +static void vma_reader_set_bitmap(VmaRestoreState *rstate, int64_t cluster_num,
920 + assert(rstate->bitmap);
922 + unsigned long val, idx, bit;
924 + idx = cluster_num / BITS_PER_LONG;
926 + assert(rstate->bitmap_size > idx);
928 + bit = cluster_num % BITS_PER_LONG;
929 + val = rstate->bitmap[idx];
931 + if (!(val & (1UL << bit))) {
935 + if (val & (1UL << bit)) {
936 + val &= ~(1UL << bit);
939 + rstate->bitmap[idx] = val;
942 +typedef struct VmaBlob {
948 +static const VmaBlob *get_header_blob(VmaReader *vmar, uint32_t pos)
951 + assert(vmar->blob_hash);
953 + return g_hash_table_lookup(vmar->blob_hash, &pos);
956 +static const char *get_header_str(VmaReader *vmar, uint32_t pos)
958 + const VmaBlob *blob = get_header_blob(vmar, pos);
962 + const char *res = (char *)blob->data;
963 + if (res[blob->len-1] != '\0') {
970 +safe_read(int fd, unsigned char *buf, size_t count)
975 + n = read(fd, buf, count);
976 + } while (n < 0 && errno == EINTR);
982 +full_read(int fd, unsigned char *buf, size_t len)
990 + n = safe_read(fd, buf, len);
1012 +void vma_reader_destroy(VmaReader *vmar)
1016 + if (vmar->fd >= 0) {
1020 + if (vmar->cdata_list) {
1021 + g_list_free(vmar->cdata_list);
1025 + for (i = 1; i < 256; i++) {
1026 + if (vmar->rstate[i].bitmap) {
1027 + g_free(vmar->rstate[i].bitmap);
1031 + if (vmar->md5csum) {
1032 + g_checksum_free(vmar->md5csum);
1035 + if (vmar->blob_hash) {
1036 + g_hash_table_destroy(vmar->blob_hash);
1039 + if (vmar->head_data) {
1040 + g_free(vmar->head_data);
1047 +static int vma_reader_read_head(VmaReader *vmar, Error **errp)
1051 + assert(*errp == NULL);
1053 + unsigned char md5sum[16];
1057 + vmar->head_data = g_malloc(sizeof(VmaHeader));
1059 + if (full_read(vmar->fd, vmar->head_data, sizeof(VmaHeader)) !=
1060 + sizeof(VmaHeader)) {
1061 + error_setg(errp, "can't read vma header - %s",
1062 + errno ? g_strerror(errno) : "got EOF");
1066 + VmaHeader *h = (VmaHeader *)vmar->head_data;
1068 + if (h->magic != VMA_MAGIC) {
1069 + error_setg(errp, "not a vma file - wrong magic number");
1073 + uint32_t header_size = GUINT32_FROM_BE(h->header_size);
1074 + int need = header_size - sizeof(VmaHeader);
1076 + error_setg(errp, "wrong vma header size %d", header_size);
1080 + vmar->head_data = g_realloc(vmar->head_data, header_size);
1081 + h = (VmaHeader *)vmar->head_data;
1083 + if (full_read(vmar->fd, vmar->head_data + sizeof(VmaHeader), need) !=
1085 + error_setg(errp, "can't read vma header data - %s",
1086 + errno ? g_strerror(errno) : "got EOF");
1090 + memcpy(md5sum, h->md5sum, 16);
1091 + memset(h->md5sum, 0, 16);
1093 + g_checksum_reset(vmar->md5csum);
1094 + g_checksum_update(vmar->md5csum, vmar->head_data, header_size);
1096 + g_checksum_get_digest(vmar->md5csum, (guint8 *)(h->md5sum), &csize);
1098 + if (memcmp(md5sum, h->md5sum, 16) != 0) {
1099 + error_setg(errp, "wrong vma header chechsum");
1103 + /* we can modify header data after checksum verify */
1104 + h->header_size = header_size;
1106 + h->version = GUINT32_FROM_BE(h->version);
1107 + if (h->version != 1) {
1108 + error_setg(errp, "wrong vma version %d", h->version);
1112 + h->ctime = GUINT64_FROM_BE(h->ctime);
1113 + h->blob_buffer_offset = GUINT32_FROM_BE(h->blob_buffer_offset);
1114 + h->blob_buffer_size = GUINT32_FROM_BE(h->blob_buffer_size);
1116 + uint32_t bstart = h->blob_buffer_offset + 1;
1117 + uint32_t bend = h->blob_buffer_offset + h->blob_buffer_size;
1119 + if (bstart <= sizeof(VmaHeader)) {
1120 + error_setg(errp, "wrong vma blob buffer offset %d",
1121 + h->blob_buffer_offset);
1125 + if (bend > header_size) {
1126 + error_setg(errp, "wrong vma blob buffer size %d/%d",
1127 + h->blob_buffer_offset, h->blob_buffer_size);
1131 + while ((bstart + 2) <= bend) {
1132 + uint32_t size = vmar->head_data[bstart] +
1133 + (vmar->head_data[bstart+1] << 8);
1134 + if ((bstart + size + 2) <= bend) {
1135 + VmaBlob *blob = g_new0(VmaBlob, 1);
1136 + blob->start = bstart - h->blob_buffer_offset;
1138 + blob->data = vmar->head_data + bstart + 2;
1139 + g_hash_table_insert(vmar->blob_hash, &blob->start, blob);
1141 + bstart += size + 2;
1146 + for (i = 1; i < 256; i++) {
1147 + VmaDeviceInfoHeader *dih = &h->dev_info[i];
1148 + uint32_t devname_ptr = GUINT32_FROM_BE(dih->devname_ptr);
1149 + uint64_t size = GUINT64_FROM_BE(dih->size);
1150 + const char *devname = get_header_str(vmar, devname_ptr);
1152 + if (size && devname) {
1154 + vmar->devinfo[i].size = size;
1155 + vmar->devinfo[i].devname = devname;
1157 + if (strcmp(devname, "vmstate") == 0) {
1158 + vmar->vmstate_stream = i;
1163 + for (i = 0; i < VMA_MAX_CONFIGS; i++) {
1164 + uint32_t name_ptr = GUINT32_FROM_BE(h->config_names[i]);
1165 + uint32_t data_ptr = GUINT32_FROM_BE(h->config_data[i]);
1167 + if (!(name_ptr && data_ptr)) {
1170 + const char *name = get_header_str(vmar, name_ptr);
1171 + const VmaBlob *blob = get_header_blob(vmar, data_ptr);
1173 + if (!(name && blob)) {
1174 + error_setg(errp, "vma contains invalid data pointers");
1178 + VmaConfigData *cdata = g_new0(VmaConfigData, 1);
1179 + cdata->name = name;
1180 + cdata->data = blob->data;
1181 + cdata->len = blob->len;
1183 + vmar->cdata_list = g_list_append(vmar->cdata_list, cdata);
1189 +VmaReader *vma_reader_create(const char *filename, Error **errp)
1194 + VmaReader *vmar = g_new0(VmaReader, 1);
1196 + if (strcmp(filename, "-") == 0) {
1197 + vmar->fd = dup(0);
1199 + vmar->fd = open(filename, O_RDONLY);
1202 + if (vmar->fd < 0) {
1203 + error_setg(errp, "can't open file %s - %s\n", filename,
1204 + g_strerror(errno));
1208 + vmar->md5csum = g_checksum_new(G_CHECKSUM_MD5);
1209 + if (!vmar->md5csum) {
1210 + error_setg(errp, "can't allocate cmsum\n");
1214 + vmar->blob_hash = g_hash_table_new_full(g_int32_hash, g_int32_equal,
1217 + if (vma_reader_read_head(vmar, errp) < 0) {
1225 + vma_reader_destroy(vmar);
1231 +VmaHeader *vma_reader_get_header(VmaReader *vmar)
1234 + assert(vmar->head_data);
1236 + return (VmaHeader *)(vmar->head_data);
1239 +GList *vma_reader_get_config_data(VmaReader *vmar)
1242 + assert(vmar->head_data);
1244 + return vmar->cdata_list;
1247 +VmaDeviceInfo *vma_reader_get_device_info(VmaReader *vmar, guint8 dev_id)
1252 + if (vmar->devinfo[dev_id].size && vmar->devinfo[dev_id].devname) {
1253 + return &vmar->devinfo[dev_id];
1259 +static void allocate_rstate(VmaReader *vmar, guint8 dev_id,
1260 + BlockBackend *target, bool write_zeroes)
1265 + vmar->rstate[dev_id].target = target;
1266 + vmar->rstate[dev_id].write_zeroes = write_zeroes;
1268 + int64_t size = vmar->devinfo[dev_id].size;
1270 + int64_t bitmap_size = (size/BDRV_SECTOR_SIZE) +
1271 + (VMA_CLUSTER_SIZE/BDRV_SECTOR_SIZE) * BITS_PER_LONG - 1;
1272 + bitmap_size /= (VMA_CLUSTER_SIZE/BDRV_SECTOR_SIZE) * BITS_PER_LONG;
1274 + vmar->rstate[dev_id].bitmap_size = bitmap_size;
1275 + vmar->rstate[dev_id].bitmap = g_new0(unsigned long, bitmap_size);
1277 + vmar->cluster_count += size/VMA_CLUSTER_SIZE;
1280 +int vma_reader_register_bs(VmaReader *vmar, guint8 dev_id, BlockBackend *target,
1281 + bool write_zeroes, Error **errp)
1284 + assert(target != NULL);
1286 + assert(vmar->rstate[dev_id].target == NULL);
1288 + int64_t size = blk_getlength(target);
1289 + int64_t size_diff = size - vmar->devinfo[dev_id].size;
1291 + /* storage types can have different size restrictions, so it
1292 + * is not always possible to create an image with exact size.
1293 + * So we tolerate a size difference up to 4MB.
1295 + if ((size_diff < 0) || (size_diff > 4*1024*1024)) {
1296 + error_setg(errp, "vma_reader_register_bs for stream %s failed - "
1297 + "unexpected size %zd != %zd", vmar->devinfo[dev_id].devname,
1298 + size, vmar->devinfo[dev_id].size);
1302 + allocate_rstate(vmar, dev_id, target, write_zeroes);
1307 +static ssize_t safe_write(int fd, void *buf, size_t count)
1312 + n = write(fd, buf, count);
1313 + } while (n < 0 && errno == EINTR);
1318 +static size_t full_write(int fd, void *buf, size_t len)
1326 + n = safe_write(fd, buf, len);
1336 + /* incomplete write ? */
1343 +static int restore_write_data(VmaReader *vmar, guint8 dev_id,
1344 + BlockBackend *target, int vmstate_fd,
1345 + unsigned char *buf, int64_t sector_num,
1346 + int nb_sectors, Error **errp)
1350 + if (dev_id == vmar->vmstate_stream) {
1351 + if (vmstate_fd >= 0) {
1352 + int len = nb_sectors * BDRV_SECTOR_SIZE;
1353 + int res = full_write(vmstate_fd, buf, len);
1355 + error_setg(errp, "write vmstate failed %d", res);
1360 + int res = blk_pwrite(target, sector_num * BDRV_SECTOR_SIZE, buf, nb_sectors * BDRV_SECTOR_SIZE, 0);
1362 + error_setg(errp, "blk_pwrite to %s failed (%d)",
1363 + bdrv_get_device_name(blk_bs(target)), res);
1370 +static int restore_extent(VmaReader *vmar, unsigned char *buf,
1371 + int extent_size, int vmstate_fd,
1372 + bool verbose, bool verify, Error **errp)
1377 + VmaExtentHeader *ehead = (VmaExtentHeader *)buf;
1378 + int start = VMA_EXTENT_HEADER_SIZE;
1381 + for (i = 0; i < VMA_BLOCKS_PER_EXTENT; i++) {
1382 + uint64_t block_info = GUINT64_FROM_BE(ehead->blockinfo[i]);
1383 + uint64_t cluster_num = block_info & 0xffffffff;
1384 + uint8_t dev_id = (block_info >> 32) & 0xff;
1385 + uint16_t mask = block_info >> (32+16);
1386 + int64_t max_sector;
1392 + VmaRestoreState *rstate = &vmar->rstate[dev_id];
1393 + BlockBackend *target = NULL;
1395 + if (dev_id != vmar->vmstate_stream) {
1396 + target = rstate->target;
1397 + if (!verify && !target) {
1398 + error_setg(errp, "got wrong dev id %d", dev_id);
1402 + if (vma_reader_get_bitmap(rstate, cluster_num)) {
1403 + error_setg(errp, "found duplicated cluster %zd for stream %s",
1404 + cluster_num, vmar->devinfo[dev_id].devname);
1407 + vma_reader_set_bitmap(rstate, cluster_num, 1);
1409 + max_sector = vmar->devinfo[dev_id].size/BDRV_SECTOR_SIZE;
1411 + max_sector = G_MAXINT64;
1412 + if (cluster_num != vmar->vmstate_clusters) {
1413 + error_setg(errp, "found out of order vmstate data");
1416 + vmar->vmstate_clusters++;
1419 + vmar->clusters_read++;
1422 + time_t duration = time(NULL) - vmar->start_time;
1423 + int percent = (vmar->clusters_read*100)/vmar->cluster_count;
1424 + if (percent != vmar->clusters_read_per) {
1425 + printf("progress %d%% (read %zd bytes, duration %zd sec)\n",
1426 + percent, vmar->clusters_read*VMA_CLUSTER_SIZE,
1429 + vmar->clusters_read_per = percent;
1433 + /* try to write whole clusters to speedup restore */
1434 + if (mask == 0xffff) {
1435 + if ((start + VMA_CLUSTER_SIZE) > extent_size) {
1436 + error_setg(errp, "short vma extent - too many blocks");
1439 + int64_t sector_num = (cluster_num * VMA_CLUSTER_SIZE) /
1441 + int64_t end_sector = sector_num +
1442 + VMA_CLUSTER_SIZE/BDRV_SECTOR_SIZE;
1444 + if (end_sector > max_sector) {
1445 + end_sector = max_sector;
1448 + if (end_sector <= sector_num) {
1449 + error_setg(errp, "got wrong block address - write bejond end");
1454 + int nb_sectors = end_sector - sector_num;
1455 + if (restore_write_data(vmar, dev_id, target, vmstate_fd,
1456 + buf + start, sector_num, nb_sectors,
1462 + start += VMA_CLUSTER_SIZE;
1467 + for (j = 0; j < 16; j++) {
1468 + int64_t sector_num = (cluster_num*VMA_CLUSTER_SIZE +
1469 + j*VMA_BLOCK_SIZE)/BDRV_SECTOR_SIZE;
1471 + int64_t end_sector = sector_num +
1472 + VMA_BLOCK_SIZE/BDRV_SECTOR_SIZE;
1473 + if (end_sector > max_sector) {
1474 + end_sector = max_sector;
1478 + if ((start + VMA_BLOCK_SIZE) > extent_size) {
1479 + error_setg(errp, "short vma extent - too many blocks");
1483 + if (end_sector <= sector_num) {
1484 + error_setg(errp, "got wrong block address - "
1485 + "write bejond end");
1490 + int nb_sectors = end_sector - sector_num;
1491 + if (restore_write_data(vmar, dev_id, target, vmstate_fd,
1492 + buf + start, sector_num,
1493 + nb_sectors, errp) < 0) {
1498 + start += VMA_BLOCK_SIZE;
1503 + if (end_sector > sector_num) {
1504 + /* Todo: use bdrv_co_write_zeroes (but that need to
1505 + * be run inside coroutine?)
1507 + int nb_sectors = end_sector - sector_num;
1508 + int zero_size = BDRV_SECTOR_SIZE*nb_sectors;
1509 + vmar->zero_cluster_data += zero_size;
1511 + vmar->partial_zero_cluster_data += zero_size;
1514 + if (rstate->write_zeroes && !verify) {
1515 + if (restore_write_data(vmar, dev_id, target, vmstate_fd,
1516 + zero_vma_block, sector_num,
1517 + nb_sectors, errp) < 0) {
1529 + if (start != extent_size) {
1530 + error_setg(errp, "vma extent error - missing blocks");
1537 +static int vma_reader_restore_full(VmaReader *vmar, int vmstate_fd,
1538 + bool verbose, bool verify,
1542 + assert(vmar->head_data);
1545 + unsigned char buf[VMA_MAX_EXTENT_SIZE];
1547 + unsigned char md5sum[16];
1548 + VmaHeader *h = (VmaHeader *)vmar->head_data;
1550 + vmar->start_time = time(NULL);
1553 + int bytes = full_read(vmar->fd, buf + buf_pos, sizeof(buf) - buf_pos);
1555 + error_setg(errp, "read failed - %s", g_strerror(errno));
1565 + if (buf_pos < VMA_EXTENT_HEADER_SIZE) {
1566 + error_setg(errp, "read short extent (%d bytes)", buf_pos);
1570 + VmaExtentHeader *ehead = (VmaExtentHeader *)buf;
1572 + /* extract md5sum */
1573 + memcpy(md5sum, ehead->md5sum, sizeof(ehead->md5sum));
1574 + memset(ehead->md5sum, 0, sizeof(ehead->md5sum));
1576 + g_checksum_reset(vmar->md5csum);
1577 + g_checksum_update(vmar->md5csum, buf, VMA_EXTENT_HEADER_SIZE);
1579 + g_checksum_get_digest(vmar->md5csum, ehead->md5sum, &csize);
1581 + if (memcmp(md5sum, ehead->md5sum, 16) != 0) {
1582 + error_setg(errp, "wrong vma extent header chechsum");
1586 + if (memcmp(h->uuid, ehead->uuid, sizeof(ehead->uuid)) != 0) {
1587 + error_setg(errp, "wrong vma extent uuid");
1591 + if (ehead->magic != VMA_EXTENT_MAGIC || ehead->reserved1 != 0) {
1592 + error_setg(errp, "wrong vma extent header magic");
1596 + int block_count = GUINT16_FROM_BE(ehead->block_count);
1597 + int extent_size = VMA_EXTENT_HEADER_SIZE + block_count*VMA_BLOCK_SIZE;
1599 + if (buf_pos < extent_size) {
1600 + error_setg(errp, "short vma extent (%d < %d)", buf_pos,
1605 + if (restore_extent(vmar, buf, extent_size, vmstate_fd, verbose,
1606 + verify, errp) < 0) {
1610 + if (buf_pos > extent_size) {
1611 + memmove(buf, buf + extent_size, buf_pos - extent_size);
1612 + buf_pos = buf_pos - extent_size;
1621 + for (i = 1; i < 256; i++) {
1622 + VmaRestoreState *rstate = &vmar->rstate[i];
1623 + if (!rstate->target) {
1627 + if (blk_flush(rstate->target) < 0) {
1628 + error_setg(errp, "vma blk_flush %s failed",
1629 + vmar->devinfo[i].devname);
1633 + if (vmar->devinfo[i].size &&
1634 + (strcmp(vmar->devinfo[i].devname, "vmstate") != 0)) {
1635 + assert(rstate->bitmap);
1637 + int64_t cluster_num, end;
1639 + end = (vmar->devinfo[i].size + VMA_CLUSTER_SIZE - 1) /
1642 + for (cluster_num = 0; cluster_num < end; cluster_num++) {
1643 + if (!vma_reader_get_bitmap(rstate, cluster_num)) {
1644 + error_setg(errp, "detected missing cluster %zd "
1645 + "for stream %s", cluster_num,
1646 + vmar->devinfo[i].devname);
1654 + if (vmar->clusters_read) {
1655 + printf("total bytes read %zd, sparse bytes %zd (%.3g%%)\n",
1656 + vmar->clusters_read*VMA_CLUSTER_SIZE,
1657 + vmar->zero_cluster_data,
1658 + (double)(100.0*vmar->zero_cluster_data)/
1659 + (vmar->clusters_read*VMA_CLUSTER_SIZE));
1661 + int64_t datasize = vmar->clusters_read*VMA_CLUSTER_SIZE-vmar->zero_cluster_data;
1662 + if (datasize) { // this does not make sense for empty files
1663 + printf("space reduction due to 4K zero blocks %.3g%%\n",
1664 + (double)(100.0*vmar->partial_zero_cluster_data) / datasize);
1667 + printf("vma archive contains no image data\n");
1673 +int vma_reader_restore(VmaReader *vmar, int vmstate_fd, bool verbose,
1676 + return vma_reader_restore_full(vmar, vmstate_fd, verbose, false, errp);
1679 +int vma_reader_verify(VmaReader *vmar, bool verbose, Error **errp)
1683 + for (dev_id = 1; dev_id < 255; dev_id++) {
1684 + if (vma_reader_get_device_info(vmar, dev_id)) {
1685 + allocate_rstate(vmar, dev_id, NULL, false);
1689 + return vma_reader_restore_full(vmar, -1, verbose, true, errp);
1692 diff --git a/vma-writer.c b/vma-writer.c
1693 new file mode 100644
1694 index 0000000000..9001cbdd2b
1699 + * VMA: Virtual Machine Archive
1701 + * Copyright (C) 2012 Proxmox Server Solutions
1704 + * Dietmar Maurer (dietmar@proxmox.com)
1706 + * This work is licensed under the terms of the GNU GPL, version 2 or later.
1707 + * See the COPYING file in the top-level directory.
1711 +#include "qemu/osdep.h"
1713 +#include <uuid/uuid.h>
1716 +#include "block/block.h"
1717 +#include "monitor/monitor.h"
1718 +#include "qemu/main-loop.h"
1719 +#include "qemu/coroutine.h"
1720 +#include "qemu/cutils.h"
1722 +#define DEBUG_VMA 0
1724 +#define DPRINTF(fmt, ...)\
1725 + do { if (DEBUG_VMA) { printf("vma: " fmt, ## __VA_ARGS__); } } while (0)
1727 +#define WRITE_BUFFERS 5
1728 +#define HEADER_CLUSTERS 8
1729 +#define HEADERBUF_SIZE (VMA_CLUSTER_SIZE*HEADER_CLUSTERS)
1735 + char errmsg[8192];
1737 + bool header_written;
1740 + /* we always write extents */
1741 + unsigned char *outbuf;
1742 + int outbuf_pos; /* in bytes */
1743 + int outbuf_count; /* in VMA_BLOCKS */
1744 + uint64_t outbuf_block_info[VMA_BLOCKS_PER_EXTENT];
1746 + unsigned char *headerbuf;
1748 + GChecksum *md5csum;
1749 + CoMutex flush_lock;
1750 + Coroutine *co_writer;
1752 + /* drive informations */
1753 + VmaStreamInfo stream_info[256];
1754 + guint stream_count;
1756 + guint8 vmstate_stream;
1757 + uint32_t vmstate_clusters;
1759 + /* header blob table */
1760 + char *header_blob_table;
1761 + uint32_t header_blob_table_size;
1762 + uint32_t header_blob_table_pos;
1764 + /* store for config blobs */
1765 + uint32_t config_names[VMA_MAX_CONFIGS]; /* offset into blob_buffer table */
1766 + uint32_t config_data[VMA_MAX_CONFIGS]; /* offset into blob_buffer table */
1767 + uint32_t config_count;
1770 +void vma_writer_set_error(VmaWriter *vmaw, const char *fmt, ...)
1774 + if (vmaw->status < 0) {
1778 + vmaw->status = -1;
1780 + va_start(ap, fmt);
1781 + g_vsnprintf(vmaw->errmsg, sizeof(vmaw->errmsg), fmt, ap);
1784 + DPRINTF("vma_writer_set_error: %s\n", vmaw->errmsg);
1787 +static uint32_t allocate_header_blob(VmaWriter *vmaw, const char *data,
1790 + if (len > 65535) {
1794 + if (!vmaw->header_blob_table ||
1795 + (vmaw->header_blob_table_size <
1796 + (vmaw->header_blob_table_pos + len + 2))) {
1797 + int newsize = vmaw->header_blob_table_size + ((len + 2 + 511)/512)*512;
1799 + vmaw->header_blob_table = g_realloc(vmaw->header_blob_table, newsize);
1800 + memset(vmaw->header_blob_table + vmaw->header_blob_table_size,
1801 + 0, newsize - vmaw->header_blob_table_size);
1802 + vmaw->header_blob_table_size = newsize;
1805 + uint32_t cpos = vmaw->header_blob_table_pos;
1806 + vmaw->header_blob_table[cpos] = len & 255;
1807 + vmaw->header_blob_table[cpos+1] = (len >> 8) & 255;
1808 + memcpy(vmaw->header_blob_table + cpos + 2, data, len);
1809 + vmaw->header_blob_table_pos += len + 2;
1813 +static uint32_t allocate_header_string(VmaWriter *vmaw, const char *str)
1817 + size_t len = strlen(str) + 1;
1819 + return allocate_header_blob(vmaw, str, len);
1822 +int vma_writer_add_config(VmaWriter *vmaw, const char *name, gpointer data,
1826 + assert(!vmaw->header_written);
1827 + assert(vmaw->config_count < VMA_MAX_CONFIGS);
1831 + gchar *basename = g_path_get_basename(name);
1832 + uint32_t name_ptr = allocate_header_string(vmaw, basename);
1839 + uint32_t data_ptr = allocate_header_blob(vmaw, data, len);
1844 + vmaw->config_names[vmaw->config_count] = name_ptr;
1845 + vmaw->config_data[vmaw->config_count] = data_ptr;
1847 + vmaw->config_count++;
1852 +int vma_writer_register_stream(VmaWriter *vmaw, const char *devname,
1857 + assert(!vmaw->status);
1859 + if (vmaw->header_written) {
1860 + vma_writer_set_error(vmaw, "vma_writer_register_stream: header "
1861 + "already written");
1865 + guint n = vmaw->stream_count + 1;
1867 + /* we can have dev_ids form 1 to 255 (0 reserved)
1868 + * 255(-1) reseverd for safety
1871 + vma_writer_set_error(vmaw, "vma_writer_register_stream: "
1872 + "too many drives");
1877 + vma_writer_set_error(vmaw, "vma_writer_register_stream: "
1878 + "got strange size %zd", size);
1882 + DPRINTF("vma_writer_register_stream %s %zu %d\n", devname, size, n);
1884 + vmaw->stream_info[n].devname = g_strdup(devname);
1885 + vmaw->stream_info[n].size = size;
1887 + vmaw->stream_info[n].cluster_count = (size + VMA_CLUSTER_SIZE - 1) /
1890 + vmaw->stream_count = n;
1892 + if (strcmp(devname, "vmstate") == 0) {
1893 + vmaw->vmstate_stream = n;
1899 +static void vma_co_continue_write(void *opaque)
1901 + VmaWriter *vmaw = opaque;
1903 + DPRINTF("vma_co_continue_write\n");
1904 + qemu_coroutine_enter(vmaw->co_writer);
1907 +static ssize_t coroutine_fn
1908 +vma_queue_write(VmaWriter *vmaw, const void *buf, size_t bytes)
1910 + DPRINTF("vma_queue_write enter %zd\n", bytes);
1914 + assert(bytes <= VMA_MAX_EXTENT_SIZE);
1919 + assert(vmaw->co_writer == NULL);
1921 + vmaw->co_writer = qemu_coroutine_self();
1923 + while (done < bytes) {
1924 + aio_set_fd_handler(qemu_get_aio_context(), vmaw->fd, false, NULL, vma_co_continue_write, NULL, vmaw);
1925 + qemu_coroutine_yield();
1926 + aio_set_fd_handler(qemu_get_aio_context(), vmaw->fd, false, NULL, NULL, NULL, NULL);
1927 + if (vmaw->status < 0) {
1928 + DPRINTF("vma_queue_write detected canceled backup\n");
1932 + ret = write(vmaw->fd, buf + done, bytes - done);
1935 + DPRINTF("vma_queue_write written %zd %zd\n", done, ret);
1936 + } else if (ret < 0) {
1937 + if (errno == EAGAIN || errno == EWOULDBLOCK) {
1940 + vma_writer_set_error(vmaw, "vma_queue_write: write error - %s",
1941 + g_strerror(errno));
1942 + done = -1; /* always return failure for partial writes */
1945 + } else if (ret == 0) {
1946 + /* should not happen - simply try again */
1950 + vmaw->co_writer = NULL;
1952 + return (done == bytes) ? bytes : -1;
1955 +VmaWriter *vma_writer_create(const char *filename, uuid_t uuid, Error **errp)
1959 + assert(sizeof(VmaHeader) == (4096 + 8192));
1960 + assert(G_STRUCT_OFFSET(VmaHeader, config_names) == 2044);
1961 + assert(G_STRUCT_OFFSET(VmaHeader, config_data) == 3068);
1962 + assert(G_STRUCT_OFFSET(VmaHeader, dev_info) == 4096);
1963 + assert(sizeof(VmaExtentHeader) == 512);
1965 + VmaWriter *vmaw = g_new0(VmaWriter, 1);
1968 + vmaw->md5csum = g_checksum_new(G_CHECKSUM_MD5);
1969 + if (!vmaw->md5csum) {
1970 + error_setg(errp, "can't allocate cmsum\n");
1974 + if (strstart(filename, "exec:", &p)) {
1975 + vmaw->cmd = popen(p, "w");
1976 + if (vmaw->cmd == NULL) {
1977 + error_setg(errp, "can't popen command '%s' - %s\n", p,
1978 + g_strerror(errno));
1981 + vmaw->fd = fileno(vmaw->cmd);
1983 + /* try to use O_NONBLOCK */
1984 + fcntl(vmaw->fd, F_SETFL, fcntl(vmaw->fd, F_GETFL)|O_NONBLOCK);
1989 + const char *tmp_id_str;
1991 + if ((stat(filename, &st) == 0) && S_ISFIFO(st.st_mode)) {
1992 + oflags = O_NONBLOCK|O_WRONLY;
1993 + vmaw->fd = qemu_open(filename, oflags, 0644);
1994 + } else if (strstart(filename, "/dev/fdset/", &tmp_id_str)) {
1995 + oflags = O_NONBLOCK|O_WRONLY;
1996 + vmaw->fd = qemu_open(filename, oflags, 0644);
1997 + } else if (strstart(filename, "/dev/fdname/", &tmp_id_str)) {
1998 + vmaw->fd = monitor_get_fd(cur_mon, tmp_id_str, errp);
1999 + if (vmaw->fd < 0) {
2002 + /* try to use O_NONBLOCK */
2003 + fcntl(vmaw->fd, F_SETFL, fcntl(vmaw->fd, F_GETFL)|O_NONBLOCK);
2005 + oflags = O_NONBLOCK|O_DIRECT|O_WRONLY|O_CREAT|O_EXCL;
2006 + vmaw->fd = qemu_open(filename, oflags, 0644);
2009 + if (vmaw->fd < 0) {
2010 + error_setg(errp, "can't open file %s - %s\n", filename,
2011 + g_strerror(errno));
2016 + /* we use O_DIRECT, so we need to align IO buffers */
2018 + vmaw->outbuf = qemu_memalign(512, VMA_MAX_EXTENT_SIZE);
2019 + vmaw->headerbuf = qemu_memalign(512, HEADERBUF_SIZE);
2021 + vmaw->outbuf_count = 0;
2022 + vmaw->outbuf_pos = VMA_EXTENT_HEADER_SIZE;
2024 + vmaw->header_blob_table_pos = 1; /* start at pos 1 */
2026 + qemu_co_mutex_init(&vmaw->flush_lock);
2028 + uuid_copy(vmaw->uuid, uuid);
2035 + pclose(vmaw->cmd);
2036 + } else if (vmaw->fd >= 0) {
2040 + if (vmaw->md5csum) {
2041 + g_checksum_free(vmaw->md5csum);
2050 +static int coroutine_fn vma_write_header(VmaWriter *vmaw)
2053 + unsigned char *buf = vmaw->headerbuf;
2054 + VmaHeader *head = (VmaHeader *)buf;
2058 + DPRINTF("VMA WRITE HEADER\n");
2060 + if (vmaw->status < 0) {
2061 + return vmaw->status;
2064 + memset(buf, 0, HEADERBUF_SIZE);
2066 + head->magic = VMA_MAGIC;
2067 + head->version = GUINT32_TO_BE(1); /* v1 */
2068 + memcpy(head->uuid, vmaw->uuid, 16);
2070 + time_t ctime = time(NULL);
2071 + head->ctime = GUINT64_TO_BE(ctime);
2073 + for (i = 0; i < VMA_MAX_CONFIGS; i++) {
2074 + head->config_names[i] = GUINT32_TO_BE(vmaw->config_names[i]);
2075 + head->config_data[i] = GUINT32_TO_BE(vmaw->config_data[i]);
2078 + /* 32 bytes per device (12 used currently) = 8192 bytes max */
2079 + for (i = 1; i <= 254; i++) {
2080 + VmaStreamInfo *si = &vmaw->stream_info[i];
2082 + assert(si->devname);
2083 + uint32_t devname_ptr = allocate_header_string(vmaw, si->devname);
2084 + if (!devname_ptr) {
2087 + head->dev_info[i].devname_ptr = GUINT32_TO_BE(devname_ptr);
2088 + head->dev_info[i].size = GUINT64_TO_BE(si->size);
2092 + uint32_t header_size = sizeof(VmaHeader) + vmaw->header_blob_table_size;
2093 + head->header_size = GUINT32_TO_BE(header_size);
2095 + if (header_size > HEADERBUF_SIZE) {
2096 + return -1; /* just to be sure */
2099 + uint32_t blob_buffer_offset = sizeof(VmaHeader);
2100 + memcpy(buf + blob_buffer_offset, vmaw->header_blob_table,
2101 + vmaw->header_blob_table_size);
2102 + head->blob_buffer_offset = GUINT32_TO_BE(blob_buffer_offset);
2103 + head->blob_buffer_size = GUINT32_TO_BE(vmaw->header_blob_table_pos);
2105 + g_checksum_reset(vmaw->md5csum);
2106 + g_checksum_update(vmaw->md5csum, (const guchar *)buf, header_size);
2108 + g_checksum_get_digest(vmaw->md5csum, (guint8 *)(head->md5sum), &csize);
2110 + return vma_queue_write(vmaw, buf, header_size);
2113 +static int coroutine_fn vma_writer_flush(VmaWriter *vmaw)
2120 + if (vmaw->status < 0) {
2121 + return vmaw->status;
2124 + if (!vmaw->header_written) {
2125 + vmaw->header_written = true;
2126 + ret = vma_write_header(vmaw);
2128 + vma_writer_set_error(vmaw, "vma_writer_flush: write header failed");
2133 + DPRINTF("VMA WRITE FLUSH %d %d\n", vmaw->outbuf_count, vmaw->outbuf_pos);
2136 + VmaExtentHeader *ehead = (VmaExtentHeader *)vmaw->outbuf;
2138 + ehead->magic = VMA_EXTENT_MAGIC;
2139 + ehead->reserved1 = 0;
2141 + for (i = 0; i < VMA_BLOCKS_PER_EXTENT; i++) {
2142 + ehead->blockinfo[i] = GUINT64_TO_BE(vmaw->outbuf_block_info[i]);
2145 + guint16 block_count = (vmaw->outbuf_pos - VMA_EXTENT_HEADER_SIZE) /
2148 + ehead->block_count = GUINT16_TO_BE(block_count);
2150 + memcpy(ehead->uuid, vmaw->uuid, sizeof(ehead->uuid));
2151 + memset(ehead->md5sum, 0, sizeof(ehead->md5sum));
2153 + g_checksum_reset(vmaw->md5csum);
2154 + g_checksum_update(vmaw->md5csum, vmaw->outbuf, VMA_EXTENT_HEADER_SIZE);
2156 + g_checksum_get_digest(vmaw->md5csum, ehead->md5sum, &csize);
2158 + int bytes = vmaw->outbuf_pos;
2159 + ret = vma_queue_write(vmaw, vmaw->outbuf, bytes);
2160 + if (ret != bytes) {
2161 + vma_writer_set_error(vmaw, "vma_writer_flush: failed write");
2164 + vmaw->outbuf_count = 0;
2165 + vmaw->outbuf_pos = VMA_EXTENT_HEADER_SIZE;
2167 + for (i = 0; i < VMA_BLOCKS_PER_EXTENT; i++) {
2168 + vmaw->outbuf_block_info[i] = 0;
2171 + return vmaw->status;
2174 +static int vma_count_open_streams(VmaWriter *vmaw)
2176 + g_assert(vmaw != NULL);
2179 + int open_drives = 0;
2180 + for (i = 0; i <= 255; i++) {
2181 + if (vmaw->stream_info[i].size && !vmaw->stream_info[i].finished) {
2186 + return open_drives;
2191 + * You need to call this if the vma archive does not contain
2192 + * any data stream.
2195 +vma_writer_flush_output(VmaWriter *vmaw)
2197 + qemu_co_mutex_lock(&vmaw->flush_lock);
2198 + int ret = vma_writer_flush(vmaw);
2199 + qemu_co_mutex_unlock(&vmaw->flush_lock);
2201 + vma_writer_set_error(vmaw, "vma_writer_flush_header failed");
2207 + * all jobs should call this when there is no more data
2208 + * Returns: number of remaining stream (0 ==> finished)
2211 +vma_writer_close_stream(VmaWriter *vmaw, uint8_t dev_id)
2213 + g_assert(vmaw != NULL);
2215 + DPRINTF("vma_writer_set_status %d\n", dev_id);
2216 + if (!vmaw->stream_info[dev_id].size) {
2217 + vma_writer_set_error(vmaw, "vma_writer_close_stream: "
2218 + "no such stream %d", dev_id);
2221 + if (vmaw->stream_info[dev_id].finished) {
2222 + vma_writer_set_error(vmaw, "vma_writer_close_stream: "
2223 + "stream already closed %d", dev_id);
2227 + vmaw->stream_info[dev_id].finished = true;
2229 + int open_drives = vma_count_open_streams(vmaw);
2231 + if (open_drives <= 0) {
2232 + DPRINTF("vma_writer_set_status all drives completed\n");
2233 + vma_writer_flush_output(vmaw);
2236 + return open_drives;
2239 +int vma_writer_get_status(VmaWriter *vmaw, VmaStatus *status)
2243 + g_assert(vmaw != NULL);
2246 + status->status = vmaw->status;
2247 + g_strlcpy(status->errmsg, vmaw->errmsg, sizeof(status->errmsg));
2248 + for (i = 0; i <= 255; i++) {
2249 + status->stream_info[i] = vmaw->stream_info[i];
2252 + uuid_unparse_lower(vmaw->uuid, status->uuid_str);
2255 + status->closed = vmaw->closed;
2257 + return vmaw->status;
2260 +static int vma_writer_get_buffer(VmaWriter *vmaw)
2264 + qemu_co_mutex_lock(&vmaw->flush_lock);
2266 + /* wait until buffer is available */
2267 + while (vmaw->outbuf_count >= (VMA_BLOCKS_PER_EXTENT - 1)) {
2268 + ret = vma_writer_flush(vmaw);
2270 + vma_writer_set_error(vmaw, "vma_writer_get_buffer: flush failed");
2275 + qemu_co_mutex_unlock(&vmaw->flush_lock);
2281 +int64_t coroutine_fn
2282 +vma_writer_write(VmaWriter *vmaw, uint8_t dev_id, int64_t cluster_num,
2283 + unsigned char *buf, size_t *zero_bytes)
2285 + g_assert(vmaw != NULL);
2286 + g_assert(zero_bytes != NULL);
2290 + if (vmaw->status < 0) {
2291 + return vmaw->status;
2294 + if (!dev_id || !vmaw->stream_info[dev_id].size) {
2295 + vma_writer_set_error(vmaw, "vma_writer_write: "
2296 + "no such stream %d", dev_id);
2300 + if (vmaw->stream_info[dev_id].finished) {
2301 + vma_writer_set_error(vmaw, "vma_writer_write: "
2302 + "stream already closed %d", dev_id);
2307 + if (cluster_num >= (((uint64_t)1)<<32)) {
2308 + vma_writer_set_error(vmaw, "vma_writer_write: "
2309 + "cluster number out of range");
2313 + if (dev_id == vmaw->vmstate_stream) {
2314 + if (cluster_num != vmaw->vmstate_clusters) {
2315 + vma_writer_set_error(vmaw, "vma_writer_write: "
2316 + "non sequential vmstate write");
2318 + vmaw->vmstate_clusters++;
2319 + } else if (cluster_num >= vmaw->stream_info[dev_id].cluster_count) {
2320 + vma_writer_set_error(vmaw, "vma_writer_write: cluster number too big");
2324 + /* wait until buffer is available */
2325 + if (vma_writer_get_buffer(vmaw) < 0) {
2326 + vma_writer_set_error(vmaw, "vma_writer_write: "
2327 + "vma_writer_get_buffer failed");
2331 + DPRINTF("VMA WRITE %d %zd\n", dev_id, cluster_num);
2333 + uint16_t mask = 0;
2338 + for (i = 0; i < 16; i++) {
2339 + unsigned char *vmablock = buf + (i*VMA_BLOCK_SIZE);
2340 + if (!buffer_is_zero(vmablock, VMA_BLOCK_SIZE)) {
2342 + memcpy(vmaw->outbuf + vmaw->outbuf_pos, vmablock,
2344 + vmaw->outbuf_pos += VMA_BLOCK_SIZE;
2346 + DPRINTF("VMA WRITE %zd ZERO BLOCK %d\n", cluster_num, i);
2347 + vmaw->stream_info[dev_id].zero_bytes += VMA_BLOCK_SIZE;
2348 + *zero_bytes += VMA_BLOCK_SIZE;
2354 + DPRINTF("VMA WRITE %zd ZERO CLUSTER\n", cluster_num);
2355 + vmaw->stream_info[dev_id].zero_bytes += VMA_CLUSTER_SIZE;
2356 + *zero_bytes += VMA_CLUSTER_SIZE;
2359 + uint64_t block_info = ((uint64_t)mask) << (32+16);
2360 + block_info |= ((uint64_t)dev_id) << 32;
2361 + block_info |= (cluster_num & 0xffffffff);
2362 + vmaw->outbuf_block_info[vmaw->outbuf_count] = block_info;
2364 + DPRINTF("VMA WRITE MASK %zd %zx\n", cluster_num, block_info);
2366 + vmaw->outbuf_count++;
2368 + /** NOTE: We allways write whole clusters, but we correctly set
2369 + * transferred bytes. So transferred == size when when everything
2372 + size_t transferred = VMA_CLUSTER_SIZE;
2374 + if (dev_id != vmaw->vmstate_stream) {
2375 + uint64_t last = (cluster_num + 1) * VMA_CLUSTER_SIZE;
2376 + if (last > vmaw->stream_info[dev_id].size) {
2377 + uint64_t diff = last - vmaw->stream_info[dev_id].size;
2378 + if (diff >= VMA_CLUSTER_SIZE) {
2379 + vma_writer_set_error(vmaw, "vma_writer_write: "
2380 + "read after last cluster");
2383 + transferred -= diff;
2387 + vmaw->stream_info[dev_id].transferred += transferred;
2389 + return transferred;
2392 +void vma_writer_error_propagate(VmaWriter *vmaw, Error **errp)
2394 + if (vmaw->status < 0 && *errp == NULL) {
2395 + error_setg(errp, "%s", vmaw->errmsg);
2399 +int vma_writer_close(VmaWriter *vmaw, Error **errp)
2401 + g_assert(vmaw != NULL);
2405 + while (vmaw->co_writer) {
2406 + aio_poll(qemu_get_aio_context(), true);
2409 + assert(vmaw->co_writer == NULL);
2412 + if (pclose(vmaw->cmd) < 0) {
2413 + vma_writer_set_error(vmaw, "vma_writer_close: "
2414 + "pclose failed - %s", g_strerror(errno));
2417 + if (close(vmaw->fd) < 0) {
2418 + vma_writer_set_error(vmaw, "vma_writer_close: "
2419 + "close failed - %s", g_strerror(errno));
2423 + for (i = 0; i <= 255; i++) {
2424 + VmaStreamInfo *si = &vmaw->stream_info[i];
2426 + if (!si->finished) {
2427 + vma_writer_set_error(vmaw, "vma_writer_close: "
2428 + "detected open stream '%s'", si->devname);
2429 + } else if ((si->transferred != si->size) &&
2430 + (i != vmaw->vmstate_stream)) {
2431 + vma_writer_set_error(vmaw, "vma_writer_close: "
2432 + "incomplete stream '%s' (%zd != %zd)",
2433 + si->devname, si->transferred, si->size);
2438 + for (i = 0; i <= 255; i++) {
2439 + vmaw->stream_info[i].finished = 1; /* mark as closed */
2444 + if (vmaw->status < 0 && *errp == NULL) {
2445 + error_setg(errp, "%s", vmaw->errmsg);
2448 + return vmaw->status;
2451 +void vma_writer_destroy(VmaWriter *vmaw)
2457 + for (i = 0; i <= 255; i++) {
2458 + if (vmaw->stream_info[i].devname) {
2459 + g_free(vmaw->stream_info[i].devname);
2463 + if (vmaw->md5csum) {
2464 + g_checksum_free(vmaw->md5csum);
2469 diff --git a/vma.c b/vma.c
2470 new file mode 100644
2471 index 0000000000..04915427c8
2476 + * VMA: Virtual Machine Archive
2478 + * Copyright (C) 2012-2013 Proxmox Server Solutions
2481 + * Dietmar Maurer (dietmar@proxmox.com)
2483 + * This work is licensed under the terms of the GNU GPL, version 2 or later.
2484 + * See the COPYING file in the top-level directory.
2488 +#include "qemu/osdep.h"
2492 +#include "qemu-common.h"
2493 +#include "qemu/error-report.h"
2494 +#include "qemu/main-loop.h"
2495 +#include "qapi/qmp/qstring.h"
2496 +#include "sysemu/char.h" /* qstring_from_str */
2497 +#include "sysemu/block-backend.h"
2499 +static void help(void)
2501 + const char *help_msg =
2502 + "usage: vma command [command options]\n"
2504 + "vma list <filename>\n"
2505 + "vma config <filename> [-c config]\n"
2506 + "vma create <filename> [-c config] pathname ...\n"
2507 + "vma extract <filename> [-r <fifo>] <targetdir>\n"
2508 + "vma verify <filename> [-v]\n"
2511 + printf("%s", help_msg);
2515 +static const char *extract_devname(const char *path, char **devname, int index)
2519 + const char *sep = strchr(path, '=');
2522 + *devname = g_strndup(path, sep - path);
2526 + *devname = g_strdup_printf("disk%d", index);
2535 +static void print_content(VmaReader *vmar)
2539 + VmaHeader *head = vma_reader_get_header(vmar);
2541 + GList *l = vma_reader_get_config_data(vmar);
2542 + while (l && l->data) {
2543 + VmaConfigData *cdata = (VmaConfigData *)l->data;
2544 + l = g_list_next(l);
2545 + printf("CFG: size: %d name: %s\n", cdata->len, cdata->name);
2549 + VmaDeviceInfo *di;
2550 + for (i = 1; i < 255; i++) {
2551 + di = vma_reader_get_device_info(vmar, i);
2553 + if (strcmp(di->devname, "vmstate") == 0) {
2554 + printf("VMSTATE: dev_id=%d memory: %zd\n", i, di->size);
2556 + printf("DEV: dev_id=%d size: %zd devname: %s\n",
2557 + i, di->size, di->devname);
2561 + /* ctime is the last entry we print */
2562 + printf("CTIME: %s", ctime(&head->ctime));
2566 +static int list_content(int argc, char **argv)
2569 + const char *filename;
2572 + c = getopt(argc, argv, "h");
2582 + g_assert_not_reached();
2586 + /* Get the filename */
2587 + if ((optind + 1) != argc) {
2590 + filename = argv[optind++];
2592 + Error *errp = NULL;
2593 + VmaReader *vmar = vma_reader_create(filename, &errp);
2596 + g_error("%s", error_get_pretty(errp));
2599 + print_content(vmar);
2601 + vma_reader_destroy(vmar);
2606 +typedef struct RestoreMap {
2613 +static int extract_content(int argc, char **argv)
2617 + const char *filename;
2618 + const char *dirname;
2619 + const char *readmap = NULL;
2622 + c = getopt(argc, argv, "hvr:");
2642 + /* Get the filename */
2643 + if ((optind + 2) != argc) {
2646 + filename = argv[optind++];
2647 + dirname = argv[optind++];
2649 + Error *errp = NULL;
2650 + VmaReader *vmar = vma_reader_create(filename, &errp);
2653 + g_error("%s", error_get_pretty(errp));
2656 + if (mkdir(dirname, 0777) < 0) {
2657 + g_error("unable to create target directory %s - %s",
2658 + dirname, g_strerror(errno));
2661 + GList *l = vma_reader_get_config_data(vmar);
2662 + while (l && l->data) {
2663 + VmaConfigData *cdata = (VmaConfigData *)l->data;
2664 + l = g_list_next(l);
2665 + char *cfgfn = g_strdup_printf("%s/%s", dirname, cdata->name);
2666 + GError *err = NULL;
2667 + if (!g_file_set_contents(cfgfn, (gchar *)cdata->data, cdata->len,
2669 + g_error("unable to write file: %s", err->message);
2673 + GHashTable *devmap = g_hash_table_new(g_str_hash, g_str_equal);
2676 + print_content(vmar);
2678 + FILE *map = fopen(readmap, "r");
2680 + g_error("unable to open fifo %s - %s", readmap, g_strerror(errno));
2685 + char *line = fgets(inbuf, sizeof(inbuf), map);
2686 + if (!line || line[0] == '\0' || !strcmp(line, "done\n")) {
2689 + int len = strlen(line);
2690 + if (line[len - 1] == '\n') {
2691 + line[len - 1] = '\0';
2697 + char *format = NULL;
2698 + if (strncmp(line, "format=", sizeof("format=")-1) == 0) {
2699 + format = line + sizeof("format=")-1;
2700 + char *colon = strchr(format, ':');
2702 + g_error("read map failed - found only a format ('%s')", inbuf);
2704 + format = g_strndup(format, colon - format);
2710 + if (line[0] == '0' && line[1] == ':') {
2712 + write_zero = false;
2713 + } else if (line[0] == '1' && line[1] == ':') {
2715 + write_zero = true;
2717 + g_error("read map failed - parse error ('%s')", inbuf);
2720 + char *devname = NULL;
2721 + path = extract_devname(path, &devname, -1);
2723 + g_error("read map failed - no dev name specified ('%s')",
2727 + RestoreMap *map = g_new0(RestoreMap, 1);
2728 + map->devname = g_strdup(devname);
2729 + map->path = g_strdup(path);
2730 + map->format = format;
2731 + map->write_zero = write_zero;
2733 + g_hash_table_insert(devmap, map->devname, map);
2739 + int vmstate_fd = -1;
2740 + guint8 vmstate_stream = 0;
2742 + BlockBackend *blk = NULL;
2744 + for (i = 1; i < 255; i++) {
2745 + VmaDeviceInfo *di = vma_reader_get_device_info(vmar, i);
2746 + if (di && (strcmp(di->devname, "vmstate") == 0)) {
2747 + vmstate_stream = i;
2748 + char *statefn = g_strdup_printf("%s/vmstate.bin", dirname);
2749 + vmstate_fd = open(statefn, O_WRONLY|O_CREAT|O_EXCL, 0644);
2750 + if (vmstate_fd < 0) {
2751 + g_error("create vmstate file '%s' failed - %s", statefn,
2752 + g_strerror(errno));
2756 + char *devfn = NULL;
2757 + const char *format = NULL;
2758 + int flags = BDRV_O_RDWR | BDRV_O_NO_FLUSH;
2759 + bool write_zero = true;
2763 + map = (RestoreMap *)g_hash_table_lookup(devmap, di->devname);
2764 + if (map == NULL) {
2765 + g_error("no device name mapping for %s", di->devname);
2767 + devfn = map->path;
2768 + format = map->format;
2769 + write_zero = map->write_zero;
2771 + devfn = g_strdup_printf("%s/tmp-disk-%s.raw",
2772 + dirname, di->devname);
2773 + printf("DEVINFO %s %zd\n", devfn, di->size);
2775 + bdrv_img_create(devfn, "raw", NULL, NULL, NULL, di->size,
2778 + g_error("can't create file %s: %s", devfn,
2779 + error_get_pretty(errp));
2782 + /* Note: we created an empty file above, so there is no
2783 + * need to write zeroes (so we generate a sparse file)
2785 + write_zero = false;
2788 + size_t devlen = strlen(devfn);
2789 + QDict *options = NULL;
2791 + /* explicit format from commandline */
2792 + options = qdict_new();
2793 + qdict_put(options, "driver", qstring_from_str(format));
2794 + } else if ((devlen > 4 && strcmp(devfn+devlen-4, ".raw") == 0) ||
2795 + strncmp(devfn, "/dev/", 5) == 0)
2797 + /* This part is now deprecated for PVE as well (just as qemu
2798 + * deprecated not specifying an explicit raw format, too.
2800 + /* explicit raw format */
2801 + options = qdict_new();
2802 + qdict_put(options, "driver", qstring_from_str("raw"));
2806 + if (errp || !(blk = blk_new_open(devfn, NULL, options, flags, &errp))) {
2807 + g_error("can't open file %s - %s", devfn,
2808 + error_get_pretty(errp));
2811 + if (vma_reader_register_bs(vmar, i, blk, write_zero, &errp) < 0) {
2812 + g_error("%s", error_get_pretty(errp));
2821 + if (vma_reader_restore(vmar, vmstate_fd, verbose, &errp) < 0) {
2822 + g_error("restore failed - %s", error_get_pretty(errp));
2826 + for (i = 1; i < 255; i++) {
2827 + VmaDeviceInfo *di = vma_reader_get_device_info(vmar, i);
2828 + if (di && (i != vmstate_stream)) {
2829 + char *tmpfn = g_strdup_printf("%s/tmp-disk-%s.raw",
2830 + dirname, di->devname);
2831 + char *fn = g_strdup_printf("%s/disk-%s.raw",
2832 + dirname, di->devname);
2833 + if (rename(tmpfn, fn) != 0) {
2834 + g_error("rename %s to %s failed - %s",
2835 + tmpfn, fn, g_strerror(errno));
2841 + vma_reader_destroy(vmar);
2850 +static int verify_content(int argc, char **argv)
2854 + const char *filename;
2857 + c = getopt(argc, argv, "hv");
2874 + /* Get the filename */
2875 + if ((optind + 1) != argc) {
2878 + filename = argv[optind++];
2880 + Error *errp = NULL;
2881 + VmaReader *vmar = vma_reader_create(filename, &errp);
2884 + g_error("%s", error_get_pretty(errp));
2888 + print_content(vmar);
2891 + if (vma_reader_verify(vmar, verbose, &errp) < 0) {
2892 + g_error("verify failed - %s", error_get_pretty(errp));
2895 + vma_reader_destroy(vmar);
2902 +typedef struct BackupJob {
2903 + BlockBackend *target;
2909 +#define BACKUP_SECTORS_PER_CLUSTER (VMA_CLUSTER_SIZE / BDRV_SECTOR_SIZE)
2911 +static void coroutine_fn backup_run_empty(void *opaque)
2913 + VmaWriter *vmaw = (VmaWriter *)opaque;
2915 + vma_writer_flush_output(vmaw);
2917 + Error *err = NULL;
2918 + if (vma_writer_close(vmaw, &err) != 0) {
2919 + g_warning("vma_writer_close failed %s", error_get_pretty(err));
2923 +static void coroutine_fn backup_run(void *opaque)
2925 + BackupJob *job = (BackupJob *)opaque;
2927 + QEMUIOVector qiov;
2929 + int64_t start, end;
2932 + unsigned char *buf = blk_blockalign(job->target, VMA_CLUSTER_SIZE);
2935 + end = DIV_ROUND_UP(job->len / BDRV_SECTOR_SIZE,
2936 + BACKUP_SECTORS_PER_CLUSTER);
2938 + for (; start < end; start++) {
2939 + iov.iov_base = buf;
2940 + iov.iov_len = VMA_CLUSTER_SIZE;
2941 + qemu_iovec_init_external(&qiov, &iov, 1);
2943 + ret = blk_co_preadv(job->target, start * VMA_CLUSTER_SIZE,
2944 + VMA_CLUSTER_SIZE, &qiov, 0);
2946 + vma_writer_set_error(job->vmaw, "read error", -1);
2951 + if (vma_writer_write(job->vmaw, job->dev_id, start, buf, &zb) < 0) {
2952 + vma_writer_set_error(job->vmaw, "backup_dump_cb vma_writer_write failed", -1);
2959 + if (vma_writer_close_stream(job->vmaw, job->dev_id) <= 0) {
2960 + Error *err = NULL;
2961 + if (vma_writer_close(job->vmaw, &err) != 0) {
2962 + g_warning("vma_writer_close failed %s", error_get_pretty(err));
2967 +static int create_archive(int argc, char **argv)
2971 + const char *archivename;
2972 + GList *config_files = NULL;
2975 + c = getopt(argc, argv, "hvc:");
2985 + config_files = g_list_append(config_files, optarg);
2991 + g_assert_not_reached();
2996 + /* make sure we an archive name */
2997 + if ((optind + 1) > argc) {
3001 + archivename = argv[optind++];
3004 + uuid_generate(uuid);
3006 + Error *local_err = NULL;
3007 + VmaWriter *vmaw = vma_writer_create(archivename, uuid, &local_err);
3009 + if (vmaw == NULL) {
3010 + g_error("%s", error_get_pretty(local_err));
3013 + GList *l = config_files;
3014 + while (l && l->data) {
3015 + char *name = l->data;
3016 + char *cdata = NULL;
3018 + GError *err = NULL;
3019 + if (!g_file_get_contents(name, &cdata, &clen, &err)) {
3020 + unlink(archivename);
3021 + g_error("Unable to read file: %s", err->message);
3024 + if (vma_writer_add_config(vmaw, name, cdata, clen) != 0) {
3025 + unlink(archivename);
3026 + g_error("Unable to append config data %s (len = %zd)",
3029 + l = g_list_next(l);
3033 + while (optind < argc) {
3034 + const char *path = argv[optind++];
3035 + char *devname = NULL;
3036 + path = extract_devname(path, &devname, devcount++);
3038 + Error *errp = NULL;
3039 + BlockBackend *target;
3041 + target = blk_new_open(path, NULL, NULL, 0, &errp);
3043 + unlink(archivename);
3044 + g_error("bdrv_open '%s' failed - %s", path, error_get_pretty(errp));
3046 + int64_t size = blk_getlength(target);
3047 + int dev_id = vma_writer_register_stream(vmaw, devname, size);
3048 + if (dev_id <= 0) {
3049 + unlink(archivename);
3050 + g_error("vma_writer_register_stream '%s' failed", devname);
3053 + BackupJob *job = g_new0(BackupJob, 1);
3055 + job->target = target;
3057 + job->dev_id = dev_id;
3059 + Coroutine *co = qemu_coroutine_create(backup_run, job);
3060 + qemu_coroutine_enter(co);
3063 + VmaStatus vmastat;
3065 + int last_percent = -1;
3069 + main_loop_wait(false);
3070 + vma_writer_get_status(vmaw, &vmastat);
3074 + uint64_t total = 0;
3075 + uint64_t transferred = 0;
3076 + uint64_t zero_bytes = 0;
3079 + for (i = 0; i < 256; i++) {
3080 + if (vmastat.stream_info[i].size) {
3081 + total += vmastat.stream_info[i].size;
3082 + transferred += vmastat.stream_info[i].transferred;
3083 + zero_bytes += vmastat.stream_info[i].zero_bytes;
3086 + percent = (transferred*100)/total;
3087 + if (percent != last_percent) {
3088 + fprintf(stderr, "progress %d%% %zd/%zd %zd\n", percent,
3089 + transferred, total, zero_bytes);
3092 + last_percent = percent;
3096 + if (vmastat.closed) {
3101 + Coroutine *co = qemu_coroutine_create(backup_run_empty, vmaw);
3102 + qemu_coroutine_enter(co);
3104 + main_loop_wait(false);
3105 + vma_writer_get_status(vmaw, &vmastat);
3106 + if (vmastat.closed) {
3114 + vma_writer_get_status(vmaw, &vmastat);
3117 + for (i = 0; i < 256; i++) {
3118 + VmaStreamInfo *si = &vmastat.stream_info[i];
3120 + fprintf(stderr, "image %s: size=%zd zeros=%zd saved=%zd\n",
3121 + si->devname, si->size, si->zero_bytes,
3122 + si->size - si->zero_bytes);
3127 + if (vmastat.status < 0) {
3128 + unlink(archivename);
3129 + g_error("creating vma archive failed");
3135 +static int dump_config(int argc, char **argv)
3138 + const char *filename;
3139 + const char *config_name = "qemu-server.conf";
3142 + c = getopt(argc, argv, "hc:");
3152 + config_name = optarg;
3159 + /* Get the filename */
3160 + if ((optind + 1) != argc) {
3163 + filename = argv[optind++];
3165 + Error *errp = NULL;
3166 + VmaReader *vmar = vma_reader_create(filename, &errp);
3169 + g_error("%s", error_get_pretty(errp));
3173 + GList *l = vma_reader_get_config_data(vmar);
3174 + while (l && l->data) {
3175 + VmaConfigData *cdata = (VmaConfigData *)l->data;
3176 + l = g_list_next(l);
3177 + if (strcmp(cdata->name, config_name) == 0) {
3179 + fwrite(cdata->data, cdata->len, 1, stdout);
3184 + vma_reader_destroy(vmar);
3189 + fprintf(stderr, "unable to find configuration data '%s'\n", config_name);
3196 +int main(int argc, char **argv)
3198 + const char *cmdname;
3199 + Error *main_loop_err = NULL;
3201 + error_set_progname(argv[0]);
3203 + if (qemu_init_main_loop(&main_loop_err)) {
3204 + g_error("%s", error_get_pretty(main_loop_err));
3213 + cmdname = argv[1];
3217 + if (!strcmp(cmdname, "list")) {
3218 + return list_content(argc, argv);
3219 + } else if (!strcmp(cmdname, "create")) {
3220 + return create_archive(argc, argv);
3221 + } else if (!strcmp(cmdname, "extract")) {
3222 + return extract_content(argc, argv);
3223 + } else if (!strcmp(cmdname, "verify")) {
3224 + return verify_content(argc, argv);
3225 + } else if (!strcmp(cmdname, "config")) {
3226 + return dump_config(argc, argv);
3232 diff --git a/vma.h b/vma.h
3233 new file mode 100644
3234 index 0000000000..fa6f4df7e7
3239 + * VMA: Virtual Machine Archive
3241 + * Copyright (C) Proxmox Server Solutions
3244 + * Dietmar Maurer (dietmar@proxmox.com)
3246 + * This work is licensed under the terms of the GNU GPL, version 2 or later.
3247 + * See the COPYING file in the top-level directory.
3251 +#ifndef BACKUP_VMA_H
3252 +#define BACKUP_VMA_H
3254 +#include <uuid/uuid.h>
3255 +#include "qapi/error.h"
3256 +#include "block/block.h"
3258 +#define VMA_BLOCK_BITS 12
3259 +#define VMA_BLOCK_SIZE (1<<VMA_BLOCK_BITS)
3260 +#define VMA_CLUSTER_BITS (VMA_BLOCK_BITS+4)
3261 +#define VMA_CLUSTER_SIZE (1<<VMA_CLUSTER_BITS)
3263 +#if VMA_CLUSTER_SIZE != 65536
3264 +#error unexpected cluster size
3267 +#define VMA_EXTENT_HEADER_SIZE 512
3268 +#define VMA_BLOCKS_PER_EXTENT 59
3269 +#define VMA_MAX_CONFIGS 256
3271 +#define VMA_MAX_EXTENT_SIZE \
3272 + (VMA_EXTENT_HEADER_SIZE+VMA_CLUSTER_SIZE*VMA_BLOCKS_PER_EXTENT)
3273 +#if VMA_MAX_EXTENT_SIZE != 3867136
3274 +#error unexpected VMA_EXTENT_SIZE
3277 +/* File Format Definitions */
3279 +#define VMA_MAGIC (GUINT32_TO_BE(('V'<<24)|('M'<<16)|('A'<<8)|0x00))
3280 +#define VMA_EXTENT_MAGIC (GUINT32_TO_BE(('V'<<24)|('M'<<16)|('A'<<8)|'E'))
3282 +typedef struct VmaDeviceInfoHeader {
3283 + uint32_t devname_ptr; /* offset into blob_buffer table */
3284 + uint32_t reserved0;
3285 + uint64_t size; /* device size in bytes */
3286 + uint64_t reserved1;
3287 + uint64_t reserved2;
3288 +} VmaDeviceInfoHeader;
3290 +typedef struct VmaHeader {
3293 + unsigned char uuid[16];
3295 + unsigned char md5sum[16];
3297 + uint32_t blob_buffer_offset;
3298 + uint32_t blob_buffer_size;
3299 + uint32_t header_size;
3301 + unsigned char reserved[1984];
3303 + uint32_t config_names[VMA_MAX_CONFIGS]; /* offset into blob_buffer table */
3304 + uint32_t config_data[VMA_MAX_CONFIGS]; /* offset into blob_buffer table */
3306 + uint32_t reserved1;
3308 + VmaDeviceInfoHeader dev_info[256];
3311 +typedef struct VmaExtentHeader {
3313 + uint16_t reserved1;
3314 + uint16_t block_count;
3315 + unsigned char uuid[16];
3316 + unsigned char md5sum[16];
3317 + uint64_t blockinfo[VMA_BLOCKS_PER_EXTENT];
3320 +/* functions/definitions to read/write vma files */
3322 +typedef struct VmaReader VmaReader;
3324 +typedef struct VmaWriter VmaWriter;
3326 +typedef struct VmaConfigData {
3332 +typedef struct VmaStreamInfo {
3334 + uint64_t cluster_count;
3335 + uint64_t transferred;
3336 + uint64_t zero_bytes;
3341 +typedef struct VmaStatus {
3344 + char errmsg[8192];
3345 + char uuid_str[37];
3346 + VmaStreamInfo stream_info[256];
3349 +typedef struct VmaDeviceInfo {
3350 + uint64_t size; /* device size in bytes */
3351 + const char *devname;
3354 +VmaWriter *vma_writer_create(const char *filename, uuid_t uuid, Error **errp);
3355 +int vma_writer_close(VmaWriter *vmaw, Error **errp);
3356 +void vma_writer_error_propagate(VmaWriter *vmaw, Error **errp);
3357 +void vma_writer_destroy(VmaWriter *vmaw);
3358 +int vma_writer_add_config(VmaWriter *vmaw, const char *name, gpointer data,
3360 +int vma_writer_register_stream(VmaWriter *vmaw, const char *devname,
3363 +int64_t coroutine_fn vma_writer_write(VmaWriter *vmaw, uint8_t dev_id,
3364 + int64_t cluster_num, unsigned char *buf,
3365 + size_t *zero_bytes);
3367 +int coroutine_fn vma_writer_close_stream(VmaWriter *vmaw, uint8_t dev_id);
3368 +int coroutine_fn vma_writer_flush_output(VmaWriter *vmaw);
3370 +int vma_writer_get_status(VmaWriter *vmaw, VmaStatus *status);
3371 +void vma_writer_set_error(VmaWriter *vmaw, const char *fmt, ...);
3374 +VmaReader *vma_reader_create(const char *filename, Error **errp);
3375 +void vma_reader_destroy(VmaReader *vmar);
3376 +VmaHeader *vma_reader_get_header(VmaReader *vmar);
3377 +GList *vma_reader_get_config_data(VmaReader *vmar);
3378 +VmaDeviceInfo *vma_reader_get_device_info(VmaReader *vmar, guint8 dev_id);
3379 +int vma_reader_register_bs(VmaReader *vmar, guint8 dev_id,
3380 + BlockBackend *target, bool write_zeroes,
3382 +int vma_reader_restore(VmaReader *vmar, int vmstate_fd, bool verbose,
3384 +int vma_reader_verify(VmaReader *vmar, bool verbose, Error **errp);
3386 +#endif /* BACKUP_VMA_H */