block: move qmp and info dump related code to block/qapi.c
[qemu.git] / qemu-img.c
blob5d1e480fcb4605f0e3b4e1321b7a8968b1759dda
1 /*
2 * QEMU disk image utility
4 * Copyright (c) 2003-2008 Fabrice Bellard
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 * THE SOFTWARE.
24 #include "qapi-visit.h"
25 #include "qapi/qmp-output-visitor.h"
26 #include "qapi/qmp/qjson.h"
27 #include "qemu-common.h"
28 #include "qemu/option.h"
29 #include "qemu/error-report.h"
30 #include "qemu/osdep.h"
31 #include "sysemu/sysemu.h"
32 #include "block/block_int.h"
33 #include "block/qapi.h"
34 #include <getopt.h>
35 #include <stdio.h>
36 #include <stdarg.h>
38 #ifdef _WIN32
39 #include <windows.h>
40 #endif
42 typedef struct img_cmd_t {
43 const char *name;
44 int (*handler)(int argc, char **argv);
45 } img_cmd_t;
47 enum {
48 OPTION_OUTPUT = 256,
49 OPTION_BACKING_CHAIN = 257,
52 typedef enum OutputFormat {
53 OFORMAT_JSON,
54 OFORMAT_HUMAN,
55 } OutputFormat;
57 /* Default to cache=writeback as data integrity is not important for qemu-tcg. */
58 #define BDRV_O_FLAGS BDRV_O_CACHE_WB
59 #define BDRV_DEFAULT_CACHE "writeback"
61 static void format_print(void *opaque, const char *name)
63 printf(" %s", name);
66 /* Please keep in synch with qemu-img.texi */
67 static void help(void)
69 const char *help_msg =
70 "qemu-img version " QEMU_VERSION ", Copyright (c) 2004-2008 Fabrice Bellard\n"
71 "usage: qemu-img command [command options]\n"
72 "QEMU disk image utility\n"
73 "\n"
74 "Command syntax:\n"
75 #define DEF(option, callback, arg_string) \
76 " " arg_string "\n"
77 #include "qemu-img-cmds.h"
78 #undef DEF
79 #undef GEN_DOCS
80 "\n"
81 "Command parameters:\n"
82 " 'filename' is a disk image filename\n"
83 " 'fmt' is the disk image format. It is guessed automatically in most cases\n"
84 " 'cache' is the cache mode used to write the output disk image, the valid\n"
85 " options are: 'none', 'writeback' (default, except for convert), 'writethrough',\n"
86 " 'directsync' and 'unsafe' (default for convert)\n"
87 " 'size' is the disk image size in bytes. Optional suffixes\n"
88 " 'k' or 'K' (kilobyte, 1024), 'M' (megabyte, 1024k), 'G' (gigabyte, 1024M)\n"
89 " and T (terabyte, 1024G) are supported. 'b' is ignored.\n"
90 " 'output_filename' is the destination disk image filename\n"
91 " 'output_fmt' is the destination format\n"
92 " 'options' is a comma separated list of format specific options in a\n"
93 " name=value format. Use -o ? for an overview of the options supported by the\n"
94 " used format\n"
95 " '-c' indicates that target image must be compressed (qcow format only)\n"
96 " '-u' enables unsafe rebasing. It is assumed that old and new backing file\n"
97 " match exactly. The image doesn't need a working backing file before\n"
98 " rebasing in this case (useful for renaming the backing file)\n"
99 " '-h' with or without a command shows this help and lists the supported formats\n"
100 " '-p' show progress of command (only certain commands)\n"
101 " '-q' use Quiet mode - do not print any output (except errors)\n"
102 " '-S' indicates the consecutive number of bytes that must contain only zeros\n"
103 " for qemu-img to create a sparse image during conversion\n"
104 " '--output' takes the format in which the output must be done (human or json)\n"
105 "\n"
106 "Parameters to check subcommand:\n"
107 " '-r' tries to repair any inconsistencies that are found during the check.\n"
108 " '-r leaks' repairs only cluster leaks, whereas '-r all' fixes all\n"
109 " kinds of errors, with a higher risk of choosing the wrong fix or\n"
110 " hiding corruption that has already occurred.\n"
111 "\n"
112 "Parameters to snapshot subcommand:\n"
113 " 'snapshot' is the name of the snapshot to create, apply or delete\n"
114 " '-a' applies a snapshot (revert disk to saved state)\n"
115 " '-c' creates a snapshot\n"
116 " '-d' deletes a snapshot\n"
117 " '-l' lists all snapshots in the given image\n"
118 "\n"
119 "Parameters to compare subcommand:\n"
120 " '-f' first image format\n"
121 " '-F' second image format\n"
122 " '-s' run in Strict mode - fail on different image size or sector allocation\n";
124 printf("%s\nSupported formats:", help_msg);
125 bdrv_iterate_format(format_print, NULL);
126 printf("\n");
127 exit(1);
130 static int qprintf(bool quiet, const char *fmt, ...)
132 int ret = 0;
133 if (!quiet) {
134 va_list args;
135 va_start(args, fmt);
136 ret = vprintf(fmt, args);
137 va_end(args);
139 return ret;
142 #if defined(WIN32)
143 /* XXX: put correct support for win32 */
144 static int read_password(char *buf, int buf_size)
146 int c, i;
147 printf("Password: ");
148 fflush(stdout);
149 i = 0;
150 for(;;) {
151 c = getchar();
152 if (c == '\n')
153 break;
154 if (i < (buf_size - 1))
155 buf[i++] = c;
157 buf[i] = '\0';
158 return 0;
161 #else
163 #include <termios.h>
165 static struct termios oldtty;
167 static void term_exit(void)
169 tcsetattr (0, TCSANOW, &oldtty);
172 static void term_init(void)
174 struct termios tty;
176 tcgetattr (0, &tty);
177 oldtty = tty;
179 tty.c_iflag &= ~(IGNBRK|BRKINT|PARMRK|ISTRIP
180 |INLCR|IGNCR|ICRNL|IXON);
181 tty.c_oflag |= OPOST;
182 tty.c_lflag &= ~(ECHO|ECHONL|ICANON|IEXTEN);
183 tty.c_cflag &= ~(CSIZE|PARENB);
184 tty.c_cflag |= CS8;
185 tty.c_cc[VMIN] = 1;
186 tty.c_cc[VTIME] = 0;
188 tcsetattr (0, TCSANOW, &tty);
190 atexit(term_exit);
193 static int read_password(char *buf, int buf_size)
195 uint8_t ch;
196 int i, ret;
198 printf("password: ");
199 fflush(stdout);
200 term_init();
201 i = 0;
202 for(;;) {
203 ret = read(0, &ch, 1);
204 if (ret == -1) {
205 if (errno == EAGAIN || errno == EINTR) {
206 continue;
207 } else {
208 ret = -1;
209 break;
211 } else if (ret == 0) {
212 ret = -1;
213 break;
214 } else {
215 if (ch == '\r') {
216 ret = 0;
217 break;
219 if (i < (buf_size - 1))
220 buf[i++] = ch;
223 term_exit();
224 buf[i] = '\0';
225 printf("\n");
226 return ret;
228 #endif
230 static int print_block_option_help(const char *filename, const char *fmt)
232 BlockDriver *drv, *proto_drv;
233 QEMUOptionParameter *create_options = NULL;
235 /* Find driver and parse its options */
236 drv = bdrv_find_format(fmt);
237 if (!drv) {
238 error_report("Unknown file format '%s'", fmt);
239 return 1;
242 proto_drv = bdrv_find_protocol(filename);
243 if (!proto_drv) {
244 error_report("Unknown protocol '%s'", filename);
245 return 1;
248 create_options = append_option_parameters(create_options,
249 drv->create_options);
250 create_options = append_option_parameters(create_options,
251 proto_drv->create_options);
252 print_option_help(create_options);
253 free_option_parameters(create_options);
254 return 0;
257 static BlockDriverState *bdrv_new_open(const char *filename,
258 const char *fmt,
259 int flags,
260 bool require_io,
261 bool quiet)
263 BlockDriverState *bs;
264 BlockDriver *drv;
265 char password[256];
266 int ret;
268 bs = bdrv_new("image");
270 if (fmt) {
271 drv = bdrv_find_format(fmt);
272 if (!drv) {
273 error_report("Unknown file format '%s'", fmt);
274 goto fail;
276 } else {
277 drv = NULL;
280 ret = bdrv_open(bs, filename, NULL, flags, drv);
281 if (ret < 0) {
282 error_report("Could not open '%s': %s", filename, strerror(-ret));
283 goto fail;
286 if (bdrv_is_encrypted(bs) && require_io) {
287 qprintf(quiet, "Disk image '%s' is encrypted.\n", filename);
288 if (read_password(password, sizeof(password)) < 0) {
289 error_report("No password given");
290 goto fail;
292 if (bdrv_set_key(bs, password) < 0) {
293 error_report("invalid password");
294 goto fail;
297 return bs;
298 fail:
299 if (bs) {
300 bdrv_delete(bs);
302 return NULL;
305 static int add_old_style_options(const char *fmt, QEMUOptionParameter *list,
306 const char *base_filename,
307 const char *base_fmt)
309 if (base_filename) {
310 if (set_option_parameter(list, BLOCK_OPT_BACKING_FILE, base_filename)) {
311 error_report("Backing file not supported for file format '%s'",
312 fmt);
313 return -1;
316 if (base_fmt) {
317 if (set_option_parameter(list, BLOCK_OPT_BACKING_FMT, base_fmt)) {
318 error_report("Backing file format not supported for file "
319 "format '%s'", fmt);
320 return -1;
323 return 0;
326 static int img_create(int argc, char **argv)
328 int c;
329 uint64_t img_size = -1;
330 const char *fmt = "raw";
331 const char *base_fmt = NULL;
332 const char *filename;
333 const char *base_filename = NULL;
334 char *options = NULL;
335 Error *local_err = NULL;
336 bool quiet = false;
338 for(;;) {
339 c = getopt(argc, argv, "F:b:f:he6o:q");
340 if (c == -1) {
341 break;
343 switch(c) {
344 case '?':
345 case 'h':
346 help();
347 break;
348 case 'F':
349 base_fmt = optarg;
350 break;
351 case 'b':
352 base_filename = optarg;
353 break;
354 case 'f':
355 fmt = optarg;
356 break;
357 case 'e':
358 error_report("option -e is deprecated, please use \'-o "
359 "encryption\' instead!");
360 return 1;
361 case '6':
362 error_report("option -6 is deprecated, please use \'-o "
363 "compat6\' instead!");
364 return 1;
365 case 'o':
366 options = optarg;
367 break;
368 case 'q':
369 quiet = true;
370 break;
374 /* Get the filename */
375 if (optind >= argc) {
376 help();
378 filename = argv[optind++];
380 /* Get image size, if specified */
381 if (optind < argc) {
382 int64_t sval;
383 char *end;
384 sval = strtosz_suffix(argv[optind++], &end, STRTOSZ_DEFSUFFIX_B);
385 if (sval < 0 || *end) {
386 if (sval == -ERANGE) {
387 error_report("Image size must be less than 8 EiB!");
388 } else {
389 error_report("Invalid image size specified! You may use k, M, "
390 "G or T suffixes for ");
391 error_report("kilobytes, megabytes, gigabytes and terabytes.");
393 return 1;
395 img_size = (uint64_t)sval;
398 if (options && is_help_option(options)) {
399 return print_block_option_help(filename, fmt);
402 bdrv_img_create(filename, fmt, base_filename, base_fmt,
403 options, img_size, BDRV_O_FLAGS, &local_err, quiet);
404 if (error_is_set(&local_err)) {
405 error_report("%s", error_get_pretty(local_err));
406 error_free(local_err);
407 return 1;
410 return 0;
413 static void dump_json_image_check(ImageCheck *check, bool quiet)
415 Error *errp = NULL;
416 QString *str;
417 QmpOutputVisitor *ov = qmp_output_visitor_new();
418 QObject *obj;
419 visit_type_ImageCheck(qmp_output_get_visitor(ov),
420 &check, NULL, &errp);
421 obj = qmp_output_get_qobject(ov);
422 str = qobject_to_json_pretty(obj);
423 assert(str != NULL);
424 qprintf(quiet, "%s\n", qstring_get_str(str));
425 qobject_decref(obj);
426 qmp_output_visitor_cleanup(ov);
427 QDECREF(str);
430 static void dump_human_image_check(ImageCheck *check, bool quiet)
432 if (!(check->corruptions || check->leaks || check->check_errors)) {
433 qprintf(quiet, "No errors were found on the image.\n");
434 } else {
435 if (check->corruptions) {
436 qprintf(quiet, "\n%" PRId64 " errors were found on the image.\n"
437 "Data may be corrupted, or further writes to the image "
438 "may corrupt it.\n",
439 check->corruptions);
442 if (check->leaks) {
443 qprintf(quiet,
444 "\n%" PRId64 " leaked clusters were found on the image.\n"
445 "This means waste of disk space, but no harm to data.\n",
446 check->leaks);
449 if (check->check_errors) {
450 qprintf(quiet,
451 "\n%" PRId64
452 " internal errors have occurred during the check.\n",
453 check->check_errors);
457 if (check->total_clusters != 0 && check->allocated_clusters != 0) {
458 qprintf(quiet, "%" PRId64 "/%" PRId64 " = %0.2f%% allocated, "
459 "%0.2f%% fragmented, %0.2f%% compressed clusters\n",
460 check->allocated_clusters, check->total_clusters,
461 check->allocated_clusters * 100.0 / check->total_clusters,
462 check->fragmented_clusters * 100.0 / check->allocated_clusters,
463 check->compressed_clusters * 100.0 /
464 check->allocated_clusters);
467 if (check->image_end_offset) {
468 qprintf(quiet,
469 "Image end offset: %" PRId64 "\n", check->image_end_offset);
473 static int collect_image_check(BlockDriverState *bs,
474 ImageCheck *check,
475 const char *filename,
476 const char *fmt,
477 int fix)
479 int ret;
480 BdrvCheckResult result;
482 ret = bdrv_check(bs, &result, fix);
483 if (ret < 0) {
484 return ret;
487 check->filename = g_strdup(filename);
488 check->format = g_strdup(bdrv_get_format_name(bs));
489 check->check_errors = result.check_errors;
490 check->corruptions = result.corruptions;
491 check->has_corruptions = result.corruptions != 0;
492 check->leaks = result.leaks;
493 check->has_leaks = result.leaks != 0;
494 check->corruptions_fixed = result.corruptions_fixed;
495 check->has_corruptions_fixed = result.corruptions != 0;
496 check->leaks_fixed = result.leaks_fixed;
497 check->has_leaks_fixed = result.leaks != 0;
498 check->image_end_offset = result.image_end_offset;
499 check->has_image_end_offset = result.image_end_offset != 0;
500 check->total_clusters = result.bfi.total_clusters;
501 check->has_total_clusters = result.bfi.total_clusters != 0;
502 check->allocated_clusters = result.bfi.allocated_clusters;
503 check->has_allocated_clusters = result.bfi.allocated_clusters != 0;
504 check->fragmented_clusters = result.bfi.fragmented_clusters;
505 check->has_fragmented_clusters = result.bfi.fragmented_clusters != 0;
506 check->compressed_clusters = result.bfi.compressed_clusters;
507 check->has_compressed_clusters = result.bfi.compressed_clusters != 0;
509 return 0;
513 * Checks an image for consistency. Exit codes:
515 * 0 - Check completed, image is good
516 * 1 - Check not completed because of internal errors
517 * 2 - Check completed, image is corrupted
518 * 3 - Check completed, image has leaked clusters, but is good otherwise
520 static int img_check(int argc, char **argv)
522 int c, ret;
523 OutputFormat output_format = OFORMAT_HUMAN;
524 const char *filename, *fmt, *output;
525 BlockDriverState *bs;
526 int fix = 0;
527 int flags = BDRV_O_FLAGS | BDRV_O_CHECK;
528 ImageCheck *check;
529 bool quiet = false;
531 fmt = NULL;
532 output = NULL;
533 for(;;) {
534 int option_index = 0;
535 static const struct option long_options[] = {
536 {"help", no_argument, 0, 'h'},
537 {"format", required_argument, 0, 'f'},
538 {"repair", no_argument, 0, 'r'},
539 {"output", required_argument, 0, OPTION_OUTPUT},
540 {0, 0, 0, 0}
542 c = getopt_long(argc, argv, "f:hr:q",
543 long_options, &option_index);
544 if (c == -1) {
545 break;
547 switch(c) {
548 case '?':
549 case 'h':
550 help();
551 break;
552 case 'f':
553 fmt = optarg;
554 break;
555 case 'r':
556 flags |= BDRV_O_RDWR;
558 if (!strcmp(optarg, "leaks")) {
559 fix = BDRV_FIX_LEAKS;
560 } else if (!strcmp(optarg, "all")) {
561 fix = BDRV_FIX_LEAKS | BDRV_FIX_ERRORS;
562 } else {
563 help();
565 break;
566 case OPTION_OUTPUT:
567 output = optarg;
568 break;
569 case 'q':
570 quiet = true;
571 break;
574 if (optind >= argc) {
575 help();
577 filename = argv[optind++];
579 if (output && !strcmp(output, "json")) {
580 output_format = OFORMAT_JSON;
581 } else if (output && !strcmp(output, "human")) {
582 output_format = OFORMAT_HUMAN;
583 } else if (output) {
584 error_report("--output must be used with human or json as argument.");
585 return 1;
588 bs = bdrv_new_open(filename, fmt, flags, true, quiet);
589 if (!bs) {
590 return 1;
593 check = g_new0(ImageCheck, 1);
594 ret = collect_image_check(bs, check, filename, fmt, fix);
596 if (ret == -ENOTSUP) {
597 if (output_format == OFORMAT_HUMAN) {
598 error_report("This image format does not support checks");
600 ret = 1;
601 goto fail;
604 if (check->corruptions_fixed || check->leaks_fixed) {
605 int corruptions_fixed, leaks_fixed;
607 leaks_fixed = check->leaks_fixed;
608 corruptions_fixed = check->corruptions_fixed;
610 if (output_format == OFORMAT_HUMAN) {
611 qprintf(quiet,
612 "The following inconsistencies were found and repaired:\n\n"
613 " %" PRId64 " leaked clusters\n"
614 " %" PRId64 " corruptions\n\n"
615 "Double checking the fixed image now...\n",
616 check->leaks_fixed,
617 check->corruptions_fixed);
620 ret = collect_image_check(bs, check, filename, fmt, 0);
622 check->leaks_fixed = leaks_fixed;
623 check->corruptions_fixed = corruptions_fixed;
626 switch (output_format) {
627 case OFORMAT_HUMAN:
628 dump_human_image_check(check, quiet);
629 break;
630 case OFORMAT_JSON:
631 dump_json_image_check(check, quiet);
632 break;
635 if (ret || check->check_errors) {
636 ret = 1;
637 goto fail;
640 if (check->corruptions) {
641 ret = 2;
642 } else if (check->leaks) {
643 ret = 3;
644 } else {
645 ret = 0;
648 fail:
649 qapi_free_ImageCheck(check);
650 bdrv_delete(bs);
652 return ret;
655 static int img_commit(int argc, char **argv)
657 int c, ret, flags;
658 const char *filename, *fmt, *cache;
659 BlockDriverState *bs;
660 bool quiet = false;
662 fmt = NULL;
663 cache = BDRV_DEFAULT_CACHE;
664 for(;;) {
665 c = getopt(argc, argv, "f:ht:q");
666 if (c == -1) {
667 break;
669 switch(c) {
670 case '?':
671 case 'h':
672 help();
673 break;
674 case 'f':
675 fmt = optarg;
676 break;
677 case 't':
678 cache = optarg;
679 break;
680 case 'q':
681 quiet = true;
682 break;
685 if (optind >= argc) {
686 help();
688 filename = argv[optind++];
690 flags = BDRV_O_RDWR;
691 ret = bdrv_parse_cache_flags(cache, &flags);
692 if (ret < 0) {
693 error_report("Invalid cache option: %s", cache);
694 return -1;
697 bs = bdrv_new_open(filename, fmt, flags, true, quiet);
698 if (!bs) {
699 return 1;
701 ret = bdrv_commit(bs);
702 switch(ret) {
703 case 0:
704 qprintf(quiet, "Image committed.\n");
705 break;
706 case -ENOENT:
707 error_report("No disk inserted");
708 break;
709 case -EACCES:
710 error_report("Image is read-only");
711 break;
712 case -ENOTSUP:
713 error_report("Image is already committed");
714 break;
715 default:
716 error_report("Error while committing image");
717 break;
720 bdrv_delete(bs);
721 if (ret) {
722 return 1;
724 return 0;
728 * Returns true iff the first sector pointed to by 'buf' contains at least
729 * a non-NUL byte.
731 * 'pnum' is set to the number of sectors (including and immediately following
732 * the first one) that are known to be in the same allocated/unallocated state.
734 static int is_allocated_sectors(const uint8_t *buf, int n, int *pnum)
736 bool is_zero;
737 int i;
739 if (n <= 0) {
740 *pnum = 0;
741 return 0;
743 is_zero = buffer_is_zero(buf, 512);
744 for(i = 1; i < n; i++) {
745 buf += 512;
746 if (is_zero != buffer_is_zero(buf, 512)) {
747 break;
750 *pnum = i;
751 return !is_zero;
755 * Like is_allocated_sectors, but if the buffer starts with a used sector,
756 * up to 'min' consecutive sectors containing zeros are ignored. This avoids
757 * breaking up write requests for only small sparse areas.
759 static int is_allocated_sectors_min(const uint8_t *buf, int n, int *pnum,
760 int min)
762 int ret;
763 int num_checked, num_used;
765 if (n < min) {
766 min = n;
769 ret = is_allocated_sectors(buf, n, pnum);
770 if (!ret) {
771 return ret;
774 num_used = *pnum;
775 buf += BDRV_SECTOR_SIZE * *pnum;
776 n -= *pnum;
777 num_checked = num_used;
779 while (n > 0) {
780 ret = is_allocated_sectors(buf, n, pnum);
782 buf += BDRV_SECTOR_SIZE * *pnum;
783 n -= *pnum;
784 num_checked += *pnum;
785 if (ret) {
786 num_used = num_checked;
787 } else if (*pnum >= min) {
788 break;
792 *pnum = num_used;
793 return 1;
797 * Compares two buffers sector by sector. Returns 0 if the first sector of both
798 * buffers matches, non-zero otherwise.
800 * pnum is set to the number of sectors (including and immediately following
801 * the first one) that are known to have the same comparison result
803 static int compare_sectors(const uint8_t *buf1, const uint8_t *buf2, int n,
804 int *pnum)
806 int res, i;
808 if (n <= 0) {
809 *pnum = 0;
810 return 0;
813 res = !!memcmp(buf1, buf2, 512);
814 for(i = 1; i < n; i++) {
815 buf1 += 512;
816 buf2 += 512;
818 if (!!memcmp(buf1, buf2, 512) != res) {
819 break;
823 *pnum = i;
824 return res;
827 #define IO_BUF_SIZE (2 * 1024 * 1024)
829 static int64_t sectors_to_bytes(int64_t sectors)
831 return sectors << BDRV_SECTOR_BITS;
834 static int64_t sectors_to_process(int64_t total, int64_t from)
836 return MIN(total - from, IO_BUF_SIZE >> BDRV_SECTOR_BITS);
840 * Check if passed sectors are empty (not allocated or contain only 0 bytes)
842 * Returns 0 in case sectors are filled with 0, 1 if sectors contain non-zero
843 * data and negative value on error.
845 * @param bs: Driver used for accessing file
846 * @param sect_num: Number of first sector to check
847 * @param sect_count: Number of sectors to check
848 * @param filename: Name of disk file we are checking (logging purpose)
849 * @param buffer: Allocated buffer for storing read data
850 * @param quiet: Flag for quiet mode
852 static int check_empty_sectors(BlockDriverState *bs, int64_t sect_num,
853 int sect_count, const char *filename,
854 uint8_t *buffer, bool quiet)
856 int pnum, ret = 0;
857 ret = bdrv_read(bs, sect_num, buffer, sect_count);
858 if (ret < 0) {
859 error_report("Error while reading offset %" PRId64 " of %s: %s",
860 sectors_to_bytes(sect_num), filename, strerror(-ret));
861 return ret;
863 ret = is_allocated_sectors(buffer, sect_count, &pnum);
864 if (ret || pnum != sect_count) {
865 qprintf(quiet, "Content mismatch at offset %" PRId64 "!\n",
866 sectors_to_bytes(ret ? sect_num : sect_num + pnum));
867 return 1;
870 return 0;
874 * Compares two images. Exit codes:
876 * 0 - Images are identical
877 * 1 - Images differ
878 * >1 - Error occurred
880 static int img_compare(int argc, char **argv)
882 const char *fmt1 = NULL, *fmt2 = NULL, *filename1, *filename2;
883 BlockDriverState *bs1, *bs2;
884 int64_t total_sectors1, total_sectors2;
885 uint8_t *buf1 = NULL, *buf2 = NULL;
886 int pnum1, pnum2;
887 int allocated1, allocated2;
888 int ret = 0; /* return value - 0 Ident, 1 Different, >1 Error */
889 bool progress = false, quiet = false, strict = false;
890 int64_t total_sectors;
891 int64_t sector_num = 0;
892 int64_t nb_sectors;
893 int c, pnum;
894 uint64_t bs_sectors;
895 uint64_t progress_base;
897 for (;;) {
898 c = getopt(argc, argv, "hpf:F:sq");
899 if (c == -1) {
900 break;
902 switch (c) {
903 case '?':
904 case 'h':
905 help();
906 break;
907 case 'f':
908 fmt1 = optarg;
909 break;
910 case 'F':
911 fmt2 = optarg;
912 break;
913 case 'p':
914 progress = true;
915 break;
916 case 'q':
917 quiet = true;
918 break;
919 case 's':
920 strict = true;
921 break;
925 /* Progress is not shown in Quiet mode */
926 if (quiet) {
927 progress = false;
931 if (optind > argc - 2) {
932 help();
934 filename1 = argv[optind++];
935 filename2 = argv[optind++];
937 /* Initialize before goto out */
938 qemu_progress_init(progress, 2.0);
940 bs1 = bdrv_new_open(filename1, fmt1, BDRV_O_FLAGS, true, quiet);
941 if (!bs1) {
942 error_report("Can't open file %s", filename1);
943 ret = 2;
944 goto out3;
947 bs2 = bdrv_new_open(filename2, fmt2, BDRV_O_FLAGS, true, quiet);
948 if (!bs2) {
949 error_report("Can't open file %s", filename2);
950 ret = 2;
951 goto out2;
954 buf1 = qemu_blockalign(bs1, IO_BUF_SIZE);
955 buf2 = qemu_blockalign(bs2, IO_BUF_SIZE);
956 bdrv_get_geometry(bs1, &bs_sectors);
957 total_sectors1 = bs_sectors;
958 bdrv_get_geometry(bs2, &bs_sectors);
959 total_sectors2 = bs_sectors;
960 total_sectors = MIN(total_sectors1, total_sectors2);
961 progress_base = MAX(total_sectors1, total_sectors2);
963 qemu_progress_print(0, 100);
965 if (strict && total_sectors1 != total_sectors2) {
966 ret = 1;
967 qprintf(quiet, "Strict mode: Image size mismatch!\n");
968 goto out;
971 for (;;) {
972 nb_sectors = sectors_to_process(total_sectors, sector_num);
973 if (nb_sectors <= 0) {
974 break;
976 allocated1 = bdrv_is_allocated_above(bs1, NULL, sector_num, nb_sectors,
977 &pnum1);
978 if (allocated1 < 0) {
979 ret = 3;
980 error_report("Sector allocation test failed for %s", filename1);
981 goto out;
984 allocated2 = bdrv_is_allocated_above(bs2, NULL, sector_num, nb_sectors,
985 &pnum2);
986 if (allocated2 < 0) {
987 ret = 3;
988 error_report("Sector allocation test failed for %s", filename2);
989 goto out;
991 nb_sectors = MIN(pnum1, pnum2);
993 if (allocated1 == allocated2) {
994 if (allocated1) {
995 ret = bdrv_read(bs1, sector_num, buf1, nb_sectors);
996 if (ret < 0) {
997 error_report("Error while reading offset %" PRId64 " of %s:"
998 " %s", sectors_to_bytes(sector_num), filename1,
999 strerror(-ret));
1000 ret = 4;
1001 goto out;
1003 ret = bdrv_read(bs2, sector_num, buf2, nb_sectors);
1004 if (ret < 0) {
1005 error_report("Error while reading offset %" PRId64
1006 " of %s: %s", sectors_to_bytes(sector_num),
1007 filename2, strerror(-ret));
1008 ret = 4;
1009 goto out;
1011 ret = compare_sectors(buf1, buf2, nb_sectors, &pnum);
1012 if (ret || pnum != nb_sectors) {
1013 ret = 1;
1014 qprintf(quiet, "Content mismatch at offset %" PRId64 "!\n",
1015 sectors_to_bytes(
1016 ret ? sector_num : sector_num + pnum));
1017 goto out;
1020 } else {
1021 if (strict) {
1022 ret = 1;
1023 qprintf(quiet, "Strict mode: Offset %" PRId64
1024 " allocation mismatch!\n",
1025 sectors_to_bytes(sector_num));
1026 goto out;
1029 if (allocated1) {
1030 ret = check_empty_sectors(bs1, sector_num, nb_sectors,
1031 filename1, buf1, quiet);
1032 } else {
1033 ret = check_empty_sectors(bs2, sector_num, nb_sectors,
1034 filename2, buf1, quiet);
1036 if (ret) {
1037 if (ret < 0) {
1038 ret = 4;
1039 error_report("Error while reading offset %" PRId64 ": %s",
1040 sectors_to_bytes(sector_num), strerror(-ret));
1042 goto out;
1045 sector_num += nb_sectors;
1046 qemu_progress_print(((float) nb_sectors / progress_base)*100, 100);
1049 if (total_sectors1 != total_sectors2) {
1050 BlockDriverState *bs_over;
1051 int64_t total_sectors_over;
1052 const char *filename_over;
1054 qprintf(quiet, "Warning: Image size mismatch!\n");
1055 if (total_sectors1 > total_sectors2) {
1056 total_sectors_over = total_sectors1;
1057 bs_over = bs1;
1058 filename_over = filename1;
1059 } else {
1060 total_sectors_over = total_sectors2;
1061 bs_over = bs2;
1062 filename_over = filename2;
1065 for (;;) {
1066 nb_sectors = sectors_to_process(total_sectors_over, sector_num);
1067 if (nb_sectors <= 0) {
1068 break;
1070 ret = bdrv_is_allocated_above(bs_over, NULL, sector_num,
1071 nb_sectors, &pnum);
1072 if (ret < 0) {
1073 ret = 3;
1074 error_report("Sector allocation test failed for %s",
1075 filename_over);
1076 goto out;
1079 nb_sectors = pnum;
1080 if (ret) {
1081 ret = check_empty_sectors(bs_over, sector_num, nb_sectors,
1082 filename_over, buf1, quiet);
1083 if (ret) {
1084 if (ret < 0) {
1085 ret = 4;
1086 error_report("Error while reading offset %" PRId64
1087 " of %s: %s", sectors_to_bytes(sector_num),
1088 filename_over, strerror(-ret));
1090 goto out;
1093 sector_num += nb_sectors;
1094 qemu_progress_print(((float) nb_sectors / progress_base)*100, 100);
1098 qprintf(quiet, "Images are identical.\n");
1099 ret = 0;
1101 out:
1102 bdrv_delete(bs2);
1103 qemu_vfree(buf1);
1104 qemu_vfree(buf2);
1105 out2:
1106 bdrv_delete(bs1);
1107 out3:
1108 qemu_progress_end();
1109 return ret;
1112 static int img_convert(int argc, char **argv)
1114 int c, ret = 0, n, n1, bs_n, bs_i, compress, cluster_size, cluster_sectors;
1115 int progress = 0, flags;
1116 const char *fmt, *out_fmt, *cache, *out_baseimg, *out_filename;
1117 BlockDriver *drv, *proto_drv;
1118 BlockDriverState **bs = NULL, *out_bs = NULL;
1119 int64_t total_sectors, nb_sectors, sector_num, bs_offset;
1120 uint64_t bs_sectors;
1121 uint8_t * buf = NULL;
1122 const uint8_t *buf1;
1123 BlockDriverInfo bdi;
1124 QEMUOptionParameter *param = NULL, *create_options = NULL;
1125 QEMUOptionParameter *out_baseimg_param;
1126 char *options = NULL;
1127 const char *snapshot_name = NULL;
1128 float local_progress = 0;
1129 int min_sparse = 8; /* Need at least 4k of zeros for sparse detection */
1130 bool quiet = false;
1132 fmt = NULL;
1133 out_fmt = "raw";
1134 cache = "unsafe";
1135 out_baseimg = NULL;
1136 compress = 0;
1137 for(;;) {
1138 c = getopt(argc, argv, "f:O:B:s:hce6o:pS:t:q");
1139 if (c == -1) {
1140 break;
1142 switch(c) {
1143 case '?':
1144 case 'h':
1145 help();
1146 break;
1147 case 'f':
1148 fmt = optarg;
1149 break;
1150 case 'O':
1151 out_fmt = optarg;
1152 break;
1153 case 'B':
1154 out_baseimg = optarg;
1155 break;
1156 case 'c':
1157 compress = 1;
1158 break;
1159 case 'e':
1160 error_report("option -e is deprecated, please use \'-o "
1161 "encryption\' instead!");
1162 return 1;
1163 case '6':
1164 error_report("option -6 is deprecated, please use \'-o "
1165 "compat6\' instead!");
1166 return 1;
1167 case 'o':
1168 options = optarg;
1169 break;
1170 case 's':
1171 snapshot_name = optarg;
1172 break;
1173 case 'S':
1175 int64_t sval;
1176 char *end;
1177 sval = strtosz_suffix(optarg, &end, STRTOSZ_DEFSUFFIX_B);
1178 if (sval < 0 || *end) {
1179 error_report("Invalid minimum zero buffer size for sparse output specified");
1180 return 1;
1183 min_sparse = sval / BDRV_SECTOR_SIZE;
1184 break;
1186 case 'p':
1187 progress = 1;
1188 break;
1189 case 't':
1190 cache = optarg;
1191 break;
1192 case 'q':
1193 quiet = true;
1194 break;
1198 if (quiet) {
1199 progress = 0;
1202 bs_n = argc - optind - 1;
1203 if (bs_n < 1) {
1204 help();
1207 out_filename = argv[argc - 1];
1209 /* Initialize before goto out */
1210 qemu_progress_init(progress, 2.0);
1212 if (options && is_help_option(options)) {
1213 ret = print_block_option_help(out_filename, out_fmt);
1214 goto out;
1217 if (bs_n > 1 && out_baseimg) {
1218 error_report("-B makes no sense when concatenating multiple input "
1219 "images");
1220 ret = -1;
1221 goto out;
1224 qemu_progress_print(0, 100);
1226 bs = g_malloc0(bs_n * sizeof(BlockDriverState *));
1228 total_sectors = 0;
1229 for (bs_i = 0; bs_i < bs_n; bs_i++) {
1230 bs[bs_i] = bdrv_new_open(argv[optind + bs_i], fmt, BDRV_O_FLAGS, true,
1231 quiet);
1232 if (!bs[bs_i]) {
1233 error_report("Could not open '%s'", argv[optind + bs_i]);
1234 ret = -1;
1235 goto out;
1237 bdrv_get_geometry(bs[bs_i], &bs_sectors);
1238 total_sectors += bs_sectors;
1241 if (snapshot_name != NULL) {
1242 if (bs_n > 1) {
1243 error_report("No support for concatenating multiple snapshot");
1244 ret = -1;
1245 goto out;
1247 if (bdrv_snapshot_load_tmp(bs[0], snapshot_name) < 0) {
1248 error_report("Failed to load snapshot");
1249 ret = -1;
1250 goto out;
1254 /* Find driver and parse its options */
1255 drv = bdrv_find_format(out_fmt);
1256 if (!drv) {
1257 error_report("Unknown file format '%s'", out_fmt);
1258 ret = -1;
1259 goto out;
1262 proto_drv = bdrv_find_protocol(out_filename);
1263 if (!proto_drv) {
1264 error_report("Unknown protocol '%s'", out_filename);
1265 ret = -1;
1266 goto out;
1269 create_options = append_option_parameters(create_options,
1270 drv->create_options);
1271 create_options = append_option_parameters(create_options,
1272 proto_drv->create_options);
1274 if (options) {
1275 param = parse_option_parameters(options, create_options, param);
1276 if (param == NULL) {
1277 error_report("Invalid options for file format '%s'.", out_fmt);
1278 ret = -1;
1279 goto out;
1281 } else {
1282 param = parse_option_parameters("", create_options, param);
1285 set_option_parameter_int(param, BLOCK_OPT_SIZE, total_sectors * 512);
1286 ret = add_old_style_options(out_fmt, param, out_baseimg, NULL);
1287 if (ret < 0) {
1288 goto out;
1291 /* Get backing file name if -o backing_file was used */
1292 out_baseimg_param = get_option_parameter(param, BLOCK_OPT_BACKING_FILE);
1293 if (out_baseimg_param) {
1294 out_baseimg = out_baseimg_param->value.s;
1297 /* Check if compression is supported */
1298 if (compress) {
1299 QEMUOptionParameter *encryption =
1300 get_option_parameter(param, BLOCK_OPT_ENCRYPT);
1301 QEMUOptionParameter *preallocation =
1302 get_option_parameter(param, BLOCK_OPT_PREALLOC);
1304 if (!drv->bdrv_write_compressed) {
1305 error_report("Compression not supported for this file format");
1306 ret = -1;
1307 goto out;
1310 if (encryption && encryption->value.n) {
1311 error_report("Compression and encryption not supported at "
1312 "the same time");
1313 ret = -1;
1314 goto out;
1317 if (preallocation && preallocation->value.s
1318 && strcmp(preallocation->value.s, "off"))
1320 error_report("Compression and preallocation not supported at "
1321 "the same time");
1322 ret = -1;
1323 goto out;
1327 /* Create the new image */
1328 ret = bdrv_create(drv, out_filename, param);
1329 if (ret < 0) {
1330 if (ret == -ENOTSUP) {
1331 error_report("Formatting not supported for file format '%s'",
1332 out_fmt);
1333 } else if (ret == -EFBIG) {
1334 error_report("The image size is too large for file format '%s'",
1335 out_fmt);
1336 } else {
1337 error_report("%s: error while converting %s: %s",
1338 out_filename, out_fmt, strerror(-ret));
1340 goto out;
1343 flags = BDRV_O_RDWR;
1344 ret = bdrv_parse_cache_flags(cache, &flags);
1345 if (ret < 0) {
1346 error_report("Invalid cache option: %s", cache);
1347 return -1;
1350 out_bs = bdrv_new_open(out_filename, out_fmt, flags, true, quiet);
1351 if (!out_bs) {
1352 ret = -1;
1353 goto out;
1356 bs_i = 0;
1357 bs_offset = 0;
1358 bdrv_get_geometry(bs[0], &bs_sectors);
1359 buf = qemu_blockalign(out_bs, IO_BUF_SIZE);
1361 if (compress) {
1362 ret = bdrv_get_info(out_bs, &bdi);
1363 if (ret < 0) {
1364 error_report("could not get block driver info");
1365 goto out;
1367 cluster_size = bdi.cluster_size;
1368 if (cluster_size <= 0 || cluster_size > IO_BUF_SIZE) {
1369 error_report("invalid cluster size");
1370 ret = -1;
1371 goto out;
1373 cluster_sectors = cluster_size >> 9;
1374 sector_num = 0;
1376 nb_sectors = total_sectors;
1377 if (nb_sectors != 0) {
1378 local_progress = (float)100 /
1379 (nb_sectors / MIN(nb_sectors, cluster_sectors));
1382 for(;;) {
1383 int64_t bs_num;
1384 int remainder;
1385 uint8_t *buf2;
1387 nb_sectors = total_sectors - sector_num;
1388 if (nb_sectors <= 0)
1389 break;
1390 if (nb_sectors >= cluster_sectors)
1391 n = cluster_sectors;
1392 else
1393 n = nb_sectors;
1395 bs_num = sector_num - bs_offset;
1396 assert (bs_num >= 0);
1397 remainder = n;
1398 buf2 = buf;
1399 while (remainder > 0) {
1400 int nlow;
1401 while (bs_num == bs_sectors) {
1402 bs_i++;
1403 assert (bs_i < bs_n);
1404 bs_offset += bs_sectors;
1405 bdrv_get_geometry(bs[bs_i], &bs_sectors);
1406 bs_num = 0;
1407 /* printf("changing part: sector_num=%" PRId64 ", "
1408 "bs_i=%d, bs_offset=%" PRId64 ", bs_sectors=%" PRId64
1409 "\n", sector_num, bs_i, bs_offset, bs_sectors); */
1411 assert (bs_num < bs_sectors);
1413 nlow = (remainder > bs_sectors - bs_num) ? bs_sectors - bs_num : remainder;
1415 ret = bdrv_read(bs[bs_i], bs_num, buf2, nlow);
1416 if (ret < 0) {
1417 error_report("error while reading sector %" PRId64 ": %s",
1418 bs_num, strerror(-ret));
1419 goto out;
1422 buf2 += nlow * 512;
1423 bs_num += nlow;
1425 remainder -= nlow;
1427 assert (remainder == 0);
1429 if (!buffer_is_zero(buf, n * BDRV_SECTOR_SIZE)) {
1430 ret = bdrv_write_compressed(out_bs, sector_num, buf, n);
1431 if (ret != 0) {
1432 error_report("error while compressing sector %" PRId64
1433 ": %s", sector_num, strerror(-ret));
1434 goto out;
1437 sector_num += n;
1438 qemu_progress_print(local_progress, 100);
1440 /* signal EOF to align */
1441 bdrv_write_compressed(out_bs, 0, NULL, 0);
1442 } else {
1443 int has_zero_init = bdrv_has_zero_init(out_bs);
1445 sector_num = 0; // total number of sectors converted so far
1446 nb_sectors = total_sectors - sector_num;
1447 if (nb_sectors != 0) {
1448 local_progress = (float)100 /
1449 (nb_sectors / MIN(nb_sectors, IO_BUF_SIZE / 512));
1452 for(;;) {
1453 nb_sectors = total_sectors - sector_num;
1454 if (nb_sectors <= 0) {
1455 break;
1457 if (nb_sectors >= (IO_BUF_SIZE / 512)) {
1458 n = (IO_BUF_SIZE / 512);
1459 } else {
1460 n = nb_sectors;
1463 while (sector_num - bs_offset >= bs_sectors) {
1464 bs_i ++;
1465 assert (bs_i < bs_n);
1466 bs_offset += bs_sectors;
1467 bdrv_get_geometry(bs[bs_i], &bs_sectors);
1468 /* printf("changing part: sector_num=%" PRId64 ", bs_i=%d, "
1469 "bs_offset=%" PRId64 ", bs_sectors=%" PRId64 "\n",
1470 sector_num, bs_i, bs_offset, bs_sectors); */
1473 if (n > bs_offset + bs_sectors - sector_num) {
1474 n = bs_offset + bs_sectors - sector_num;
1477 if (has_zero_init) {
1478 /* If the output image is being created as a copy on write image,
1479 assume that sectors which are unallocated in the input image
1480 are present in both the output's and input's base images (no
1481 need to copy them). */
1482 if (out_baseimg) {
1483 if (!bdrv_is_allocated(bs[bs_i], sector_num - bs_offset,
1484 n, &n1)) {
1485 sector_num += n1;
1486 continue;
1488 /* The next 'n1' sectors are allocated in the input image. Copy
1489 only those as they may be followed by unallocated sectors. */
1490 n = n1;
1492 } else {
1493 n1 = n;
1496 ret = bdrv_read(bs[bs_i], sector_num - bs_offset, buf, n);
1497 if (ret < 0) {
1498 error_report("error while reading sector %" PRId64 ": %s",
1499 sector_num - bs_offset, strerror(-ret));
1500 goto out;
1502 /* NOTE: at the same time we convert, we do not write zero
1503 sectors to have a chance to compress the image. Ideally, we
1504 should add a specific call to have the info to go faster */
1505 buf1 = buf;
1506 while (n > 0) {
1507 /* If the output image is being created as a copy on write image,
1508 copy all sectors even the ones containing only NUL bytes,
1509 because they may differ from the sectors in the base image.
1511 If the output is to a host device, we also write out
1512 sectors that are entirely 0, since whatever data was
1513 already there is garbage, not 0s. */
1514 if (!has_zero_init || out_baseimg ||
1515 is_allocated_sectors_min(buf1, n, &n1, min_sparse)) {
1516 ret = bdrv_write(out_bs, sector_num, buf1, n1);
1517 if (ret < 0) {
1518 error_report("error while writing sector %" PRId64
1519 ": %s", sector_num, strerror(-ret));
1520 goto out;
1523 sector_num += n1;
1524 n -= n1;
1525 buf1 += n1 * 512;
1527 qemu_progress_print(local_progress, 100);
1530 out:
1531 qemu_progress_end();
1532 free_option_parameters(create_options);
1533 free_option_parameters(param);
1534 qemu_vfree(buf);
1535 if (out_bs) {
1536 bdrv_delete(out_bs);
1538 if (bs) {
1539 for (bs_i = 0; bs_i < bs_n; bs_i++) {
1540 if (bs[bs_i]) {
1541 bdrv_delete(bs[bs_i]);
1544 g_free(bs);
1546 if (ret) {
1547 return 1;
1549 return 0;
1553 static void dump_snapshots(BlockDriverState *bs)
1555 QEMUSnapshotInfo *sn_tab, *sn;
1556 int nb_sns, i;
1557 char buf[256];
1559 nb_sns = bdrv_snapshot_list(bs, &sn_tab);
1560 if (nb_sns <= 0)
1561 return;
1562 printf("Snapshot list:\n");
1563 printf("%s\n", bdrv_snapshot_dump(buf, sizeof(buf), NULL));
1564 for(i = 0; i < nb_sns; i++) {
1565 sn = &sn_tab[i];
1566 printf("%s\n", bdrv_snapshot_dump(buf, sizeof(buf), sn));
1568 g_free(sn_tab);
1571 static void dump_json_image_info_list(ImageInfoList *list)
1573 Error *errp = NULL;
1574 QString *str;
1575 QmpOutputVisitor *ov = qmp_output_visitor_new();
1576 QObject *obj;
1577 visit_type_ImageInfoList(qmp_output_get_visitor(ov),
1578 &list, NULL, &errp);
1579 obj = qmp_output_get_qobject(ov);
1580 str = qobject_to_json_pretty(obj);
1581 assert(str != NULL);
1582 printf("%s\n", qstring_get_str(str));
1583 qobject_decref(obj);
1584 qmp_output_visitor_cleanup(ov);
1585 QDECREF(str);
1588 static void dump_json_image_info(ImageInfo *info)
1590 Error *errp = NULL;
1591 QString *str;
1592 QmpOutputVisitor *ov = qmp_output_visitor_new();
1593 QObject *obj;
1594 visit_type_ImageInfo(qmp_output_get_visitor(ov),
1595 &info, NULL, &errp);
1596 obj = qmp_output_get_qobject(ov);
1597 str = qobject_to_json_pretty(obj);
1598 assert(str != NULL);
1599 printf("%s\n", qstring_get_str(str));
1600 qobject_decref(obj);
1601 qmp_output_visitor_cleanup(ov);
1602 QDECREF(str);
1605 static void dump_human_image_info_list(ImageInfoList *list)
1607 ImageInfoList *elem;
1608 bool delim = false;
1610 for (elem = list; elem; elem = elem->next) {
1611 if (delim) {
1612 printf("\n");
1614 delim = true;
1616 bdrv_image_info_dump(elem->value);
1620 static gboolean str_equal_func(gconstpointer a, gconstpointer b)
1622 return strcmp(a, b) == 0;
1626 * Open an image file chain and return an ImageInfoList
1628 * @filename: topmost image filename
1629 * @fmt: topmost image format (may be NULL to autodetect)
1630 * @chain: true - enumerate entire backing file chain
1631 * false - only topmost image file
1633 * Returns a list of ImageInfo objects or NULL if there was an error opening an
1634 * image file. If there was an error a message will have been printed to
1635 * stderr.
1637 static ImageInfoList *collect_image_info_list(const char *filename,
1638 const char *fmt,
1639 bool chain)
1641 ImageInfoList *head = NULL;
1642 ImageInfoList **last = &head;
1643 GHashTable *filenames;
1645 filenames = g_hash_table_new_full(g_str_hash, str_equal_func, NULL, NULL);
1647 while (filename) {
1648 BlockDriverState *bs;
1649 ImageInfo *info;
1650 ImageInfoList *elem;
1652 if (g_hash_table_lookup_extended(filenames, filename, NULL, NULL)) {
1653 error_report("Backing file '%s' creates an infinite loop.",
1654 filename);
1655 goto err;
1657 g_hash_table_insert(filenames, (gpointer)filename, NULL);
1659 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS | BDRV_O_NO_BACKING,
1660 false, false);
1661 if (!bs) {
1662 goto err;
1665 info = g_new0(ImageInfo, 1);
1666 bdrv_collect_image_info(bs, info, filename);
1667 bdrv_collect_snapshots(bs, info);
1669 elem = g_new0(ImageInfoList, 1);
1670 elem->value = info;
1671 *last = elem;
1672 last = &elem->next;
1674 bdrv_delete(bs);
1676 filename = fmt = NULL;
1677 if (chain) {
1678 if (info->has_full_backing_filename) {
1679 filename = info->full_backing_filename;
1680 } else if (info->has_backing_filename) {
1681 filename = info->backing_filename;
1683 if (info->has_backing_filename_format) {
1684 fmt = info->backing_filename_format;
1688 g_hash_table_destroy(filenames);
1689 return head;
1691 err:
1692 qapi_free_ImageInfoList(head);
1693 g_hash_table_destroy(filenames);
1694 return NULL;
1697 static int img_info(int argc, char **argv)
1699 int c;
1700 OutputFormat output_format = OFORMAT_HUMAN;
1701 bool chain = false;
1702 const char *filename, *fmt, *output;
1703 ImageInfoList *list;
1705 fmt = NULL;
1706 output = NULL;
1707 for(;;) {
1708 int option_index = 0;
1709 static const struct option long_options[] = {
1710 {"help", no_argument, 0, 'h'},
1711 {"format", required_argument, 0, 'f'},
1712 {"output", required_argument, 0, OPTION_OUTPUT},
1713 {"backing-chain", no_argument, 0, OPTION_BACKING_CHAIN},
1714 {0, 0, 0, 0}
1716 c = getopt_long(argc, argv, "f:h",
1717 long_options, &option_index);
1718 if (c == -1) {
1719 break;
1721 switch(c) {
1722 case '?':
1723 case 'h':
1724 help();
1725 break;
1726 case 'f':
1727 fmt = optarg;
1728 break;
1729 case OPTION_OUTPUT:
1730 output = optarg;
1731 break;
1732 case OPTION_BACKING_CHAIN:
1733 chain = true;
1734 break;
1737 if (optind >= argc) {
1738 help();
1740 filename = argv[optind++];
1742 if (output && !strcmp(output, "json")) {
1743 output_format = OFORMAT_JSON;
1744 } else if (output && !strcmp(output, "human")) {
1745 output_format = OFORMAT_HUMAN;
1746 } else if (output) {
1747 error_report("--output must be used with human or json as argument.");
1748 return 1;
1751 list = collect_image_info_list(filename, fmt, chain);
1752 if (!list) {
1753 return 1;
1756 switch (output_format) {
1757 case OFORMAT_HUMAN:
1758 dump_human_image_info_list(list);
1759 break;
1760 case OFORMAT_JSON:
1761 if (chain) {
1762 dump_json_image_info_list(list);
1763 } else {
1764 dump_json_image_info(list->value);
1766 break;
1769 qapi_free_ImageInfoList(list);
1770 return 0;
1773 #define SNAPSHOT_LIST 1
1774 #define SNAPSHOT_CREATE 2
1775 #define SNAPSHOT_APPLY 3
1776 #define SNAPSHOT_DELETE 4
1778 static int img_snapshot(int argc, char **argv)
1780 BlockDriverState *bs;
1781 QEMUSnapshotInfo sn;
1782 char *filename, *snapshot_name = NULL;
1783 int c, ret = 0, bdrv_oflags;
1784 int action = 0;
1785 qemu_timeval tv;
1786 bool quiet = false;
1788 bdrv_oflags = BDRV_O_FLAGS | BDRV_O_RDWR;
1789 /* Parse commandline parameters */
1790 for(;;) {
1791 c = getopt(argc, argv, "la:c:d:hq");
1792 if (c == -1) {
1793 break;
1795 switch(c) {
1796 case '?':
1797 case 'h':
1798 help();
1799 return 0;
1800 case 'l':
1801 if (action) {
1802 help();
1803 return 0;
1805 action = SNAPSHOT_LIST;
1806 bdrv_oflags &= ~BDRV_O_RDWR; /* no need for RW */
1807 break;
1808 case 'a':
1809 if (action) {
1810 help();
1811 return 0;
1813 action = SNAPSHOT_APPLY;
1814 snapshot_name = optarg;
1815 break;
1816 case 'c':
1817 if (action) {
1818 help();
1819 return 0;
1821 action = SNAPSHOT_CREATE;
1822 snapshot_name = optarg;
1823 break;
1824 case 'd':
1825 if (action) {
1826 help();
1827 return 0;
1829 action = SNAPSHOT_DELETE;
1830 snapshot_name = optarg;
1831 break;
1832 case 'q':
1833 quiet = true;
1834 break;
1838 if (optind >= argc) {
1839 help();
1841 filename = argv[optind++];
1843 /* Open the image */
1844 bs = bdrv_new_open(filename, NULL, bdrv_oflags, true, quiet);
1845 if (!bs) {
1846 return 1;
1849 /* Perform the requested action */
1850 switch(action) {
1851 case SNAPSHOT_LIST:
1852 dump_snapshots(bs);
1853 break;
1855 case SNAPSHOT_CREATE:
1856 memset(&sn, 0, sizeof(sn));
1857 pstrcpy(sn.name, sizeof(sn.name), snapshot_name);
1859 qemu_gettimeofday(&tv);
1860 sn.date_sec = tv.tv_sec;
1861 sn.date_nsec = tv.tv_usec * 1000;
1863 ret = bdrv_snapshot_create(bs, &sn);
1864 if (ret) {
1865 error_report("Could not create snapshot '%s': %d (%s)",
1866 snapshot_name, ret, strerror(-ret));
1868 break;
1870 case SNAPSHOT_APPLY:
1871 ret = bdrv_snapshot_goto(bs, snapshot_name);
1872 if (ret) {
1873 error_report("Could not apply snapshot '%s': %d (%s)",
1874 snapshot_name, ret, strerror(-ret));
1876 break;
1878 case SNAPSHOT_DELETE:
1879 ret = bdrv_snapshot_delete(bs, snapshot_name);
1880 if (ret) {
1881 error_report("Could not delete snapshot '%s': %d (%s)",
1882 snapshot_name, ret, strerror(-ret));
1884 break;
1887 /* Cleanup */
1888 bdrv_delete(bs);
1889 if (ret) {
1890 return 1;
1892 return 0;
1895 static int img_rebase(int argc, char **argv)
1897 BlockDriverState *bs, *bs_old_backing = NULL, *bs_new_backing = NULL;
1898 BlockDriver *old_backing_drv, *new_backing_drv;
1899 char *filename;
1900 const char *fmt, *cache, *out_basefmt, *out_baseimg;
1901 int c, flags, ret;
1902 int unsafe = 0;
1903 int progress = 0;
1904 bool quiet = false;
1906 /* Parse commandline parameters */
1907 fmt = NULL;
1908 cache = BDRV_DEFAULT_CACHE;
1909 out_baseimg = NULL;
1910 out_basefmt = NULL;
1911 for(;;) {
1912 c = getopt(argc, argv, "uhf:F:b:pt:q");
1913 if (c == -1) {
1914 break;
1916 switch(c) {
1917 case '?':
1918 case 'h':
1919 help();
1920 return 0;
1921 case 'f':
1922 fmt = optarg;
1923 break;
1924 case 'F':
1925 out_basefmt = optarg;
1926 break;
1927 case 'b':
1928 out_baseimg = optarg;
1929 break;
1930 case 'u':
1931 unsafe = 1;
1932 break;
1933 case 'p':
1934 progress = 1;
1935 break;
1936 case 't':
1937 cache = optarg;
1938 break;
1939 case 'q':
1940 quiet = true;
1941 break;
1945 if (quiet) {
1946 progress = 0;
1949 if ((optind >= argc) || (!unsafe && !out_baseimg)) {
1950 help();
1952 filename = argv[optind++];
1954 qemu_progress_init(progress, 2.0);
1955 qemu_progress_print(0, 100);
1957 flags = BDRV_O_RDWR | (unsafe ? BDRV_O_NO_BACKING : 0);
1958 ret = bdrv_parse_cache_flags(cache, &flags);
1959 if (ret < 0) {
1960 error_report("Invalid cache option: %s", cache);
1961 return -1;
1965 * Open the images.
1967 * Ignore the old backing file for unsafe rebase in case we want to correct
1968 * the reference to a renamed or moved backing file.
1970 bs = bdrv_new_open(filename, fmt, flags, true, quiet);
1971 if (!bs) {
1972 return 1;
1975 /* Find the right drivers for the backing files */
1976 old_backing_drv = NULL;
1977 new_backing_drv = NULL;
1979 if (!unsafe && bs->backing_format[0] != '\0') {
1980 old_backing_drv = bdrv_find_format(bs->backing_format);
1981 if (old_backing_drv == NULL) {
1982 error_report("Invalid format name: '%s'", bs->backing_format);
1983 ret = -1;
1984 goto out;
1988 if (out_basefmt != NULL) {
1989 new_backing_drv = bdrv_find_format(out_basefmt);
1990 if (new_backing_drv == NULL) {
1991 error_report("Invalid format name: '%s'", out_basefmt);
1992 ret = -1;
1993 goto out;
1997 /* For safe rebasing we need to compare old and new backing file */
1998 if (unsafe) {
1999 /* Make the compiler happy */
2000 bs_old_backing = NULL;
2001 bs_new_backing = NULL;
2002 } else {
2003 char backing_name[1024];
2005 bs_old_backing = bdrv_new("old_backing");
2006 bdrv_get_backing_filename(bs, backing_name, sizeof(backing_name));
2007 ret = bdrv_open(bs_old_backing, backing_name, NULL, BDRV_O_FLAGS,
2008 old_backing_drv);
2009 if (ret) {
2010 error_report("Could not open old backing file '%s'", backing_name);
2011 goto out;
2013 if (out_baseimg[0]) {
2014 bs_new_backing = bdrv_new("new_backing");
2015 ret = bdrv_open(bs_new_backing, out_baseimg, NULL, BDRV_O_FLAGS,
2016 new_backing_drv);
2017 if (ret) {
2018 error_report("Could not open new backing file '%s'",
2019 out_baseimg);
2020 goto out;
2026 * Check each unallocated cluster in the COW file. If it is unallocated,
2027 * accesses go to the backing file. We must therefore compare this cluster
2028 * in the old and new backing file, and if they differ we need to copy it
2029 * from the old backing file into the COW file.
2031 * If qemu-img crashes during this step, no harm is done. The content of
2032 * the image is the same as the original one at any time.
2034 if (!unsafe) {
2035 uint64_t num_sectors;
2036 uint64_t old_backing_num_sectors;
2037 uint64_t new_backing_num_sectors = 0;
2038 uint64_t sector;
2039 int n;
2040 uint8_t * buf_old;
2041 uint8_t * buf_new;
2042 float local_progress = 0;
2044 buf_old = qemu_blockalign(bs, IO_BUF_SIZE);
2045 buf_new = qemu_blockalign(bs, IO_BUF_SIZE);
2047 bdrv_get_geometry(bs, &num_sectors);
2048 bdrv_get_geometry(bs_old_backing, &old_backing_num_sectors);
2049 if (bs_new_backing) {
2050 bdrv_get_geometry(bs_new_backing, &new_backing_num_sectors);
2053 if (num_sectors != 0) {
2054 local_progress = (float)100 /
2055 (num_sectors / MIN(num_sectors, IO_BUF_SIZE / 512));
2058 for (sector = 0; sector < num_sectors; sector += n) {
2060 /* How many sectors can we handle with the next read? */
2061 if (sector + (IO_BUF_SIZE / 512) <= num_sectors) {
2062 n = (IO_BUF_SIZE / 512);
2063 } else {
2064 n = num_sectors - sector;
2067 /* If the cluster is allocated, we don't need to take action */
2068 ret = bdrv_is_allocated(bs, sector, n, &n);
2069 if (ret) {
2070 continue;
2074 * Read old and new backing file and take into consideration that
2075 * backing files may be smaller than the COW image.
2077 if (sector >= old_backing_num_sectors) {
2078 memset(buf_old, 0, n * BDRV_SECTOR_SIZE);
2079 } else {
2080 if (sector + n > old_backing_num_sectors) {
2081 n = old_backing_num_sectors - sector;
2084 ret = bdrv_read(bs_old_backing, sector, buf_old, n);
2085 if (ret < 0) {
2086 error_report("error while reading from old backing file");
2087 goto out;
2091 if (sector >= new_backing_num_sectors || !bs_new_backing) {
2092 memset(buf_new, 0, n * BDRV_SECTOR_SIZE);
2093 } else {
2094 if (sector + n > new_backing_num_sectors) {
2095 n = new_backing_num_sectors - sector;
2098 ret = bdrv_read(bs_new_backing, sector, buf_new, n);
2099 if (ret < 0) {
2100 error_report("error while reading from new backing file");
2101 goto out;
2105 /* If they differ, we need to write to the COW file */
2106 uint64_t written = 0;
2108 while (written < n) {
2109 int pnum;
2111 if (compare_sectors(buf_old + written * 512,
2112 buf_new + written * 512, n - written, &pnum))
2114 ret = bdrv_write(bs, sector + written,
2115 buf_old + written * 512, pnum);
2116 if (ret < 0) {
2117 error_report("Error while writing to COW image: %s",
2118 strerror(-ret));
2119 goto out;
2123 written += pnum;
2125 qemu_progress_print(local_progress, 100);
2128 qemu_vfree(buf_old);
2129 qemu_vfree(buf_new);
2133 * Change the backing file. All clusters that are different from the old
2134 * backing file are overwritten in the COW file now, so the visible content
2135 * doesn't change when we switch the backing file.
2137 if (out_baseimg && *out_baseimg) {
2138 ret = bdrv_change_backing_file(bs, out_baseimg, out_basefmt);
2139 } else {
2140 ret = bdrv_change_backing_file(bs, NULL, NULL);
2143 if (ret == -ENOSPC) {
2144 error_report("Could not change the backing file to '%s': No "
2145 "space left in the file header", out_baseimg);
2146 } else if (ret < 0) {
2147 error_report("Could not change the backing file to '%s': %s",
2148 out_baseimg, strerror(-ret));
2151 qemu_progress_print(100, 0);
2153 * TODO At this point it is possible to check if any clusters that are
2154 * allocated in the COW file are the same in the backing file. If so, they
2155 * could be dropped from the COW file. Don't do this before switching the
2156 * backing file, in case of a crash this would lead to corruption.
2158 out:
2159 qemu_progress_end();
2160 /* Cleanup */
2161 if (!unsafe) {
2162 if (bs_old_backing != NULL) {
2163 bdrv_delete(bs_old_backing);
2165 if (bs_new_backing != NULL) {
2166 bdrv_delete(bs_new_backing);
2170 bdrv_delete(bs);
2171 if (ret) {
2172 return 1;
2174 return 0;
2177 static int img_resize(int argc, char **argv)
2179 int c, ret, relative;
2180 const char *filename, *fmt, *size;
2181 int64_t n, total_size;
2182 bool quiet = false;
2183 BlockDriverState *bs = NULL;
2184 QemuOpts *param;
2185 static QemuOptsList resize_options = {
2186 .name = "resize_options",
2187 .head = QTAILQ_HEAD_INITIALIZER(resize_options.head),
2188 .desc = {
2190 .name = BLOCK_OPT_SIZE,
2191 .type = QEMU_OPT_SIZE,
2192 .help = "Virtual disk size"
2193 }, {
2194 /* end of list */
2199 /* Remove size from argv manually so that negative numbers are not treated
2200 * as options by getopt. */
2201 if (argc < 3) {
2202 help();
2203 return 1;
2206 size = argv[--argc];
2208 /* Parse getopt arguments */
2209 fmt = NULL;
2210 for(;;) {
2211 c = getopt(argc, argv, "f:hq");
2212 if (c == -1) {
2213 break;
2215 switch(c) {
2216 case '?':
2217 case 'h':
2218 help();
2219 break;
2220 case 'f':
2221 fmt = optarg;
2222 break;
2223 case 'q':
2224 quiet = true;
2225 break;
2228 if (optind >= argc) {
2229 help();
2231 filename = argv[optind++];
2233 /* Choose grow, shrink, or absolute resize mode */
2234 switch (size[0]) {
2235 case '+':
2236 relative = 1;
2237 size++;
2238 break;
2239 case '-':
2240 relative = -1;
2241 size++;
2242 break;
2243 default:
2244 relative = 0;
2245 break;
2248 /* Parse size */
2249 param = qemu_opts_create_nofail(&resize_options);
2250 if (qemu_opt_set(param, BLOCK_OPT_SIZE, size)) {
2251 /* Error message already printed when size parsing fails */
2252 ret = -1;
2253 qemu_opts_del(param);
2254 goto out;
2256 n = qemu_opt_get_size(param, BLOCK_OPT_SIZE, 0);
2257 qemu_opts_del(param);
2259 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS | BDRV_O_RDWR, true, quiet);
2260 if (!bs) {
2261 ret = -1;
2262 goto out;
2265 if (relative) {
2266 total_size = bdrv_getlength(bs) + n * relative;
2267 } else {
2268 total_size = n;
2270 if (total_size <= 0) {
2271 error_report("New image size must be positive");
2272 ret = -1;
2273 goto out;
2276 ret = bdrv_truncate(bs, total_size);
2277 switch (ret) {
2278 case 0:
2279 qprintf(quiet, "Image resized.\n");
2280 break;
2281 case -ENOTSUP:
2282 error_report("This image does not support resize");
2283 break;
2284 case -EACCES:
2285 error_report("Image is read-only");
2286 break;
2287 default:
2288 error_report("Error resizing image (%d)", -ret);
2289 break;
2291 out:
2292 if (bs) {
2293 bdrv_delete(bs);
2295 if (ret) {
2296 return 1;
2298 return 0;
2301 static const img_cmd_t img_cmds[] = {
2302 #define DEF(option, callback, arg_string) \
2303 { option, callback },
2304 #include "qemu-img-cmds.h"
2305 #undef DEF
2306 #undef GEN_DOCS
2307 { NULL, NULL, },
2310 int main(int argc, char **argv)
2312 const img_cmd_t *cmd;
2313 const char *cmdname;
2315 error_set_progname(argv[0]);
2317 qemu_init_main_loop();
2318 bdrv_init();
2319 if (argc < 2)
2320 help();
2321 cmdname = argv[1];
2322 argc--; argv++;
2324 /* find the command */
2325 for(cmd = img_cmds; cmd->name != NULL; cmd++) {
2326 if (!strcmp(cmdname, cmd->name)) {
2327 return cmd->handler(argc, argv);
2331 /* not found */
2332 help();
2333 return 0;