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
43 #define BDRV_DEFAULT_CACHE "writeback"
45 static void format_print(void *opaque
, const char *name
)
50 /* Please keep in synch with qemu-img.texi */
51 static void help(void)
53 const char *help_msg
=
54 "qemu-img version " QEMU_VERSION
", Copyright (c) 2004-2008 Fabrice Bellard\n"
55 "usage: qemu-img command [command options]\n"
56 "QEMU disk image utility\n"
59 #define DEF(option, callback, arg_string) \
61 #include "qemu-img-cmds.h"
65 "Command parameters:\n"
66 " 'filename' is a disk image filename\n"
67 " 'fmt' is the disk image format. It is guessed automatically in most cases\n"
68 " 'cache' is the cache mode used to write the output disk image, the valid\n"
69 " options are: 'none', 'writeback' (default), 'writethrough', 'directsync'\n"
71 " 'size' is the disk image size in bytes. Optional suffixes\n"
72 " 'k' or 'K' (kilobyte, 1024), 'M' (megabyte, 1024k), 'G' (gigabyte, 1024M)\n"
73 " and T (terabyte, 1024G) are supported. 'b' is ignored.\n"
74 " 'output_filename' is the destination disk image filename\n"
75 " 'output_fmt' is the destination format\n"
76 " 'options' is a comma separated list of format specific options in a\n"
77 " name=value format. Use -o ? for an overview of the options supported by the\n"
79 " '-c' indicates that target image must be compressed (qcow format only)\n"
80 " '-u' enables unsafe rebasing. It is assumed that old and new backing file\n"
81 " match exactly. The image doesn't need a working backing file before\n"
82 " rebasing in this case (useful for renaming the backing file)\n"
83 " '-h' with or without a command shows this help and lists the supported formats\n"
84 " '-p' show progress of command (only certain commands)\n"
85 " '-S' indicates the consecutive number of bytes that must contain only zeros\n"
86 " for qemu-img to create a sparse image during conversion\n"
88 "Parameters to snapshot subcommand:\n"
89 " 'snapshot' is the name of the snapshot to create, apply or delete\n"
90 " '-a' applies a snapshot (revert disk to saved state)\n"
91 " '-c' creates a snapshot\n"
92 " '-d' deletes a snapshot\n"
93 " '-l' lists all snapshots in the given image\n";
95 printf("%s\nSupported formats:", help_msg
);
96 bdrv_iterate_format(format_print
, NULL
);
102 /* XXX: put correct support for win32 */
103 static int read_password(char *buf
, int buf_size
)
106 printf("Password: ");
113 if (i
< (buf_size
- 1))
124 static struct termios oldtty
;
126 static void term_exit(void)
128 tcsetattr (0, TCSANOW
, &oldtty
);
131 static void term_init(void)
138 tty
.c_iflag
&= ~(IGNBRK
|BRKINT
|PARMRK
|ISTRIP
139 |INLCR
|IGNCR
|ICRNL
|IXON
);
140 tty
.c_oflag
|= OPOST
;
141 tty
.c_lflag
&= ~(ECHO
|ECHONL
|ICANON
|IEXTEN
);
142 tty
.c_cflag
&= ~(CSIZE
|PARENB
);
147 tcsetattr (0, TCSANOW
, &tty
);
152 static int read_password(char *buf
, int buf_size
)
157 printf("password: ");
162 ret
= read(0, &ch
, 1);
164 if (errno
== EAGAIN
|| errno
== EINTR
) {
170 } else if (ret
== 0) {
178 if (i
< (buf_size
- 1))
189 static int print_block_option_help(const char *filename
, const char *fmt
)
191 BlockDriver
*drv
, *proto_drv
;
192 QEMUOptionParameter
*create_options
= NULL
;
194 /* Find driver and parse its options */
195 drv
= bdrv_find_format(fmt
);
197 error_report("Unknown file format '%s'", fmt
);
201 proto_drv
= bdrv_find_protocol(filename
);
203 error_report("Unknown protocol '%s'", filename
);
207 create_options
= append_option_parameters(create_options
,
208 drv
->create_options
);
209 create_options
= append_option_parameters(create_options
,
210 proto_drv
->create_options
);
211 print_option_help(create_options
);
212 free_option_parameters(create_options
);
216 static BlockDriverState
*bdrv_new_open(const char *filename
,
220 BlockDriverState
*bs
;
225 bs
= bdrv_new("image");
228 drv
= bdrv_find_format(fmt
);
230 error_report("Unknown file format '%s'", fmt
);
237 ret
= bdrv_open(bs
, filename
, flags
, drv
);
239 error_report("Could not open '%s': %s", filename
, strerror(-ret
));
243 if (bdrv_is_encrypted(bs
)) {
244 printf("Disk image '%s' is encrypted.\n", filename
);
245 if (read_password(password
, sizeof(password
)) < 0) {
246 error_report("No password given");
249 if (bdrv_set_key(bs
, password
) < 0) {
250 error_report("invalid password");
262 static int add_old_style_options(const char *fmt
, QEMUOptionParameter
*list
,
263 const char *base_filename
,
264 const char *base_fmt
)
267 if (set_option_parameter(list
, BLOCK_OPT_BACKING_FILE
, base_filename
)) {
268 error_report("Backing file not supported for file format '%s'",
274 if (set_option_parameter(list
, BLOCK_OPT_BACKING_FMT
, base_fmt
)) {
275 error_report("Backing file format not supported for file "
283 static int img_create(int argc
, char **argv
)
286 uint64_t img_size
= -1;
287 const char *fmt
= "raw";
288 const char *base_fmt
= NULL
;
289 const char *filename
;
290 const char *base_filename
= NULL
;
291 char *options
= NULL
;
294 c
= getopt(argc
, argv
, "F:b:f:he6o:");
307 base_filename
= optarg
;
313 error_report("option -e is deprecated, please use \'-o "
314 "encryption\' instead!");
317 error_report("option -6 is deprecated, please use \'-o "
318 "compat6\' instead!");
326 /* Get the filename */
327 if (optind
>= argc
) {
330 filename
= argv
[optind
++];
332 /* Get image size, if specified */
336 sval
= strtosz_suffix(argv
[optind
++], &end
, STRTOSZ_DEFSUFFIX_B
);
337 if (sval
< 0 || *end
) {
338 error_report("Invalid image size specified! You may use k, M, G or "
340 error_report("kilobytes, megabytes, gigabytes and terabytes.");
344 img_size
= (uint64_t)sval
;
347 if (options
&& !strcmp(options
, "?")) {
348 ret
= print_block_option_help(filename
, fmt
);
352 ret
= bdrv_img_create(filename
, fmt
, base_filename
, base_fmt
,
353 options
, img_size
, BDRV_O_FLAGS
);
362 * Checks an image for consistency. Exit codes:
364 * 0 - Check completed, image is good
365 * 1 - Check not completed because of internal errors
366 * 2 - Check completed, image is corrupted
367 * 3 - Check completed, image has leaked clusters, but is good otherwise
369 static int img_check(int argc
, char **argv
)
372 const char *filename
, *fmt
;
373 BlockDriverState
*bs
;
374 BdrvCheckResult result
;
378 c
= getopt(argc
, argv
, "f:h");
392 if (optind
>= argc
) {
395 filename
= argv
[optind
++];
397 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
);
401 ret
= bdrv_check(bs
, &result
);
403 if (ret
== -ENOTSUP
) {
404 error_report("This image format does not support checks");
409 if (!(result
.corruptions
|| result
.leaks
|| result
.check_errors
)) {
410 printf("No errors were found on the image.\n");
412 if (result
.corruptions
) {
413 printf("\n%d errors were found on the image.\n"
414 "Data may be corrupted, or further writes to the image "
420 printf("\n%d leaked clusters were found on the image.\n"
421 "This means waste of disk space, but no harm to data.\n",
425 if (result
.check_errors
) {
426 printf("\n%d internal errors have occurred during the check.\n",
427 result
.check_errors
);
431 if (result
.bfi
.total_clusters
!= 0 && result
.bfi
.allocated_clusters
!= 0) {
432 printf("%" PRId64
"/%" PRId64
"= %0.2f%% allocated, %0.2f%% fragmented\n",
433 result
.bfi
.allocated_clusters
, result
.bfi
.total_clusters
,
434 result
.bfi
.allocated_clusters
* 100.0 / result
.bfi
.total_clusters
,
435 result
.bfi
.fragmented_clusters
* 100.0 / result
.bfi
.allocated_clusters
);
440 if (ret
< 0 || result
.check_errors
) {
441 printf("\nAn error has occurred during the check: %s\n"
442 "The check is not complete and may have missed error.\n",
447 if (result
.corruptions
) {
449 } else if (result
.leaks
) {
456 static int img_commit(int argc
, char **argv
)
459 const char *filename
, *fmt
, *cache
;
460 BlockDriverState
*bs
;
463 cache
= BDRV_DEFAULT_CACHE
;
465 c
= getopt(argc
, argv
, "f:ht:");
482 if (optind
>= argc
) {
485 filename
= argv
[optind
++];
488 ret
= bdrv_parse_cache_flags(cache
, &flags
);
490 error_report("Invalid cache option: %s", cache
);
494 bs
= bdrv_new_open(filename
, fmt
, flags
);
498 ret
= bdrv_commit(bs
);
501 printf("Image committed.\n");
504 error_report("No disk inserted");
507 error_report("Image is read-only");
510 error_report("Image is already committed");
513 error_report("Error while committing image");
525 * Returns true iff the first sector pointed to by 'buf' contains at least
528 * 'pnum' is set to the number of sectors (including and immediately following
529 * the first one) that are known to be in the same allocated/unallocated state.
531 static int is_allocated_sectors(const uint8_t *buf
, int n
, int *pnum
)
540 is_zero
= buffer_is_zero(buf
, 512);
541 for(i
= 1; i
< n
; i
++) {
543 if (is_zero
!= buffer_is_zero(buf
, 512)) {
552 * Like is_allocated_sectors, but if the buffer starts with a used sector,
553 * up to 'min' consecutive sectors containing zeros are ignored. This avoids
554 * breaking up write requests for only small sparse areas.
556 static int is_allocated_sectors_min(const uint8_t *buf
, int n
, int *pnum
,
560 int num_checked
, num_used
;
566 ret
= is_allocated_sectors(buf
, n
, pnum
);
572 buf
+= BDRV_SECTOR_SIZE
* *pnum
;
574 num_checked
= num_used
;
577 ret
= is_allocated_sectors(buf
, n
, pnum
);
579 buf
+= BDRV_SECTOR_SIZE
* *pnum
;
581 num_checked
+= *pnum
;
583 num_used
= num_checked
;
584 } else if (*pnum
>= min
) {
594 * Compares two buffers sector by sector. Returns 0 if the first sector of both
595 * buffers matches, non-zero otherwise.
597 * pnum is set to the number of sectors (including and immediately following
598 * the first one) that are known to have the same comparison result
600 static int compare_sectors(const uint8_t *buf1
, const uint8_t *buf2
, int n
,
610 res
= !!memcmp(buf1
, buf2
, 512);
611 for(i
= 1; i
< n
; i
++) {
615 if (!!memcmp(buf1
, buf2
, 512) != res
) {
624 #define IO_BUF_SIZE (2 * 1024 * 1024)
626 static int img_convert(int argc
, char **argv
)
628 int c
, ret
= 0, n
, n1
, bs_n
, bs_i
, compress
, cluster_size
, cluster_sectors
;
629 int progress
= 0, flags
;
630 const char *fmt
, *out_fmt
, *cache
, *out_baseimg
, *out_filename
;
631 BlockDriver
*drv
, *proto_drv
;
632 BlockDriverState
**bs
= NULL
, *out_bs
= NULL
;
633 int64_t total_sectors
, nb_sectors
, sector_num
, bs_offset
;
635 uint8_t * buf
= NULL
;
638 QEMUOptionParameter
*param
= NULL
, *create_options
= NULL
;
639 QEMUOptionParameter
*out_baseimg_param
;
640 char *options
= NULL
;
641 const char *snapshot_name
= NULL
;
642 float local_progress
;
643 int min_sparse
= 8; /* Need at least 4k of zeros for sparse detection */
651 c
= getopt(argc
, argv
, "f:O:B:s:hce6o:pS:t:");
667 out_baseimg
= optarg
;
673 error_report("option -e is deprecated, please use \'-o "
674 "encryption\' instead!");
677 error_report("option -6 is deprecated, please use \'-o "
678 "compat6\' instead!");
684 snapshot_name
= optarg
;
690 sval
= strtosz_suffix(optarg
, &end
, STRTOSZ_DEFSUFFIX_B
);
691 if (sval
< 0 || *end
) {
692 error_report("Invalid minimum zero buffer size for sparse output specified");
696 min_sparse
= sval
/ BDRV_SECTOR_SIZE
;
708 bs_n
= argc
- optind
- 1;
713 out_filename
= argv
[argc
- 1];
715 if (options
&& !strcmp(options
, "?")) {
716 ret
= print_block_option_help(out_filename
, out_fmt
);
720 if (bs_n
> 1 && out_baseimg
) {
721 error_report("-B makes no sense when concatenating multiple input "
727 qemu_progress_init(progress
, 2.0);
728 qemu_progress_print(0, 100);
730 bs
= g_malloc0(bs_n
* sizeof(BlockDriverState
*));
733 for (bs_i
= 0; bs_i
< bs_n
; bs_i
++) {
734 bs
[bs_i
] = bdrv_new_open(argv
[optind
+ bs_i
], fmt
, BDRV_O_FLAGS
);
736 error_report("Could not open '%s'", argv
[optind
+ bs_i
]);
740 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
741 total_sectors
+= bs_sectors
;
744 if (snapshot_name
!= NULL
) {
746 error_report("No support for concatenating multiple snapshot");
750 if (bdrv_snapshot_load_tmp(bs
[0], snapshot_name
) < 0) {
751 error_report("Failed to load snapshot");
757 /* Find driver and parse its options */
758 drv
= bdrv_find_format(out_fmt
);
760 error_report("Unknown file format '%s'", out_fmt
);
765 proto_drv
= bdrv_find_protocol(out_filename
);
767 error_report("Unknown protocol '%s'", out_filename
);
772 create_options
= append_option_parameters(create_options
,
773 drv
->create_options
);
774 create_options
= append_option_parameters(create_options
,
775 proto_drv
->create_options
);
778 param
= parse_option_parameters(options
, create_options
, param
);
780 error_report("Invalid options for file format '%s'.", out_fmt
);
785 param
= parse_option_parameters("", create_options
, param
);
788 set_option_parameter_int(param
, BLOCK_OPT_SIZE
, total_sectors
* 512);
789 ret
= add_old_style_options(out_fmt
, param
, out_baseimg
, NULL
);
794 /* Get backing file name if -o backing_file was used */
795 out_baseimg_param
= get_option_parameter(param
, BLOCK_OPT_BACKING_FILE
);
796 if (out_baseimg_param
) {
797 out_baseimg
= out_baseimg_param
->value
.s
;
800 /* Check if compression is supported */
802 QEMUOptionParameter
*encryption
=
803 get_option_parameter(param
, BLOCK_OPT_ENCRYPT
);
804 QEMUOptionParameter
*preallocation
=
805 get_option_parameter(param
, BLOCK_OPT_PREALLOC
);
807 if (!drv
->bdrv_write_compressed
) {
808 error_report("Compression not supported for this file format");
813 if (encryption
&& encryption
->value
.n
) {
814 error_report("Compression and encryption not supported at "
820 if (preallocation
&& preallocation
->value
.s
821 && strcmp(preallocation
->value
.s
, "off"))
823 error_report("Compression and preallocation not supported at "
830 /* Create the new image */
831 ret
= bdrv_create(drv
, out_filename
, param
);
833 if (ret
== -ENOTSUP
) {
834 error_report("Formatting not supported for file format '%s'",
836 } else if (ret
== -EFBIG
) {
837 error_report("The image size is too large for file format '%s'",
840 error_report("%s: error while converting %s: %s",
841 out_filename
, out_fmt
, strerror(-ret
));
847 ret
= bdrv_parse_cache_flags(cache
, &flags
);
849 error_report("Invalid cache option: %s", cache
);
853 out_bs
= bdrv_new_open(out_filename
, out_fmt
, flags
);
861 bdrv_get_geometry(bs
[0], &bs_sectors
);
862 buf
= qemu_blockalign(out_bs
, IO_BUF_SIZE
);
865 ret
= bdrv_get_info(out_bs
, &bdi
);
867 error_report("could not get block driver info");
870 cluster_size
= bdi
.cluster_size
;
871 if (cluster_size
<= 0 || cluster_size
> IO_BUF_SIZE
) {
872 error_report("invalid cluster size");
876 cluster_sectors
= cluster_size
>> 9;
879 nb_sectors
= total_sectors
;
880 local_progress
= (float)100 /
881 (nb_sectors
/ MIN(nb_sectors
, cluster_sectors
));
888 nb_sectors
= total_sectors
- sector_num
;
891 if (nb_sectors
>= cluster_sectors
)
896 bs_num
= sector_num
- bs_offset
;
897 assert (bs_num
>= 0);
900 while (remainder
> 0) {
902 while (bs_num
== bs_sectors
) {
904 assert (bs_i
< bs_n
);
905 bs_offset
+= bs_sectors
;
906 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
908 /* printf("changing part: sector_num=%" PRId64 ", "
909 "bs_i=%d, bs_offset=%" PRId64 ", bs_sectors=%" PRId64
910 "\n", sector_num, bs_i, bs_offset, bs_sectors); */
912 assert (bs_num
< bs_sectors
);
914 nlow
= (remainder
> bs_sectors
- bs_num
) ? bs_sectors
- bs_num
: remainder
;
916 ret
= bdrv_read(bs
[bs_i
], bs_num
, buf2
, nlow
);
918 error_report("error while reading sector %" PRId64
": %s",
919 bs_num
, strerror(-ret
));
928 assert (remainder
== 0);
930 if (n
< cluster_sectors
) {
931 memset(buf
+ n
* 512, 0, cluster_size
- n
* 512);
933 if (!buffer_is_zero(buf
, cluster_size
)) {
934 ret
= bdrv_write_compressed(out_bs
, sector_num
, buf
,
937 error_report("error while compressing sector %" PRId64
938 ": %s", sector_num
, strerror(-ret
));
943 qemu_progress_print(local_progress
, 100);
945 /* signal EOF to align */
946 bdrv_write_compressed(out_bs
, 0, NULL
, 0);
948 int has_zero_init
= bdrv_has_zero_init(out_bs
);
950 sector_num
= 0; // total number of sectors converted so far
951 nb_sectors
= total_sectors
- sector_num
;
952 local_progress
= (float)100 /
953 (nb_sectors
/ MIN(nb_sectors
, IO_BUF_SIZE
/ 512));
956 nb_sectors
= total_sectors
- sector_num
;
957 if (nb_sectors
<= 0) {
960 if (nb_sectors
>= (IO_BUF_SIZE
/ 512)) {
961 n
= (IO_BUF_SIZE
/ 512);
966 while (sector_num
- bs_offset
>= bs_sectors
) {
968 assert (bs_i
< bs_n
);
969 bs_offset
+= bs_sectors
;
970 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
971 /* printf("changing part: sector_num=%" PRId64 ", bs_i=%d, "
972 "bs_offset=%" PRId64 ", bs_sectors=%" PRId64 "\n",
973 sector_num, bs_i, bs_offset, bs_sectors); */
976 if (n
> bs_offset
+ bs_sectors
- sector_num
) {
977 n
= bs_offset
+ bs_sectors
- sector_num
;
981 /* If the output image is being created as a copy on write image,
982 assume that sectors which are unallocated in the input image
983 are present in both the output's and input's base images (no
984 need to copy them). */
986 if (!bdrv_is_allocated(bs
[bs_i
], sector_num
- bs_offset
,
991 /* The next 'n1' sectors are allocated in the input image. Copy
992 only those as they may be followed by unallocated sectors. */
999 ret
= bdrv_read(bs
[bs_i
], sector_num
- bs_offset
, buf
, n
);
1001 error_report("error while reading sector %" PRId64
": %s",
1002 sector_num
- bs_offset
, strerror(-ret
));
1005 /* NOTE: at the same time we convert, we do not write zero
1006 sectors to have a chance to compress the image. Ideally, we
1007 should add a specific call to have the info to go faster */
1010 /* If the output image is being created as a copy on write image,
1011 copy all sectors even the ones containing only NUL bytes,
1012 because they may differ from the sectors in the base image.
1014 If the output is to a host device, we also write out
1015 sectors that are entirely 0, since whatever data was
1016 already there is garbage, not 0s. */
1017 if (!has_zero_init
|| out_baseimg
||
1018 is_allocated_sectors_min(buf1
, n
, &n1
, min_sparse
)) {
1019 ret
= bdrv_write(out_bs
, sector_num
, buf1
, n1
);
1021 error_report("error while writing sector %" PRId64
1022 ": %s", sector_num
, strerror(-ret
));
1030 qemu_progress_print(local_progress
, 100);
1034 qemu_progress_end();
1035 free_option_parameters(create_options
);
1036 free_option_parameters(param
);
1039 bdrv_delete(out_bs
);
1042 for (bs_i
= 0; bs_i
< bs_n
; bs_i
++) {
1044 bdrv_delete(bs
[bs_i
]);
1056 static void dump_snapshots(BlockDriverState
*bs
)
1058 QEMUSnapshotInfo
*sn_tab
, *sn
;
1062 nb_sns
= bdrv_snapshot_list(bs
, &sn_tab
);
1065 printf("Snapshot list:\n");
1066 printf("%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), NULL
));
1067 for(i
= 0; i
< nb_sns
; i
++) {
1069 printf("%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), sn
));
1074 static int img_info(int argc
, char **argv
)
1077 const char *filename
, *fmt
;
1078 BlockDriverState
*bs
;
1079 char fmt_name
[128], size_buf
[128], dsize_buf
[128];
1080 uint64_t total_sectors
;
1081 int64_t allocated_size
;
1082 char backing_filename
[1024];
1083 char backing_filename2
[1024];
1084 BlockDriverInfo bdi
;
1088 c
= getopt(argc
, argv
, "f:h");
1102 if (optind
>= argc
) {
1105 filename
= argv
[optind
++];
1107 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
| BDRV_O_NO_BACKING
);
1111 bdrv_get_format(bs
, fmt_name
, sizeof(fmt_name
));
1112 bdrv_get_geometry(bs
, &total_sectors
);
1113 get_human_readable_size(size_buf
, sizeof(size_buf
), total_sectors
* 512);
1114 allocated_size
= bdrv_get_allocated_file_size(bs
);
1115 if (allocated_size
< 0) {
1116 snprintf(dsize_buf
, sizeof(dsize_buf
), "unavailable");
1118 get_human_readable_size(dsize_buf
, sizeof(dsize_buf
),
1121 printf("image: %s\n"
1123 "virtual size: %s (%" PRId64
" bytes)\n"
1125 filename
, fmt_name
, size_buf
,
1126 (total_sectors
* 512),
1128 if (bdrv_is_encrypted(bs
)) {
1129 printf("encrypted: yes\n");
1131 if (bdrv_get_info(bs
, &bdi
) >= 0) {
1132 if (bdi
.cluster_size
!= 0) {
1133 printf("cluster_size: %d\n", bdi
.cluster_size
);
1136 printf("cleanly shut down: no\n");
1139 bdrv_get_backing_filename(bs
, backing_filename
, sizeof(backing_filename
));
1140 if (backing_filename
[0] != '\0') {
1141 path_combine(backing_filename2
, sizeof(backing_filename2
),
1142 filename
, backing_filename
);
1143 printf("backing file: %s (actual path: %s)\n",
1152 #define SNAPSHOT_LIST 1
1153 #define SNAPSHOT_CREATE 2
1154 #define SNAPSHOT_APPLY 3
1155 #define SNAPSHOT_DELETE 4
1157 static int img_snapshot(int argc
, char **argv
)
1159 BlockDriverState
*bs
;
1160 QEMUSnapshotInfo sn
;
1161 char *filename
, *snapshot_name
= NULL
;
1162 int c
, ret
= 0, bdrv_oflags
;
1166 bdrv_oflags
= BDRV_O_FLAGS
| BDRV_O_RDWR
;
1167 /* Parse commandline parameters */
1169 c
= getopt(argc
, argv
, "la:c:d:h");
1183 action
= SNAPSHOT_LIST
;
1184 bdrv_oflags
&= ~BDRV_O_RDWR
; /* no need for RW */
1191 action
= SNAPSHOT_APPLY
;
1192 snapshot_name
= optarg
;
1199 action
= SNAPSHOT_CREATE
;
1200 snapshot_name
= optarg
;
1207 action
= SNAPSHOT_DELETE
;
1208 snapshot_name
= optarg
;
1213 if (optind
>= argc
) {
1216 filename
= argv
[optind
++];
1218 /* Open the image */
1219 bs
= bdrv_new_open(filename
, NULL
, bdrv_oflags
);
1224 /* Perform the requested action */
1230 case SNAPSHOT_CREATE
:
1231 memset(&sn
, 0, sizeof(sn
));
1232 pstrcpy(sn
.name
, sizeof(sn
.name
), snapshot_name
);
1234 qemu_gettimeofday(&tv
);
1235 sn
.date_sec
= tv
.tv_sec
;
1236 sn
.date_nsec
= tv
.tv_usec
* 1000;
1238 ret
= bdrv_snapshot_create(bs
, &sn
);
1240 error_report("Could not create snapshot '%s': %d (%s)",
1241 snapshot_name
, ret
, strerror(-ret
));
1245 case SNAPSHOT_APPLY
:
1246 ret
= bdrv_snapshot_goto(bs
, snapshot_name
);
1248 error_report("Could not apply snapshot '%s': %d (%s)",
1249 snapshot_name
, ret
, strerror(-ret
));
1253 case SNAPSHOT_DELETE
:
1254 ret
= bdrv_snapshot_delete(bs
, snapshot_name
);
1256 error_report("Could not delete snapshot '%s': %d (%s)",
1257 snapshot_name
, ret
, strerror(-ret
));
1270 static int img_rebase(int argc
, char **argv
)
1272 BlockDriverState
*bs
, *bs_old_backing
= NULL
, *bs_new_backing
= NULL
;
1273 BlockDriver
*old_backing_drv
, *new_backing_drv
;
1275 const char *fmt
, *cache
, *out_basefmt
, *out_baseimg
;
1280 /* Parse commandline parameters */
1282 cache
= BDRV_DEFAULT_CACHE
;
1286 c
= getopt(argc
, argv
, "uhf:F:b:pt:");
1299 out_basefmt
= optarg
;
1302 out_baseimg
= optarg
;
1316 if ((optind
>= argc
) || (!unsafe
&& !out_baseimg
)) {
1319 filename
= argv
[optind
++];
1321 qemu_progress_init(progress
, 2.0);
1322 qemu_progress_print(0, 100);
1324 flags
= BDRV_O_RDWR
| (unsafe
? BDRV_O_NO_BACKING
: 0);
1325 ret
= bdrv_parse_cache_flags(cache
, &flags
);
1327 error_report("Invalid cache option: %s", cache
);
1334 * Ignore the old backing file for unsafe rebase in case we want to correct
1335 * the reference to a renamed or moved backing file.
1337 bs
= bdrv_new_open(filename
, fmt
, flags
);
1342 /* Find the right drivers for the backing files */
1343 old_backing_drv
= NULL
;
1344 new_backing_drv
= NULL
;
1346 if (!unsafe
&& bs
->backing_format
[0] != '\0') {
1347 old_backing_drv
= bdrv_find_format(bs
->backing_format
);
1348 if (old_backing_drv
== NULL
) {
1349 error_report("Invalid format name: '%s'", bs
->backing_format
);
1355 if (out_basefmt
!= NULL
) {
1356 new_backing_drv
= bdrv_find_format(out_basefmt
);
1357 if (new_backing_drv
== NULL
) {
1358 error_report("Invalid format name: '%s'", out_basefmt
);
1364 /* For safe rebasing we need to compare old and new backing file */
1366 /* Make the compiler happy */
1367 bs_old_backing
= NULL
;
1368 bs_new_backing
= NULL
;
1370 char backing_name
[1024];
1372 bs_old_backing
= bdrv_new("old_backing");
1373 bdrv_get_backing_filename(bs
, backing_name
, sizeof(backing_name
));
1374 ret
= bdrv_open(bs_old_backing
, backing_name
, BDRV_O_FLAGS
,
1377 error_report("Could not open old backing file '%s'", backing_name
);
1381 bs_new_backing
= bdrv_new("new_backing");
1382 ret
= bdrv_open(bs_new_backing
, out_baseimg
, BDRV_O_FLAGS
,
1385 error_report("Could not open new backing file '%s'", out_baseimg
);
1391 * Check each unallocated cluster in the COW file. If it is unallocated,
1392 * accesses go to the backing file. We must therefore compare this cluster
1393 * in the old and new backing file, and if they differ we need to copy it
1394 * from the old backing file into the COW file.
1396 * If qemu-img crashes during this step, no harm is done. The content of
1397 * the image is the same as the original one at any time.
1400 uint64_t num_sectors
;
1401 uint64_t old_backing_num_sectors
;
1402 uint64_t new_backing_num_sectors
;
1407 float local_progress
;
1409 buf_old
= qemu_blockalign(bs
, IO_BUF_SIZE
);
1410 buf_new
= qemu_blockalign(bs
, IO_BUF_SIZE
);
1412 bdrv_get_geometry(bs
, &num_sectors
);
1413 bdrv_get_geometry(bs_old_backing
, &old_backing_num_sectors
);
1414 bdrv_get_geometry(bs_new_backing
, &new_backing_num_sectors
);
1416 local_progress
= (float)100 /
1417 (num_sectors
/ MIN(num_sectors
, IO_BUF_SIZE
/ 512));
1418 for (sector
= 0; sector
< num_sectors
; sector
+= n
) {
1420 /* How many sectors can we handle with the next read? */
1421 if (sector
+ (IO_BUF_SIZE
/ 512) <= num_sectors
) {
1422 n
= (IO_BUF_SIZE
/ 512);
1424 n
= num_sectors
- sector
;
1427 /* If the cluster is allocated, we don't need to take action */
1428 ret
= bdrv_is_allocated(bs
, sector
, n
, &n
);
1434 * Read old and new backing file and take into consideration that
1435 * backing files may be smaller than the COW image.
1437 if (sector
>= old_backing_num_sectors
) {
1438 memset(buf_old
, 0, n
* BDRV_SECTOR_SIZE
);
1440 if (sector
+ n
> old_backing_num_sectors
) {
1441 n
= old_backing_num_sectors
- sector
;
1444 ret
= bdrv_read(bs_old_backing
, sector
, buf_old
, n
);
1446 error_report("error while reading from old backing file");
1451 if (sector
>= new_backing_num_sectors
) {
1452 memset(buf_new
, 0, n
* BDRV_SECTOR_SIZE
);
1454 if (sector
+ n
> new_backing_num_sectors
) {
1455 n
= new_backing_num_sectors
- sector
;
1458 ret
= bdrv_read(bs_new_backing
, sector
, buf_new
, n
);
1460 error_report("error while reading from new backing file");
1465 /* If they differ, we need to write to the COW file */
1466 uint64_t written
= 0;
1468 while (written
< n
) {
1471 if (compare_sectors(buf_old
+ written
* 512,
1472 buf_new
+ written
* 512, n
- written
, &pnum
))
1474 ret
= bdrv_write(bs
, sector
+ written
,
1475 buf_old
+ written
* 512, pnum
);
1477 error_report("Error while writing to COW image: %s",
1485 qemu_progress_print(local_progress
, 100);
1488 qemu_vfree(buf_old
);
1489 qemu_vfree(buf_new
);
1493 * Change the backing file. All clusters that are different from the old
1494 * backing file are overwritten in the COW file now, so the visible content
1495 * doesn't change when we switch the backing file.
1497 ret
= bdrv_change_backing_file(bs
, out_baseimg
, out_basefmt
);
1498 if (ret
== -ENOSPC
) {
1499 error_report("Could not change the backing file to '%s': No "
1500 "space left in the file header", out_baseimg
);
1501 } else if (ret
< 0) {
1502 error_report("Could not change the backing file to '%s': %s",
1503 out_baseimg
, strerror(-ret
));
1506 qemu_progress_print(100, 0);
1508 * TODO At this point it is possible to check if any clusters that are
1509 * allocated in the COW file are the same in the backing file. If so, they
1510 * could be dropped from the COW file. Don't do this before switching the
1511 * backing file, in case of a crash this would lead to corruption.
1514 qemu_progress_end();
1517 if (bs_old_backing
!= NULL
) {
1518 bdrv_delete(bs_old_backing
);
1520 if (bs_new_backing
!= NULL
) {
1521 bdrv_delete(bs_new_backing
);
1532 static int img_resize(int argc
, char **argv
)
1534 int c
, ret
, relative
;
1535 const char *filename
, *fmt
, *size
;
1536 int64_t n
, total_size
;
1537 BlockDriverState
*bs
= NULL
;
1538 QEMUOptionParameter
*param
;
1539 QEMUOptionParameter resize_options
[] = {
1541 .name
= BLOCK_OPT_SIZE
,
1543 .help
= "Virtual disk size"
1548 /* Remove size from argv manually so that negative numbers are not treated
1549 * as options by getopt. */
1555 size
= argv
[--argc
];
1557 /* Parse getopt arguments */
1560 c
= getopt(argc
, argv
, "f:h");
1574 if (optind
>= argc
) {
1577 filename
= argv
[optind
++];
1579 /* Choose grow, shrink, or absolute resize mode */
1595 param
= parse_option_parameters("", resize_options
, NULL
);
1596 if (set_option_parameter(param
, BLOCK_OPT_SIZE
, size
)) {
1597 /* Error message already printed when size parsing fails */
1601 n
= get_option_parameter(param
, BLOCK_OPT_SIZE
)->value
.n
;
1602 free_option_parameters(param
);
1604 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
| BDRV_O_RDWR
);
1611 total_size
= bdrv_getlength(bs
) + n
* relative
;
1615 if (total_size
<= 0) {
1616 error_report("New image size must be positive");
1621 ret
= bdrv_truncate(bs
, total_size
);
1624 printf("Image resized.\n");
1627 error_report("This image does not support resize");
1630 error_report("Image is read-only");
1633 error_report("Error resizing image (%d)", -ret
);
1646 static const img_cmd_t img_cmds
[] = {
1647 #define DEF(option, callback, arg_string) \
1648 { option, callback },
1649 #include "qemu-img-cmds.h"
1655 int main(int argc
, char **argv
)
1657 const img_cmd_t
*cmd
;
1658 const char *cmdname
;
1660 error_set_progname(argv
[0]);
1668 qemu_init_main_loop();
1670 /* find the command */
1671 for(cmd
= img_cmds
; cmd
->name
!= NULL
; cmd
++) {
1672 if (!strcmp(cmdname
, cmd
->name
)) {
1673 return cmd
->handler(argc
, argv
);