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
24 #include "qemu-common.h"
25 #include "qemu-option.h"
26 #include "qemu-error.h"
29 #include "block_int.h"
36 typedef struct img_cmd_t
{
38 int (*handler
)(int argc
, char **argv
);
41 /* Default to cache=writeback as data integrity is not important for qemu-tcg. */
42 #define BDRV_O_FLAGS BDRV_O_CACHE_WB
44 static void format_print(void *opaque
, const char *name
)
49 /* Please keep in synch with qemu-img.texi */
50 static void help(void)
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"
58 #define DEF(option, callback, arg_string) \
60 #include "qemu-img-cmds.h"
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"
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"
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";
88 printf("%s\nSupported formats:", help_msg
);
89 bdrv_iterate_format(format_print
, NULL
);
95 /* XXX: put correct support for win32 */
96 static int read_password(char *buf
, int buf_size
)
106 if (i
< (buf_size
- 1))
117 static struct termios oldtty
;
119 static void term_exit(void)
121 tcsetattr (0, TCSANOW
, &oldtty
);
124 static void term_init(void)
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
);
140 tcsetattr (0, TCSANOW
, &tty
);
145 static int read_password(char *buf
, int buf_size
)
150 printf("password: ");
155 ret
= read(0, &ch
, 1);
157 if (errno
== EAGAIN
|| errno
== EINTR
) {
163 } else if (ret
== 0) {
171 if (i
< (buf_size
- 1))
182 static int print_block_option_help(const char *filename
, const char *fmt
)
184 BlockDriver
*drv
, *proto_drv
;
185 QEMUOptionParameter
*create_options
= NULL
;
187 /* Find driver and parse its options */
188 drv
= bdrv_find_format(fmt
);
190 error_report("Unknown file format '%s'", fmt
);
194 proto_drv
= bdrv_find_protocol(filename
);
196 error_report("Unknown protocol '%s'", filename
);
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
);
209 static BlockDriverState
*bdrv_new_open(const char *filename
,
213 BlockDriverState
*bs
;
220 drv
= bdrv_find_format(fmt
);
222 error_report("Unknown file format '%s'", fmt
);
228 if (bdrv_open(bs
, filename
, flags
, drv
) < 0) {
229 error_report("Could not open '%s'", filename
);
232 if (bdrv_is_encrypted(bs
)) {
233 printf("Disk image '%s' is encrypted.\n", filename
);
234 if (read_password(password
, sizeof(password
)) < 0) {
235 error_report("No password given");
238 if (bdrv_set_key(bs
, password
) < 0) {
239 error_report("invalid password");
251 static int add_old_style_options(const char *fmt
, QEMUOptionParameter
*list
,
252 const char *base_filename
,
253 const char *base_fmt
)
256 if (set_option_parameter(list
, BLOCK_OPT_BACKING_FILE
, base_filename
)) {
257 error_report("Backing file not supported for file format '%s'",
263 if (set_option_parameter(list
, BLOCK_OPT_BACKING_FMT
, base_fmt
)) {
264 error_report("Backing file format not supported for file "
272 static int img_create(int argc
, char **argv
)
275 uint64_t img_size
= -1;
276 const char *fmt
= "raw";
277 const char *base_fmt
= NULL
;
278 const char *filename
;
279 const char *base_filename
= NULL
;
280 char *options
= NULL
;
283 c
= getopt(argc
, argv
, "F:b:f:he6o:");
296 base_filename
= optarg
;
302 error_report("qemu-img: option -e is deprecated, please use \'-o "
303 "encryption\' instead!");
306 error_report("qemu-img: option -6 is deprecated, please use \'-o "
307 "compat6\' instead!");
315 /* Get the filename */
316 if (optind
>= argc
) {
319 filename
= argv
[optind
++];
321 /* Get image size, if specified */
324 sval
= strtosz_suffix(argv
[optind
++], NULL
, STRTOSZ_DEFSUFFIX_B
);
326 error_report("Invalid image size specified! You may use k, M, G or "
328 error_report("kilobytes, megabytes, gigabytes and terabytes.");
332 img_size
= (uint64_t)sval
;
335 if (options
&& !strcmp(options
, "?")) {
336 ret
= print_block_option_help(filename
, fmt
);
340 ret
= bdrv_img_create(filename
, fmt
, base_filename
, base_fmt
,
341 options
, img_size
, BDRV_O_FLAGS
);
350 * Checks an image for consistency. Exit codes:
352 * 0 - Check completed, image is good
353 * 1 - Check not completed because of internal errors
354 * 2 - Check completed, image is corrupted
355 * 3 - Check completed, image has leaked clusters, but is good otherwise
357 static int img_check(int argc
, char **argv
)
360 const char *filename
, *fmt
;
361 BlockDriverState
*bs
;
362 BdrvCheckResult result
;
366 c
= getopt(argc
, argv
, "f:h");
380 if (optind
>= argc
) {
383 filename
= argv
[optind
++];
385 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
);
389 ret
= bdrv_check(bs
, &result
);
391 if (ret
== -ENOTSUP
) {
392 error_report("This image format does not support checks");
397 if (!(result
.corruptions
|| result
.leaks
|| result
.check_errors
)) {
398 printf("No errors were found on the image.\n");
400 if (result
.corruptions
) {
401 printf("\n%d errors were found on the image.\n"
402 "Data may be corrupted, or further writes to the image "
408 printf("\n%d leaked clusters were found on the image.\n"
409 "This means waste of disk space, but no harm to data.\n",
413 if (result
.check_errors
) {
414 printf("\n%d internal errors have occurred during the check.\n",
415 result
.check_errors
);
421 if (ret
< 0 || result
.check_errors
) {
422 printf("\nAn error has occurred during the check: %s\n"
423 "The check is not complete and may have missed error.\n",
428 if (result
.corruptions
) {
430 } else if (result
.leaks
) {
437 static int img_commit(int argc
, char **argv
)
440 const char *filename
, *fmt
;
441 BlockDriverState
*bs
;
445 c
= getopt(argc
, argv
, "f:h");
459 if (optind
>= argc
) {
462 filename
= argv
[optind
++];
464 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
| BDRV_O_RDWR
);
468 ret
= bdrv_commit(bs
);
471 printf("Image committed.\n");
474 error_report("No disk inserted");
477 error_report("Image is read-only");
480 error_report("Image is already committed");
483 error_report("Error while committing image");
494 static int is_not_zero(const uint8_t *sector
, int len
)
498 for(i
= 0;i
< len
; i
++) {
499 if (((uint32_t *)sector
)[i
] != 0)
506 * Returns true iff the first sector pointed to by 'buf' contains at least
509 * 'pnum' is set to the number of sectors (including and immediately following
510 * the first one) that are known to be in the same allocated/unallocated state.
512 static int is_allocated_sectors(const uint8_t *buf
, int n
, int *pnum
)
520 v
= is_not_zero(buf
, 512);
521 for(i
= 1; i
< n
; i
++) {
523 if (v
!= is_not_zero(buf
, 512))
531 * Compares two buffers sector by sector. Returns 0 if the first sector of both
532 * buffers matches, non-zero otherwise.
534 * pnum is set to the number of sectors (including and immediately following
535 * the first one) that are known to have the same comparison result
537 static int compare_sectors(const uint8_t *buf1
, const uint8_t *buf2
, int n
,
547 res
= !!memcmp(buf1
, buf2
, 512);
548 for(i
= 1; i
< n
; i
++) {
552 if (!!memcmp(buf1
, buf2
, 512) != res
) {
561 #define IO_BUF_SIZE (2 * 1024 * 1024)
563 static int img_convert(int argc
, char **argv
)
565 int c
, ret
= 0, n
, n1
, bs_n
, bs_i
, compress
, cluster_size
, cluster_sectors
;
566 const char *fmt
, *out_fmt
, *out_baseimg
, *out_filename
;
567 BlockDriver
*drv
, *proto_drv
;
568 BlockDriverState
**bs
= NULL
, *out_bs
= NULL
;
569 int64_t total_sectors
, nb_sectors
, sector_num
, bs_offset
;
571 uint8_t * buf
= NULL
;
574 QEMUOptionParameter
*param
= NULL
, *create_options
= NULL
;
575 QEMUOptionParameter
*out_baseimg_param
;
576 char *options
= NULL
;
577 const char *snapshot_name
= NULL
;
584 c
= getopt(argc
, argv
, "f:O:B:s:hce6o:");
600 out_baseimg
= optarg
;
606 error_report("qemu-img: option -e is deprecated, please use \'-o "
607 "encryption\' instead!");
610 error_report("qemu-img: option -6 is deprecated, please use \'-o "
611 "compat6\' instead!");
617 snapshot_name
= optarg
;
622 bs_n
= argc
- optind
- 1;
627 out_filename
= argv
[argc
- 1];
629 if (options
&& !strcmp(options
, "?")) {
630 ret
= print_block_option_help(out_filename
, out_fmt
);
634 if (bs_n
> 1 && out_baseimg
) {
635 error_report("-B makes no sense when concatenating multiple input "
641 bs
= qemu_mallocz(bs_n
* sizeof(BlockDriverState
*));
644 for (bs_i
= 0; bs_i
< bs_n
; bs_i
++) {
645 bs
[bs_i
] = bdrv_new_open(argv
[optind
+ bs_i
], fmt
, BDRV_O_FLAGS
);
647 error_report("Could not open '%s'", argv
[optind
+ bs_i
]);
651 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
652 total_sectors
+= bs_sectors
;
655 if (snapshot_name
!= NULL
) {
657 error_report("No support for concatenating multiple snapshot\n");
661 if (bdrv_snapshot_load_tmp(bs
[0], snapshot_name
) < 0) {
662 error_report("Failed to load snapshot\n");
668 /* Find driver and parse its options */
669 drv
= bdrv_find_format(out_fmt
);
671 error_report("Unknown file format '%s'", out_fmt
);
676 proto_drv
= bdrv_find_protocol(out_filename
);
678 error_report("Unknown protocol '%s'", out_filename
);
683 create_options
= append_option_parameters(create_options
,
684 drv
->create_options
);
685 create_options
= append_option_parameters(create_options
,
686 proto_drv
->create_options
);
689 param
= parse_option_parameters(options
, create_options
, param
);
691 error_report("Invalid options for file format '%s'.", out_fmt
);
696 param
= parse_option_parameters("", create_options
, param
);
699 set_option_parameter_int(param
, BLOCK_OPT_SIZE
, total_sectors
* 512);
700 ret
= add_old_style_options(out_fmt
, param
, out_baseimg
, NULL
);
705 /* Get backing file name if -o backing_file was used */
706 out_baseimg_param
= get_option_parameter(param
, BLOCK_OPT_BACKING_FILE
);
707 if (out_baseimg_param
) {
708 out_baseimg
= out_baseimg_param
->value
.s
;
711 /* Check if compression is supported */
713 QEMUOptionParameter
*encryption
=
714 get_option_parameter(param
, BLOCK_OPT_ENCRYPT
);
716 if (!drv
->bdrv_write_compressed
) {
717 error_report("Compression not supported for this file format");
722 if (encryption
&& encryption
->value
.n
) {
723 error_report("Compression and encryption not supported at "
730 /* Create the new image */
731 ret
= bdrv_create(drv
, out_filename
, param
);
733 if (ret
== -ENOTSUP
) {
734 error_report("Formatting not supported for file format '%s'",
736 } else if (ret
== -EFBIG
) {
737 error_report("The image size is too large for file format '%s'",
740 error_report("%s: error while converting %s: %s",
741 out_filename
, out_fmt
, strerror(-ret
));
746 out_bs
= bdrv_new_open(out_filename
, out_fmt
,
747 BDRV_O_FLAGS
| BDRV_O_RDWR
| BDRV_O_NO_FLUSH
);
755 bdrv_get_geometry(bs
[0], &bs_sectors
);
756 buf
= qemu_malloc(IO_BUF_SIZE
);
759 ret
= bdrv_get_info(out_bs
, &bdi
);
761 error_report("could not get block driver info");
764 cluster_size
= bdi
.cluster_size
;
765 if (cluster_size
<= 0 || cluster_size
> IO_BUF_SIZE
) {
766 error_report("invalid cluster size");
770 cluster_sectors
= cluster_size
>> 9;
777 nb_sectors
= total_sectors
- sector_num
;
780 if (nb_sectors
>= cluster_sectors
)
785 bs_num
= sector_num
- bs_offset
;
786 assert (bs_num
>= 0);
789 while (remainder
> 0) {
791 while (bs_num
== bs_sectors
) {
793 assert (bs_i
< bs_n
);
794 bs_offset
+= bs_sectors
;
795 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
797 /* printf("changing part: sector_num=%" PRId64 ", "
798 "bs_i=%d, bs_offset=%" PRId64 ", bs_sectors=%" PRId64
799 "\n", sector_num, bs_i, bs_offset, bs_sectors); */
801 assert (bs_num
< bs_sectors
);
803 nlow
= (remainder
> bs_sectors
- bs_num
) ? bs_sectors
- bs_num
: remainder
;
805 ret
= bdrv_read(bs
[bs_i
], bs_num
, buf2
, nlow
);
807 error_report("error while reading");
816 assert (remainder
== 0);
818 if (n
< cluster_sectors
) {
819 memset(buf
+ n
* 512, 0, cluster_size
- n
* 512);
821 if (is_not_zero(buf
, cluster_size
)) {
822 ret
= bdrv_write_compressed(out_bs
, sector_num
, buf
,
825 error_report("error while compressing sector %" PRId64
,
832 /* signal EOF to align */
833 bdrv_write_compressed(out_bs
, 0, NULL
, 0);
835 int has_zero_init
= bdrv_has_zero_init(out_bs
);
837 sector_num
= 0; // total number of sectors converted so far
839 nb_sectors
= total_sectors
- sector_num
;
840 if (nb_sectors
<= 0) {
843 if (nb_sectors
>= (IO_BUF_SIZE
/ 512)) {
844 n
= (IO_BUF_SIZE
/ 512);
849 while (sector_num
- bs_offset
>= bs_sectors
) {
851 assert (bs_i
< bs_n
);
852 bs_offset
+= bs_sectors
;
853 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
854 /* printf("changing part: sector_num=%" PRId64 ", bs_i=%d, "
855 "bs_offset=%" PRId64 ", bs_sectors=%" PRId64 "\n",
856 sector_num, bs_i, bs_offset, bs_sectors); */
859 if (n
> bs_offset
+ bs_sectors
- sector_num
) {
860 n
= bs_offset
+ bs_sectors
- sector_num
;
864 /* If the output image is being created as a copy on write image,
865 assume that sectors which are unallocated in the input image
866 are present in both the output's and input's base images (no
867 need to copy them). */
869 if (!bdrv_is_allocated(bs
[bs_i
], sector_num
- bs_offset
,
874 /* The next 'n1' sectors are allocated in the input image. Copy
875 only those as they may be followed by unallocated sectors. */
882 ret
= bdrv_read(bs
[bs_i
], sector_num
- bs_offset
, buf
, n
);
884 error_report("error while reading");
887 /* NOTE: at the same time we convert, we do not write zero
888 sectors to have a chance to compress the image. Ideally, we
889 should add a specific call to have the info to go faster */
892 /* If the output image is being created as a copy on write image,
893 copy all sectors even the ones containing only NUL bytes,
894 because they may differ from the sectors in the base image.
896 If the output is to a host device, we also write out
897 sectors that are entirely 0, since whatever data was
898 already there is garbage, not 0s. */
899 if (!has_zero_init
|| out_baseimg
||
900 is_allocated_sectors(buf1
, n
, &n1
)) {
901 ret
= bdrv_write(out_bs
, sector_num
, buf1
, n1
);
903 error_report("error while writing");
914 free_option_parameters(create_options
);
915 free_option_parameters(param
);
921 for (bs_i
= 0; bs_i
< bs_n
; bs_i
++) {
923 bdrv_delete(bs
[bs_i
]);
935 static int64_t get_allocated_file_size(const char *filename
)
937 typedef DWORD (WINAPI
* get_compressed_t
)(const char *filename
, DWORD
*high
);
938 get_compressed_t get_compressed
;
941 /* WinNT support GetCompressedFileSize to determine allocate size */
942 get_compressed
= (get_compressed_t
) GetProcAddress(GetModuleHandle("kernel32"), "GetCompressedFileSizeA");
943 if (get_compressed
) {
945 low
= get_compressed(filename
, &high
);
946 if (low
!= 0xFFFFFFFFlu
|| GetLastError() == NO_ERROR
)
947 return (((int64_t) high
) << 32) + low
;
950 if (_stati64(filename
, &st
) < 0)
955 static int64_t get_allocated_file_size(const char *filename
)
958 if (stat(filename
, &st
) < 0)
960 return (int64_t)st
.st_blocks
* 512;
964 static void dump_snapshots(BlockDriverState
*bs
)
966 QEMUSnapshotInfo
*sn_tab
, *sn
;
970 nb_sns
= bdrv_snapshot_list(bs
, &sn_tab
);
973 printf("Snapshot list:\n");
974 printf("%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), NULL
));
975 for(i
= 0; i
< nb_sns
; i
++) {
977 printf("%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), sn
));
982 static int img_info(int argc
, char **argv
)
985 const char *filename
, *fmt
;
986 BlockDriverState
*bs
;
987 char fmt_name
[128], size_buf
[128], dsize_buf
[128];
988 uint64_t total_sectors
;
989 int64_t allocated_size
;
990 char backing_filename
[1024];
991 char backing_filename2
[1024];
996 c
= getopt(argc
, argv
, "f:h");
1010 if (optind
>= argc
) {
1013 filename
= argv
[optind
++];
1015 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
| BDRV_O_NO_BACKING
);
1019 bdrv_get_format(bs
, fmt_name
, sizeof(fmt_name
));
1020 bdrv_get_geometry(bs
, &total_sectors
);
1021 get_human_readable_size(size_buf
, sizeof(size_buf
), total_sectors
* 512);
1022 allocated_size
= get_allocated_file_size(filename
);
1023 if (allocated_size
< 0) {
1024 snprintf(dsize_buf
, sizeof(dsize_buf
), "unavailable");
1026 get_human_readable_size(dsize_buf
, sizeof(dsize_buf
),
1029 printf("image: %s\n"
1031 "virtual size: %s (%" PRId64
" bytes)\n"
1033 filename
, fmt_name
, size_buf
,
1034 (total_sectors
* 512),
1036 if (bdrv_is_encrypted(bs
)) {
1037 printf("encrypted: yes\n");
1039 if (bdrv_get_info(bs
, &bdi
) >= 0) {
1040 if (bdi
.cluster_size
!= 0) {
1041 printf("cluster_size: %d\n", bdi
.cluster_size
);
1044 bdrv_get_backing_filename(bs
, backing_filename
, sizeof(backing_filename
));
1045 if (backing_filename
[0] != '\0') {
1046 path_combine(backing_filename2
, sizeof(backing_filename2
),
1047 filename
, backing_filename
);
1048 printf("backing file: %s (actual path: %s)\n",
1057 #define SNAPSHOT_LIST 1
1058 #define SNAPSHOT_CREATE 2
1059 #define SNAPSHOT_APPLY 3
1060 #define SNAPSHOT_DELETE 4
1062 static int img_snapshot(int argc
, char **argv
)
1064 BlockDriverState
*bs
;
1065 QEMUSnapshotInfo sn
;
1066 char *filename
, *snapshot_name
= NULL
;
1067 int c
, ret
= 0, bdrv_oflags
;
1071 bdrv_oflags
= BDRV_O_RDWR
;
1072 /* Parse commandline parameters */
1074 c
= getopt(argc
, argv
, "la:c:d:h");
1088 action
= SNAPSHOT_LIST
;
1089 bdrv_oflags
&= ~BDRV_O_RDWR
; /* no need for RW */
1096 action
= SNAPSHOT_APPLY
;
1097 snapshot_name
= optarg
;
1104 action
= SNAPSHOT_CREATE
;
1105 snapshot_name
= optarg
;
1112 action
= SNAPSHOT_DELETE
;
1113 snapshot_name
= optarg
;
1118 if (optind
>= argc
) {
1121 filename
= argv
[optind
++];
1123 /* Open the image */
1124 bs
= bdrv_new_open(filename
, NULL
, bdrv_oflags
);
1129 /* Perform the requested action */
1135 case SNAPSHOT_CREATE
:
1136 memset(&sn
, 0, sizeof(sn
));
1137 pstrcpy(sn
.name
, sizeof(sn
.name
), snapshot_name
);
1139 qemu_gettimeofday(&tv
);
1140 sn
.date_sec
= tv
.tv_sec
;
1141 sn
.date_nsec
= tv
.tv_usec
* 1000;
1143 ret
= bdrv_snapshot_create(bs
, &sn
);
1145 error_report("Could not create snapshot '%s': %d (%s)",
1146 snapshot_name
, ret
, strerror(-ret
));
1150 case SNAPSHOT_APPLY
:
1151 ret
= bdrv_snapshot_goto(bs
, snapshot_name
);
1153 error_report("Could not apply snapshot '%s': %d (%s)",
1154 snapshot_name
, ret
, strerror(-ret
));
1158 case SNAPSHOT_DELETE
:
1159 ret
= bdrv_snapshot_delete(bs
, snapshot_name
);
1161 error_report("Could not delete snapshot '%s': %d (%s)",
1162 snapshot_name
, ret
, strerror(-ret
));
1175 static int img_rebase(int argc
, char **argv
)
1177 BlockDriverState
*bs
, *bs_old_backing
= NULL
, *bs_new_backing
= NULL
;
1178 BlockDriver
*old_backing_drv
, *new_backing_drv
;
1180 const char *fmt
, *out_basefmt
, *out_baseimg
;
1184 /* Parse commandline parameters */
1190 c
= getopt(argc
, argv
, "uhf:F:b:");
1203 out_basefmt
= optarg
;
1206 out_baseimg
= optarg
;
1214 if ((optind
>= argc
) || !out_baseimg
) {
1217 filename
= argv
[optind
++];
1222 * Ignore the old backing file for unsafe rebase in case we want to correct
1223 * the reference to a renamed or moved backing file.
1225 flags
= BDRV_O_FLAGS
| BDRV_O_RDWR
| (unsafe
? BDRV_O_NO_BACKING
: 0);
1226 bs
= bdrv_new_open(filename
, fmt
, flags
);
1231 /* Find the right drivers for the backing files */
1232 old_backing_drv
= NULL
;
1233 new_backing_drv
= NULL
;
1235 if (!unsafe
&& bs
->backing_format
[0] != '\0') {
1236 old_backing_drv
= bdrv_find_format(bs
->backing_format
);
1237 if (old_backing_drv
== NULL
) {
1238 error_report("Invalid format name: '%s'", bs
->backing_format
);
1244 if (out_basefmt
!= NULL
) {
1245 new_backing_drv
= bdrv_find_format(out_basefmt
);
1246 if (new_backing_drv
== NULL
) {
1247 error_report("Invalid format name: '%s'", out_basefmt
);
1253 /* For safe rebasing we need to compare old and new backing file */
1255 /* Make the compiler happy */
1256 bs_old_backing
= NULL
;
1257 bs_new_backing
= NULL
;
1259 char backing_name
[1024];
1261 bs_old_backing
= bdrv_new("old_backing");
1262 bdrv_get_backing_filename(bs
, backing_name
, sizeof(backing_name
));
1263 ret
= bdrv_open(bs_old_backing
, backing_name
, BDRV_O_FLAGS
,
1266 error_report("Could not open old backing file '%s'", backing_name
);
1270 bs_new_backing
= bdrv_new("new_backing");
1271 ret
= bdrv_open(bs_new_backing
, out_baseimg
, BDRV_O_FLAGS
,
1274 error_report("Could not open new backing file '%s'", out_baseimg
);
1280 * Check each unallocated cluster in the COW file. If it is unallocated,
1281 * accesses go to the backing file. We must therefore compare this cluster
1282 * in the old and new backing file, and if they differ we need to copy it
1283 * from the old backing file into the COW file.
1285 * If qemu-img crashes during this step, no harm is done. The content of
1286 * the image is the same as the original one at any time.
1289 uint64_t num_sectors
;
1295 buf_old
= qemu_malloc(IO_BUF_SIZE
);
1296 buf_new
= qemu_malloc(IO_BUF_SIZE
);
1298 bdrv_get_geometry(bs
, &num_sectors
);
1300 for (sector
= 0; sector
< num_sectors
; sector
+= n
) {
1302 /* How many sectors can we handle with the next read? */
1303 if (sector
+ (IO_BUF_SIZE
/ 512) <= num_sectors
) {
1304 n
= (IO_BUF_SIZE
/ 512);
1306 n
= num_sectors
- sector
;
1309 /* If the cluster is allocated, we don't need to take action */
1310 ret
= bdrv_is_allocated(bs
, sector
, n
, &n
);
1315 /* Read old and new backing file */
1316 ret
= bdrv_read(bs_old_backing
, sector
, buf_old
, n
);
1318 error_report("error while reading from old backing file");
1321 ret
= bdrv_read(bs_new_backing
, sector
, buf_new
, n
);
1323 error_report("error while reading from new backing file");
1327 /* If they differ, we need to write to the COW file */
1328 uint64_t written
= 0;
1330 while (written
< n
) {
1333 if (compare_sectors(buf_old
+ written
* 512,
1334 buf_new
+ written
* 512, n
- written
, &pnum
))
1336 ret
= bdrv_write(bs
, sector
+ written
,
1337 buf_old
+ written
* 512, pnum
);
1339 error_report("Error while writing to COW image: %s",
1354 * Change the backing file. All clusters that are different from the old
1355 * backing file are overwritten in the COW file now, so the visible content
1356 * doesn't change when we switch the backing file.
1358 ret
= bdrv_change_backing_file(bs
, out_baseimg
, out_basefmt
);
1359 if (ret
== -ENOSPC
) {
1360 error_report("Could not change the backing file to '%s': No "
1361 "space left in the file header", out_baseimg
);
1362 } else if (ret
< 0) {
1363 error_report("Could not change the backing file to '%s': %s",
1364 out_baseimg
, strerror(-ret
));
1368 * TODO At this point it is possible to check if any clusters that are
1369 * allocated in the COW file are the same in the backing file. If so, they
1370 * could be dropped from the COW file. Don't do this before switching the
1371 * backing file, in case of a crash this would lead to corruption.
1376 bdrv_delete(bs_old_backing
);
1377 bdrv_delete(bs_new_backing
);
1387 static int img_resize(int argc
, char **argv
)
1389 int c
, ret
, relative
;
1390 const char *filename
, *fmt
, *size
;
1391 int64_t n
, total_size
;
1392 BlockDriverState
*bs
= NULL
;
1393 QEMUOptionParameter
*param
;
1394 QEMUOptionParameter resize_options
[] = {
1396 .name
= BLOCK_OPT_SIZE
,
1398 .help
= "Virtual disk size"
1405 c
= getopt(argc
, argv
, "f:h");
1419 if (optind
+ 1 >= argc
) {
1422 filename
= argv
[optind
++];
1423 size
= argv
[optind
++];
1425 /* Choose grow, shrink, or absolute resize mode */
1441 param
= parse_option_parameters("", resize_options
, NULL
);
1442 if (set_option_parameter(param
, BLOCK_OPT_SIZE
, size
)) {
1443 /* Error message already printed when size parsing fails */
1447 n
= get_option_parameter(param
, BLOCK_OPT_SIZE
)->value
.n
;
1448 free_option_parameters(param
);
1450 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
| BDRV_O_RDWR
);
1457 total_size
= bdrv_getlength(bs
) + n
* relative
;
1461 if (total_size
<= 0) {
1462 error_report("New image size must be positive");
1467 ret
= bdrv_truncate(bs
, total_size
);
1470 printf("Image resized.\n");
1473 error_report("This image format does not support resize");
1476 error_report("Image is read-only");
1479 error_report("Error resizing image (%d)", -ret
);
1492 static const img_cmd_t img_cmds
[] = {
1493 #define DEF(option, callback, arg_string) \
1494 { option, callback },
1495 #include "qemu-img-cmds.h"
1501 int main(int argc
, char **argv
)
1503 const img_cmd_t
*cmd
;
1504 const char *cmdname
;
1506 error_set_progname(argv
[0]);
1514 /* find the command */
1515 for(cmd
= img_cmds
; cmd
->name
!= NULL
; cmd
++) {
1516 if (!strcmp(cmdname
, cmd
->name
)) {
1517 return cmd
->handler(argc
, argv
);