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 */
335 sval
= strtosz_suffix(argv
[optind
++], NULL
, STRTOSZ_DEFSUFFIX_B
);
337 error_report("Invalid image size specified! You may use k, M, G or "
339 error_report("kilobytes, megabytes, gigabytes and terabytes.");
343 img_size
= (uint64_t)sval
;
346 if (options
&& !strcmp(options
, "?")) {
347 ret
= print_block_option_help(filename
, fmt
);
351 ret
= bdrv_img_create(filename
, fmt
, base_filename
, base_fmt
,
352 options
, img_size
, BDRV_O_FLAGS
);
361 * Checks an image for consistency. Exit codes:
363 * 0 - Check completed, image is good
364 * 1 - Check not completed because of internal errors
365 * 2 - Check completed, image is corrupted
366 * 3 - Check completed, image has leaked clusters, but is good otherwise
368 static int img_check(int argc
, char **argv
)
371 const char *filename
, *fmt
;
372 BlockDriverState
*bs
;
373 BdrvCheckResult result
;
377 c
= getopt(argc
, argv
, "f:h");
391 if (optind
>= argc
) {
394 filename
= argv
[optind
++];
396 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
);
400 ret
= bdrv_check(bs
, &result
);
402 if (ret
== -ENOTSUP
) {
403 error_report("This image format does not support checks");
408 if (!(result
.corruptions
|| result
.leaks
|| result
.check_errors
)) {
409 printf("No errors were found on the image.\n");
411 if (result
.corruptions
) {
412 printf("\n%d errors were found on the image.\n"
413 "Data may be corrupted, or further writes to the image "
419 printf("\n%d leaked clusters were found on the image.\n"
420 "This means waste of disk space, but no harm to data.\n",
424 if (result
.check_errors
) {
425 printf("\n%d internal errors have occurred during the check.\n",
426 result
.check_errors
);
432 if (ret
< 0 || result
.check_errors
) {
433 printf("\nAn error has occurred during the check: %s\n"
434 "The check is not complete and may have missed error.\n",
439 if (result
.corruptions
) {
441 } else if (result
.leaks
) {
448 static int img_commit(int argc
, char **argv
)
451 const char *filename
, *fmt
, *cache
;
452 BlockDriverState
*bs
;
455 cache
= BDRV_DEFAULT_CACHE
;
457 c
= getopt(argc
, argv
, "f:ht:");
474 if (optind
>= argc
) {
477 filename
= argv
[optind
++];
480 ret
= bdrv_parse_cache_flags(cache
, &flags
);
482 error_report("Invalid cache option: %s", cache
);
486 bs
= bdrv_new_open(filename
, fmt
, flags
);
490 ret
= bdrv_commit(bs
);
493 printf("Image committed.\n");
496 error_report("No disk inserted");
499 error_report("Image is read-only");
502 error_report("Image is already committed");
505 error_report("Error while committing image");
517 * Checks whether the sector is not a zero sector.
519 * Attention! The len must be a multiple of 4 * sizeof(long) due to
520 * restriction of optimizations in this function.
522 static int is_not_zero(const uint8_t *sector
, int len
)
525 * Use long as the biggest available internal data type that fits into the
526 * CPU register and unroll the loop to smooth out the effect of memory
532 const long * const data
= (const long *) sector
;
536 for(i
= 0; i
< len
; i
+= 4) {
542 if (d0
|| d1
|| d2
|| d3
) {
551 * Returns true iff the first sector pointed to by 'buf' contains at least
554 * 'pnum' is set to the number of sectors (including and immediately following
555 * the first one) that are known to be in the same allocated/unallocated state.
557 static int is_allocated_sectors(const uint8_t *buf
, int n
, int *pnum
)
565 v
= is_not_zero(buf
, 512);
566 for(i
= 1; i
< n
; i
++) {
568 if (v
!= is_not_zero(buf
, 512))
576 * Like is_allocated_sectors, but if the buffer starts with a used sector,
577 * up to 'min' consecutive sectors containing zeros are ignored. This avoids
578 * breaking up write requests for only small sparse areas.
580 static int is_allocated_sectors_min(const uint8_t *buf
, int n
, int *pnum
,
584 int num_checked
, num_used
;
590 ret
= is_allocated_sectors(buf
, n
, pnum
);
596 buf
+= BDRV_SECTOR_SIZE
* *pnum
;
598 num_checked
= num_used
;
601 ret
= is_allocated_sectors(buf
, n
, pnum
);
603 buf
+= BDRV_SECTOR_SIZE
* *pnum
;
605 num_checked
+= *pnum
;
607 num_used
= num_checked
;
608 } else if (*pnum
>= min
) {
618 * Compares two buffers sector by sector. Returns 0 if the first sector of both
619 * buffers matches, non-zero otherwise.
621 * pnum is set to the number of sectors (including and immediately following
622 * the first one) that are known to have the same comparison result
624 static int compare_sectors(const uint8_t *buf1
, const uint8_t *buf2
, int n
,
634 res
= !!memcmp(buf1
, buf2
, 512);
635 for(i
= 1; i
< n
; i
++) {
639 if (!!memcmp(buf1
, buf2
, 512) != res
) {
648 #define IO_BUF_SIZE (2 * 1024 * 1024)
650 static int img_convert(int argc
, char **argv
)
652 int c
, ret
= 0, n
, n1
, bs_n
, bs_i
, compress
, cluster_size
, cluster_sectors
;
653 int progress
= 0, flags
;
654 const char *fmt
, *out_fmt
, *cache
, *out_baseimg
, *out_filename
;
655 BlockDriver
*drv
, *proto_drv
;
656 BlockDriverState
**bs
= NULL
, *out_bs
= NULL
;
657 int64_t total_sectors
, nb_sectors
, sector_num
, bs_offset
;
659 uint8_t * buf
= NULL
;
662 QEMUOptionParameter
*param
= NULL
, *create_options
= NULL
;
663 QEMUOptionParameter
*out_baseimg_param
;
664 char *options
= NULL
;
665 const char *snapshot_name
= NULL
;
666 float local_progress
;
667 int min_sparse
= 8; /* Need at least 4k of zeros for sparse detection */
675 c
= getopt(argc
, argv
, "f:O:B:s:hce6o:pS:t:");
691 out_baseimg
= optarg
;
697 error_report("option -e is deprecated, please use \'-o "
698 "encryption\' instead!");
701 error_report("option -6 is deprecated, please use \'-o "
702 "compat6\' instead!");
708 snapshot_name
= optarg
;
713 sval
= strtosz_suffix(optarg
, NULL
, STRTOSZ_DEFSUFFIX_B
);
715 error_report("Invalid minimum zero buffer size for sparse output specified");
719 min_sparse
= sval
/ BDRV_SECTOR_SIZE
;
731 bs_n
= argc
- optind
- 1;
736 out_filename
= argv
[argc
- 1];
738 if (options
&& !strcmp(options
, "?")) {
739 ret
= print_block_option_help(out_filename
, out_fmt
);
743 if (bs_n
> 1 && out_baseimg
) {
744 error_report("-B makes no sense when concatenating multiple input "
750 qemu_progress_init(progress
, 2.0);
751 qemu_progress_print(0, 100);
753 bs
= g_malloc0(bs_n
* sizeof(BlockDriverState
*));
756 for (bs_i
= 0; bs_i
< bs_n
; bs_i
++) {
757 bs
[bs_i
] = bdrv_new_open(argv
[optind
+ bs_i
], fmt
, BDRV_O_FLAGS
);
759 error_report("Could not open '%s'", argv
[optind
+ bs_i
]);
763 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
764 total_sectors
+= bs_sectors
;
767 if (snapshot_name
!= NULL
) {
769 error_report("No support for concatenating multiple snapshot");
773 if (bdrv_snapshot_load_tmp(bs
[0], snapshot_name
) < 0) {
774 error_report("Failed to load snapshot");
780 /* Find driver and parse its options */
781 drv
= bdrv_find_format(out_fmt
);
783 error_report("Unknown file format '%s'", out_fmt
);
788 proto_drv
= bdrv_find_protocol(out_filename
);
790 error_report("Unknown protocol '%s'", out_filename
);
795 create_options
= append_option_parameters(create_options
,
796 drv
->create_options
);
797 create_options
= append_option_parameters(create_options
,
798 proto_drv
->create_options
);
801 param
= parse_option_parameters(options
, create_options
, param
);
803 error_report("Invalid options for file format '%s'.", out_fmt
);
808 param
= parse_option_parameters("", create_options
, param
);
811 set_option_parameter_int(param
, BLOCK_OPT_SIZE
, total_sectors
* 512);
812 ret
= add_old_style_options(out_fmt
, param
, out_baseimg
, NULL
);
817 /* Get backing file name if -o backing_file was used */
818 out_baseimg_param
= get_option_parameter(param
, BLOCK_OPT_BACKING_FILE
);
819 if (out_baseimg_param
) {
820 out_baseimg
= out_baseimg_param
->value
.s
;
823 /* Check if compression is supported */
825 QEMUOptionParameter
*encryption
=
826 get_option_parameter(param
, BLOCK_OPT_ENCRYPT
);
828 if (!drv
->bdrv_write_compressed
) {
829 error_report("Compression not supported for this file format");
834 if (encryption
&& encryption
->value
.n
) {
835 error_report("Compression and encryption not supported at "
842 /* Create the new image */
843 ret
= bdrv_create(drv
, out_filename
, param
);
845 if (ret
== -ENOTSUP
) {
846 error_report("Formatting not supported for file format '%s'",
848 } else if (ret
== -EFBIG
) {
849 error_report("The image size is too large for file format '%s'",
852 error_report("%s: error while converting %s: %s",
853 out_filename
, out_fmt
, strerror(-ret
));
859 ret
= bdrv_parse_cache_flags(cache
, &flags
);
861 error_report("Invalid cache option: %s", cache
);
865 out_bs
= bdrv_new_open(out_filename
, out_fmt
, flags
);
873 bdrv_get_geometry(bs
[0], &bs_sectors
);
874 buf
= qemu_blockalign(out_bs
, IO_BUF_SIZE
);
877 ret
= bdrv_get_info(out_bs
, &bdi
);
879 error_report("could not get block driver info");
882 cluster_size
= bdi
.cluster_size
;
883 if (cluster_size
<= 0 || cluster_size
> IO_BUF_SIZE
) {
884 error_report("invalid cluster size");
888 cluster_sectors
= cluster_size
>> 9;
891 nb_sectors
= total_sectors
;
892 local_progress
= (float)100 /
893 (nb_sectors
/ MIN(nb_sectors
, cluster_sectors
));
900 nb_sectors
= total_sectors
- sector_num
;
903 if (nb_sectors
>= cluster_sectors
)
908 bs_num
= sector_num
- bs_offset
;
909 assert (bs_num
>= 0);
912 while (remainder
> 0) {
914 while (bs_num
== bs_sectors
) {
916 assert (bs_i
< bs_n
);
917 bs_offset
+= bs_sectors
;
918 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
920 /* printf("changing part: sector_num=%" PRId64 ", "
921 "bs_i=%d, bs_offset=%" PRId64 ", bs_sectors=%" PRId64
922 "\n", sector_num, bs_i, bs_offset, bs_sectors); */
924 assert (bs_num
< bs_sectors
);
926 nlow
= (remainder
> bs_sectors
- bs_num
) ? bs_sectors
- bs_num
: remainder
;
928 ret
= bdrv_read(bs
[bs_i
], bs_num
, buf2
, nlow
);
930 error_report("error while reading sector %" PRId64
": %s",
931 bs_num
, strerror(-ret
));
940 assert (remainder
== 0);
942 if (n
< cluster_sectors
) {
943 memset(buf
+ n
* 512, 0, cluster_size
- n
* 512);
945 if (is_not_zero(buf
, cluster_size
)) {
946 ret
= bdrv_write_compressed(out_bs
, sector_num
, buf
,
949 error_report("error while compressing sector %" PRId64
950 ": %s", sector_num
, strerror(-ret
));
955 qemu_progress_print(local_progress
, 100);
957 /* signal EOF to align */
958 bdrv_write_compressed(out_bs
, 0, NULL
, 0);
960 int has_zero_init
= bdrv_has_zero_init(out_bs
);
962 sector_num
= 0; // total number of sectors converted so far
963 nb_sectors
= total_sectors
- sector_num
;
964 local_progress
= (float)100 /
965 (nb_sectors
/ MIN(nb_sectors
, IO_BUF_SIZE
/ 512));
968 nb_sectors
= total_sectors
- sector_num
;
969 if (nb_sectors
<= 0) {
972 if (nb_sectors
>= (IO_BUF_SIZE
/ 512)) {
973 n
= (IO_BUF_SIZE
/ 512);
978 while (sector_num
- bs_offset
>= bs_sectors
) {
980 assert (bs_i
< bs_n
);
981 bs_offset
+= bs_sectors
;
982 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
983 /* printf("changing part: sector_num=%" PRId64 ", bs_i=%d, "
984 "bs_offset=%" PRId64 ", bs_sectors=%" PRId64 "\n",
985 sector_num, bs_i, bs_offset, bs_sectors); */
988 if (n
> bs_offset
+ bs_sectors
- sector_num
) {
989 n
= bs_offset
+ bs_sectors
- sector_num
;
993 /* If the output image is being created as a copy on write image,
994 assume that sectors which are unallocated in the input image
995 are present in both the output's and input's base images (no
996 need to copy them). */
998 if (!bdrv_is_allocated(bs
[bs_i
], sector_num
- bs_offset
,
1003 /* The next 'n1' sectors are allocated in the input image. Copy
1004 only those as they may be followed by unallocated sectors. */
1011 ret
= bdrv_read(bs
[bs_i
], sector_num
- bs_offset
, buf
, n
);
1013 error_report("error while reading sector %" PRId64
": %s",
1014 sector_num
- bs_offset
, strerror(-ret
));
1017 /* NOTE: at the same time we convert, we do not write zero
1018 sectors to have a chance to compress the image. Ideally, we
1019 should add a specific call to have the info to go faster */
1022 /* If the output image is being created as a copy on write image,
1023 copy all sectors even the ones containing only NUL bytes,
1024 because they may differ from the sectors in the base image.
1026 If the output is to a host device, we also write out
1027 sectors that are entirely 0, since whatever data was
1028 already there is garbage, not 0s. */
1029 if (!has_zero_init
|| out_baseimg
||
1030 is_allocated_sectors_min(buf1
, n
, &n1
, min_sparse
)) {
1031 ret
= bdrv_write(out_bs
, sector_num
, buf1
, n1
);
1033 error_report("error while writing sector %" PRId64
1034 ": %s", sector_num
, strerror(-ret
));
1042 qemu_progress_print(local_progress
, 100);
1046 qemu_progress_end();
1047 free_option_parameters(create_options
);
1048 free_option_parameters(param
);
1051 bdrv_delete(out_bs
);
1054 for (bs_i
= 0; bs_i
< bs_n
; bs_i
++) {
1056 bdrv_delete(bs
[bs_i
]);
1068 static void dump_snapshots(BlockDriverState
*bs
)
1070 QEMUSnapshotInfo
*sn_tab
, *sn
;
1074 nb_sns
= bdrv_snapshot_list(bs
, &sn_tab
);
1077 printf("Snapshot list:\n");
1078 printf("%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), NULL
));
1079 for(i
= 0; i
< nb_sns
; i
++) {
1081 printf("%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), sn
));
1086 static int img_info(int argc
, char **argv
)
1089 const char *filename
, *fmt
;
1090 BlockDriverState
*bs
;
1091 char fmt_name
[128], size_buf
[128], dsize_buf
[128];
1092 uint64_t total_sectors
;
1093 int64_t allocated_size
;
1094 char backing_filename
[1024];
1095 char backing_filename2
[1024];
1096 BlockDriverInfo bdi
;
1100 c
= getopt(argc
, argv
, "f:h");
1114 if (optind
>= argc
) {
1117 filename
= argv
[optind
++];
1119 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
| BDRV_O_NO_BACKING
);
1123 bdrv_get_format(bs
, fmt_name
, sizeof(fmt_name
));
1124 bdrv_get_geometry(bs
, &total_sectors
);
1125 get_human_readable_size(size_buf
, sizeof(size_buf
), total_sectors
* 512);
1126 allocated_size
= bdrv_get_allocated_file_size(bs
);
1127 if (allocated_size
< 0) {
1128 snprintf(dsize_buf
, sizeof(dsize_buf
), "unavailable");
1130 get_human_readable_size(dsize_buf
, sizeof(dsize_buf
),
1133 printf("image: %s\n"
1135 "virtual size: %s (%" PRId64
" bytes)\n"
1137 filename
, fmt_name
, size_buf
,
1138 (total_sectors
* 512),
1140 if (bdrv_is_encrypted(bs
)) {
1141 printf("encrypted: yes\n");
1143 if (bdrv_get_info(bs
, &bdi
) >= 0) {
1144 if (bdi
.cluster_size
!= 0) {
1145 printf("cluster_size: %d\n", bdi
.cluster_size
);
1148 bdrv_get_backing_filename(bs
, backing_filename
, sizeof(backing_filename
));
1149 if (backing_filename
[0] != '\0') {
1150 path_combine(backing_filename2
, sizeof(backing_filename2
),
1151 filename
, backing_filename
);
1152 printf("backing file: %s (actual path: %s)\n",
1161 #define SNAPSHOT_LIST 1
1162 #define SNAPSHOT_CREATE 2
1163 #define SNAPSHOT_APPLY 3
1164 #define SNAPSHOT_DELETE 4
1166 static int img_snapshot(int argc
, char **argv
)
1168 BlockDriverState
*bs
;
1169 QEMUSnapshotInfo sn
;
1170 char *filename
, *snapshot_name
= NULL
;
1171 int c
, ret
= 0, bdrv_oflags
;
1175 bdrv_oflags
= BDRV_O_FLAGS
| BDRV_O_RDWR
;
1176 /* Parse commandline parameters */
1178 c
= getopt(argc
, argv
, "la:c:d:h");
1192 action
= SNAPSHOT_LIST
;
1193 bdrv_oflags
&= ~BDRV_O_RDWR
; /* no need for RW */
1200 action
= SNAPSHOT_APPLY
;
1201 snapshot_name
= optarg
;
1208 action
= SNAPSHOT_CREATE
;
1209 snapshot_name
= optarg
;
1216 action
= SNAPSHOT_DELETE
;
1217 snapshot_name
= optarg
;
1222 if (optind
>= argc
) {
1225 filename
= argv
[optind
++];
1227 /* Open the image */
1228 bs
= bdrv_new_open(filename
, NULL
, bdrv_oflags
);
1233 /* Perform the requested action */
1239 case SNAPSHOT_CREATE
:
1240 memset(&sn
, 0, sizeof(sn
));
1241 pstrcpy(sn
.name
, sizeof(sn
.name
), snapshot_name
);
1243 qemu_gettimeofday(&tv
);
1244 sn
.date_sec
= tv
.tv_sec
;
1245 sn
.date_nsec
= tv
.tv_usec
* 1000;
1247 ret
= bdrv_snapshot_create(bs
, &sn
);
1249 error_report("Could not create snapshot '%s': %d (%s)",
1250 snapshot_name
, ret
, strerror(-ret
));
1254 case SNAPSHOT_APPLY
:
1255 ret
= bdrv_snapshot_goto(bs
, snapshot_name
);
1257 error_report("Could not apply snapshot '%s': %d (%s)",
1258 snapshot_name
, ret
, strerror(-ret
));
1262 case SNAPSHOT_DELETE
:
1263 ret
= bdrv_snapshot_delete(bs
, snapshot_name
);
1265 error_report("Could not delete snapshot '%s': %d (%s)",
1266 snapshot_name
, ret
, strerror(-ret
));
1279 static int img_rebase(int argc
, char **argv
)
1281 BlockDriverState
*bs
, *bs_old_backing
= NULL
, *bs_new_backing
= NULL
;
1282 BlockDriver
*old_backing_drv
, *new_backing_drv
;
1284 const char *fmt
, *cache
, *out_basefmt
, *out_baseimg
;
1289 /* Parse commandline parameters */
1291 cache
= BDRV_DEFAULT_CACHE
;
1295 c
= getopt(argc
, argv
, "uhf:F:b:pt:");
1308 out_basefmt
= optarg
;
1311 out_baseimg
= optarg
;
1325 if ((optind
>= argc
) || (!unsafe
&& !out_baseimg
)) {
1328 filename
= argv
[optind
++];
1330 qemu_progress_init(progress
, 2.0);
1331 qemu_progress_print(0, 100);
1333 flags
= BDRV_O_RDWR
| (unsafe
? BDRV_O_NO_BACKING
: 0);
1334 ret
= bdrv_parse_cache_flags(cache
, &flags
);
1336 error_report("Invalid cache option: %s", cache
);
1343 * Ignore the old backing file for unsafe rebase in case we want to correct
1344 * the reference to a renamed or moved backing file.
1346 bs
= bdrv_new_open(filename
, fmt
, flags
);
1351 /* Find the right drivers for the backing files */
1352 old_backing_drv
= NULL
;
1353 new_backing_drv
= NULL
;
1355 if (!unsafe
&& bs
->backing_format
[0] != '\0') {
1356 old_backing_drv
= bdrv_find_format(bs
->backing_format
);
1357 if (old_backing_drv
== NULL
) {
1358 error_report("Invalid format name: '%s'", bs
->backing_format
);
1364 if (out_basefmt
!= NULL
) {
1365 new_backing_drv
= bdrv_find_format(out_basefmt
);
1366 if (new_backing_drv
== NULL
) {
1367 error_report("Invalid format name: '%s'", out_basefmt
);
1373 /* For safe rebasing we need to compare old and new backing file */
1375 /* Make the compiler happy */
1376 bs_old_backing
= NULL
;
1377 bs_new_backing
= NULL
;
1379 char backing_name
[1024];
1381 bs_old_backing
= bdrv_new("old_backing");
1382 bdrv_get_backing_filename(bs
, backing_name
, sizeof(backing_name
));
1383 ret
= bdrv_open(bs_old_backing
, backing_name
, BDRV_O_FLAGS
,
1386 error_report("Could not open old backing file '%s'", backing_name
);
1390 bs_new_backing
= bdrv_new("new_backing");
1391 ret
= bdrv_open(bs_new_backing
, out_baseimg
, BDRV_O_FLAGS
,
1394 error_report("Could not open new backing file '%s'", out_baseimg
);
1400 * Check each unallocated cluster in the COW file. If it is unallocated,
1401 * accesses go to the backing file. We must therefore compare this cluster
1402 * in the old and new backing file, and if they differ we need to copy it
1403 * from the old backing file into the COW file.
1405 * If qemu-img crashes during this step, no harm is done. The content of
1406 * the image is the same as the original one at any time.
1409 uint64_t num_sectors
;
1414 float local_progress
;
1416 buf_old
= qemu_blockalign(bs
, IO_BUF_SIZE
);
1417 buf_new
= qemu_blockalign(bs
, IO_BUF_SIZE
);
1419 bdrv_get_geometry(bs
, &num_sectors
);
1421 local_progress
= (float)100 /
1422 (num_sectors
/ MIN(num_sectors
, IO_BUF_SIZE
/ 512));
1423 for (sector
= 0; sector
< num_sectors
; sector
+= n
) {
1425 /* How many sectors can we handle with the next read? */
1426 if (sector
+ (IO_BUF_SIZE
/ 512) <= num_sectors
) {
1427 n
= (IO_BUF_SIZE
/ 512);
1429 n
= num_sectors
- sector
;
1432 /* If the cluster is allocated, we don't need to take action */
1433 ret
= bdrv_is_allocated(bs
, sector
, n
, &n
);
1438 /* Read old and new backing file */
1439 ret
= bdrv_read(bs_old_backing
, sector
, buf_old
, n
);
1441 error_report("error while reading from old backing file");
1444 ret
= bdrv_read(bs_new_backing
, sector
, buf_new
, n
);
1446 error_report("error while reading from new backing file");
1450 /* If they differ, we need to write to the COW file */
1451 uint64_t written
= 0;
1453 while (written
< n
) {
1456 if (compare_sectors(buf_old
+ written
* 512,
1457 buf_new
+ written
* 512, n
- written
, &pnum
))
1459 ret
= bdrv_write(bs
, sector
+ written
,
1460 buf_old
+ written
* 512, pnum
);
1462 error_report("Error while writing to COW image: %s",
1470 qemu_progress_print(local_progress
, 100);
1473 qemu_vfree(buf_old
);
1474 qemu_vfree(buf_new
);
1478 * Change the backing file. All clusters that are different from the old
1479 * backing file are overwritten in the COW file now, so the visible content
1480 * doesn't change when we switch the backing file.
1482 ret
= bdrv_change_backing_file(bs
, out_baseimg
, out_basefmt
);
1483 if (ret
== -ENOSPC
) {
1484 error_report("Could not change the backing file to '%s': No "
1485 "space left in the file header", out_baseimg
);
1486 } else if (ret
< 0) {
1487 error_report("Could not change the backing file to '%s': %s",
1488 out_baseimg
, strerror(-ret
));
1491 qemu_progress_print(100, 0);
1493 * TODO At this point it is possible to check if any clusters that are
1494 * allocated in the COW file are the same in the backing file. If so, they
1495 * could be dropped from the COW file. Don't do this before switching the
1496 * backing file, in case of a crash this would lead to corruption.
1499 qemu_progress_end();
1502 if (bs_old_backing
!= NULL
) {
1503 bdrv_delete(bs_old_backing
);
1505 if (bs_new_backing
!= NULL
) {
1506 bdrv_delete(bs_new_backing
);
1517 static int img_resize(int argc
, char **argv
)
1519 int c
, ret
, relative
;
1520 const char *filename
, *fmt
, *size
;
1521 int64_t n
, total_size
;
1522 BlockDriverState
*bs
= NULL
;
1523 QEMUOptionParameter
*param
;
1524 QEMUOptionParameter resize_options
[] = {
1526 .name
= BLOCK_OPT_SIZE
,
1528 .help
= "Virtual disk size"
1533 /* Remove size from argv manually so that negative numbers are not treated
1534 * as options by getopt. */
1540 size
= argv
[--argc
];
1542 /* Parse getopt arguments */
1545 c
= getopt(argc
, argv
, "f:h");
1559 if (optind
>= argc
) {
1562 filename
= argv
[optind
++];
1564 /* Choose grow, shrink, or absolute resize mode */
1580 param
= parse_option_parameters("", resize_options
, NULL
);
1581 if (set_option_parameter(param
, BLOCK_OPT_SIZE
, size
)) {
1582 /* Error message already printed when size parsing fails */
1586 n
= get_option_parameter(param
, BLOCK_OPT_SIZE
)->value
.n
;
1587 free_option_parameters(param
);
1589 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
| BDRV_O_RDWR
);
1596 total_size
= bdrv_getlength(bs
) + n
* relative
;
1600 if (total_size
<= 0) {
1601 error_report("New image size must be positive");
1606 ret
= bdrv_truncate(bs
, total_size
);
1609 printf("Image resized.\n");
1612 error_report("This image format does not support resize");
1615 error_report("Image is read-only");
1618 error_report("Error resizing image (%d)", -ret
);
1631 static const img_cmd_t img_cmds
[] = {
1632 #define DEF(option, callback, arg_string) \
1633 { option, callback },
1634 #include "qemu-img-cmds.h"
1640 int main(int argc
, char **argv
)
1642 const img_cmd_t
*cmd
;
1643 const char *cmdname
;
1645 error_set_progname(argv
[0]);
1653 /* find the command */
1654 for(cmd
= img_cmds
; cmd
->name
!= NULL
; cmd
++) {
1655 if (!strcmp(cmdname
, cmd
->name
)) {
1656 return cmd
->handler(argc
, argv
);