img_convert(): Only try to free bs[] entries if bs is valid.
[qemu.git] / qemu-img.c
blobaded72d49fa79730126562dd28f9a8bb2353dda5
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 "qemu-common.h"
25 #include "qemu-option.h"
26 #include "osdep.h"
27 #include "sysemu.h"
28 #include "block_int.h"
29 #include <stdio.h>
31 #ifdef _WIN32
32 #include <windows.h>
33 #endif
35 typedef struct img_cmd_t {
36 const char *name;
37 int (*handler)(int argc, char **argv);
38 } img_cmd_t;
40 /* Default to cache=writeback as data integrity is not important for qemu-tcg. */
41 #define BDRV_O_FLAGS BDRV_O_CACHE_WB
43 static void GCC_FMT_ATTR(1, 2) error(const char *fmt, ...)
45 va_list ap;
46 va_start(ap, fmt);
47 fprintf(stderr, "qemu-img: ");
48 vfprintf(stderr, fmt, ap);
49 fprintf(stderr, "\n");
50 va_end(ap);
53 static void format_print(void *opaque, const char *name)
55 printf(" %s", name);
58 /* Please keep in synch with qemu-img.texi */
59 static void help(void)
61 const char *help_msg =
62 "qemu-img version " QEMU_VERSION ", Copyright (c) 2004-2008 Fabrice Bellard\n"
63 "usage: qemu-img command [command options]\n"
64 "QEMU disk image utility\n"
65 "\n"
66 "Command syntax:\n"
67 #define DEF(option, callback, arg_string) \
68 " " arg_string "\n"
69 #include "qemu-img-cmds.h"
70 #undef DEF
71 #undef GEN_DOCS
72 "\n"
73 "Command parameters:\n"
74 " 'filename' is a disk image filename\n"
75 " 'fmt' is the disk image format. It is guessed automatically in most cases\n"
76 " 'size' is the disk image size in bytes. Optional suffixes\n"
77 " 'k' or 'K' (kilobyte, 1024), 'M' (megabyte, 1024k), 'G' (gigabyte, 1024M)\n"
78 " and T (terabyte, 1024G) are supported. 'b' is ignored.\n"
79 " 'output_filename' is the destination disk image filename\n"
80 " 'output_fmt' is the destination format\n"
81 " 'options' is a comma separated list of format specific options in a\n"
82 " name=value format. Use -o ? for an overview of the options supported by the\n"
83 " used format\n"
84 " '-c' indicates that target image must be compressed (qcow format only)\n"
85 " '-u' enables unsafe rebasing. It is assumed that old and new backing file\n"
86 " match exactly. The image doesn't need a working backing file before\n"
87 " rebasing in this case (useful for renaming the backing file)\n"
88 " '-h' with or without a command shows this help and lists the supported formats\n"
89 "\n"
90 "Parameters to snapshot subcommand:\n"
91 " 'snapshot' is the name of the snapshot to create, apply or delete\n"
92 " '-a' applies a snapshot (revert disk to saved state)\n"
93 " '-c' creates a snapshot\n"
94 " '-d' deletes a snapshot\n"
95 " '-l' lists all snapshots in the given image\n";
97 printf("%s\nSupported formats:", help_msg);
98 bdrv_iterate_format(format_print, NULL);
99 printf("\n");
100 exit(1);
103 #if defined(WIN32)
104 /* XXX: put correct support for win32 */
105 static int read_password(char *buf, int buf_size)
107 int c, i;
108 printf("Password: ");
109 fflush(stdout);
110 i = 0;
111 for(;;) {
112 c = getchar();
113 if (c == '\n')
114 break;
115 if (i < (buf_size - 1))
116 buf[i++] = c;
118 buf[i] = '\0';
119 return 0;
122 #else
124 #include <termios.h>
126 static struct termios oldtty;
128 static void term_exit(void)
130 tcsetattr (0, TCSANOW, &oldtty);
133 static void term_init(void)
135 struct termios tty;
137 tcgetattr (0, &tty);
138 oldtty = tty;
140 tty.c_iflag &= ~(IGNBRK|BRKINT|PARMRK|ISTRIP
141 |INLCR|IGNCR|ICRNL|IXON);
142 tty.c_oflag |= OPOST;
143 tty.c_lflag &= ~(ECHO|ECHONL|ICANON|IEXTEN);
144 tty.c_cflag &= ~(CSIZE|PARENB);
145 tty.c_cflag |= CS8;
146 tty.c_cc[VMIN] = 1;
147 tty.c_cc[VTIME] = 0;
149 tcsetattr (0, TCSANOW, &tty);
151 atexit(term_exit);
154 static int read_password(char *buf, int buf_size)
156 uint8_t ch;
157 int i, ret;
159 printf("password: ");
160 fflush(stdout);
161 term_init();
162 i = 0;
163 for(;;) {
164 ret = read(0, &ch, 1);
165 if (ret == -1) {
166 if (errno == EAGAIN || errno == EINTR) {
167 continue;
168 } else {
169 ret = -1;
170 break;
172 } else if (ret == 0) {
173 ret = -1;
174 break;
175 } else {
176 if (ch == '\r') {
177 ret = 0;
178 break;
180 if (i < (buf_size - 1))
181 buf[i++] = ch;
184 term_exit();
185 buf[i] = '\0';
186 printf("\n");
187 return ret;
189 #endif
191 static BlockDriverState *bdrv_new_open(const char *filename,
192 const char *fmt,
193 int flags)
195 BlockDriverState *bs;
196 BlockDriver *drv;
197 char password[256];
199 bs = bdrv_new("");
200 if (!bs) {
201 error("Not enough memory");
202 goto fail;
204 if (fmt) {
205 drv = bdrv_find_format(fmt);
206 if (!drv) {
207 error("Unknown file format '%s'", fmt);
208 goto fail;
210 } else {
211 drv = NULL;
213 if (bdrv_open(bs, filename, flags, drv) < 0) {
214 error("Could not open '%s'", filename);
215 goto fail;
217 if (bdrv_is_encrypted(bs)) {
218 printf("Disk image '%s' is encrypted.\n", filename);
219 if (read_password(password, sizeof(password)) < 0) {
220 error("No password given");
221 goto fail;
223 if (bdrv_set_key(bs, password) < 0) {
224 error("invalid password");
225 goto fail;
228 return bs;
229 fail:
230 if (bs) {
231 bdrv_delete(bs);
233 return NULL;
236 static int add_old_style_options(const char *fmt, QEMUOptionParameter *list,
237 int flags, const char *base_filename, const char *base_fmt)
239 if (flags & BLOCK_FLAG_ENCRYPT) {
240 if (set_option_parameter(list, BLOCK_OPT_ENCRYPT, "on")) {
241 error("Encryption not supported for file format '%s'", fmt);
242 return -1;
245 if (flags & BLOCK_FLAG_COMPAT6) {
246 if (set_option_parameter(list, BLOCK_OPT_COMPAT6, "on")) {
247 error("VMDK version 6 not supported for file format '%s'", fmt);
248 return -1;
252 if (base_filename) {
253 if (set_option_parameter(list, BLOCK_OPT_BACKING_FILE, base_filename)) {
254 error("Backing file not supported for file format '%s'", fmt);
255 return -1;
258 if (base_fmt) {
259 if (set_option_parameter(list, BLOCK_OPT_BACKING_FMT, base_fmt)) {
260 error("Backing file format not supported for file format '%s'", fmt);
261 return -1;
264 return 0;
267 static int img_create(int argc, char **argv)
269 int c, ret = 0, flags;
270 const char *fmt = "raw";
271 const char *base_fmt = NULL;
272 const char *filename;
273 const char *base_filename = NULL;
274 BlockDriver *drv, *proto_drv;
275 QEMUOptionParameter *param = NULL, *create_options = NULL;
276 char *options = NULL;
278 flags = 0;
279 for(;;) {
280 c = getopt(argc, argv, "F:b:f:he6o:");
281 if (c == -1)
282 break;
283 switch(c) {
284 case 'h':
285 help();
286 break;
287 case 'F':
288 base_fmt = optarg;
289 break;
290 case 'b':
291 base_filename = optarg;
292 break;
293 case 'f':
294 fmt = optarg;
295 break;
296 case 'e':
297 flags |= BLOCK_FLAG_ENCRYPT;
298 break;
299 case '6':
300 flags |= BLOCK_FLAG_COMPAT6;
301 break;
302 case 'o':
303 options = optarg;
304 break;
308 /* Get the filename */
309 if (optind >= argc)
310 help();
311 filename = argv[optind++];
313 /* Find driver and parse its options */
314 drv = bdrv_find_format(fmt);
315 if (!drv) {
316 error("Unknown file format '%s'", fmt);
317 return 1;
320 proto_drv = bdrv_find_protocol(filename);
321 if (!proto_drv) {
322 error("Unknown protocol '%s'", filename);
323 return 1;
326 create_options = append_option_parameters(create_options,
327 drv->create_options);
328 create_options = append_option_parameters(create_options,
329 proto_drv->create_options);
331 if (options && !strcmp(options, "?")) {
332 print_option_help(create_options);
333 goto out;
336 /* Create parameter list with default values */
337 param = parse_option_parameters("", create_options, param);
338 set_option_parameter_int(param, BLOCK_OPT_SIZE, -1);
340 /* Parse -o options */
341 if (options) {
342 param = parse_option_parameters(options, create_options, param);
343 if (param == NULL) {
344 error("Invalid options for file format '%s'.", fmt);
345 ret = -1;
346 goto out;
350 /* Add size to parameters */
351 if (optind < argc) {
352 set_option_parameter(param, BLOCK_OPT_SIZE, argv[optind++]);
355 /* Add old-style options to parameters */
356 ret = add_old_style_options(fmt, param, flags, base_filename, base_fmt);
357 if (ret < 0) {
358 goto out;
361 // The size for the image must always be specified, with one exception:
362 // If we are using a backing file, we can obtain the size from there
363 if (get_option_parameter(param, BLOCK_OPT_SIZE)->value.n == -1) {
365 QEMUOptionParameter *backing_file =
366 get_option_parameter(param, BLOCK_OPT_BACKING_FILE);
367 QEMUOptionParameter *backing_fmt =
368 get_option_parameter(param, BLOCK_OPT_BACKING_FMT);
370 if (backing_file && backing_file->value.s) {
371 BlockDriverState *bs;
372 uint64_t size;
373 const char *fmt = NULL;
374 char buf[32];
376 if (backing_fmt && backing_fmt->value.s) {
377 if (bdrv_find_format(backing_fmt->value.s)) {
378 fmt = backing_fmt->value.s;
379 } else {
380 error("Unknown backing file format '%s'",
381 backing_fmt->value.s);
382 ret = -1;
383 goto out;
387 bs = bdrv_new_open(backing_file->value.s, fmt, BDRV_O_FLAGS);
388 if (!bs) {
389 ret = -1;
390 goto out;
392 bdrv_get_geometry(bs, &size);
393 size *= 512;
394 bdrv_delete(bs);
396 snprintf(buf, sizeof(buf), "%" PRId64, size);
397 set_option_parameter(param, BLOCK_OPT_SIZE, buf);
398 } else {
399 error("Image creation needs a size parameter");
400 ret = -1;
401 goto out;
405 printf("Formatting '%s', fmt=%s ", filename, fmt);
406 print_option_parameters(param);
407 puts("");
409 ret = bdrv_create(drv, filename, param);
410 free_option_parameters(create_options);
411 free_option_parameters(param);
413 if (ret < 0) {
414 if (ret == -ENOTSUP) {
415 error("Formatting or formatting option not supported for file format '%s'", fmt);
416 } else if (ret == -EFBIG) {
417 error("The image size is too large for file format '%s'", fmt);
418 } else {
419 error("%s: error while creating %s: %s", filename, fmt, strerror(-ret));
422 out:
423 if (ret) {
424 return 1;
426 return 0;
430 * Checks an image for consistency. Exit codes:
432 * 0 - Check completed, image is good
433 * 1 - Check not completed because of internal errors
434 * 2 - Check completed, image is corrupted
435 * 3 - Check completed, image has leaked clusters, but is good otherwise
437 static int img_check(int argc, char **argv)
439 int c, ret;
440 const char *filename, *fmt;
441 BlockDriverState *bs;
442 BdrvCheckResult result;
444 fmt = NULL;
445 for(;;) {
446 c = getopt(argc, argv, "f:h");
447 if (c == -1)
448 break;
449 switch(c) {
450 case 'h':
451 help();
452 break;
453 case 'f':
454 fmt = optarg;
455 break;
458 if (optind >= argc)
459 help();
460 filename = argv[optind++];
462 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS);
463 if (!bs) {
464 return 1;
466 ret = bdrv_check(bs, &result);
468 if (ret == -ENOTSUP) {
469 error("This image format does not support checks");
470 bdrv_delete(bs);
471 return 1;
474 if (!(result.corruptions || result.leaks || result.check_errors)) {
475 printf("No errors were found on the image.\n");
476 } else {
477 if (result.corruptions) {
478 printf("\n%d errors were found on the image.\n"
479 "Data may be corrupted, or further writes to the image "
480 "may corrupt it.\n",
481 result.corruptions);
484 if (result.leaks) {
485 printf("\n%d leaked clusters were found on the image.\n"
486 "This means waste of disk space, but no harm to data.\n",
487 result.leaks);
490 if (result.check_errors) {
491 printf("\n%d internal errors have occurred during the check.\n",
492 result.check_errors);
496 bdrv_delete(bs);
498 if (ret < 0 || result.check_errors) {
499 printf("\nAn error has occurred during the check: %s\n"
500 "The check is not complete and may have missed error.\n",
501 strerror(-ret));
502 return 1;
505 if (result.corruptions) {
506 return 2;
507 } else if (result.leaks) {
508 return 3;
509 } else {
510 return 0;
514 static int img_commit(int argc, char **argv)
516 int c, ret;
517 const char *filename, *fmt;
518 BlockDriverState *bs;
520 fmt = NULL;
521 for(;;) {
522 c = getopt(argc, argv, "f:h");
523 if (c == -1)
524 break;
525 switch(c) {
526 case 'h':
527 help();
528 break;
529 case 'f':
530 fmt = optarg;
531 break;
534 if (optind >= argc)
535 help();
536 filename = argv[optind++];
538 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS | BDRV_O_RDWR);
539 if (!bs) {
540 return 1;
542 ret = bdrv_commit(bs);
543 switch(ret) {
544 case 0:
545 printf("Image committed.\n");
546 break;
547 case -ENOENT:
548 error("No disk inserted");
549 break;
550 case -EACCES:
551 error("Image is read-only");
552 break;
553 case -ENOTSUP:
554 error("Image is already committed");
555 break;
556 default:
557 error("Error while committing image");
558 break;
561 bdrv_delete(bs);
562 if (ret) {
563 return 1;
565 return 0;
568 static int is_not_zero(const uint8_t *sector, int len)
570 int i;
571 len >>= 2;
572 for(i = 0;i < len; i++) {
573 if (((uint32_t *)sector)[i] != 0)
574 return 1;
576 return 0;
580 * Returns true iff the first sector pointed to by 'buf' contains at least
581 * a non-NUL byte.
583 * 'pnum' is set to the number of sectors (including and immediately following
584 * the first one) that are known to be in the same allocated/unallocated state.
586 static int is_allocated_sectors(const uint8_t *buf, int n, int *pnum)
588 int v, i;
590 if (n <= 0) {
591 *pnum = 0;
592 return 0;
594 v = is_not_zero(buf, 512);
595 for(i = 1; i < n; i++) {
596 buf += 512;
597 if (v != is_not_zero(buf, 512))
598 break;
600 *pnum = i;
601 return v;
605 * Compares two buffers sector by sector. Returns 0 if the first sector of both
606 * buffers matches, non-zero otherwise.
608 * pnum is set to the number of sectors (including and immediately following
609 * the first one) that are known to have the same comparison result
611 static int compare_sectors(const uint8_t *buf1, const uint8_t *buf2, int n,
612 int *pnum)
614 int res, i;
616 if (n <= 0) {
617 *pnum = 0;
618 return 0;
621 res = !!memcmp(buf1, buf2, 512);
622 for(i = 1; i < n; i++) {
623 buf1 += 512;
624 buf2 += 512;
626 if (!!memcmp(buf1, buf2, 512) != res) {
627 break;
631 *pnum = i;
632 return res;
635 #define IO_BUF_SIZE (2 * 1024 * 1024)
637 static int img_convert(int argc, char **argv)
639 int c, ret = 0, n, n1, bs_n, bs_i, flags, cluster_size, cluster_sectors;
640 const char *fmt, *out_fmt, *out_baseimg, *out_filename;
641 BlockDriver *drv, *proto_drv;
642 BlockDriverState **bs = NULL, *out_bs = NULL;
643 int64_t total_sectors, nb_sectors, sector_num, bs_offset;
644 uint64_t bs_sectors;
645 uint8_t * buf = NULL;
646 const uint8_t *buf1;
647 BlockDriverInfo bdi;
648 QEMUOptionParameter *param = NULL, *create_options = NULL;
649 QEMUOptionParameter *out_baseimg_param;
650 char *options = NULL;
651 const char *snapshot_name = NULL;
653 fmt = NULL;
654 out_fmt = "raw";
655 out_baseimg = NULL;
656 flags = 0;
657 for(;;) {
658 c = getopt(argc, argv, "f:O:B:s:hce6o:");
659 if (c == -1)
660 break;
661 switch(c) {
662 case 'h':
663 help();
664 break;
665 case 'f':
666 fmt = optarg;
667 break;
668 case 'O':
669 out_fmt = optarg;
670 break;
671 case 'B':
672 out_baseimg = optarg;
673 break;
674 case 'c':
675 flags |= BLOCK_FLAG_COMPRESS;
676 break;
677 case 'e':
678 flags |= BLOCK_FLAG_ENCRYPT;
679 break;
680 case '6':
681 flags |= BLOCK_FLAG_COMPAT6;
682 break;
683 case 'o':
684 options = optarg;
685 break;
686 case 's':
687 snapshot_name = optarg;
688 break;
692 bs_n = argc - optind - 1;
693 if (bs_n < 1) help();
695 out_filename = argv[argc - 1];
697 if (bs_n > 1 && out_baseimg) {
698 error("-B makes no sense when concatenating multiple input images");
699 ret = -1;
700 goto out;
703 bs = qemu_mallocz(bs_n * sizeof(BlockDriverState *));
705 total_sectors = 0;
706 for (bs_i = 0; bs_i < bs_n; bs_i++) {
707 bs[bs_i] = bdrv_new_open(argv[optind + bs_i], fmt, BDRV_O_FLAGS);
708 if (!bs[bs_i]) {
709 error("Could not open '%s'", argv[optind + bs_i]);
710 ret = -1;
711 goto out;
713 bdrv_get_geometry(bs[bs_i], &bs_sectors);
714 total_sectors += bs_sectors;
717 if (snapshot_name != NULL) {
718 if (bs_n > 1) {
719 error("No support for concatenating multiple snapshot\n");
720 ret = -1;
721 goto out;
723 if (bdrv_snapshot_load_tmp(bs[0], snapshot_name) < 0) {
724 error("Failed to load snapshot\n");
725 ret = -1;
726 goto out;
730 /* Find driver and parse its options */
731 drv = bdrv_find_format(out_fmt);
732 if (!drv) {
733 error("Unknown file format '%s'", out_fmt);
734 ret = -1;
735 goto out;
738 proto_drv = bdrv_find_protocol(out_filename);
739 if (!proto_drv) {
740 error("Unknown protocol '%s'", out_filename);
741 ret = -1;
742 goto out;
745 create_options = append_option_parameters(create_options,
746 drv->create_options);
747 create_options = append_option_parameters(create_options,
748 proto_drv->create_options);
749 if (options && !strcmp(options, "?")) {
750 print_option_help(create_options);
751 goto out;
754 if (options) {
755 param = parse_option_parameters(options, create_options, param);
756 if (param == NULL) {
757 error("Invalid options for file format '%s'.", out_fmt);
758 ret = -1;
759 goto out;
761 } else {
762 param = parse_option_parameters("", create_options, param);
765 set_option_parameter_int(param, BLOCK_OPT_SIZE, total_sectors * 512);
766 ret = add_old_style_options(out_fmt, param, flags, out_baseimg, NULL);
767 if (ret < 0) {
768 goto out;
771 /* Get backing file name if -o backing_file was used */
772 out_baseimg_param = get_option_parameter(param, BLOCK_OPT_BACKING_FILE);
773 if (out_baseimg_param) {
774 out_baseimg = out_baseimg_param->value.s;
777 /* Check if compression is supported */
778 if (flags & BLOCK_FLAG_COMPRESS) {
779 QEMUOptionParameter *encryption =
780 get_option_parameter(param, BLOCK_OPT_ENCRYPT);
782 if (!drv->bdrv_write_compressed) {
783 error("Compression not supported for this file format");
784 ret = -1;
785 goto out;
788 if (encryption && encryption->value.n) {
789 error("Compression and encryption not supported at the same time");
790 ret = -1;
791 goto out;
795 /* Create the new image */
796 ret = bdrv_create(drv, out_filename, param);
797 if (ret < 0) {
798 if (ret == -ENOTSUP) {
799 error("Formatting not supported for file format '%s'", out_fmt);
800 } else if (ret == -EFBIG) {
801 error("The image size is too large for file format '%s'", out_fmt);
802 } else {
803 error("%s: error while converting %s: %s", out_filename, out_fmt, strerror(-ret));
805 goto out;
808 out_bs = bdrv_new_open(out_filename, out_fmt,
809 BDRV_O_FLAGS | BDRV_O_RDWR | BDRV_O_NO_FLUSH);
810 if (!out_bs) {
811 ret = -1;
812 goto out;
815 bs_i = 0;
816 bs_offset = 0;
817 bdrv_get_geometry(bs[0], &bs_sectors);
818 buf = qemu_malloc(IO_BUF_SIZE);
820 if (flags & BLOCK_FLAG_COMPRESS) {
821 ret = bdrv_get_info(out_bs, &bdi);
822 if (ret < 0) {
823 error("could not get block driver info");
824 goto out;
826 cluster_size = bdi.cluster_size;
827 if (cluster_size <= 0 || cluster_size > IO_BUF_SIZE) {
828 error("invalid cluster size");
829 ret = -1;
830 goto out;
832 cluster_sectors = cluster_size >> 9;
833 sector_num = 0;
834 for(;;) {
835 int64_t bs_num;
836 int remainder;
837 uint8_t *buf2;
839 nb_sectors = total_sectors - sector_num;
840 if (nb_sectors <= 0)
841 break;
842 if (nb_sectors >= cluster_sectors)
843 n = cluster_sectors;
844 else
845 n = nb_sectors;
847 bs_num = sector_num - bs_offset;
848 assert (bs_num >= 0);
849 remainder = n;
850 buf2 = buf;
851 while (remainder > 0) {
852 int nlow;
853 while (bs_num == bs_sectors) {
854 bs_i++;
855 assert (bs_i < bs_n);
856 bs_offset += bs_sectors;
857 bdrv_get_geometry(bs[bs_i], &bs_sectors);
858 bs_num = 0;
859 /* printf("changing part: sector_num=%" PRId64 ", "
860 "bs_i=%d, bs_offset=%" PRId64 ", bs_sectors=%" PRId64
861 "\n", sector_num, bs_i, bs_offset, bs_sectors); */
863 assert (bs_num < bs_sectors);
865 nlow = (remainder > bs_sectors - bs_num) ? bs_sectors - bs_num : remainder;
867 ret = bdrv_read(bs[bs_i], bs_num, buf2, nlow);
868 if (ret < 0) {
869 error("error while reading");
870 goto out;
873 buf2 += nlow * 512;
874 bs_num += nlow;
876 remainder -= nlow;
878 assert (remainder == 0);
880 if (n < cluster_sectors)
881 memset(buf + n * 512, 0, cluster_size - n * 512);
882 if (is_not_zero(buf, cluster_size)) {
883 ret = bdrv_write_compressed(out_bs, sector_num, buf,
884 cluster_sectors);
885 if (ret != 0) {
886 error("error while compressing sector %" PRId64,
887 sector_num);
888 goto out;
891 sector_num += n;
893 /* signal EOF to align */
894 bdrv_write_compressed(out_bs, 0, NULL, 0);
895 } else {
896 int has_zero_init = bdrv_has_zero_init(out_bs);
898 sector_num = 0; // total number of sectors converted so far
899 for(;;) {
900 nb_sectors = total_sectors - sector_num;
901 if (nb_sectors <= 0)
902 break;
903 if (nb_sectors >= (IO_BUF_SIZE / 512))
904 n = (IO_BUF_SIZE / 512);
905 else
906 n = nb_sectors;
908 while (sector_num - bs_offset >= bs_sectors) {
909 bs_i ++;
910 assert (bs_i < bs_n);
911 bs_offset += bs_sectors;
912 bdrv_get_geometry(bs[bs_i], &bs_sectors);
913 /* printf("changing part: sector_num=%" PRId64 ", bs_i=%d, "
914 "bs_offset=%" PRId64 ", bs_sectors=%" PRId64 "\n",
915 sector_num, bs_i, bs_offset, bs_sectors); */
918 if (n > bs_offset + bs_sectors - sector_num)
919 n = bs_offset + bs_sectors - sector_num;
921 if (has_zero_init) {
922 /* If the output image is being created as a copy on write image,
923 assume that sectors which are unallocated in the input image
924 are present in both the output's and input's base images (no
925 need to copy them). */
926 if (out_baseimg) {
927 if (!bdrv_is_allocated(bs[bs_i], sector_num - bs_offset,
928 n, &n1)) {
929 sector_num += n1;
930 continue;
932 /* The next 'n1' sectors are allocated in the input image. Copy
933 only those as they may be followed by unallocated sectors. */
934 n = n1;
936 } else {
937 n1 = n;
940 ret = bdrv_read(bs[bs_i], sector_num - bs_offset, buf, n);
941 if (ret < 0) {
942 error("error while reading");
943 goto out;
945 /* NOTE: at the same time we convert, we do not write zero
946 sectors to have a chance to compress the image. Ideally, we
947 should add a specific call to have the info to go faster */
948 buf1 = buf;
949 while (n > 0) {
950 /* If the output image is being created as a copy on write image,
951 copy all sectors even the ones containing only NUL bytes,
952 because they may differ from the sectors in the base image.
954 If the output is to a host device, we also write out
955 sectors that are entirely 0, since whatever data was
956 already there is garbage, not 0s. */
957 if (!has_zero_init || out_baseimg ||
958 is_allocated_sectors(buf1, n, &n1)) {
959 ret = bdrv_write(out_bs, sector_num, buf1, n1);
960 if (ret < 0) {
961 error("error while writing");
962 goto out;
965 sector_num += n1;
966 n -= n1;
967 buf1 += n1 * 512;
971 out:
972 free_option_parameters(create_options);
973 free_option_parameters(param);
974 qemu_free(buf);
975 if (out_bs) {
976 bdrv_delete(out_bs);
978 if (bs) {
979 for (bs_i = 0; bs_i < bs_n; bs_i++) {
980 if (bs[bs_i]) {
981 bdrv_delete(bs[bs_i]);
984 qemu_free(bs);
986 if (ret) {
987 return 1;
989 return 0;
992 #ifdef _WIN32
993 static int64_t get_allocated_file_size(const char *filename)
995 typedef DWORD (WINAPI * get_compressed_t)(const char *filename, DWORD *high);
996 get_compressed_t get_compressed;
997 struct _stati64 st;
999 /* WinNT support GetCompressedFileSize to determine allocate size */
1000 get_compressed = (get_compressed_t) GetProcAddress(GetModuleHandle("kernel32"), "GetCompressedFileSizeA");
1001 if (get_compressed) {
1002 DWORD high, low;
1003 low = get_compressed(filename, &high);
1004 if (low != 0xFFFFFFFFlu || GetLastError() == NO_ERROR)
1005 return (((int64_t) high) << 32) + low;
1008 if (_stati64(filename, &st) < 0)
1009 return -1;
1010 return st.st_size;
1012 #else
1013 static int64_t get_allocated_file_size(const char *filename)
1015 struct stat st;
1016 if (stat(filename, &st) < 0)
1017 return -1;
1018 return (int64_t)st.st_blocks * 512;
1020 #endif
1022 static void dump_snapshots(BlockDriverState *bs)
1024 QEMUSnapshotInfo *sn_tab, *sn;
1025 int nb_sns, i;
1026 char buf[256];
1028 nb_sns = bdrv_snapshot_list(bs, &sn_tab);
1029 if (nb_sns <= 0)
1030 return;
1031 printf("Snapshot list:\n");
1032 printf("%s\n", bdrv_snapshot_dump(buf, sizeof(buf), NULL));
1033 for(i = 0; i < nb_sns; i++) {
1034 sn = &sn_tab[i];
1035 printf("%s\n", bdrv_snapshot_dump(buf, sizeof(buf), sn));
1037 qemu_free(sn_tab);
1040 static int img_info(int argc, char **argv)
1042 int c;
1043 const char *filename, *fmt;
1044 BlockDriverState *bs;
1045 char fmt_name[128], size_buf[128], dsize_buf[128];
1046 uint64_t total_sectors;
1047 int64_t allocated_size;
1048 char backing_filename[1024];
1049 char backing_filename2[1024];
1050 BlockDriverInfo bdi;
1052 fmt = NULL;
1053 for(;;) {
1054 c = getopt(argc, argv, "f:h");
1055 if (c == -1)
1056 break;
1057 switch(c) {
1058 case 'h':
1059 help();
1060 break;
1061 case 'f':
1062 fmt = optarg;
1063 break;
1066 if (optind >= argc)
1067 help();
1068 filename = argv[optind++];
1070 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS | BDRV_O_NO_BACKING);
1071 if (!bs) {
1072 return 1;
1074 bdrv_get_format(bs, fmt_name, sizeof(fmt_name));
1075 bdrv_get_geometry(bs, &total_sectors);
1076 get_human_readable_size(size_buf, sizeof(size_buf), total_sectors * 512);
1077 allocated_size = get_allocated_file_size(filename);
1078 if (allocated_size < 0)
1079 snprintf(dsize_buf, sizeof(dsize_buf), "unavailable");
1080 else
1081 get_human_readable_size(dsize_buf, sizeof(dsize_buf),
1082 allocated_size);
1083 printf("image: %s\n"
1084 "file format: %s\n"
1085 "virtual size: %s (%" PRId64 " bytes)\n"
1086 "disk size: %s\n",
1087 filename, fmt_name, size_buf,
1088 (total_sectors * 512),
1089 dsize_buf);
1090 if (bdrv_is_encrypted(bs))
1091 printf("encrypted: yes\n");
1092 if (bdrv_get_info(bs, &bdi) >= 0) {
1093 if (bdi.cluster_size != 0)
1094 printf("cluster_size: %d\n", bdi.cluster_size);
1096 bdrv_get_backing_filename(bs, backing_filename, sizeof(backing_filename));
1097 if (backing_filename[0] != '\0') {
1098 path_combine(backing_filename2, sizeof(backing_filename2),
1099 filename, backing_filename);
1100 printf("backing file: %s (actual path: %s)\n",
1101 backing_filename,
1102 backing_filename2);
1104 dump_snapshots(bs);
1105 bdrv_delete(bs);
1106 return 0;
1109 #define SNAPSHOT_LIST 1
1110 #define SNAPSHOT_CREATE 2
1111 #define SNAPSHOT_APPLY 3
1112 #define SNAPSHOT_DELETE 4
1114 static int img_snapshot(int argc, char **argv)
1116 BlockDriverState *bs;
1117 QEMUSnapshotInfo sn;
1118 char *filename, *snapshot_name = NULL;
1119 int c, ret = 0, bdrv_oflags;
1120 int action = 0;
1121 qemu_timeval tv;
1123 bdrv_oflags = BDRV_O_RDWR;
1124 /* Parse commandline parameters */
1125 for(;;) {
1126 c = getopt(argc, argv, "la:c:d:h");
1127 if (c == -1)
1128 break;
1129 switch(c) {
1130 case 'h':
1131 help();
1132 return 0;
1133 case 'l':
1134 if (action) {
1135 help();
1136 return 0;
1138 action = SNAPSHOT_LIST;
1139 bdrv_oflags &= ~BDRV_O_RDWR; /* no need for RW */
1140 break;
1141 case 'a':
1142 if (action) {
1143 help();
1144 return 0;
1146 action = SNAPSHOT_APPLY;
1147 snapshot_name = optarg;
1148 break;
1149 case 'c':
1150 if (action) {
1151 help();
1152 return 0;
1154 action = SNAPSHOT_CREATE;
1155 snapshot_name = optarg;
1156 break;
1157 case 'd':
1158 if (action) {
1159 help();
1160 return 0;
1162 action = SNAPSHOT_DELETE;
1163 snapshot_name = optarg;
1164 break;
1168 if (optind >= argc)
1169 help();
1170 filename = argv[optind++];
1172 /* Open the image */
1173 bs = bdrv_new_open(filename, NULL, bdrv_oflags);
1174 if (!bs) {
1175 return 1;
1178 /* Perform the requested action */
1179 switch(action) {
1180 case SNAPSHOT_LIST:
1181 dump_snapshots(bs);
1182 break;
1184 case SNAPSHOT_CREATE:
1185 memset(&sn, 0, sizeof(sn));
1186 pstrcpy(sn.name, sizeof(sn.name), snapshot_name);
1188 qemu_gettimeofday(&tv);
1189 sn.date_sec = tv.tv_sec;
1190 sn.date_nsec = tv.tv_usec * 1000;
1192 ret = bdrv_snapshot_create(bs, &sn);
1193 if (ret)
1194 error("Could not create snapshot '%s': %d (%s)",
1195 snapshot_name, ret, strerror(-ret));
1196 break;
1198 case SNAPSHOT_APPLY:
1199 ret = bdrv_snapshot_goto(bs, snapshot_name);
1200 if (ret)
1201 error("Could not apply snapshot '%s': %d (%s)",
1202 snapshot_name, ret, strerror(-ret));
1203 break;
1205 case SNAPSHOT_DELETE:
1206 ret = bdrv_snapshot_delete(bs, snapshot_name);
1207 if (ret)
1208 error("Could not delete snapshot '%s': %d (%s)",
1209 snapshot_name, ret, strerror(-ret));
1210 break;
1213 /* Cleanup */
1214 bdrv_delete(bs);
1215 if (ret) {
1216 return 1;
1218 return 0;
1221 static int img_rebase(int argc, char **argv)
1223 BlockDriverState *bs, *bs_old_backing = NULL, *bs_new_backing = NULL;
1224 BlockDriver *old_backing_drv, *new_backing_drv;
1225 char *filename;
1226 const char *fmt, *out_basefmt, *out_baseimg;
1227 int c, flags, ret;
1228 int unsafe = 0;
1230 /* Parse commandline parameters */
1231 fmt = NULL;
1232 out_baseimg = NULL;
1233 out_basefmt = NULL;
1235 for(;;) {
1236 c = getopt(argc, argv, "uhf:F:b:");
1237 if (c == -1)
1238 break;
1239 switch(c) {
1240 case 'h':
1241 help();
1242 return 0;
1243 case 'f':
1244 fmt = optarg;
1245 break;
1246 case 'F':
1247 out_basefmt = optarg;
1248 break;
1249 case 'b':
1250 out_baseimg = optarg;
1251 break;
1252 case 'u':
1253 unsafe = 1;
1254 break;
1258 if ((optind >= argc) || !out_baseimg)
1259 help();
1260 filename = argv[optind++];
1263 * Open the images.
1265 * Ignore the old backing file for unsafe rebase in case we want to correct
1266 * the reference to a renamed or moved backing file.
1268 flags = BDRV_O_FLAGS | BDRV_O_RDWR | (unsafe ? BDRV_O_NO_BACKING : 0);
1269 bs = bdrv_new_open(filename, fmt, flags);
1270 if (!bs) {
1271 return 1;
1274 /* Find the right drivers for the backing files */
1275 old_backing_drv = NULL;
1276 new_backing_drv = NULL;
1278 if (!unsafe && bs->backing_format[0] != '\0') {
1279 old_backing_drv = bdrv_find_format(bs->backing_format);
1280 if (old_backing_drv == NULL) {
1281 error("Invalid format name: '%s'", bs->backing_format);
1282 ret = -1;
1283 goto out;
1287 if (out_basefmt != NULL) {
1288 new_backing_drv = bdrv_find_format(out_basefmt);
1289 if (new_backing_drv == NULL) {
1290 error("Invalid format name: '%s'", out_basefmt);
1291 ret = -1;
1292 goto out;
1296 /* For safe rebasing we need to compare old and new backing file */
1297 if (unsafe) {
1298 /* Make the compiler happy */
1299 bs_old_backing = NULL;
1300 bs_new_backing = NULL;
1301 } else {
1302 char backing_name[1024];
1304 bs_old_backing = bdrv_new("old_backing");
1305 bdrv_get_backing_filename(bs, backing_name, sizeof(backing_name));
1306 ret = bdrv_open(bs_old_backing, backing_name, BDRV_O_FLAGS,
1307 old_backing_drv);
1308 if (ret) {
1309 error("Could not open old backing file '%s'", backing_name);
1310 goto out;
1313 bs_new_backing = bdrv_new("new_backing");
1314 ret = bdrv_open(bs_new_backing, out_baseimg, BDRV_O_FLAGS,
1315 new_backing_drv);
1316 if (ret) {
1317 error("Could not open new backing file '%s'", out_baseimg);
1318 goto out;
1323 * Check each unallocated cluster in the COW file. If it is unallocated,
1324 * accesses go to the backing file. We must therefore compare this cluster
1325 * in the old and new backing file, and if they differ we need to copy it
1326 * from the old backing file into the COW file.
1328 * If qemu-img crashes during this step, no harm is done. The content of
1329 * the image is the same as the original one at any time.
1331 if (!unsafe) {
1332 uint64_t num_sectors;
1333 uint64_t sector;
1334 int n;
1335 uint8_t * buf_old;
1336 uint8_t * buf_new;
1338 buf_old = qemu_malloc(IO_BUF_SIZE);
1339 buf_new = qemu_malloc(IO_BUF_SIZE);
1341 bdrv_get_geometry(bs, &num_sectors);
1343 for (sector = 0; sector < num_sectors; sector += n) {
1345 /* How many sectors can we handle with the next read? */
1346 if (sector + (IO_BUF_SIZE / 512) <= num_sectors) {
1347 n = (IO_BUF_SIZE / 512);
1348 } else {
1349 n = num_sectors - sector;
1352 /* If the cluster is allocated, we don't need to take action */
1353 ret = bdrv_is_allocated(bs, sector, n, &n);
1354 if (ret) {
1355 continue;
1358 /* Read old and new backing file */
1359 ret = bdrv_read(bs_old_backing, sector, buf_old, n);
1360 if (ret < 0) {
1361 error("error while reading from old backing file");
1362 goto out;
1364 ret = bdrv_read(bs_new_backing, sector, buf_new, n);
1365 if (ret < 0) {
1366 error("error while reading from new backing file");
1367 goto out;
1370 /* If they differ, we need to write to the COW file */
1371 uint64_t written = 0;
1373 while (written < n) {
1374 int pnum;
1376 if (compare_sectors(buf_old + written * 512,
1377 buf_new + written * 512, n - written, &pnum))
1379 ret = bdrv_write(bs, sector + written,
1380 buf_old + written * 512, pnum);
1381 if (ret < 0) {
1382 error("Error while writing to COW image: %s",
1383 strerror(-ret));
1384 goto out;
1388 written += pnum;
1392 qemu_free(buf_old);
1393 qemu_free(buf_new);
1397 * Change the backing file. All clusters that are different from the old
1398 * backing file are overwritten in the COW file now, so the visible content
1399 * doesn't change when we switch the backing file.
1401 ret = bdrv_change_backing_file(bs, out_baseimg, out_basefmt);
1402 if (ret == -ENOSPC) {
1403 error("Could not change the backing file to '%s': No space left in "
1404 "the file header", out_baseimg);
1405 } else if (ret < 0) {
1406 error("Could not change the backing file to '%s': %s",
1407 out_baseimg, strerror(-ret));
1411 * TODO At this point it is possible to check if any clusters that are
1412 * allocated in the COW file are the same in the backing file. If so, they
1413 * could be dropped from the COW file. Don't do this before switching the
1414 * backing file, in case of a crash this would lead to corruption.
1416 out:
1417 /* Cleanup */
1418 if (!unsafe) {
1419 bdrv_delete(bs_old_backing);
1420 bdrv_delete(bs_new_backing);
1423 bdrv_delete(bs);
1424 if (ret) {
1425 return 1;
1427 return 0;
1430 static int img_resize(int argc, char **argv)
1432 int c, ret, relative;
1433 const char *filename, *fmt, *size;
1434 int64_t n, total_size;
1435 BlockDriverState *bs;
1436 QEMUOptionParameter *param;
1437 QEMUOptionParameter resize_options[] = {
1439 .name = BLOCK_OPT_SIZE,
1440 .type = OPT_SIZE,
1441 .help = "Virtual disk size"
1443 { NULL }
1446 fmt = NULL;
1447 for(;;) {
1448 c = getopt(argc, argv, "f:h");
1449 if (c == -1) {
1450 break;
1452 switch(c) {
1453 case 'h':
1454 help();
1455 break;
1456 case 'f':
1457 fmt = optarg;
1458 break;
1461 if (optind + 1 >= argc) {
1462 help();
1464 filename = argv[optind++];
1465 size = argv[optind++];
1467 /* Choose grow, shrink, or absolute resize mode */
1468 switch (size[0]) {
1469 case '+':
1470 relative = 1;
1471 size++;
1472 break;
1473 case '-':
1474 relative = -1;
1475 size++;
1476 break;
1477 default:
1478 relative = 0;
1479 break;
1482 /* Parse size */
1483 param = parse_option_parameters("", resize_options, NULL);
1484 if (set_option_parameter(param, BLOCK_OPT_SIZE, size)) {
1485 /* Error message already printed when size parsing fails */
1486 exit(1);
1488 n = get_option_parameter(param, BLOCK_OPT_SIZE)->value.n;
1489 free_option_parameters(param);
1491 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS | BDRV_O_RDWR);
1492 if (!bs) {
1493 return 1;
1496 if (relative) {
1497 total_size = bdrv_getlength(bs) + n * relative;
1498 } else {
1499 total_size = n;
1501 if (total_size <= 0) {
1502 error("New image size must be positive");
1503 ret = -1;
1504 goto out;
1507 ret = bdrv_truncate(bs, total_size);
1508 switch (ret) {
1509 case 0:
1510 printf("Image resized.\n");
1511 break;
1512 case -ENOTSUP:
1513 error("This image format does not support resize");
1514 break;
1515 case -EACCES:
1516 error("Image is read-only");
1517 break;
1518 default:
1519 error("Error resizing image (%d)", -ret);
1520 break;
1522 out:
1523 bdrv_delete(bs);
1524 if (ret) {
1525 return 1;
1527 return 0;
1530 static const img_cmd_t img_cmds[] = {
1531 #define DEF(option, callback, arg_string) \
1532 { option, callback },
1533 #include "qemu-img-cmds.h"
1534 #undef DEF
1535 #undef GEN_DOCS
1536 { NULL, NULL, },
1539 int main(int argc, char **argv)
1541 const img_cmd_t *cmd;
1542 const char *cmdname;
1544 bdrv_init();
1545 if (argc < 2)
1546 help();
1547 cmdname = argv[1];
1548 argc--; argv++;
1550 /* find the command */
1551 for(cmd = img_cmds; cmd->name != NULL; cmd++) {
1552 if (!strcmp(cmdname, cmd->name)) {
1553 return cmd->handler(argc, argv);
1557 /* not found */
1558 help();
1559 return 0;