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
, BDRV_O_FLAGS
| BDRV_O_RDWR
);
794 bdrv_get_geometry(bs
[0], &bs_sectors
);
795 buf
= qemu_malloc(IO_BUF_SIZE
);
797 if (flags
& BLOCK_FLAG_COMPRESS
) {
798 ret
= bdrv_get_info(out_bs
, &bdi
);
800 error("could not get block driver info");
803 cluster_size
= bdi
.cluster_size
;
804 if (cluster_size
<= 0 || cluster_size
> IO_BUF_SIZE
) {
805 error("invalid cluster size");
809 cluster_sectors
= cluster_size
>> 9;
816 nb_sectors
= total_sectors
- sector_num
;
819 if (nb_sectors
>= cluster_sectors
)
824 bs_num
= sector_num
- bs_offset
;
825 assert (bs_num
>= 0);
828 while (remainder
> 0) {
830 while (bs_num
== bs_sectors
) {
832 assert (bs_i
< bs_n
);
833 bs_offset
+= bs_sectors
;
834 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
836 /* printf("changing part: sector_num=%" PRId64 ", "
837 "bs_i=%d, bs_offset=%" PRId64 ", bs_sectors=%" PRId64
838 "\n", sector_num, bs_i, bs_offset, bs_sectors); */
840 assert (bs_num
< bs_sectors
);
842 nlow
= (remainder
> bs_sectors
- bs_num
) ? bs_sectors
- bs_num
: remainder
;
844 ret
= bdrv_read(bs
[bs_i
], bs_num
, buf2
, nlow
);
846 error("error while reading");
855 assert (remainder
== 0);
857 if (n
< cluster_sectors
)
858 memset(buf
+ n
* 512, 0, cluster_size
- n
* 512);
859 if (is_not_zero(buf
, cluster_size
)) {
860 ret
= bdrv_write_compressed(out_bs
, sector_num
, buf
,
863 error("error while compressing sector %" PRId64
,
870 /* signal EOF to align */
871 bdrv_write_compressed(out_bs
, 0, NULL
, 0);
873 int has_zero_init
= bdrv_has_zero_init(out_bs
);
875 sector_num
= 0; // total number of sectors converted so far
877 nb_sectors
= total_sectors
- sector_num
;
880 if (nb_sectors
>= (IO_BUF_SIZE
/ 512))
881 n
= (IO_BUF_SIZE
/ 512);
885 while (sector_num
- bs_offset
>= bs_sectors
) {
887 assert (bs_i
< bs_n
);
888 bs_offset
+= bs_sectors
;
889 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
890 /* printf("changing part: sector_num=%" PRId64 ", bs_i=%d, "
891 "bs_offset=%" PRId64 ", bs_sectors=%" PRId64 "\n",
892 sector_num, bs_i, bs_offset, bs_sectors); */
895 if (n
> bs_offset
+ bs_sectors
- sector_num
)
896 n
= bs_offset
+ bs_sectors
- sector_num
;
899 /* If the output image is being created as a copy on write image,
900 assume that sectors which are unallocated in the input image
901 are present in both the output's and input's base images (no
902 need to copy them). */
904 if (!bdrv_is_allocated(bs
[bs_i
], sector_num
- bs_offset
,
909 /* The next 'n1' sectors are allocated in the input image. Copy
910 only those as they may be followed by unallocated sectors. */
917 ret
= bdrv_read(bs
[bs_i
], sector_num
- bs_offset
, buf
, n
);
919 error("error while reading");
922 /* NOTE: at the same time we convert, we do not write zero
923 sectors to have a chance to compress the image. Ideally, we
924 should add a specific call to have the info to go faster */
927 /* If the output image is being created as a copy on write image,
928 copy all sectors even the ones containing only NUL bytes,
929 because they may differ from the sectors in the base image.
931 If the output is to a host device, we also write out
932 sectors that are entirely 0, since whatever data was
933 already there is garbage, not 0s. */
934 if (!has_zero_init
|| out_baseimg
||
935 is_allocated_sectors(buf1
, n
, &n1
)) {
936 ret
= bdrv_write(out_bs
, sector_num
, buf1
, n1
);
938 error("error while writing");
949 free_option_parameters(create_options
);
950 free_option_parameters(param
);
955 for (bs_i
= 0; bs_i
< bs_n
; bs_i
++) {
957 bdrv_delete(bs
[bs_i
]);
968 static int64_t get_allocated_file_size(const char *filename
)
970 typedef DWORD (WINAPI
* get_compressed_t
)(const char *filename
, DWORD
*high
);
971 get_compressed_t get_compressed
;
974 /* WinNT support GetCompressedFileSize to determine allocate size */
975 get_compressed
= (get_compressed_t
) GetProcAddress(GetModuleHandle("kernel32"), "GetCompressedFileSizeA");
976 if (get_compressed
) {
978 low
= get_compressed(filename
, &high
);
979 if (low
!= 0xFFFFFFFFlu
|| GetLastError() == NO_ERROR
)
980 return (((int64_t) high
) << 32) + low
;
983 if (_stati64(filename
, &st
) < 0)
988 static int64_t get_allocated_file_size(const char *filename
)
991 if (stat(filename
, &st
) < 0)
993 return (int64_t)st
.st_blocks
* 512;
997 static void dump_snapshots(BlockDriverState
*bs
)
999 QEMUSnapshotInfo
*sn_tab
, *sn
;
1003 nb_sns
= bdrv_snapshot_list(bs
, &sn_tab
);
1006 printf("Snapshot list:\n");
1007 printf("%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), NULL
));
1008 for(i
= 0; i
< nb_sns
; i
++) {
1010 printf("%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), sn
));
1015 static int img_info(int argc
, char **argv
)
1018 const char *filename
, *fmt
;
1019 BlockDriverState
*bs
;
1020 char fmt_name
[128], size_buf
[128], dsize_buf
[128];
1021 uint64_t total_sectors
;
1022 int64_t allocated_size
;
1023 char backing_filename
[1024];
1024 char backing_filename2
[1024];
1025 BlockDriverInfo bdi
;
1029 c
= getopt(argc
, argv
, "f:h");
1043 filename
= argv
[optind
++];
1045 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
| BDRV_O_NO_BACKING
);
1049 bdrv_get_format(bs
, fmt_name
, sizeof(fmt_name
));
1050 bdrv_get_geometry(bs
, &total_sectors
);
1051 get_human_readable_size(size_buf
, sizeof(size_buf
), total_sectors
* 512);
1052 allocated_size
= get_allocated_file_size(filename
);
1053 if (allocated_size
< 0)
1054 snprintf(dsize_buf
, sizeof(dsize_buf
), "unavailable");
1056 get_human_readable_size(dsize_buf
, sizeof(dsize_buf
),
1058 printf("image: %s\n"
1060 "virtual size: %s (%" PRId64
" bytes)\n"
1062 filename
, fmt_name
, size_buf
,
1063 (total_sectors
* 512),
1065 if (bdrv_is_encrypted(bs
))
1066 printf("encrypted: yes\n");
1067 if (bdrv_get_info(bs
, &bdi
) >= 0) {
1068 if (bdi
.cluster_size
!= 0)
1069 printf("cluster_size: %d\n", bdi
.cluster_size
);
1071 bdrv_get_backing_filename(bs
, backing_filename
, sizeof(backing_filename
));
1072 if (backing_filename
[0] != '\0') {
1073 path_combine(backing_filename2
, sizeof(backing_filename2
),
1074 filename
, backing_filename
);
1075 printf("backing file: %s (actual path: %s)\n",
1084 #define SNAPSHOT_LIST 1
1085 #define SNAPSHOT_CREATE 2
1086 #define SNAPSHOT_APPLY 3
1087 #define SNAPSHOT_DELETE 4
1089 static int img_snapshot(int argc
, char **argv
)
1091 BlockDriverState
*bs
;
1092 QEMUSnapshotInfo sn
;
1093 char *filename
, *snapshot_name
= NULL
;
1094 int c
, ret
= 0, bdrv_oflags
;
1098 bdrv_oflags
= BDRV_O_RDWR
;
1099 /* Parse commandline parameters */
1101 c
= getopt(argc
, argv
, "la:c:d:h");
1113 action
= SNAPSHOT_LIST
;
1114 bdrv_oflags
&= ~BDRV_O_RDWR
; /* no need for RW */
1121 action
= SNAPSHOT_APPLY
;
1122 snapshot_name
= optarg
;
1129 action
= SNAPSHOT_CREATE
;
1130 snapshot_name
= optarg
;
1137 action
= SNAPSHOT_DELETE
;
1138 snapshot_name
= optarg
;
1145 filename
= argv
[optind
++];
1147 /* Open the image */
1148 bs
= bdrv_new_open(filename
, NULL
, bdrv_oflags
);
1153 /* Perform the requested action */
1159 case SNAPSHOT_CREATE
:
1160 memset(&sn
, 0, sizeof(sn
));
1161 pstrcpy(sn
.name
, sizeof(sn
.name
), snapshot_name
);
1163 qemu_gettimeofday(&tv
);
1164 sn
.date_sec
= tv
.tv_sec
;
1165 sn
.date_nsec
= tv
.tv_usec
* 1000;
1167 ret
= bdrv_snapshot_create(bs
, &sn
);
1169 error("Could not create snapshot '%s': %d (%s)",
1170 snapshot_name
, ret
, strerror(-ret
));
1173 case SNAPSHOT_APPLY
:
1174 ret
= bdrv_snapshot_goto(bs
, snapshot_name
);
1176 error("Could not apply snapshot '%s': %d (%s)",
1177 snapshot_name
, ret
, strerror(-ret
));
1180 case SNAPSHOT_DELETE
:
1181 ret
= bdrv_snapshot_delete(bs
, snapshot_name
);
1183 error("Could not delete snapshot '%s': %d (%s)",
1184 snapshot_name
, ret
, strerror(-ret
));
1196 static int img_rebase(int argc
, char **argv
)
1198 BlockDriverState
*bs
, *bs_old_backing
= NULL
, *bs_new_backing
= NULL
;
1199 BlockDriver
*old_backing_drv
, *new_backing_drv
;
1201 const char *fmt
, *out_basefmt
, *out_baseimg
;
1205 /* Parse commandline parameters */
1211 c
= getopt(argc
, argv
, "uhf:F:b:");
1222 out_basefmt
= optarg
;
1225 out_baseimg
= optarg
;
1233 if ((optind
>= argc
) || !out_baseimg
)
1235 filename
= argv
[optind
++];
1240 * Ignore the old backing file for unsafe rebase in case we want to correct
1241 * the reference to a renamed or moved backing file.
1243 flags
= BDRV_O_FLAGS
| BDRV_O_RDWR
| (unsafe
? BDRV_O_NO_BACKING
: 0);
1244 bs
= bdrv_new_open(filename
, fmt
, flags
);
1249 /* Find the right drivers for the backing files */
1250 old_backing_drv
= NULL
;
1251 new_backing_drv
= NULL
;
1253 if (!unsafe
&& bs
->backing_format
[0] != '\0') {
1254 old_backing_drv
= bdrv_find_format(bs
->backing_format
);
1255 if (old_backing_drv
== NULL
) {
1256 error("Invalid format name: '%s'", bs
->backing_format
);
1262 if (out_basefmt
!= NULL
) {
1263 new_backing_drv
= bdrv_find_format(out_basefmt
);
1264 if (new_backing_drv
== NULL
) {
1265 error("Invalid format name: '%s'", out_basefmt
);
1271 /* For safe rebasing we need to compare old and new backing file */
1273 /* Make the compiler happy */
1274 bs_old_backing
= NULL
;
1275 bs_new_backing
= NULL
;
1277 char backing_name
[1024];
1279 bs_old_backing
= bdrv_new("old_backing");
1280 bdrv_get_backing_filename(bs
, backing_name
, sizeof(backing_name
));
1281 ret
= bdrv_open(bs_old_backing
, backing_name
, BDRV_O_FLAGS
,
1284 error("Could not open old backing file '%s'", backing_name
);
1288 bs_new_backing
= bdrv_new("new_backing");
1289 ret
= bdrv_open(bs_new_backing
, out_baseimg
, BDRV_O_FLAGS
,
1292 error("Could not open new backing file '%s'", out_baseimg
);
1298 * Check each unallocated cluster in the COW file. If it is unallocated,
1299 * accesses go to the backing file. We must therefore compare this cluster
1300 * in the old and new backing file, and if they differ we need to copy it
1301 * from the old backing file into the COW file.
1303 * If qemu-img crashes during this step, no harm is done. The content of
1304 * the image is the same as the original one at any time.
1307 uint64_t num_sectors
;
1313 buf_old
= qemu_malloc(IO_BUF_SIZE
);
1314 buf_new
= qemu_malloc(IO_BUF_SIZE
);
1316 bdrv_get_geometry(bs
, &num_sectors
);
1318 for (sector
= 0; sector
< num_sectors
; sector
+= n
) {
1320 /* How many sectors can we handle with the next read? */
1321 if (sector
+ (IO_BUF_SIZE
/ 512) <= num_sectors
) {
1322 n
= (IO_BUF_SIZE
/ 512);
1324 n
= num_sectors
- sector
;
1327 /* If the cluster is allocated, we don't need to take action */
1328 ret
= bdrv_is_allocated(bs
, sector
, n
, &n
);
1333 /* Read old and new backing file */
1334 ret
= bdrv_read(bs_old_backing
, sector
, buf_old
, n
);
1336 error("error while reading from old backing file");
1339 ret
= bdrv_read(bs_new_backing
, sector
, buf_new
, n
);
1341 error("error while reading from new backing file");
1345 /* If they differ, we need to write to the COW file */
1346 uint64_t written
= 0;
1348 while (written
< n
) {
1351 if (compare_sectors(buf_old
+ written
* 512,
1352 buf_new
+ written
* 512, n
- written
, &pnum
))
1354 ret
= bdrv_write(bs
, sector
+ written
,
1355 buf_old
+ written
* 512, pnum
);
1357 error("Error while writing to COW image: %s",
1372 * Change the backing file. All clusters that are different from the old
1373 * backing file are overwritten in the COW file now, so the visible content
1374 * doesn't change when we switch the backing file.
1376 ret
= bdrv_change_backing_file(bs
, out_baseimg
, out_basefmt
);
1377 if (ret
== -ENOSPC
) {
1378 error("Could not change the backing file to '%s': No space left in "
1379 "the file header", out_baseimg
);
1380 } else if (ret
< 0) {
1381 error("Could not change the backing file to '%s': %s",
1382 out_baseimg
, strerror(-ret
));
1386 * TODO At this point it is possible to check if any clusters that are
1387 * allocated in the COW file are the same in the backing file. If so, they
1388 * could be dropped from the COW file. Don't do this before switching the
1389 * backing file, in case of a crash this would lead to corruption.
1394 bdrv_delete(bs_old_backing
);
1395 bdrv_delete(bs_new_backing
);
1405 static int img_resize(int argc
, char **argv
)
1407 int c
, ret
, relative
;
1408 const char *filename
, *fmt
, *size
;
1409 int64_t n
, total_size
;
1410 BlockDriverState
*bs
;
1411 QEMUOptionParameter
*param
;
1412 QEMUOptionParameter resize_options
[] = {
1414 .name
= BLOCK_OPT_SIZE
,
1416 .help
= "Virtual disk size"
1423 c
= getopt(argc
, argv
, "f:h");
1436 if (optind
+ 1 >= argc
) {
1439 filename
= argv
[optind
++];
1440 size
= argv
[optind
++];
1442 /* Choose grow, shrink, or absolute resize mode */
1458 param
= parse_option_parameters("", resize_options
, NULL
);
1459 if (set_option_parameter(param
, BLOCK_OPT_SIZE
, size
)) {
1460 /* Error message already printed when size parsing fails */
1463 n
= get_option_parameter(param
, BLOCK_OPT_SIZE
)->value
.n
;
1464 free_option_parameters(param
);
1466 bs
= bdrv_new_open(filename
, fmt
, BDRV_O_FLAGS
| BDRV_O_RDWR
);
1472 total_size
= bdrv_getlength(bs
) + n
* relative
;
1476 if (total_size
<= 0) {
1477 error("New image size must be positive");
1482 ret
= bdrv_truncate(bs
, total_size
);
1485 printf("Image resized.\n");
1488 error("This image format does not support resize");
1491 error("Image is read-only");
1494 error("Error resizing image (%d)", -ret
);
1505 static const img_cmd_t img_cmds
[] = {
1506 #define DEF(option, callback, arg_string) \
1507 { option, callback },
1508 #include "qemu-img-cmds.h"
1514 int main(int argc
, char **argv
)
1516 const img_cmd_t
*cmd
;
1517 const char *cmdname
;
1525 /* find the command */
1526 for(cmd
= img_cmds
; cmd
->name
!= NULL
; cmd
++) {
1527 if (!strcmp(cmdname
, cmd
->name
)) {
1528 return cmd
->handler(argc
, argv
);