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"
27 #include "block_int.h"
34 typedef struct img_cmd_t
{
36 int (*handler
)(int argc
, char **argv
);
39 /* Default to cache=writeback as data integrity is not important for qemu-tcg. */
40 #define BDRV_O_FLAGS BDRV_O_CACHE_WB
42 static void error(const char *fmt
, ...)
46 fprintf(stderr
, "qemu-img: ");
47 vfprintf(stderr
, fmt
, ap
);
48 fprintf(stderr
, "\n");
52 static void format_print(void *opaque
, const char *name
)
57 /* Please keep in synch with qemu-img.texi */
58 static void help(void)
60 const char *help_msg
=
61 "qemu-img version " QEMU_VERSION
", Copyright (c) 2004-2008 Fabrice Bellard\n"
62 "usage: qemu-img command [command options]\n"
63 "QEMU disk image utility\n"
66 #define DEF(option, callback, arg_string) \
68 #include "qemu-img-cmds.h"
72 "Command parameters:\n"
73 " 'filename' is a disk image filename\n"
74 " 'fmt' is the disk image format. It is guessed automatically in most cases\n"
75 " 'size' is the disk image size in bytes. Optional suffixes\n"
76 " 'k' or 'K' (kilobyte, 1024), 'M' (megabyte, 1024k), 'G' (gigabyte, 1024M)\n"
77 " and T (terabyte, 1024G) are supported. 'b' is ignored.\n"
78 " 'output_filename' is the destination disk image filename\n"
79 " 'output_fmt' is the destination format\n"
80 " 'options' is a comma separated list of format specific options in a\n"
81 " name=value format. Use -o ? for an overview of the options supported by the\n"
83 " '-c' indicates that target image must be compressed (qcow format only)\n"
84 " '-u' enables unsafe rebasing. It is assumed that old and new backing file\n"
85 " match exactly. The image doesn't need a working backing file before\n"
86 " rebasing in this case (useful for renaming the backing file)\n"
87 " '-h' with or without a command shows this help and lists the supported formats\n"
89 "Parameters to snapshot subcommand:\n"
90 " 'snapshot' is the name of the snapshot to create, apply or delete\n"
91 " '-a' applies a snapshot (revert disk to saved state)\n"
92 " '-c' creates a snapshot\n"
93 " '-d' deletes a snapshot\n"
94 " '-l' lists all snapshots in the given image\n";
96 printf("%s\nSupported formats:", help_msg
);
97 bdrv_iterate_format(format_print
, NULL
);
103 /* XXX: put correct support for win32 */
104 static int read_password(char *buf
, int buf_size
)
107 printf("Password: ");
114 if (i
< (buf_size
- 1))
125 static struct termios oldtty
;
127 static void term_exit(void)
129 tcsetattr (0, TCSANOW
, &oldtty
);
132 static void term_init(void)
139 tty
.c_iflag
&= ~(IGNBRK
|BRKINT
|PARMRK
|ISTRIP
140 |INLCR
|IGNCR
|ICRNL
|IXON
);
141 tty
.c_oflag
|= OPOST
;
142 tty
.c_lflag
&= ~(ECHO
|ECHONL
|ICANON
|IEXTEN
);
143 tty
.c_cflag
&= ~(CSIZE
|PARENB
);
148 tcsetattr (0, TCSANOW
, &tty
);
153 static int read_password(char *buf
, int buf_size
)
158 printf("password: ");
163 ret
= read(0, &ch
, 1);
165 if (errno
== EAGAIN
|| errno
== EINTR
) {
171 } else if (ret
== 0) {
179 if (i
< (buf_size
- 1))
190 static BlockDriverState
*bdrv_new_open(const char *filename
,
194 BlockDriverState
*bs
;
200 error("Not enough memory");
204 drv
= bdrv_find_format(fmt
);
206 error("Unknown file format '%s'", fmt
);
212 if (bdrv_open(bs
, filename
, flags
, drv
) < 0) {
213 error("Could not open '%s'", filename
);
216 if (bdrv_is_encrypted(bs
)) {
217 printf("Disk image '%s' is encrypted.\n", filename
);
218 if (read_password(password
, sizeof(password
)) < 0) {
219 error("No password given");
222 if (bdrv_set_key(bs
, password
) < 0) {
223 error("invalid password");
235 static int add_old_style_options(const char *fmt
, QEMUOptionParameter
*list
,
236 int flags
, const char *base_filename
, const char *base_fmt
)
238 if (flags
& BLOCK_FLAG_ENCRYPT
) {
239 if (set_option_parameter(list
, BLOCK_OPT_ENCRYPT
, "on")) {
240 error("Encryption not supported for file format '%s'", fmt
);
244 if (flags
& BLOCK_FLAG_COMPAT6
) {
245 if (set_option_parameter(list
, BLOCK_OPT_COMPAT6
, "on")) {
246 error("VMDK version 6 not supported for file format '%s'", fmt
);
252 if (set_option_parameter(list
, BLOCK_OPT_BACKING_FILE
, base_filename
)) {
253 error("Backing file not supported for file format '%s'", fmt
);
258 if (set_option_parameter(list
, BLOCK_OPT_BACKING_FMT
, base_fmt
)) {
259 error("Backing file format not supported for file format '%s'", fmt
);
266 static int img_create(int argc
, char **argv
)
268 int c
, ret
= 0, flags
;
269 const char *fmt
= "raw";
270 const char *base_fmt
= NULL
;
271 const char *filename
;
272 const char *base_filename
= NULL
;
273 BlockDriver
*drv
, *proto_drv
;
274 QEMUOptionParameter
*param
= NULL
, *create_options
= NULL
;
275 char *options
= NULL
;
279 c
= getopt(argc
, argv
, "F:b:f:he6o:");
290 base_filename
= optarg
;
296 flags
|= BLOCK_FLAG_ENCRYPT
;
299 flags
|= BLOCK_FLAG_COMPAT6
;
307 /* Get the filename */
310 filename
= argv
[optind
++];
312 /* Find driver and parse its options */
313 drv
= bdrv_find_format(fmt
);
315 error("Unknown file format '%s'", fmt
);
319 proto_drv
= bdrv_find_protocol(filename
);
321 error("Unknown protocol '%s'", filename
);
325 create_options
= append_option_parameters(create_options
,
326 drv
->create_options
);
327 create_options
= append_option_parameters(create_options
,
328 proto_drv
->create_options
);
330 if (options
&& !strcmp(options
, "?")) {
331 print_option_help(create_options
);
335 /* Create parameter list with default values */
336 param
= parse_option_parameters("", create_options
, param
);
337 set_option_parameter_int(param
, BLOCK_OPT_SIZE
, -1);
339 /* Parse -o options */
341 param
= parse_option_parameters(options
, create_options
, param
);
343 error("Invalid options for file format '%s'.", fmt
);
349 /* Add size to parameters */
351 set_option_parameter(param
, BLOCK_OPT_SIZE
, argv
[optind
++]);
354 /* Add old-style options to parameters */
355 ret
= add_old_style_options(fmt
, param
, flags
, base_filename
, base_fmt
);
360 // The size for the image must always be specified, with one exception:
361 // If we are using a backing file, we can obtain the size from there
362 if (get_option_parameter(param
, BLOCK_OPT_SIZE
)->value
.n
== -1) {
364 QEMUOptionParameter
*backing_file
=
365 get_option_parameter(param
, BLOCK_OPT_BACKING_FILE
);
366 QEMUOptionParameter
*backing_fmt
=
367 get_option_parameter(param
, BLOCK_OPT_BACKING_FMT
);
369 if (backing_file
&& backing_file
->value
.s
) {
370 BlockDriverState
*bs
;
372 const char *fmt
= NULL
;
375 if (backing_fmt
&& backing_fmt
->value
.s
) {
376 if (bdrv_find_format(backing_fmt
->value
.s
)) {
377 fmt
= backing_fmt
->value
.s
;
379 error("Unknown backing file format '%s'",
380 backing_fmt
->value
.s
);
386 bs
= bdrv_new_open(backing_file
->value
.s
, fmt
, BDRV_O_FLAGS
);
391 bdrv_get_geometry(bs
, &size
);
395 snprintf(buf
, sizeof(buf
), "%" PRId64
, size
);
396 set_option_parameter(param
, BLOCK_OPT_SIZE
, buf
);
398 error("Image creation needs a size parameter");
404 printf("Formatting '%s', fmt=%s ", filename
, fmt
);
405 print_option_parameters(param
);
408 ret
= bdrv_create(drv
, filename
, param
);
409 free_option_parameters(create_options
);
410 free_option_parameters(param
);
413 if (ret
== -ENOTSUP
) {
414 error("Formatting or formatting option not supported for file format '%s'", fmt
);
415 } else if (ret
== -EFBIG
) {
416 error("The image size is too large for file format '%s'", fmt
);
418 error("%s: error while creating %s: %s", filename
, fmt
, strerror(-ret
));
429 * Checks an image for consistency. Exit codes:
431 * 0 - Check completed, image is good
432 * 1 - Check not completed because of internal errors
433 * 2 - Check completed, image is corrupted
434 * 3 - Check completed, image has leaked clusters, but is good otherwise
436 static int img_check(int argc
, char **argv
)
439 const char *filename
, *fmt
;
440 BlockDriverState
*bs
;
441 BdrvCheckResult result
;
445 c
= getopt(argc
, argv
, "f:h");
459 filename
= argv
[optind
++];
461 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
);
465 ret
= bdrv_check(bs
, &result
);
467 if (ret
== -ENOTSUP
) {
468 error("This image format does not support checks");
473 if (!(result
.corruptions
|| result
.leaks
|| result
.check_errors
)) {
474 printf("No errors were found on the image.\n");
476 if (result
.corruptions
) {
477 printf("\n%d errors were found on the image.\n"
478 "Data may be corrupted, or further writes to the image "
484 printf("\n%d leaked clusters were found on the image.\n"
485 "This means waste of disk space, but no harm to data.\n",
489 if (result
.check_errors
) {
490 printf("\n%d internal errors have occurred during the check.\n",
491 result
.check_errors
);
497 if (ret
< 0 || result
.check_errors
) {
498 printf("\nAn error has occurred during the check: %s\n"
499 "The check is not complete and may have missed error.\n",
504 if (result
.corruptions
) {
506 } else if (result
.leaks
) {
513 static int img_commit(int argc
, char **argv
)
516 const char *filename
, *fmt
;
517 BlockDriverState
*bs
;
521 c
= getopt(argc
, argv
, "f:h");
535 filename
= argv
[optind
++];
537 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
| BDRV_O_RDWR
);
541 ret
= bdrv_commit(bs
);
544 printf("Image committed.\n");
547 error("No disk inserted");
550 error("Image is read-only");
553 error("Image is already committed");
556 error("Error while committing image");
567 static int is_not_zero(const uint8_t *sector
, int len
)
571 for(i
= 0;i
< len
; i
++) {
572 if (((uint32_t *)sector
)[i
] != 0)
579 * Returns true iff the first sector pointed to by 'buf' contains at least
582 * 'pnum' is set to the number of sectors (including and immediately following
583 * the first one) that are known to be in the same allocated/unallocated state.
585 static int is_allocated_sectors(const uint8_t *buf
, int n
, int *pnum
)
593 v
= is_not_zero(buf
, 512);
594 for(i
= 1; i
< n
; i
++) {
596 if (v
!= is_not_zero(buf
, 512))
604 * Compares two buffers sector by sector. Returns 0 if the first sector of both
605 * buffers matches, non-zero otherwise.
607 * pnum is set to the number of sectors (including and immediately following
608 * the first one) that are known to have the same comparison result
610 static int compare_sectors(const uint8_t *buf1
, const uint8_t *buf2
, int n
,
620 res
= !!memcmp(buf1
, buf2
, 512);
621 for(i
= 1; i
< n
; i
++) {
625 if (!!memcmp(buf1
, buf2
, 512) != res
) {
634 #define IO_BUF_SIZE (2 * 1024 * 1024)
636 static int img_convert(int argc
, char **argv
)
638 int c
, ret
= 0, n
, n1
, bs_n
, bs_i
, flags
, cluster_size
, cluster_sectors
;
639 const char *fmt
, *out_fmt
, *out_baseimg
, *out_filename
;
640 BlockDriver
*drv
, *proto_drv
;
641 BlockDriverState
**bs
= NULL
, *out_bs
= NULL
;
642 int64_t total_sectors
, nb_sectors
, sector_num
, bs_offset
;
644 uint8_t * buf
= NULL
;
647 QEMUOptionParameter
*param
= NULL
, *create_options
= NULL
;
648 char *options
= NULL
;
655 c
= getopt(argc
, argv
, "f:O:B:hce6o:");
669 out_baseimg
= optarg
;
672 flags
|= BLOCK_FLAG_COMPRESS
;
675 flags
|= BLOCK_FLAG_ENCRYPT
;
678 flags
|= BLOCK_FLAG_COMPAT6
;
686 bs_n
= argc
- optind
- 1;
687 if (bs_n
< 1) help();
689 out_filename
= argv
[argc
- 1];
691 if (bs_n
> 1 && out_baseimg
) {
692 error("-B makes no sense when concatenating multiple input images");
696 bs
= calloc(bs_n
, sizeof(BlockDriverState
*));
698 error("Out of memory");
703 for (bs_i
= 0; bs_i
< bs_n
; bs_i
++) {
704 bs
[bs_i
] = bdrv_new_open(argv
[optind
+ bs_i
], fmt
, BDRV_O_FLAGS
);
706 error("Could not open '%s'", argv
[optind
+ bs_i
]);
710 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
711 total_sectors
+= bs_sectors
;
714 /* Find driver and parse its options */
715 drv
= bdrv_find_format(out_fmt
);
717 error("Unknown file format '%s'", out_fmt
);
722 proto_drv
= bdrv_find_protocol(out_filename
);
724 error("Unknown protocol '%s'", out_filename
);
729 create_options
= append_option_parameters(create_options
,
730 drv
->create_options
);
731 create_options
= append_option_parameters(create_options
,
732 proto_drv
->create_options
);
733 if (options
&& !strcmp(options
, "?")) {
734 print_option_help(create_options
);
739 param
= parse_option_parameters(options
, create_options
, param
);
741 error("Invalid options for file format '%s'.", out_fmt
);
746 param
= parse_option_parameters("", create_options
, param
);
749 set_option_parameter_int(param
, BLOCK_OPT_SIZE
, total_sectors
* 512);
750 ret
= add_old_style_options(out_fmt
, param
, flags
, out_baseimg
, NULL
);
755 /* Check if compression is supported */
756 if (flags
& BLOCK_FLAG_COMPRESS
) {
757 QEMUOptionParameter
*encryption
=
758 get_option_parameter(param
, BLOCK_OPT_ENCRYPT
);
760 if (!drv
->bdrv_write_compressed
) {
761 error("Compression not supported for this file format");
766 if (encryption
&& encryption
->value
.n
) {
767 error("Compression and encryption not supported at the same time");
773 /* Create the new image */
774 ret
= bdrv_create(drv
, out_filename
, param
);
776 if (ret
== -ENOTSUP
) {
777 error("Formatting not supported for file format '%s'", out_fmt
);
778 } else if (ret
== -EFBIG
) {
779 error("The image size is too large for file format '%s'", out_fmt
);
781 error("%s: error while converting %s: %s", out_filename
, out_fmt
, strerror(-ret
));
786 out_bs
= bdrv_new_open(out_filename
, out_fmt
,
787 BDRV_O_FLAGS
| BDRV_O_RDWR
| BDRV_O_NO_FLUSH
);
795 bdrv_get_geometry(bs
[0], &bs_sectors
);
796 buf
= qemu_malloc(IO_BUF_SIZE
);
798 if (flags
& BLOCK_FLAG_COMPRESS
) {
799 ret
= bdrv_get_info(out_bs
, &bdi
);
801 error("could not get block driver info");
804 cluster_size
= bdi
.cluster_size
;
805 if (cluster_size
<= 0 || cluster_size
> IO_BUF_SIZE
) {
806 error("invalid cluster size");
810 cluster_sectors
= cluster_size
>> 9;
817 nb_sectors
= total_sectors
- sector_num
;
820 if (nb_sectors
>= cluster_sectors
)
825 bs_num
= sector_num
- bs_offset
;
826 assert (bs_num
>= 0);
829 while (remainder
> 0) {
831 while (bs_num
== bs_sectors
) {
833 assert (bs_i
< bs_n
);
834 bs_offset
+= bs_sectors
;
835 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
837 /* printf("changing part: sector_num=%" PRId64 ", "
838 "bs_i=%d, bs_offset=%" PRId64 ", bs_sectors=%" PRId64
839 "\n", sector_num, bs_i, bs_offset, bs_sectors); */
841 assert (bs_num
< bs_sectors
);
843 nlow
= (remainder
> bs_sectors
- bs_num
) ? bs_sectors
- bs_num
: remainder
;
845 ret
= bdrv_read(bs
[bs_i
], bs_num
, buf2
, nlow
);
847 error("error while reading");
856 assert (remainder
== 0);
858 if (n
< cluster_sectors
)
859 memset(buf
+ n
* 512, 0, cluster_size
- n
* 512);
860 if (is_not_zero(buf
, cluster_size
)) {
861 ret
= bdrv_write_compressed(out_bs
, sector_num
, buf
,
864 error("error while compressing sector %" PRId64
,
871 /* signal EOF to align */
872 bdrv_write_compressed(out_bs
, 0, NULL
, 0);
874 int has_zero_init
= bdrv_has_zero_init(out_bs
);
876 sector_num
= 0; // total number of sectors converted so far
878 nb_sectors
= total_sectors
- sector_num
;
881 if (nb_sectors
>= (IO_BUF_SIZE
/ 512))
882 n
= (IO_BUF_SIZE
/ 512);
886 while (sector_num
- bs_offset
>= bs_sectors
) {
888 assert (bs_i
< bs_n
);
889 bs_offset
+= bs_sectors
;
890 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
891 /* printf("changing part: sector_num=%" PRId64 ", bs_i=%d, "
892 "bs_offset=%" PRId64 ", bs_sectors=%" PRId64 "\n",
893 sector_num, bs_i, bs_offset, bs_sectors); */
896 if (n
> bs_offset
+ bs_sectors
- sector_num
)
897 n
= bs_offset
+ bs_sectors
- sector_num
;
900 /* If the output image is being created as a copy on write image,
901 assume that sectors which are unallocated in the input image
902 are present in both the output's and input's base images (no
903 need to copy them). */
905 if (!bdrv_is_allocated(bs
[bs_i
], sector_num
- bs_offset
,
910 /* The next 'n1' sectors are allocated in the input image. Copy
911 only those as they may be followed by unallocated sectors. */
918 ret
= bdrv_read(bs
[bs_i
], sector_num
- bs_offset
, buf
, n
);
920 error("error while reading");
923 /* NOTE: at the same time we convert, we do not write zero
924 sectors to have a chance to compress the image. Ideally, we
925 should add a specific call to have the info to go faster */
928 /* If the output image is being created as a copy on write image,
929 copy all sectors even the ones containing only NUL bytes,
930 because they may differ from the sectors in the base image.
932 If the output is to a host device, we also write out
933 sectors that are entirely 0, since whatever data was
934 already there is garbage, not 0s. */
935 if (!has_zero_init
|| out_baseimg
||
936 is_allocated_sectors(buf1
, n
, &n1
)) {
937 ret
= bdrv_write(out_bs
, sector_num
, buf1
, n1
);
939 error("error while writing");
950 free_option_parameters(create_options
);
951 free_option_parameters(param
);
956 for (bs_i
= 0; bs_i
< bs_n
; bs_i
++) {
958 bdrv_delete(bs
[bs_i
]);
969 static int64_t get_allocated_file_size(const char *filename
)
971 typedef DWORD (WINAPI
* get_compressed_t
)(const char *filename
, DWORD
*high
);
972 get_compressed_t get_compressed
;
975 /* WinNT support GetCompressedFileSize to determine allocate size */
976 get_compressed
= (get_compressed_t
) GetProcAddress(GetModuleHandle("kernel32"), "GetCompressedFileSizeA");
977 if (get_compressed
) {
979 low
= get_compressed(filename
, &high
);
980 if (low
!= 0xFFFFFFFFlu
|| GetLastError() == NO_ERROR
)
981 return (((int64_t) high
) << 32) + low
;
984 if (_stati64(filename
, &st
) < 0)
989 static int64_t get_allocated_file_size(const char *filename
)
992 if (stat(filename
, &st
) < 0)
994 return (int64_t)st
.st_blocks
* 512;
998 static void dump_snapshots(BlockDriverState
*bs
)
1000 QEMUSnapshotInfo
*sn_tab
, *sn
;
1004 nb_sns
= bdrv_snapshot_list(bs
, &sn_tab
);
1007 printf("Snapshot list:\n");
1008 printf("%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), NULL
));
1009 for(i
= 0; i
< nb_sns
; i
++) {
1011 printf("%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), sn
));
1016 static int img_info(int argc
, char **argv
)
1019 const char *filename
, *fmt
;
1020 BlockDriverState
*bs
;
1021 char fmt_name
[128], size_buf
[128], dsize_buf
[128];
1022 uint64_t total_sectors
;
1023 int64_t allocated_size
;
1024 char backing_filename
[1024];
1025 char backing_filename2
[1024];
1026 BlockDriverInfo bdi
;
1030 c
= getopt(argc
, argv
, "f:h");
1044 filename
= argv
[optind
++];
1046 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
| BDRV_O_NO_BACKING
);
1050 bdrv_get_format(bs
, fmt_name
, sizeof(fmt_name
));
1051 bdrv_get_geometry(bs
, &total_sectors
);
1052 get_human_readable_size(size_buf
, sizeof(size_buf
), total_sectors
* 512);
1053 allocated_size
= get_allocated_file_size(filename
);
1054 if (allocated_size
< 0)
1055 snprintf(dsize_buf
, sizeof(dsize_buf
), "unavailable");
1057 get_human_readable_size(dsize_buf
, sizeof(dsize_buf
),
1059 printf("image: %s\n"
1061 "virtual size: %s (%" PRId64
" bytes)\n"
1063 filename
, fmt_name
, size_buf
,
1064 (total_sectors
* 512),
1066 if (bdrv_is_encrypted(bs
))
1067 printf("encrypted: yes\n");
1068 if (bdrv_get_info(bs
, &bdi
) >= 0) {
1069 if (bdi
.cluster_size
!= 0)
1070 printf("cluster_size: %d\n", bdi
.cluster_size
);
1072 bdrv_get_backing_filename(bs
, backing_filename
, sizeof(backing_filename
));
1073 if (backing_filename
[0] != '\0') {
1074 path_combine(backing_filename2
, sizeof(backing_filename2
),
1075 filename
, backing_filename
);
1076 printf("backing file: %s (actual path: %s)\n",
1085 #define SNAPSHOT_LIST 1
1086 #define SNAPSHOT_CREATE 2
1087 #define SNAPSHOT_APPLY 3
1088 #define SNAPSHOT_DELETE 4
1090 static int img_snapshot(int argc
, char **argv
)
1092 BlockDriverState
*bs
;
1093 QEMUSnapshotInfo sn
;
1094 char *filename
, *snapshot_name
= NULL
;
1095 int c
, ret
= 0, bdrv_oflags
;
1099 bdrv_oflags
= BDRV_O_RDWR
;
1100 /* Parse commandline parameters */
1102 c
= getopt(argc
, argv
, "la:c:d:h");
1114 action
= SNAPSHOT_LIST
;
1115 bdrv_oflags
&= ~BDRV_O_RDWR
; /* no need for RW */
1122 action
= SNAPSHOT_APPLY
;
1123 snapshot_name
= optarg
;
1130 action
= SNAPSHOT_CREATE
;
1131 snapshot_name
= optarg
;
1138 action
= SNAPSHOT_DELETE
;
1139 snapshot_name
= optarg
;
1146 filename
= argv
[optind
++];
1148 /* Open the image */
1149 bs
= bdrv_new_open(filename
, NULL
, bdrv_oflags
);
1154 /* Perform the requested action */
1160 case SNAPSHOT_CREATE
:
1161 memset(&sn
, 0, sizeof(sn
));
1162 pstrcpy(sn
.name
, sizeof(sn
.name
), snapshot_name
);
1164 qemu_gettimeofday(&tv
);
1165 sn
.date_sec
= tv
.tv_sec
;
1166 sn
.date_nsec
= tv
.tv_usec
* 1000;
1168 ret
= bdrv_snapshot_create(bs
, &sn
);
1170 error("Could not create snapshot '%s': %d (%s)",
1171 snapshot_name
, ret
, strerror(-ret
));
1174 case SNAPSHOT_APPLY
:
1175 ret
= bdrv_snapshot_goto(bs
, snapshot_name
);
1177 error("Could not apply snapshot '%s': %d (%s)",
1178 snapshot_name
, ret
, strerror(-ret
));
1181 case SNAPSHOT_DELETE
:
1182 ret
= bdrv_snapshot_delete(bs
, snapshot_name
);
1184 error("Could not delete snapshot '%s': %d (%s)",
1185 snapshot_name
, ret
, strerror(-ret
));
1197 static int img_rebase(int argc
, char **argv
)
1199 BlockDriverState
*bs
, *bs_old_backing
= NULL
, *bs_new_backing
= NULL
;
1200 BlockDriver
*old_backing_drv
, *new_backing_drv
;
1202 const char *fmt
, *out_basefmt
, *out_baseimg
;
1206 /* Parse commandline parameters */
1212 c
= getopt(argc
, argv
, "uhf:F:b:");
1223 out_basefmt
= optarg
;
1226 out_baseimg
= optarg
;
1234 if ((optind
>= argc
) || !out_baseimg
)
1236 filename
= argv
[optind
++];
1241 * Ignore the old backing file for unsafe rebase in case we want to correct
1242 * the reference to a renamed or moved backing file.
1244 flags
= BDRV_O_FLAGS
| BDRV_O_RDWR
| (unsafe
? BDRV_O_NO_BACKING
: 0);
1245 bs
= bdrv_new_open(filename
, fmt
, flags
);
1250 /* Find the right drivers for the backing files */
1251 old_backing_drv
= NULL
;
1252 new_backing_drv
= NULL
;
1254 if (!unsafe
&& bs
->backing_format
[0] != '\0') {
1255 old_backing_drv
= bdrv_find_format(bs
->backing_format
);
1256 if (old_backing_drv
== NULL
) {
1257 error("Invalid format name: '%s'", bs
->backing_format
);
1263 if (out_basefmt
!= NULL
) {
1264 new_backing_drv
= bdrv_find_format(out_basefmt
);
1265 if (new_backing_drv
== NULL
) {
1266 error("Invalid format name: '%s'", out_basefmt
);
1272 /* For safe rebasing we need to compare old and new backing file */
1274 /* Make the compiler happy */
1275 bs_old_backing
= NULL
;
1276 bs_new_backing
= NULL
;
1278 char backing_name
[1024];
1280 bs_old_backing
= bdrv_new("old_backing");
1281 bdrv_get_backing_filename(bs
, backing_name
, sizeof(backing_name
));
1282 ret
= bdrv_open(bs_old_backing
, backing_name
, BDRV_O_FLAGS
,
1285 error("Could not open old backing file '%s'", backing_name
);
1289 bs_new_backing
= bdrv_new("new_backing");
1290 ret
= bdrv_open(bs_new_backing
, out_baseimg
, BDRV_O_FLAGS
,
1293 error("Could not open new backing file '%s'", out_baseimg
);
1299 * Check each unallocated cluster in the COW file. If it is unallocated,
1300 * accesses go to the backing file. We must therefore compare this cluster
1301 * in the old and new backing file, and if they differ we need to copy it
1302 * from the old backing file into the COW file.
1304 * If qemu-img crashes during this step, no harm is done. The content of
1305 * the image is the same as the original one at any time.
1308 uint64_t num_sectors
;
1314 buf_old
= qemu_malloc(IO_BUF_SIZE
);
1315 buf_new
= qemu_malloc(IO_BUF_SIZE
);
1317 bdrv_get_geometry(bs
, &num_sectors
);
1319 for (sector
= 0; sector
< num_sectors
; sector
+= n
) {
1321 /* How many sectors can we handle with the next read? */
1322 if (sector
+ (IO_BUF_SIZE
/ 512) <= num_sectors
) {
1323 n
= (IO_BUF_SIZE
/ 512);
1325 n
= num_sectors
- sector
;
1328 /* If the cluster is allocated, we don't need to take action */
1329 ret
= bdrv_is_allocated(bs
, sector
, n
, &n
);
1334 /* Read old and new backing file */
1335 ret
= bdrv_read(bs_old_backing
, sector
, buf_old
, n
);
1337 error("error while reading from old backing file");
1340 ret
= bdrv_read(bs_new_backing
, sector
, buf_new
, n
);
1342 error("error while reading from new backing file");
1346 /* If they differ, we need to write to the COW file */
1347 uint64_t written
= 0;
1349 while (written
< n
) {
1352 if (compare_sectors(buf_old
+ written
* 512,
1353 buf_new
+ written
* 512, n
- written
, &pnum
))
1355 ret
= bdrv_write(bs
, sector
+ written
,
1356 buf_old
+ written
* 512, pnum
);
1358 error("Error while writing to COW image: %s",
1373 * Change the backing file. All clusters that are different from the old
1374 * backing file are overwritten in the COW file now, so the visible content
1375 * doesn't change when we switch the backing file.
1377 ret
= bdrv_change_backing_file(bs
, out_baseimg
, out_basefmt
);
1378 if (ret
== -ENOSPC
) {
1379 error("Could not change the backing file to '%s': No space left in "
1380 "the file header", out_baseimg
);
1381 } else if (ret
< 0) {
1382 error("Could not change the backing file to '%s': %s",
1383 out_baseimg
, strerror(-ret
));
1387 * TODO At this point it is possible to check if any clusters that are
1388 * allocated in the COW file are the same in the backing file. If so, they
1389 * could be dropped from the COW file. Don't do this before switching the
1390 * backing file, in case of a crash this would lead to corruption.
1395 bdrv_delete(bs_old_backing
);
1396 bdrv_delete(bs_new_backing
);
1406 static int img_resize(int argc
, char **argv
)
1408 int c
, ret
, relative
;
1409 const char *filename
, *fmt
, *size
;
1410 int64_t n
, total_size
;
1411 BlockDriverState
*bs
;
1412 QEMUOptionParameter
*param
;
1413 QEMUOptionParameter resize_options
[] = {
1415 .name
= BLOCK_OPT_SIZE
,
1417 .help
= "Virtual disk size"
1424 c
= getopt(argc
, argv
, "f:h");
1437 if (optind
+ 1 >= argc
) {
1440 filename
= argv
[optind
++];
1441 size
= argv
[optind
++];
1443 /* Choose grow, shrink, or absolute resize mode */
1459 param
= parse_option_parameters("", resize_options
, NULL
);
1460 if (set_option_parameter(param
, BLOCK_OPT_SIZE
, size
)) {
1461 /* Error message already printed when size parsing fails */
1464 n
= get_option_parameter(param
, BLOCK_OPT_SIZE
)->value
.n
;
1465 free_option_parameters(param
);
1467 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
| BDRV_O_RDWR
);
1473 total_size
= bdrv_getlength(bs
) + n
* relative
;
1477 if (total_size
<= 0) {
1478 error("New image size must be positive");
1483 ret
= bdrv_truncate(bs
, total_size
);
1486 printf("Image resized.\n");
1489 error("This image format does not support resize");
1492 error("Image is read-only");
1495 error("Error resizing image (%d)", -ret
);
1506 static const img_cmd_t img_cmds
[] = {
1507 #define DEF(option, callback, arg_string) \
1508 { option, callback },
1509 #include "qemu-img-cmds.h"
1515 int main(int argc
, char **argv
)
1517 const img_cmd_t
*cmd
;
1518 const char *cmdname
;
1526 /* find the command */
1527 for(cmd
= img_cmds
; cmd
->name
!= NULL
; cmd
++) {
1528 if (!strcmp(cmdname
, cmd
->name
)) {
1529 return cmd
->handler(argc
, argv
);