]> git.proxmox.com Git - qemu.git/blob - qemu-img.c
0b871d842c03b711984f771b3e15e19f338e06e8
[qemu.git] / qemu-img.c
1 /*
2 * QEMU disk image utility
3 *
4 * Copyright (c) 2003-2008 Fabrice Bellard
5 *
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:
12 *
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
15 *
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.
23 */
24 #include "qemu-common.h"
25 #include "qemu-option.h"
26 #include "qemu-error.h"
27 #include "osdep.h"
28 #include "sysemu.h"
29 #include "block_int.h"
30 #include <stdio.h>
31
32 #ifdef _WIN32
33 #include <windows.h>
34 #endif
35
36 typedef struct img_cmd_t {
37 const char *name;
38 int (*handler)(int argc, char **argv);
39 } img_cmd_t;
40
41 /* Default to cache=writeback as data integrity is not important for qemu-tcg. */
42 #define BDRV_O_FLAGS BDRV_O_CACHE_WB
43
44 static void format_print(void *opaque, const char *name)
45 {
46 printf(" %s", name);
47 }
48
49 /* Please keep in synch with qemu-img.texi */
50 static void help(void)
51 {
52 const char *help_msg =
53 "qemu-img version " QEMU_VERSION ", Copyright (c) 2004-2008 Fabrice Bellard\n"
54 "usage: qemu-img command [command options]\n"
55 "QEMU disk image utility\n"
56 "\n"
57 "Command syntax:\n"
58 #define DEF(option, callback, arg_string) \
59 " " arg_string "\n"
60 #include "qemu-img-cmds.h"
61 #undef DEF
62 #undef GEN_DOCS
63 "\n"
64 "Command parameters:\n"
65 " 'filename' is a disk image filename\n"
66 " 'fmt' is the disk image format. It is guessed automatically in most cases\n"
67 " 'size' is the disk image size in bytes. Optional suffixes\n"
68 " 'k' or 'K' (kilobyte, 1024), 'M' (megabyte, 1024k), 'G' (gigabyte, 1024M)\n"
69 " and T (terabyte, 1024G) are supported. 'b' is ignored.\n"
70 " 'output_filename' is the destination disk image filename\n"
71 " 'output_fmt' is the destination format\n"
72 " 'options' is a comma separated list of format specific options in a\n"
73 " name=value format. Use -o ? for an overview of the options supported by the\n"
74 " used format\n"
75 " '-c' indicates that target image must be compressed (qcow format only)\n"
76 " '-u' enables unsafe rebasing. It is assumed that old and new backing file\n"
77 " match exactly. The image doesn't need a working backing file before\n"
78 " rebasing in this case (useful for renaming the backing file)\n"
79 " '-h' with or without a command shows this help and lists the supported formats\n"
80 "\n"
81 "Parameters to snapshot subcommand:\n"
82 " 'snapshot' is the name of the snapshot to create, apply or delete\n"
83 " '-a' applies a snapshot (revert disk to saved state)\n"
84 " '-c' creates a snapshot\n"
85 " '-d' deletes a snapshot\n"
86 " '-l' lists all snapshots in the given image\n";
87
88 printf("%s\nSupported formats:", help_msg);
89 bdrv_iterate_format(format_print, NULL);
90 printf("\n");
91 exit(1);
92 }
93
94 #if defined(WIN32)
95 /* XXX: put correct support for win32 */
96 static int read_password(char *buf, int buf_size)
97 {
98 int c, i;
99 printf("Password: ");
100 fflush(stdout);
101 i = 0;
102 for(;;) {
103 c = getchar();
104 if (c == '\n')
105 break;
106 if (i < (buf_size - 1))
107 buf[i++] = c;
108 }
109 buf[i] = '\0';
110 return 0;
111 }
112
113 #else
114
115 #include <termios.h>
116
117 static struct termios oldtty;
118
119 static void term_exit(void)
120 {
121 tcsetattr (0, TCSANOW, &oldtty);
122 }
123
124 static void term_init(void)
125 {
126 struct termios tty;
127
128 tcgetattr (0, &tty);
129 oldtty = tty;
130
131 tty.c_iflag &= ~(IGNBRK|BRKINT|PARMRK|ISTRIP
132 |INLCR|IGNCR|ICRNL|IXON);
133 tty.c_oflag |= OPOST;
134 tty.c_lflag &= ~(ECHO|ECHONL|ICANON|IEXTEN);
135 tty.c_cflag &= ~(CSIZE|PARENB);
136 tty.c_cflag |= CS8;
137 tty.c_cc[VMIN] = 1;
138 tty.c_cc[VTIME] = 0;
139
140 tcsetattr (0, TCSANOW, &tty);
141
142 atexit(term_exit);
143 }
144
145 static int read_password(char *buf, int buf_size)
146 {
147 uint8_t ch;
148 int i, ret;
149
150 printf("password: ");
151 fflush(stdout);
152 term_init();
153 i = 0;
154 for(;;) {
155 ret = read(0, &ch, 1);
156 if (ret == -1) {
157 if (errno == EAGAIN || errno == EINTR) {
158 continue;
159 } else {
160 ret = -1;
161 break;
162 }
163 } else if (ret == 0) {
164 ret = -1;
165 break;
166 } else {
167 if (ch == '\r') {
168 ret = 0;
169 break;
170 }
171 if (i < (buf_size - 1))
172 buf[i++] = ch;
173 }
174 }
175 term_exit();
176 buf[i] = '\0';
177 printf("\n");
178 return ret;
179 }
180 #endif
181
182 static int print_block_option_help(const char *filename, const char *fmt)
183 {
184 BlockDriver *drv, *proto_drv;
185 QEMUOptionParameter *create_options = NULL;
186
187 /* Find driver and parse its options */
188 drv = bdrv_find_format(fmt);
189 if (!drv) {
190 error_report("Unknown file format '%s'", fmt);
191 return 1;
192 }
193
194 proto_drv = bdrv_find_protocol(filename);
195 if (!proto_drv) {
196 error_report("Unknown protocol '%s'", filename);
197 return 1;
198 }
199
200 create_options = append_option_parameters(create_options,
201 drv->create_options);
202 create_options = append_option_parameters(create_options,
203 proto_drv->create_options);
204 print_option_help(create_options);
205 free_option_parameters(create_options);
206 return 0;
207 }
208
209 static BlockDriverState *bdrv_new_open(const char *filename,
210 const char *fmt,
211 int flags)
212 {
213 BlockDriverState *bs;
214 BlockDriver *drv;
215 char password[256];
216
217 bs = bdrv_new("");
218 if (!bs) {
219 error_report("Not enough memory");
220 goto fail;
221 }
222 if (fmt) {
223 drv = bdrv_find_format(fmt);
224 if (!drv) {
225 error_report("Unknown file format '%s'", fmt);
226 goto fail;
227 }
228 } else {
229 drv = NULL;
230 }
231 if (bdrv_open(bs, filename, flags, drv) < 0) {
232 error_report("Could not open '%s'", filename);
233 goto fail;
234 }
235 if (bdrv_is_encrypted(bs)) {
236 printf("Disk image '%s' is encrypted.\n", filename);
237 if (read_password(password, sizeof(password)) < 0) {
238 error_report("No password given");
239 goto fail;
240 }
241 if (bdrv_set_key(bs, password) < 0) {
242 error_report("invalid password");
243 goto fail;
244 }
245 }
246 return bs;
247 fail:
248 if (bs) {
249 bdrv_delete(bs);
250 }
251 return NULL;
252 }
253
254 static int add_old_style_options(const char *fmt, QEMUOptionParameter *list,
255 const char *base_filename,
256 const char *base_fmt)
257 {
258 if (base_filename) {
259 if (set_option_parameter(list, BLOCK_OPT_BACKING_FILE, base_filename)) {
260 error_report("Backing file not supported for file format '%s'",
261 fmt);
262 return -1;
263 }
264 }
265 if (base_fmt) {
266 if (set_option_parameter(list, BLOCK_OPT_BACKING_FMT, base_fmt)) {
267 error_report("Backing file format not supported for file "
268 "format '%s'", fmt);
269 return -1;
270 }
271 }
272 return 0;
273 }
274
275 static int img_create(int argc, char **argv)
276 {
277 int c, ret = 0;
278 uint64_t img_size = -1;
279 const char *fmt = "raw";
280 const char *base_fmt = NULL;
281 const char *filename;
282 const char *base_filename = NULL;
283 char *options = NULL;
284
285 for(;;) {
286 c = getopt(argc, argv, "F:b:f:he6o:");
287 if (c == -1) {
288 break;
289 }
290 switch(c) {
291 case '?':
292 case 'h':
293 help();
294 break;
295 case 'F':
296 base_fmt = optarg;
297 break;
298 case 'b':
299 base_filename = optarg;
300 break;
301 case 'f':
302 fmt = optarg;
303 break;
304 case 'e':
305 error_report("qemu-img: option -e is deprecated, please use \'-o "
306 "encryption\' instead!");
307 return 1;
308 case '6':
309 error_report("qemu-img: option -6 is deprecated, please use \'-o "
310 "compat6\' instead!");
311 return 1;
312 case 'o':
313 options = optarg;
314 break;
315 }
316 }
317
318 /* Get the filename */
319 if (optind >= argc) {
320 help();
321 }
322 filename = argv[optind++];
323
324 /* Get image size, if specified */
325 if (optind < argc) {
326 ssize_t sval;
327 sval = strtosz_suffix(argv[optind++], NULL, STRTOSZ_DEFSUFFIX_B);
328 if (sval < 0) {
329 error_report("Invalid image size specified! You may use k, M, G or "
330 "T suffixes for ");
331 error_report("kilobytes, megabytes, gigabytes and terabytes.");
332 ret = -1;
333 goto out;
334 }
335 img_size = (uint64_t)sval;
336 }
337
338 if (options && !strcmp(options, "?")) {
339 ret = print_block_option_help(filename, fmt);
340 goto out;
341 }
342
343 ret = bdrv_img_create(filename, fmt, base_filename, base_fmt,
344 options, img_size, BDRV_O_FLAGS);
345 out:
346 if (ret) {
347 return 1;
348 }
349 return 0;
350 }
351
352 /*
353 * Checks an image for consistency. Exit codes:
354 *
355 * 0 - Check completed, image is good
356 * 1 - Check not completed because of internal errors
357 * 2 - Check completed, image is corrupted
358 * 3 - Check completed, image has leaked clusters, but is good otherwise
359 */
360 static int img_check(int argc, char **argv)
361 {
362 int c, ret;
363 const char *filename, *fmt;
364 BlockDriverState *bs;
365 BdrvCheckResult result;
366
367 fmt = NULL;
368 for(;;) {
369 c = getopt(argc, argv, "f:h");
370 if (c == -1) {
371 break;
372 }
373 switch(c) {
374 case '?':
375 case 'h':
376 help();
377 break;
378 case 'f':
379 fmt = optarg;
380 break;
381 }
382 }
383 if (optind >= argc) {
384 help();
385 }
386 filename = argv[optind++];
387
388 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS);
389 if (!bs) {
390 return 1;
391 }
392 ret = bdrv_check(bs, &result);
393
394 if (ret == -ENOTSUP) {
395 error_report("This image format does not support checks");
396 bdrv_delete(bs);
397 return 1;
398 }
399
400 if (!(result.corruptions || result.leaks || result.check_errors)) {
401 printf("No errors were found on the image.\n");
402 } else {
403 if (result.corruptions) {
404 printf("\n%d errors were found on the image.\n"
405 "Data may be corrupted, or further writes to the image "
406 "may corrupt it.\n",
407 result.corruptions);
408 }
409
410 if (result.leaks) {
411 printf("\n%d leaked clusters were found on the image.\n"
412 "This means waste of disk space, but no harm to data.\n",
413 result.leaks);
414 }
415
416 if (result.check_errors) {
417 printf("\n%d internal errors have occurred during the check.\n",
418 result.check_errors);
419 }
420 }
421
422 bdrv_delete(bs);
423
424 if (ret < 0 || result.check_errors) {
425 printf("\nAn error has occurred during the check: %s\n"
426 "The check is not complete and may have missed error.\n",
427 strerror(-ret));
428 return 1;
429 }
430
431 if (result.corruptions) {
432 return 2;
433 } else if (result.leaks) {
434 return 3;
435 } else {
436 return 0;
437 }
438 }
439
440 static int img_commit(int argc, char **argv)
441 {
442 int c, ret;
443 const char *filename, *fmt;
444 BlockDriverState *bs;
445
446 fmt = NULL;
447 for(;;) {
448 c = getopt(argc, argv, "f:h");
449 if (c == -1) {
450 break;
451 }
452 switch(c) {
453 case '?':
454 case 'h':
455 help();
456 break;
457 case 'f':
458 fmt = optarg;
459 break;
460 }
461 }
462 if (optind >= argc) {
463 help();
464 }
465 filename = argv[optind++];
466
467 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS | BDRV_O_RDWR);
468 if (!bs) {
469 return 1;
470 }
471 ret = bdrv_commit(bs);
472 switch(ret) {
473 case 0:
474 printf("Image committed.\n");
475 break;
476 case -ENOENT:
477 error_report("No disk inserted");
478 break;
479 case -EACCES:
480 error_report("Image is read-only");
481 break;
482 case -ENOTSUP:
483 error_report("Image is already committed");
484 break;
485 default:
486 error_report("Error while committing image");
487 break;
488 }
489
490 bdrv_delete(bs);
491 if (ret) {
492 return 1;
493 }
494 return 0;
495 }
496
497 static int is_not_zero(const uint8_t *sector, int len)
498 {
499 int i;
500 len >>= 2;
501 for(i = 0;i < len; i++) {
502 if (((uint32_t *)sector)[i] != 0)
503 return 1;
504 }
505 return 0;
506 }
507
508 /*
509 * Returns true iff the first sector pointed to by 'buf' contains at least
510 * a non-NUL byte.
511 *
512 * 'pnum' is set to the number of sectors (including and immediately following
513 * the first one) that are known to be in the same allocated/unallocated state.
514 */
515 static int is_allocated_sectors(const uint8_t *buf, int n, int *pnum)
516 {
517 int v, i;
518
519 if (n <= 0) {
520 *pnum = 0;
521 return 0;
522 }
523 v = is_not_zero(buf, 512);
524 for(i = 1; i < n; i++) {
525 buf += 512;
526 if (v != is_not_zero(buf, 512))
527 break;
528 }
529 *pnum = i;
530 return v;
531 }
532
533 /*
534 * Compares two buffers sector by sector. Returns 0 if the first sector of both
535 * buffers matches, non-zero otherwise.
536 *
537 * pnum is set to the number of sectors (including and immediately following
538 * the first one) that are known to have the same comparison result
539 */
540 static int compare_sectors(const uint8_t *buf1, const uint8_t *buf2, int n,
541 int *pnum)
542 {
543 int res, i;
544
545 if (n <= 0) {
546 *pnum = 0;
547 return 0;
548 }
549
550 res = !!memcmp(buf1, buf2, 512);
551 for(i = 1; i < n; i++) {
552 buf1 += 512;
553 buf2 += 512;
554
555 if (!!memcmp(buf1, buf2, 512) != res) {
556 break;
557 }
558 }
559
560 *pnum = i;
561 return res;
562 }
563
564 #define IO_BUF_SIZE (2 * 1024 * 1024)
565
566 static int img_convert(int argc, char **argv)
567 {
568 int c, ret = 0, n, n1, bs_n, bs_i, compress, cluster_size, cluster_sectors;
569 const char *fmt, *out_fmt, *out_baseimg, *out_filename;
570 BlockDriver *drv, *proto_drv;
571 BlockDriverState **bs = NULL, *out_bs = NULL;
572 int64_t total_sectors, nb_sectors, sector_num, bs_offset;
573 uint64_t bs_sectors;
574 uint8_t * buf = NULL;
575 const uint8_t *buf1;
576 BlockDriverInfo bdi;
577 QEMUOptionParameter *param = NULL, *create_options = NULL;
578 QEMUOptionParameter *out_baseimg_param;
579 char *options = NULL;
580 const char *snapshot_name = NULL;
581
582 fmt = NULL;
583 out_fmt = "raw";
584 out_baseimg = NULL;
585 compress = 0;
586 for(;;) {
587 c = getopt(argc, argv, "f:O:B:s:hce6o:");
588 if (c == -1) {
589 break;
590 }
591 switch(c) {
592 case '?':
593 case 'h':
594 help();
595 break;
596 case 'f':
597 fmt = optarg;
598 break;
599 case 'O':
600 out_fmt = optarg;
601 break;
602 case 'B':
603 out_baseimg = optarg;
604 break;
605 case 'c':
606 compress = 1;
607 break;
608 case 'e':
609 error_report("qemu-img: option -e is deprecated, please use \'-o "
610 "encryption\' instead!");
611 return 1;
612 case '6':
613 error_report("qemu-img: option -6 is deprecated, please use \'-o "
614 "compat6\' instead!");
615 return 1;
616 case 'o':
617 options = optarg;
618 break;
619 case 's':
620 snapshot_name = optarg;
621 break;
622 }
623 }
624
625 bs_n = argc - optind - 1;
626 if (bs_n < 1) {
627 help();
628 }
629
630 out_filename = argv[argc - 1];
631
632 if (options && !strcmp(options, "?")) {
633 ret = print_block_option_help(out_filename, out_fmt);
634 goto out;
635 }
636
637 if (bs_n > 1 && out_baseimg) {
638 error_report("-B makes no sense when concatenating multiple input "
639 "images");
640 ret = -1;
641 goto out;
642 }
643
644 bs = qemu_mallocz(bs_n * sizeof(BlockDriverState *));
645
646 total_sectors = 0;
647 for (bs_i = 0; bs_i < bs_n; bs_i++) {
648 bs[bs_i] = bdrv_new_open(argv[optind + bs_i], fmt, BDRV_O_FLAGS);
649 if (!bs[bs_i]) {
650 error_report("Could not open '%s'", argv[optind + bs_i]);
651 ret = -1;
652 goto out;
653 }
654 bdrv_get_geometry(bs[bs_i], &bs_sectors);
655 total_sectors += bs_sectors;
656 }
657
658 if (snapshot_name != NULL) {
659 if (bs_n > 1) {
660 error_report("No support for concatenating multiple snapshot\n");
661 ret = -1;
662 goto out;
663 }
664 if (bdrv_snapshot_load_tmp(bs[0], snapshot_name) < 0) {
665 error_report("Failed to load snapshot\n");
666 ret = -1;
667 goto out;
668 }
669 }
670
671 /* Find driver and parse its options */
672 drv = bdrv_find_format(out_fmt);
673 if (!drv) {
674 error_report("Unknown file format '%s'", out_fmt);
675 ret = -1;
676 goto out;
677 }
678
679 proto_drv = bdrv_find_protocol(out_filename);
680 if (!proto_drv) {
681 error_report("Unknown protocol '%s'", out_filename);
682 ret = -1;
683 goto out;
684 }
685
686 create_options = append_option_parameters(create_options,
687 drv->create_options);
688 create_options = append_option_parameters(create_options,
689 proto_drv->create_options);
690
691 if (options) {
692 param = parse_option_parameters(options, create_options, param);
693 if (param == NULL) {
694 error_report("Invalid options for file format '%s'.", out_fmt);
695 ret = -1;
696 goto out;
697 }
698 } else {
699 param = parse_option_parameters("", create_options, param);
700 }
701
702 set_option_parameter_int(param, BLOCK_OPT_SIZE, total_sectors * 512);
703 ret = add_old_style_options(out_fmt, param, out_baseimg, NULL);
704 if (ret < 0) {
705 goto out;
706 }
707
708 /* Get backing file name if -o backing_file was used */
709 out_baseimg_param = get_option_parameter(param, BLOCK_OPT_BACKING_FILE);
710 if (out_baseimg_param) {
711 out_baseimg = out_baseimg_param->value.s;
712 }
713
714 /* Check if compression is supported */
715 if (compress) {
716 QEMUOptionParameter *encryption =
717 get_option_parameter(param, BLOCK_OPT_ENCRYPT);
718
719 if (!drv->bdrv_write_compressed) {
720 error_report("Compression not supported for this file format");
721 ret = -1;
722 goto out;
723 }
724
725 if (encryption && encryption->value.n) {
726 error_report("Compression and encryption not supported at "
727 "the same time");
728 ret = -1;
729 goto out;
730 }
731 }
732
733 /* Create the new image */
734 ret = bdrv_create(drv, out_filename, param);
735 if (ret < 0) {
736 if (ret == -ENOTSUP) {
737 error_report("Formatting not supported for file format '%s'",
738 out_fmt);
739 } else if (ret == -EFBIG) {
740 error_report("The image size is too large for file format '%s'",
741 out_fmt);
742 } else {
743 error_report("%s: error while converting %s: %s",
744 out_filename, out_fmt, strerror(-ret));
745 }
746 goto out;
747 }
748
749 out_bs = bdrv_new_open(out_filename, out_fmt,
750 BDRV_O_FLAGS | BDRV_O_RDWR | BDRV_O_NO_FLUSH);
751 if (!out_bs) {
752 ret = -1;
753 goto out;
754 }
755
756 bs_i = 0;
757 bs_offset = 0;
758 bdrv_get_geometry(bs[0], &bs_sectors);
759 buf = qemu_malloc(IO_BUF_SIZE);
760
761 if (compress) {
762 ret = bdrv_get_info(out_bs, &bdi);
763 if (ret < 0) {
764 error_report("could not get block driver info");
765 goto out;
766 }
767 cluster_size = bdi.cluster_size;
768 if (cluster_size <= 0 || cluster_size > IO_BUF_SIZE) {
769 error_report("invalid cluster size");
770 ret = -1;
771 goto out;
772 }
773 cluster_sectors = cluster_size >> 9;
774 sector_num = 0;
775 for(;;) {
776 int64_t bs_num;
777 int remainder;
778 uint8_t *buf2;
779
780 nb_sectors = total_sectors - sector_num;
781 if (nb_sectors <= 0)
782 break;
783 if (nb_sectors >= cluster_sectors)
784 n = cluster_sectors;
785 else
786 n = nb_sectors;
787
788 bs_num = sector_num - bs_offset;
789 assert (bs_num >= 0);
790 remainder = n;
791 buf2 = buf;
792 while (remainder > 0) {
793 int nlow;
794 while (bs_num == bs_sectors) {
795 bs_i++;
796 assert (bs_i < bs_n);
797 bs_offset += bs_sectors;
798 bdrv_get_geometry(bs[bs_i], &bs_sectors);
799 bs_num = 0;
800 /* printf("changing part: sector_num=%" PRId64 ", "
801 "bs_i=%d, bs_offset=%" PRId64 ", bs_sectors=%" PRId64
802 "\n", sector_num, bs_i, bs_offset, bs_sectors); */
803 }
804 assert (bs_num < bs_sectors);
805
806 nlow = (remainder > bs_sectors - bs_num) ? bs_sectors - bs_num : remainder;
807
808 ret = bdrv_read(bs[bs_i], bs_num, buf2, nlow);
809 if (ret < 0) {
810 error_report("error while reading");
811 goto out;
812 }
813
814 buf2 += nlow * 512;
815 bs_num += nlow;
816
817 remainder -= nlow;
818 }
819 assert (remainder == 0);
820
821 if (n < cluster_sectors) {
822 memset(buf + n * 512, 0, cluster_size - n * 512);
823 }
824 if (is_not_zero(buf, cluster_size)) {
825 ret = bdrv_write_compressed(out_bs, sector_num, buf,
826 cluster_sectors);
827 if (ret != 0) {
828 error_report("error while compressing sector %" PRId64,
829 sector_num);
830 goto out;
831 }
832 }
833 sector_num += n;
834 }
835 /* signal EOF to align */
836 bdrv_write_compressed(out_bs, 0, NULL, 0);
837 } else {
838 int has_zero_init = bdrv_has_zero_init(out_bs);
839
840 sector_num = 0; // total number of sectors converted so far
841 for(;;) {
842 nb_sectors = total_sectors - sector_num;
843 if (nb_sectors <= 0) {
844 break;
845 }
846 if (nb_sectors >= (IO_BUF_SIZE / 512)) {
847 n = (IO_BUF_SIZE / 512);
848 } else {
849 n = nb_sectors;
850 }
851
852 while (sector_num - bs_offset >= 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 /* printf("changing part: sector_num=%" PRId64 ", bs_i=%d, "
858 "bs_offset=%" PRId64 ", bs_sectors=%" PRId64 "\n",
859 sector_num, bs_i, bs_offset, bs_sectors); */
860 }
861
862 if (n > bs_offset + bs_sectors - sector_num) {
863 n = bs_offset + bs_sectors - sector_num;
864 }
865
866 if (has_zero_init) {
867 /* If the output image is being created as a copy on write image,
868 assume that sectors which are unallocated in the input image
869 are present in both the output's and input's base images (no
870 need to copy them). */
871 if (out_baseimg) {
872 if (!bdrv_is_allocated(bs[bs_i], sector_num - bs_offset,
873 n, &n1)) {
874 sector_num += n1;
875 continue;
876 }
877 /* The next 'n1' sectors are allocated in the input image. Copy
878 only those as they may be followed by unallocated sectors. */
879 n = n1;
880 }
881 } else {
882 n1 = n;
883 }
884
885 ret = bdrv_read(bs[bs_i], sector_num - bs_offset, buf, n);
886 if (ret < 0) {
887 error_report("error while reading");
888 goto out;
889 }
890 /* NOTE: at the same time we convert, we do not write zero
891 sectors to have a chance to compress the image. Ideally, we
892 should add a specific call to have the info to go faster */
893 buf1 = buf;
894 while (n > 0) {
895 /* If the output image is being created as a copy on write image,
896 copy all sectors even the ones containing only NUL bytes,
897 because they may differ from the sectors in the base image.
898
899 If the output is to a host device, we also write out
900 sectors that are entirely 0, since whatever data was
901 already there is garbage, not 0s. */
902 if (!has_zero_init || out_baseimg ||
903 is_allocated_sectors(buf1, n, &n1)) {
904 ret = bdrv_write(out_bs, sector_num, buf1, n1);
905 if (ret < 0) {
906 error_report("error while writing");
907 goto out;
908 }
909 }
910 sector_num += n1;
911 n -= n1;
912 buf1 += n1 * 512;
913 }
914 }
915 }
916 out:
917 free_option_parameters(create_options);
918 free_option_parameters(param);
919 qemu_free(buf);
920 if (out_bs) {
921 bdrv_delete(out_bs);
922 }
923 if (bs) {
924 for (bs_i = 0; bs_i < bs_n; bs_i++) {
925 if (bs[bs_i]) {
926 bdrv_delete(bs[bs_i]);
927 }
928 }
929 qemu_free(bs);
930 }
931 if (ret) {
932 return 1;
933 }
934 return 0;
935 }
936
937 #ifdef _WIN32
938 static int64_t get_allocated_file_size(const char *filename)
939 {
940 typedef DWORD (WINAPI * get_compressed_t)(const char *filename, DWORD *high);
941 get_compressed_t get_compressed;
942 struct _stati64 st;
943
944 /* WinNT support GetCompressedFileSize to determine allocate size */
945 get_compressed = (get_compressed_t) GetProcAddress(GetModuleHandle("kernel32"), "GetCompressedFileSizeA");
946 if (get_compressed) {
947 DWORD high, low;
948 low = get_compressed(filename, &high);
949 if (low != 0xFFFFFFFFlu || GetLastError() == NO_ERROR)
950 return (((int64_t) high) << 32) + low;
951 }
952
953 if (_stati64(filename, &st) < 0)
954 return -1;
955 return st.st_size;
956 }
957 #else
958 static int64_t get_allocated_file_size(const char *filename)
959 {
960 struct stat st;
961 if (stat(filename, &st) < 0)
962 return -1;
963 return (int64_t)st.st_blocks * 512;
964 }
965 #endif
966
967 static void dump_snapshots(BlockDriverState *bs)
968 {
969 QEMUSnapshotInfo *sn_tab, *sn;
970 int nb_sns, i;
971 char buf[256];
972
973 nb_sns = bdrv_snapshot_list(bs, &sn_tab);
974 if (nb_sns <= 0)
975 return;
976 printf("Snapshot list:\n");
977 printf("%s\n", bdrv_snapshot_dump(buf, sizeof(buf), NULL));
978 for(i = 0; i < nb_sns; i++) {
979 sn = &sn_tab[i];
980 printf("%s\n", bdrv_snapshot_dump(buf, sizeof(buf), sn));
981 }
982 qemu_free(sn_tab);
983 }
984
985 static int img_info(int argc, char **argv)
986 {
987 int c;
988 const char *filename, *fmt;
989 BlockDriverState *bs;
990 char fmt_name[128], size_buf[128], dsize_buf[128];
991 uint64_t total_sectors;
992 int64_t allocated_size;
993 char backing_filename[1024];
994 char backing_filename2[1024];
995 BlockDriverInfo bdi;
996
997 fmt = NULL;
998 for(;;) {
999 c = getopt(argc, argv, "f:h");
1000 if (c == -1) {
1001 break;
1002 }
1003 switch(c) {
1004 case '?':
1005 case 'h':
1006 help();
1007 break;
1008 case 'f':
1009 fmt = optarg;
1010 break;
1011 }
1012 }
1013 if (optind >= argc) {
1014 help();
1015 }
1016 filename = argv[optind++];
1017
1018 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS | BDRV_O_NO_BACKING);
1019 if (!bs) {
1020 return 1;
1021 }
1022 bdrv_get_format(bs, fmt_name, sizeof(fmt_name));
1023 bdrv_get_geometry(bs, &total_sectors);
1024 get_human_readable_size(size_buf, sizeof(size_buf), total_sectors * 512);
1025 allocated_size = get_allocated_file_size(filename);
1026 if (allocated_size < 0) {
1027 snprintf(dsize_buf, sizeof(dsize_buf), "unavailable");
1028 } else {
1029 get_human_readable_size(dsize_buf, sizeof(dsize_buf),
1030 allocated_size);
1031 }
1032 printf("image: %s\n"
1033 "file format: %s\n"
1034 "virtual size: %s (%" PRId64 " bytes)\n"
1035 "disk size: %s\n",
1036 filename, fmt_name, size_buf,
1037 (total_sectors * 512),
1038 dsize_buf);
1039 if (bdrv_is_encrypted(bs)) {
1040 printf("encrypted: yes\n");
1041 }
1042 if (bdrv_get_info(bs, &bdi) >= 0) {
1043 if (bdi.cluster_size != 0) {
1044 printf("cluster_size: %d\n", bdi.cluster_size);
1045 }
1046 }
1047 bdrv_get_backing_filename(bs, backing_filename, sizeof(backing_filename));
1048 if (backing_filename[0] != '\0') {
1049 path_combine(backing_filename2, sizeof(backing_filename2),
1050 filename, backing_filename);
1051 printf("backing file: %s (actual path: %s)\n",
1052 backing_filename,
1053 backing_filename2);
1054 }
1055 dump_snapshots(bs);
1056 bdrv_delete(bs);
1057 return 0;
1058 }
1059
1060 #define SNAPSHOT_LIST 1
1061 #define SNAPSHOT_CREATE 2
1062 #define SNAPSHOT_APPLY 3
1063 #define SNAPSHOT_DELETE 4
1064
1065 static int img_snapshot(int argc, char **argv)
1066 {
1067 BlockDriverState *bs;
1068 QEMUSnapshotInfo sn;
1069 char *filename, *snapshot_name = NULL;
1070 int c, ret = 0, bdrv_oflags;
1071 int action = 0;
1072 qemu_timeval tv;
1073
1074 bdrv_oflags = BDRV_O_RDWR;
1075 /* Parse commandline parameters */
1076 for(;;) {
1077 c = getopt(argc, argv, "la:c:d:h");
1078 if (c == -1) {
1079 break;
1080 }
1081 switch(c) {
1082 case '?':
1083 case 'h':
1084 help();
1085 return 0;
1086 case 'l':
1087 if (action) {
1088 help();
1089 return 0;
1090 }
1091 action = SNAPSHOT_LIST;
1092 bdrv_oflags &= ~BDRV_O_RDWR; /* no need for RW */
1093 break;
1094 case 'a':
1095 if (action) {
1096 help();
1097 return 0;
1098 }
1099 action = SNAPSHOT_APPLY;
1100 snapshot_name = optarg;
1101 break;
1102 case 'c':
1103 if (action) {
1104 help();
1105 return 0;
1106 }
1107 action = SNAPSHOT_CREATE;
1108 snapshot_name = optarg;
1109 break;
1110 case 'd':
1111 if (action) {
1112 help();
1113 return 0;
1114 }
1115 action = SNAPSHOT_DELETE;
1116 snapshot_name = optarg;
1117 break;
1118 }
1119 }
1120
1121 if (optind >= argc) {
1122 help();
1123 }
1124 filename = argv[optind++];
1125
1126 /* Open the image */
1127 bs = bdrv_new_open(filename, NULL, bdrv_oflags);
1128 if (!bs) {
1129 return 1;
1130 }
1131
1132 /* Perform the requested action */
1133 switch(action) {
1134 case SNAPSHOT_LIST:
1135 dump_snapshots(bs);
1136 break;
1137
1138 case SNAPSHOT_CREATE:
1139 memset(&sn, 0, sizeof(sn));
1140 pstrcpy(sn.name, sizeof(sn.name), snapshot_name);
1141
1142 qemu_gettimeofday(&tv);
1143 sn.date_sec = tv.tv_sec;
1144 sn.date_nsec = tv.tv_usec * 1000;
1145
1146 ret = bdrv_snapshot_create(bs, &sn);
1147 if (ret) {
1148 error_report("Could not create snapshot '%s': %d (%s)",
1149 snapshot_name, ret, strerror(-ret));
1150 }
1151 break;
1152
1153 case SNAPSHOT_APPLY:
1154 ret = bdrv_snapshot_goto(bs, snapshot_name);
1155 if (ret) {
1156 error_report("Could not apply snapshot '%s': %d (%s)",
1157 snapshot_name, ret, strerror(-ret));
1158 }
1159 break;
1160
1161 case SNAPSHOT_DELETE:
1162 ret = bdrv_snapshot_delete(bs, snapshot_name);
1163 if (ret) {
1164 error_report("Could not delete snapshot '%s': %d (%s)",
1165 snapshot_name, ret, strerror(-ret));
1166 }
1167 break;
1168 }
1169
1170 /* Cleanup */
1171 bdrv_delete(bs);
1172 if (ret) {
1173 return 1;
1174 }
1175 return 0;
1176 }
1177
1178 static int img_rebase(int argc, char **argv)
1179 {
1180 BlockDriverState *bs, *bs_old_backing = NULL, *bs_new_backing = NULL;
1181 BlockDriver *old_backing_drv, *new_backing_drv;
1182 char *filename;
1183 const char *fmt, *out_basefmt, *out_baseimg;
1184 int c, flags, ret;
1185 int unsafe = 0;
1186
1187 /* Parse commandline parameters */
1188 fmt = NULL;
1189 out_baseimg = NULL;
1190 out_basefmt = NULL;
1191
1192 for(;;) {
1193 c = getopt(argc, argv, "uhf:F:b:");
1194 if (c == -1) {
1195 break;
1196 }
1197 switch(c) {
1198 case '?':
1199 case 'h':
1200 help();
1201 return 0;
1202 case 'f':
1203 fmt = optarg;
1204 break;
1205 case 'F':
1206 out_basefmt = optarg;
1207 break;
1208 case 'b':
1209 out_baseimg = optarg;
1210 break;
1211 case 'u':
1212 unsafe = 1;
1213 break;
1214 }
1215 }
1216
1217 if ((optind >= argc) || !out_baseimg) {
1218 help();
1219 }
1220 filename = argv[optind++];
1221
1222 /*
1223 * Open the images.
1224 *
1225 * Ignore the old backing file for unsafe rebase in case we want to correct
1226 * the reference to a renamed or moved backing file.
1227 */
1228 flags = BDRV_O_FLAGS | BDRV_O_RDWR | (unsafe ? BDRV_O_NO_BACKING : 0);
1229 bs = bdrv_new_open(filename, fmt, flags);
1230 if (!bs) {
1231 return 1;
1232 }
1233
1234 /* Find the right drivers for the backing files */
1235 old_backing_drv = NULL;
1236 new_backing_drv = NULL;
1237
1238 if (!unsafe && bs->backing_format[0] != '\0') {
1239 old_backing_drv = bdrv_find_format(bs->backing_format);
1240 if (old_backing_drv == NULL) {
1241 error_report("Invalid format name: '%s'", bs->backing_format);
1242 ret = -1;
1243 goto out;
1244 }
1245 }
1246
1247 if (out_basefmt != NULL) {
1248 new_backing_drv = bdrv_find_format(out_basefmt);
1249 if (new_backing_drv == NULL) {
1250 error_report("Invalid format name: '%s'", out_basefmt);
1251 ret = -1;
1252 goto out;
1253 }
1254 }
1255
1256 /* For safe rebasing we need to compare old and new backing file */
1257 if (unsafe) {
1258 /* Make the compiler happy */
1259 bs_old_backing = NULL;
1260 bs_new_backing = NULL;
1261 } else {
1262 char backing_name[1024];
1263
1264 bs_old_backing = bdrv_new("old_backing");
1265 bdrv_get_backing_filename(bs, backing_name, sizeof(backing_name));
1266 ret = bdrv_open(bs_old_backing, backing_name, BDRV_O_FLAGS,
1267 old_backing_drv);
1268 if (ret) {
1269 error_report("Could not open old backing file '%s'", backing_name);
1270 goto out;
1271 }
1272
1273 bs_new_backing = bdrv_new("new_backing");
1274 ret = bdrv_open(bs_new_backing, out_baseimg, BDRV_O_FLAGS,
1275 new_backing_drv);
1276 if (ret) {
1277 error_report("Could not open new backing file '%s'", out_baseimg);
1278 goto out;
1279 }
1280 }
1281
1282 /*
1283 * Check each unallocated cluster in the COW file. If it is unallocated,
1284 * accesses go to the backing file. We must therefore compare this cluster
1285 * in the old and new backing file, and if they differ we need to copy it
1286 * from the old backing file into the COW file.
1287 *
1288 * If qemu-img crashes during this step, no harm is done. The content of
1289 * the image is the same as the original one at any time.
1290 */
1291 if (!unsafe) {
1292 uint64_t num_sectors;
1293 uint64_t sector;
1294 int n;
1295 uint8_t * buf_old;
1296 uint8_t * buf_new;
1297
1298 buf_old = qemu_malloc(IO_BUF_SIZE);
1299 buf_new = qemu_malloc(IO_BUF_SIZE);
1300
1301 bdrv_get_geometry(bs, &num_sectors);
1302
1303 for (sector = 0; sector < num_sectors; sector += n) {
1304
1305 /* How many sectors can we handle with the next read? */
1306 if (sector + (IO_BUF_SIZE / 512) <= num_sectors) {
1307 n = (IO_BUF_SIZE / 512);
1308 } else {
1309 n = num_sectors - sector;
1310 }
1311
1312 /* If the cluster is allocated, we don't need to take action */
1313 ret = bdrv_is_allocated(bs, sector, n, &n);
1314 if (ret) {
1315 continue;
1316 }
1317
1318 /* Read old and new backing file */
1319 ret = bdrv_read(bs_old_backing, sector, buf_old, n);
1320 if (ret < 0) {
1321 error_report("error while reading from old backing file");
1322 goto out;
1323 }
1324 ret = bdrv_read(bs_new_backing, sector, buf_new, n);
1325 if (ret < 0) {
1326 error_report("error while reading from new backing file");
1327 goto out;
1328 }
1329
1330 /* If they differ, we need to write to the COW file */
1331 uint64_t written = 0;
1332
1333 while (written < n) {
1334 int pnum;
1335
1336 if (compare_sectors(buf_old + written * 512,
1337 buf_new + written * 512, n - written, &pnum))
1338 {
1339 ret = bdrv_write(bs, sector + written,
1340 buf_old + written * 512, pnum);
1341 if (ret < 0) {
1342 error_report("Error while writing to COW image: %s",
1343 strerror(-ret));
1344 goto out;
1345 }
1346 }
1347
1348 written += pnum;
1349 }
1350 }
1351
1352 qemu_free(buf_old);
1353 qemu_free(buf_new);
1354 }
1355
1356 /*
1357 * Change the backing file. All clusters that are different from the old
1358 * backing file are overwritten in the COW file now, so the visible content
1359 * doesn't change when we switch the backing file.
1360 */
1361 ret = bdrv_change_backing_file(bs, out_baseimg, out_basefmt);
1362 if (ret == -ENOSPC) {
1363 error_report("Could not change the backing file to '%s': No "
1364 "space left in the file header", out_baseimg);
1365 } else if (ret < 0) {
1366 error_report("Could not change the backing file to '%s': %s",
1367 out_baseimg, strerror(-ret));
1368 }
1369
1370 /*
1371 * TODO At this point it is possible to check if any clusters that are
1372 * allocated in the COW file are the same in the backing file. If so, they
1373 * could be dropped from the COW file. Don't do this before switching the
1374 * backing file, in case of a crash this would lead to corruption.
1375 */
1376 out:
1377 /* Cleanup */
1378 if (!unsafe) {
1379 bdrv_delete(bs_old_backing);
1380 bdrv_delete(bs_new_backing);
1381 }
1382
1383 bdrv_delete(bs);
1384 if (ret) {
1385 return 1;
1386 }
1387 return 0;
1388 }
1389
1390 static int img_resize(int argc, char **argv)
1391 {
1392 int c, ret, relative;
1393 const char *filename, *fmt, *size;
1394 int64_t n, total_size;
1395 BlockDriverState *bs = NULL;
1396 QEMUOptionParameter *param;
1397 QEMUOptionParameter resize_options[] = {
1398 {
1399 .name = BLOCK_OPT_SIZE,
1400 .type = OPT_SIZE,
1401 .help = "Virtual disk size"
1402 },
1403 { NULL }
1404 };
1405
1406 fmt = NULL;
1407 for(;;) {
1408 c = getopt(argc, argv, "f:h");
1409 if (c == -1) {
1410 break;
1411 }
1412 switch(c) {
1413 case '?':
1414 case 'h':
1415 help();
1416 break;
1417 case 'f':
1418 fmt = optarg;
1419 break;
1420 }
1421 }
1422 if (optind + 1 >= argc) {
1423 help();
1424 }
1425 filename = argv[optind++];
1426 size = argv[optind++];
1427
1428 /* Choose grow, shrink, or absolute resize mode */
1429 switch (size[0]) {
1430 case '+':
1431 relative = 1;
1432 size++;
1433 break;
1434 case '-':
1435 relative = -1;
1436 size++;
1437 break;
1438 default:
1439 relative = 0;
1440 break;
1441 }
1442
1443 /* Parse size */
1444 param = parse_option_parameters("", resize_options, NULL);
1445 if (set_option_parameter(param, BLOCK_OPT_SIZE, size)) {
1446 /* Error message already printed when size parsing fails */
1447 ret = -1;
1448 goto out;
1449 }
1450 n = get_option_parameter(param, BLOCK_OPT_SIZE)->value.n;
1451 free_option_parameters(param);
1452
1453 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS | BDRV_O_RDWR);
1454 if (!bs) {
1455 ret = -1;
1456 goto out;
1457 }
1458
1459 if (relative) {
1460 total_size = bdrv_getlength(bs) + n * relative;
1461 } else {
1462 total_size = n;
1463 }
1464 if (total_size <= 0) {
1465 error_report("New image size must be positive");
1466 ret = -1;
1467 goto out;
1468 }
1469
1470 ret = bdrv_truncate(bs, total_size);
1471 switch (ret) {
1472 case 0:
1473 printf("Image resized.\n");
1474 break;
1475 case -ENOTSUP:
1476 error_report("This image format does not support resize");
1477 break;
1478 case -EACCES:
1479 error_report("Image is read-only");
1480 break;
1481 default:
1482 error_report("Error resizing image (%d)", -ret);
1483 break;
1484 }
1485 out:
1486 if (bs) {
1487 bdrv_delete(bs);
1488 }
1489 if (ret) {
1490 return 1;
1491 }
1492 return 0;
1493 }
1494
1495 static const img_cmd_t img_cmds[] = {
1496 #define DEF(option, callback, arg_string) \
1497 { option, callback },
1498 #include "qemu-img-cmds.h"
1499 #undef DEF
1500 #undef GEN_DOCS
1501 { NULL, NULL, },
1502 };
1503
1504 int main(int argc, char **argv)
1505 {
1506 const img_cmd_t *cmd;
1507 const char *cmdname;
1508
1509 error_set_progname(argv[0]);
1510
1511 bdrv_init();
1512 if (argc < 2)
1513 help();
1514 cmdname = argv[1];
1515 argc--; argv++;
1516
1517 /* find the command */
1518 for(cmd = img_cmds; cmd->name != NULL; cmd++) {
1519 if (!strcmp(cmdname, cmd->name)) {
1520 return cmd->handler(argc, argv);
1521 }
1522 }
1523
1524 /* not found */
1525 help();
1526 return 0;
1527 }