Use qemu_mallocz() instead of calloc() in img_convert()
[qemu.git] / qemu-img.c
blobeca99c4a5d972c50ff297c01d6859239c04b3526
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 return 1;
702 bs = qemu_mallocz(bs_n * sizeof(BlockDriverState *));
704 total_sectors = 0;
705 for (bs_i = 0; bs_i < bs_n; bs_i++) {
706 bs[bs_i] = bdrv_new_open(argv[optind + bs_i], fmt, BDRV_O_FLAGS);
707 if (!bs[bs_i]) {
708 error("Could not open '%s'", argv[optind + bs_i]);
709 ret = -1;
710 goto out;
712 bdrv_get_geometry(bs[bs_i], &bs_sectors);
713 total_sectors += bs_sectors;
716 if (snapshot_name != NULL) {
717 if (bs_n > 1) {
718 error("No support for concatenating multiple snapshot\n");
719 ret = -1;
720 goto out;
722 if (bdrv_snapshot_load_tmp(bs[0], snapshot_name) < 0) {
723 error("Failed to load snapshot\n");
724 ret = -1;
725 goto out;
729 /* Find driver and parse its options */
730 drv = bdrv_find_format(out_fmt);
731 if (!drv) {
732 error("Unknown file format '%s'", out_fmt);
733 ret = -1;
734 goto out;
737 proto_drv = bdrv_find_protocol(out_filename);
738 if (!proto_drv) {
739 error("Unknown protocol '%s'", out_filename);
740 ret = -1;
741 goto out;
744 create_options = append_option_parameters(create_options,
745 drv->create_options);
746 create_options = append_option_parameters(create_options,
747 proto_drv->create_options);
748 if (options && !strcmp(options, "?")) {
749 print_option_help(create_options);
750 goto out;
753 if (options) {
754 param = parse_option_parameters(options, create_options, param);
755 if (param == NULL) {
756 error("Invalid options for file format '%s'.", out_fmt);
757 ret = -1;
758 goto out;
760 } else {
761 param = parse_option_parameters("", create_options, param);
764 set_option_parameter_int(param, BLOCK_OPT_SIZE, total_sectors * 512);
765 ret = add_old_style_options(out_fmt, param, flags, out_baseimg, NULL);
766 if (ret < 0) {
767 goto out;
770 /* Get backing file name if -o backing_file was used */
771 out_baseimg_param = get_option_parameter(param, BLOCK_OPT_BACKING_FILE);
772 if (out_baseimg_param) {
773 out_baseimg = out_baseimg_param->value.s;
776 /* Check if compression is supported */
777 if (flags & BLOCK_FLAG_COMPRESS) {
778 QEMUOptionParameter *encryption =
779 get_option_parameter(param, BLOCK_OPT_ENCRYPT);
781 if (!drv->bdrv_write_compressed) {
782 error("Compression not supported for this file format");
783 ret = -1;
784 goto out;
787 if (encryption && encryption->value.n) {
788 error("Compression and encryption not supported at the same time");
789 ret = -1;
790 goto out;
794 /* Create the new image */
795 ret = bdrv_create(drv, out_filename, param);
796 if (ret < 0) {
797 if (ret == -ENOTSUP) {
798 error("Formatting not supported for file format '%s'", out_fmt);
799 } else if (ret == -EFBIG) {
800 error("The image size is too large for file format '%s'", out_fmt);
801 } else {
802 error("%s: error while converting %s: %s", out_filename, out_fmt, strerror(-ret));
804 goto out;
807 out_bs = bdrv_new_open(out_filename, out_fmt,
808 BDRV_O_FLAGS | BDRV_O_RDWR | BDRV_O_NO_FLUSH);
809 if (!out_bs) {
810 ret = -1;
811 goto out;
814 bs_i = 0;
815 bs_offset = 0;
816 bdrv_get_geometry(bs[0], &bs_sectors);
817 buf = qemu_malloc(IO_BUF_SIZE);
819 if (flags & BLOCK_FLAG_COMPRESS) {
820 ret = bdrv_get_info(out_bs, &bdi);
821 if (ret < 0) {
822 error("could not get block driver info");
823 goto out;
825 cluster_size = bdi.cluster_size;
826 if (cluster_size <= 0 || cluster_size > IO_BUF_SIZE) {
827 error("invalid cluster size");
828 ret = -1;
829 goto out;
831 cluster_sectors = cluster_size >> 9;
832 sector_num = 0;
833 for(;;) {
834 int64_t bs_num;
835 int remainder;
836 uint8_t *buf2;
838 nb_sectors = total_sectors - sector_num;
839 if (nb_sectors <= 0)
840 break;
841 if (nb_sectors >= cluster_sectors)
842 n = cluster_sectors;
843 else
844 n = nb_sectors;
846 bs_num = sector_num - bs_offset;
847 assert (bs_num >= 0);
848 remainder = n;
849 buf2 = buf;
850 while (remainder > 0) {
851 int nlow;
852 while (bs_num == bs_sectors) {
853 bs_i++;
854 assert (bs_i < bs_n);
855 bs_offset += bs_sectors;
856 bdrv_get_geometry(bs[bs_i], &bs_sectors);
857 bs_num = 0;
858 /* printf("changing part: sector_num=%" PRId64 ", "
859 "bs_i=%d, bs_offset=%" PRId64 ", bs_sectors=%" PRId64
860 "\n", sector_num, bs_i, bs_offset, bs_sectors); */
862 assert (bs_num < bs_sectors);
864 nlow = (remainder > bs_sectors - bs_num) ? bs_sectors - bs_num : remainder;
866 ret = bdrv_read(bs[bs_i], bs_num, buf2, nlow);
867 if (ret < 0) {
868 error("error while reading");
869 goto out;
872 buf2 += nlow * 512;
873 bs_num += nlow;
875 remainder -= nlow;
877 assert (remainder == 0);
879 if (n < cluster_sectors)
880 memset(buf + n * 512, 0, cluster_size - n * 512);
881 if (is_not_zero(buf, cluster_size)) {
882 ret = bdrv_write_compressed(out_bs, sector_num, buf,
883 cluster_sectors);
884 if (ret != 0) {
885 error("error while compressing sector %" PRId64,
886 sector_num);
887 goto out;
890 sector_num += n;
892 /* signal EOF to align */
893 bdrv_write_compressed(out_bs, 0, NULL, 0);
894 } else {
895 int has_zero_init = bdrv_has_zero_init(out_bs);
897 sector_num = 0; // total number of sectors converted so far
898 for(;;) {
899 nb_sectors = total_sectors - sector_num;
900 if (nb_sectors <= 0)
901 break;
902 if (nb_sectors >= (IO_BUF_SIZE / 512))
903 n = (IO_BUF_SIZE / 512);
904 else
905 n = nb_sectors;
907 while (sector_num - bs_offset >= bs_sectors) {
908 bs_i ++;
909 assert (bs_i < bs_n);
910 bs_offset += bs_sectors;
911 bdrv_get_geometry(bs[bs_i], &bs_sectors);
912 /* printf("changing part: sector_num=%" PRId64 ", bs_i=%d, "
913 "bs_offset=%" PRId64 ", bs_sectors=%" PRId64 "\n",
914 sector_num, bs_i, bs_offset, bs_sectors); */
917 if (n > bs_offset + bs_sectors - sector_num)
918 n = bs_offset + bs_sectors - sector_num;
920 if (has_zero_init) {
921 /* If the output image is being created as a copy on write image,
922 assume that sectors which are unallocated in the input image
923 are present in both the output's and input's base images (no
924 need to copy them). */
925 if (out_baseimg) {
926 if (!bdrv_is_allocated(bs[bs_i], sector_num - bs_offset,
927 n, &n1)) {
928 sector_num += n1;
929 continue;
931 /* The next 'n1' sectors are allocated in the input image. Copy
932 only those as they may be followed by unallocated sectors. */
933 n = n1;
935 } else {
936 n1 = n;
939 ret = bdrv_read(bs[bs_i], sector_num - bs_offset, buf, n);
940 if (ret < 0) {
941 error("error while reading");
942 goto out;
944 /* NOTE: at the same time we convert, we do not write zero
945 sectors to have a chance to compress the image. Ideally, we
946 should add a specific call to have the info to go faster */
947 buf1 = buf;
948 while (n > 0) {
949 /* If the output image is being created as a copy on write image,
950 copy all sectors even the ones containing only NUL bytes,
951 because they may differ from the sectors in the base image.
953 If the output is to a host device, we also write out
954 sectors that are entirely 0, since whatever data was
955 already there is garbage, not 0s. */
956 if (!has_zero_init || out_baseimg ||
957 is_allocated_sectors(buf1, n, &n1)) {
958 ret = bdrv_write(out_bs, sector_num, buf1, n1);
959 if (ret < 0) {
960 error("error while writing");
961 goto out;
964 sector_num += n1;
965 n -= n1;
966 buf1 += n1 * 512;
970 out:
971 free_option_parameters(create_options);
972 free_option_parameters(param);
973 qemu_free(buf);
974 if (out_bs) {
975 bdrv_delete(out_bs);
977 for (bs_i = 0; bs_i < bs_n; bs_i++) {
978 if (bs[bs_i]) {
979 bdrv_delete(bs[bs_i]);
982 qemu_free(bs);
983 if (ret) {
984 return 1;
986 return 0;
989 #ifdef _WIN32
990 static int64_t get_allocated_file_size(const char *filename)
992 typedef DWORD (WINAPI * get_compressed_t)(const char *filename, DWORD *high);
993 get_compressed_t get_compressed;
994 struct _stati64 st;
996 /* WinNT support GetCompressedFileSize to determine allocate size */
997 get_compressed = (get_compressed_t) GetProcAddress(GetModuleHandle("kernel32"), "GetCompressedFileSizeA");
998 if (get_compressed) {
999 DWORD high, low;
1000 low = get_compressed(filename, &high);
1001 if (low != 0xFFFFFFFFlu || GetLastError() == NO_ERROR)
1002 return (((int64_t) high) << 32) + low;
1005 if (_stati64(filename, &st) < 0)
1006 return -1;
1007 return st.st_size;
1009 #else
1010 static int64_t get_allocated_file_size(const char *filename)
1012 struct stat st;
1013 if (stat(filename, &st) < 0)
1014 return -1;
1015 return (int64_t)st.st_blocks * 512;
1017 #endif
1019 static void dump_snapshots(BlockDriverState *bs)
1021 QEMUSnapshotInfo *sn_tab, *sn;
1022 int nb_sns, i;
1023 char buf[256];
1025 nb_sns = bdrv_snapshot_list(bs, &sn_tab);
1026 if (nb_sns <= 0)
1027 return;
1028 printf("Snapshot list:\n");
1029 printf("%s\n", bdrv_snapshot_dump(buf, sizeof(buf), NULL));
1030 for(i = 0; i < nb_sns; i++) {
1031 sn = &sn_tab[i];
1032 printf("%s\n", bdrv_snapshot_dump(buf, sizeof(buf), sn));
1034 qemu_free(sn_tab);
1037 static int img_info(int argc, char **argv)
1039 int c;
1040 const char *filename, *fmt;
1041 BlockDriverState *bs;
1042 char fmt_name[128], size_buf[128], dsize_buf[128];
1043 uint64_t total_sectors;
1044 int64_t allocated_size;
1045 char backing_filename[1024];
1046 char backing_filename2[1024];
1047 BlockDriverInfo bdi;
1049 fmt = NULL;
1050 for(;;) {
1051 c = getopt(argc, argv, "f:h");
1052 if (c == -1)
1053 break;
1054 switch(c) {
1055 case 'h':
1056 help();
1057 break;
1058 case 'f':
1059 fmt = optarg;
1060 break;
1063 if (optind >= argc)
1064 help();
1065 filename = argv[optind++];
1067 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS | BDRV_O_NO_BACKING);
1068 if (!bs) {
1069 return 1;
1071 bdrv_get_format(bs, fmt_name, sizeof(fmt_name));
1072 bdrv_get_geometry(bs, &total_sectors);
1073 get_human_readable_size(size_buf, sizeof(size_buf), total_sectors * 512);
1074 allocated_size = get_allocated_file_size(filename);
1075 if (allocated_size < 0)
1076 snprintf(dsize_buf, sizeof(dsize_buf), "unavailable");
1077 else
1078 get_human_readable_size(dsize_buf, sizeof(dsize_buf),
1079 allocated_size);
1080 printf("image: %s\n"
1081 "file format: %s\n"
1082 "virtual size: %s (%" PRId64 " bytes)\n"
1083 "disk size: %s\n",
1084 filename, fmt_name, size_buf,
1085 (total_sectors * 512),
1086 dsize_buf);
1087 if (bdrv_is_encrypted(bs))
1088 printf("encrypted: yes\n");
1089 if (bdrv_get_info(bs, &bdi) >= 0) {
1090 if (bdi.cluster_size != 0)
1091 printf("cluster_size: %d\n", bdi.cluster_size);
1093 bdrv_get_backing_filename(bs, backing_filename, sizeof(backing_filename));
1094 if (backing_filename[0] != '\0') {
1095 path_combine(backing_filename2, sizeof(backing_filename2),
1096 filename, backing_filename);
1097 printf("backing file: %s (actual path: %s)\n",
1098 backing_filename,
1099 backing_filename2);
1101 dump_snapshots(bs);
1102 bdrv_delete(bs);
1103 return 0;
1106 #define SNAPSHOT_LIST 1
1107 #define SNAPSHOT_CREATE 2
1108 #define SNAPSHOT_APPLY 3
1109 #define SNAPSHOT_DELETE 4
1111 static int img_snapshot(int argc, char **argv)
1113 BlockDriverState *bs;
1114 QEMUSnapshotInfo sn;
1115 char *filename, *snapshot_name = NULL;
1116 int c, ret = 0, bdrv_oflags;
1117 int action = 0;
1118 qemu_timeval tv;
1120 bdrv_oflags = BDRV_O_RDWR;
1121 /* Parse commandline parameters */
1122 for(;;) {
1123 c = getopt(argc, argv, "la:c:d:h");
1124 if (c == -1)
1125 break;
1126 switch(c) {
1127 case 'h':
1128 help();
1129 return 0;
1130 case 'l':
1131 if (action) {
1132 help();
1133 return 0;
1135 action = SNAPSHOT_LIST;
1136 bdrv_oflags &= ~BDRV_O_RDWR; /* no need for RW */
1137 break;
1138 case 'a':
1139 if (action) {
1140 help();
1141 return 0;
1143 action = SNAPSHOT_APPLY;
1144 snapshot_name = optarg;
1145 break;
1146 case 'c':
1147 if (action) {
1148 help();
1149 return 0;
1151 action = SNAPSHOT_CREATE;
1152 snapshot_name = optarg;
1153 break;
1154 case 'd':
1155 if (action) {
1156 help();
1157 return 0;
1159 action = SNAPSHOT_DELETE;
1160 snapshot_name = optarg;
1161 break;
1165 if (optind >= argc)
1166 help();
1167 filename = argv[optind++];
1169 /* Open the image */
1170 bs = bdrv_new_open(filename, NULL, bdrv_oflags);
1171 if (!bs) {
1172 return 1;
1175 /* Perform the requested action */
1176 switch(action) {
1177 case SNAPSHOT_LIST:
1178 dump_snapshots(bs);
1179 break;
1181 case SNAPSHOT_CREATE:
1182 memset(&sn, 0, sizeof(sn));
1183 pstrcpy(sn.name, sizeof(sn.name), snapshot_name);
1185 qemu_gettimeofday(&tv);
1186 sn.date_sec = tv.tv_sec;
1187 sn.date_nsec = tv.tv_usec * 1000;
1189 ret = bdrv_snapshot_create(bs, &sn);
1190 if (ret)
1191 error("Could not create snapshot '%s': %d (%s)",
1192 snapshot_name, ret, strerror(-ret));
1193 break;
1195 case SNAPSHOT_APPLY:
1196 ret = bdrv_snapshot_goto(bs, snapshot_name);
1197 if (ret)
1198 error("Could not apply snapshot '%s': %d (%s)",
1199 snapshot_name, ret, strerror(-ret));
1200 break;
1202 case SNAPSHOT_DELETE:
1203 ret = bdrv_snapshot_delete(bs, snapshot_name);
1204 if (ret)
1205 error("Could not delete snapshot '%s': %d (%s)",
1206 snapshot_name, ret, strerror(-ret));
1207 break;
1210 /* Cleanup */
1211 bdrv_delete(bs);
1212 if (ret) {
1213 return 1;
1215 return 0;
1218 static int img_rebase(int argc, char **argv)
1220 BlockDriverState *bs, *bs_old_backing = NULL, *bs_new_backing = NULL;
1221 BlockDriver *old_backing_drv, *new_backing_drv;
1222 char *filename;
1223 const char *fmt, *out_basefmt, *out_baseimg;
1224 int c, flags, ret;
1225 int unsafe = 0;
1227 /* Parse commandline parameters */
1228 fmt = NULL;
1229 out_baseimg = NULL;
1230 out_basefmt = NULL;
1232 for(;;) {
1233 c = getopt(argc, argv, "uhf:F:b:");
1234 if (c == -1)
1235 break;
1236 switch(c) {
1237 case 'h':
1238 help();
1239 return 0;
1240 case 'f':
1241 fmt = optarg;
1242 break;
1243 case 'F':
1244 out_basefmt = optarg;
1245 break;
1246 case 'b':
1247 out_baseimg = optarg;
1248 break;
1249 case 'u':
1250 unsafe = 1;
1251 break;
1255 if ((optind >= argc) || !out_baseimg)
1256 help();
1257 filename = argv[optind++];
1260 * Open the images.
1262 * Ignore the old backing file for unsafe rebase in case we want to correct
1263 * the reference to a renamed or moved backing file.
1265 flags = BDRV_O_FLAGS | BDRV_O_RDWR | (unsafe ? BDRV_O_NO_BACKING : 0);
1266 bs = bdrv_new_open(filename, fmt, flags);
1267 if (!bs) {
1268 return 1;
1271 /* Find the right drivers for the backing files */
1272 old_backing_drv = NULL;
1273 new_backing_drv = NULL;
1275 if (!unsafe && bs->backing_format[0] != '\0') {
1276 old_backing_drv = bdrv_find_format(bs->backing_format);
1277 if (old_backing_drv == NULL) {
1278 error("Invalid format name: '%s'", bs->backing_format);
1279 ret = -1;
1280 goto out;
1284 if (out_basefmt != NULL) {
1285 new_backing_drv = bdrv_find_format(out_basefmt);
1286 if (new_backing_drv == NULL) {
1287 error("Invalid format name: '%s'", out_basefmt);
1288 ret = -1;
1289 goto out;
1293 /* For safe rebasing we need to compare old and new backing file */
1294 if (unsafe) {
1295 /* Make the compiler happy */
1296 bs_old_backing = NULL;
1297 bs_new_backing = NULL;
1298 } else {
1299 char backing_name[1024];
1301 bs_old_backing = bdrv_new("old_backing");
1302 bdrv_get_backing_filename(bs, backing_name, sizeof(backing_name));
1303 ret = bdrv_open(bs_old_backing, backing_name, BDRV_O_FLAGS,
1304 old_backing_drv);
1305 if (ret) {
1306 error("Could not open old backing file '%s'", backing_name);
1307 goto out;
1310 bs_new_backing = bdrv_new("new_backing");
1311 ret = bdrv_open(bs_new_backing, out_baseimg, BDRV_O_FLAGS,
1312 new_backing_drv);
1313 if (ret) {
1314 error("Could not open new backing file '%s'", out_baseimg);
1315 goto out;
1320 * Check each unallocated cluster in the COW file. If it is unallocated,
1321 * accesses go to the backing file. We must therefore compare this cluster
1322 * in the old and new backing file, and if they differ we need to copy it
1323 * from the old backing file into the COW file.
1325 * If qemu-img crashes during this step, no harm is done. The content of
1326 * the image is the same as the original one at any time.
1328 if (!unsafe) {
1329 uint64_t num_sectors;
1330 uint64_t sector;
1331 int n;
1332 uint8_t * buf_old;
1333 uint8_t * buf_new;
1335 buf_old = qemu_malloc(IO_BUF_SIZE);
1336 buf_new = qemu_malloc(IO_BUF_SIZE);
1338 bdrv_get_geometry(bs, &num_sectors);
1340 for (sector = 0; sector < num_sectors; sector += n) {
1342 /* How many sectors can we handle with the next read? */
1343 if (sector + (IO_BUF_SIZE / 512) <= num_sectors) {
1344 n = (IO_BUF_SIZE / 512);
1345 } else {
1346 n = num_sectors - sector;
1349 /* If the cluster is allocated, we don't need to take action */
1350 ret = bdrv_is_allocated(bs, sector, n, &n);
1351 if (ret) {
1352 continue;
1355 /* Read old and new backing file */
1356 ret = bdrv_read(bs_old_backing, sector, buf_old, n);
1357 if (ret < 0) {
1358 error("error while reading from old backing file");
1359 goto out;
1361 ret = bdrv_read(bs_new_backing, sector, buf_new, n);
1362 if (ret < 0) {
1363 error("error while reading from new backing file");
1364 goto out;
1367 /* If they differ, we need to write to the COW file */
1368 uint64_t written = 0;
1370 while (written < n) {
1371 int pnum;
1373 if (compare_sectors(buf_old + written * 512,
1374 buf_new + written * 512, n - written, &pnum))
1376 ret = bdrv_write(bs, sector + written,
1377 buf_old + written * 512, pnum);
1378 if (ret < 0) {
1379 error("Error while writing to COW image: %s",
1380 strerror(-ret));
1381 goto out;
1385 written += pnum;
1389 qemu_free(buf_old);
1390 qemu_free(buf_new);
1394 * Change the backing file. All clusters that are different from the old
1395 * backing file are overwritten in the COW file now, so the visible content
1396 * doesn't change when we switch the backing file.
1398 ret = bdrv_change_backing_file(bs, out_baseimg, out_basefmt);
1399 if (ret == -ENOSPC) {
1400 error("Could not change the backing file to '%s': No space left in "
1401 "the file header", out_baseimg);
1402 } else if (ret < 0) {
1403 error("Could not change the backing file to '%s': %s",
1404 out_baseimg, strerror(-ret));
1408 * TODO At this point it is possible to check if any clusters that are
1409 * allocated in the COW file are the same in the backing file. If so, they
1410 * could be dropped from the COW file. Don't do this before switching the
1411 * backing file, in case of a crash this would lead to corruption.
1413 out:
1414 /* Cleanup */
1415 if (!unsafe) {
1416 bdrv_delete(bs_old_backing);
1417 bdrv_delete(bs_new_backing);
1420 bdrv_delete(bs);
1421 if (ret) {
1422 return 1;
1424 return 0;
1427 static int img_resize(int argc, char **argv)
1429 int c, ret, relative;
1430 const char *filename, *fmt, *size;
1431 int64_t n, total_size;
1432 BlockDriverState *bs;
1433 QEMUOptionParameter *param;
1434 QEMUOptionParameter resize_options[] = {
1436 .name = BLOCK_OPT_SIZE,
1437 .type = OPT_SIZE,
1438 .help = "Virtual disk size"
1440 { NULL }
1443 fmt = NULL;
1444 for(;;) {
1445 c = getopt(argc, argv, "f:h");
1446 if (c == -1) {
1447 break;
1449 switch(c) {
1450 case 'h':
1451 help();
1452 break;
1453 case 'f':
1454 fmt = optarg;
1455 break;
1458 if (optind + 1 >= argc) {
1459 help();
1461 filename = argv[optind++];
1462 size = argv[optind++];
1464 /* Choose grow, shrink, or absolute resize mode */
1465 switch (size[0]) {
1466 case '+':
1467 relative = 1;
1468 size++;
1469 break;
1470 case '-':
1471 relative = -1;
1472 size++;
1473 break;
1474 default:
1475 relative = 0;
1476 break;
1479 /* Parse size */
1480 param = parse_option_parameters("", resize_options, NULL);
1481 if (set_option_parameter(param, BLOCK_OPT_SIZE, size)) {
1482 /* Error message already printed when size parsing fails */
1483 exit(1);
1485 n = get_option_parameter(param, BLOCK_OPT_SIZE)->value.n;
1486 free_option_parameters(param);
1488 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS | BDRV_O_RDWR);
1489 if (!bs) {
1490 return 1;
1493 if (relative) {
1494 total_size = bdrv_getlength(bs) + n * relative;
1495 } else {
1496 total_size = n;
1498 if (total_size <= 0) {
1499 error("New image size must be positive");
1500 ret = -1;
1501 goto out;
1504 ret = bdrv_truncate(bs, total_size);
1505 switch (ret) {
1506 case 0:
1507 printf("Image resized.\n");
1508 break;
1509 case -ENOTSUP:
1510 error("This image format does not support resize");
1511 break;
1512 case -EACCES:
1513 error("Image is read-only");
1514 break;
1515 default:
1516 error("Error resizing image (%d)", -ret);
1517 break;
1519 out:
1520 bdrv_delete(bs);
1521 if (ret) {
1522 return 1;
1524 return 0;
1527 static const img_cmd_t img_cmds[] = {
1528 #define DEF(option, callback, arg_string) \
1529 { option, callback },
1530 #include "qemu-img-cmds.h"
1531 #undef DEF
1532 #undef GEN_DOCS
1533 { NULL, NULL, },
1536 int main(int argc, char **argv)
1538 const img_cmd_t *cmd;
1539 const char *cmdname;
1541 bdrv_init();
1542 if (argc < 2)
1543 help();
1544 cmdname = argv[1];
1545 argc--; argv++;
1547 /* find the command */
1548 for(cmd = img_cmds; cmd->name != NULL; cmd++) {
1549 if (!strcmp(cmdname, cmd->name)) {
1550 return cmd->handler(argc, argv);
1554 /* not found */
1555 help();
1556 return 0;