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 BRDV_O_FLAGS BDRV_O_CACHE_WB
42 static void QEMU_NORETURN
error(const char *fmt
, ...)
46 fprintf(stderr
, "qemu-img: ");
47 vfprintf(stderr
, fmt
, ap
);
48 fprintf(stderr
, "\n");
53 static void format_print(void *opaque
, const char *name
)
58 /* Please keep in synch with qemu-img.texi */
59 static void help(void)
61 const char *help_msg
=
62 "qemu-img version " QEMU_VERSION
", Copyright (c) 2004-2008 Fabrice Bellard\n"
63 "usage: qemu-img command [command options]\n"
64 "QEMU disk image utility\n"
67 #define DEF(option, callback, arg_string) \
69 #include "qemu-img-cmds.h"
73 "Command parameters:\n"
74 " 'filename' is a disk image filename\n"
75 " 'fmt' is the disk image format. It is guessed automatically in most cases\n"
76 " 'size' is the disk image size in bytes. Optional suffixes\n"
77 " 'k' or 'K' (kilobyte, 1024), 'M' (megabyte, 1024k), 'G' (gigabyte, 1024M)\n"
78 " and T (terabyte, 1024G) are supported. 'b' is ignored.\n"
79 " 'output_filename' is the destination disk image filename\n"
80 " 'output_fmt' is the destination format\n"
81 " 'options' is a comma separated list of format specific options in a\n"
82 " name=value format. Use -o ? for an overview of the options supported by the\n"
84 " '-c' indicates that target image must be compressed (qcow format only)\n"
85 " '-u' enables unsafe rebasing. It is assumed that old and new backing file\n"
86 " match exactly. The image doesn't need a working backing file before\n"
87 " rebasing in this case (useful for renaming the backing file)\n"
88 " '-h' with or without a command shows this help and lists the supported formats\n"
90 "Parameters to snapshot subcommand:\n"
91 " 'snapshot' is the name of the snapshot to create, apply or delete\n"
92 " '-a' applies a snapshot (revert disk to saved state)\n"
93 " '-c' creates a snapshot\n"
94 " '-d' deletes a snapshot\n"
95 " '-l' lists all snapshots in the given image\n";
97 printf("%s\nSupported formats:", help_msg
);
98 bdrv_iterate_format(format_print
, NULL
);
104 /* XXX: put correct support for win32 */
105 static int read_password(char *buf
, int buf_size
)
108 printf("Password: ");
115 if (i
< (buf_size
- 1))
126 static struct termios oldtty
;
128 static void term_exit(void)
130 tcsetattr (0, TCSANOW
, &oldtty
);
133 static void term_init(void)
140 tty
.c_iflag
&= ~(IGNBRK
|BRKINT
|PARMRK
|ISTRIP
141 |INLCR
|IGNCR
|ICRNL
|IXON
);
142 tty
.c_oflag
|= OPOST
;
143 tty
.c_lflag
&= ~(ECHO
|ECHONL
|ICANON
|IEXTEN
);
144 tty
.c_cflag
&= ~(CSIZE
|PARENB
);
149 tcsetattr (0, TCSANOW
, &tty
);
154 static int read_password(char *buf
, int buf_size
)
159 printf("password: ");
164 ret
= read(0, &ch
, 1);
166 if (errno
== EAGAIN
|| errno
== EINTR
) {
172 } else if (ret
== 0) {
180 if (i
< (buf_size
- 1))
191 static BlockDriverState
*bdrv_new_open(const char *filename
,
194 BlockDriverState
*bs
;
200 error("Not enough memory");
202 drv
= bdrv_find_format(fmt
);
204 error("Unknown file format '%s'", fmt
);
208 if (bdrv_open2(bs
, filename
, BRDV_O_FLAGS
| BDRV_O_RDWR
, drv
) < 0) {
209 error("Could not open '%s'", filename
);
211 if (bdrv_is_encrypted(bs
)) {
212 printf("Disk image '%s' is encrypted.\n", filename
);
213 if (read_password(password
, sizeof(password
)) < 0)
214 error("No password given");
215 if (bdrv_set_key(bs
, password
) < 0)
216 error("invalid password");
221 static void add_old_style_options(const char *fmt
, QEMUOptionParameter
*list
,
222 int flags
, const char *base_filename
, const char *base_fmt
)
224 if (flags
& BLOCK_FLAG_ENCRYPT
) {
225 if (set_option_parameter(list
, BLOCK_OPT_ENCRYPT
, "on")) {
226 error("Encryption not supported for file format '%s'", fmt
);
229 if (flags
& BLOCK_FLAG_COMPAT6
) {
230 if (set_option_parameter(list
, BLOCK_OPT_COMPAT6
, "on")) {
231 error("VMDK version 6 not supported for file format '%s'", fmt
);
236 if (set_option_parameter(list
, BLOCK_OPT_BACKING_FILE
, base_filename
)) {
237 error("Backing file not supported for file format '%s'", fmt
);
241 if (set_option_parameter(list
, BLOCK_OPT_BACKING_FMT
, base_fmt
)) {
242 error("Backing file format not supported for file format '%s'", fmt
);
247 static int img_create(int argc
, char **argv
)
250 const char *fmt
= "raw";
251 const char *base_fmt
= NULL
;
252 const char *filename
;
253 const char *base_filename
= NULL
;
255 QEMUOptionParameter
*param
= NULL
;
256 char *options
= NULL
;
260 c
= getopt(argc
, argv
, "F:b:f:he6o:");
271 base_filename
= optarg
;
277 flags
|= BLOCK_FLAG_ENCRYPT
;
280 flags
|= BLOCK_FLAG_COMPAT6
;
288 /* Find driver and parse its options */
289 drv
= bdrv_find_format(fmt
);
291 error("Unknown file format '%s'", fmt
);
293 if (options
&& !strcmp(options
, "?")) {
294 print_option_help(drv
->create_options
);
298 /* Create parameter list with default values */
299 param
= parse_option_parameters("", drv
->create_options
, param
);
300 set_option_parameter_int(param
, BLOCK_OPT_SIZE
, -1);
302 /* Parse -o options */
304 param
= parse_option_parameters(options
, drv
->create_options
, param
);
306 error("Invalid options for file format '%s'.", fmt
);
310 /* Get the filename */
313 filename
= argv
[optind
++];
315 /* Add size to parameters */
317 set_option_parameter(param
, BLOCK_OPT_SIZE
, argv
[optind
++]);
320 /* Add old-style options to parameters */
321 add_old_style_options(fmt
, param
, flags
, base_filename
, base_fmt
);
323 // The size for the image must always be specified, with one exception:
324 // If we are using a backing file, we can obtain the size from there
325 if (get_option_parameter(param
, BLOCK_OPT_SIZE
)->value
.n
== -1) {
327 QEMUOptionParameter
*backing_file
=
328 get_option_parameter(param
, BLOCK_OPT_BACKING_FILE
);
329 QEMUOptionParameter
*backing_fmt
=
330 get_option_parameter(param
, BLOCK_OPT_BACKING_FMT
);
332 if (backing_file
&& backing_file
->value
.s
) {
333 BlockDriverState
*bs
;
335 const char *fmt
= NULL
;
338 if (backing_fmt
&& backing_fmt
->value
.s
) {
339 if (bdrv_find_format(backing_fmt
->value
.s
)) {
340 fmt
= backing_fmt
->value
.s
;
342 error("Unknown backing file format '%s'",
343 backing_fmt
->value
.s
);
347 bs
= bdrv_new_open(backing_file
->value
.s
, fmt
);
348 bdrv_get_geometry(bs
, &size
);
352 snprintf(buf
, sizeof(buf
), "%" PRId64
, size
);
353 set_option_parameter(param
, BLOCK_OPT_SIZE
, buf
);
355 error("Image creation needs a size parameter");
359 printf("Formatting '%s', fmt=%s ", filename
, fmt
);
360 print_option_parameters(param
);
363 ret
= bdrv_create(drv
, filename
, param
);
364 free_option_parameters(param
);
367 if (ret
== -ENOTSUP
) {
368 error("Formatting or formatting option not supported for file format '%s'", fmt
);
369 } else if (ret
== -EFBIG
) {
370 error("The image size is too large for file format '%s'", fmt
);
372 error("Error while formatting");
378 static int img_check(int argc
, char **argv
)
381 const char *filename
, *fmt
;
383 BlockDriverState
*bs
;
387 c
= getopt(argc
, argv
, "f:h");
401 filename
= argv
[optind
++];
405 error("Not enough memory");
407 drv
= bdrv_find_format(fmt
);
409 error("Unknown file format '%s'", fmt
);
413 if (bdrv_open2(bs
, filename
, BRDV_O_FLAGS
, drv
) < 0) {
414 error("Could not open '%s'", filename
);
416 ret
= bdrv_check(bs
);
419 printf("No errors were found on the image.\n");
422 error("This image format does not support checks");
426 error("An error occurred during the check");
428 printf("%d errors were found on the image.\n", ret
);
437 static int img_commit(int argc
, char **argv
)
440 const char *filename
, *fmt
;
442 BlockDriverState
*bs
;
446 c
= getopt(argc
, argv
, "f:h");
460 filename
= argv
[optind
++];
464 error("Not enough memory");
466 drv
= bdrv_find_format(fmt
);
468 error("Unknown file format '%s'", fmt
);
472 if (bdrv_open2(bs
, filename
, BRDV_O_FLAGS
| BDRV_O_RDWR
, drv
) < 0) {
473 error("Could not open '%s'", filename
);
475 ret
= bdrv_commit(bs
);
478 printf("Image committed.\n");
481 error("No disk inserted");
484 error("Image is read-only");
487 error("Image is already committed");
490 error("Error while committing image");
498 static int is_not_zero(const uint8_t *sector
, int len
)
502 for(i
= 0;i
< len
; i
++) {
503 if (((uint32_t *)sector
)[i
] != 0)
510 * Returns true iff the first sector pointed to by 'buf' contains at least
513 * 'pnum' is set to the number of sectors (including and immediately following
514 * the first one) that are known to be in the same allocated/unallocated state.
516 static int is_allocated_sectors(const uint8_t *buf
, int n
, int *pnum
)
524 v
= is_not_zero(buf
, 512);
525 for(i
= 1; i
< n
; i
++) {
527 if (v
!= is_not_zero(buf
, 512))
535 * Compares two buffers sector by sector. Returns 0 if the first sector of both
536 * buffers matches, non-zero otherwise.
538 * pnum is set to the number of sectors (including and immediately following
539 * the first one) that are known to have the same comparison result
541 static int compare_sectors(const uint8_t *buf1
, const uint8_t *buf2
, int n
,
551 res
= !!memcmp(buf1
, buf2
, 512);
552 for(i
= 1; i
< n
; i
++) {
556 if (!!memcmp(buf1
, buf2
, 512) != res
) {
565 #define IO_BUF_SIZE (2 * 1024 * 1024)
567 static int img_convert(int argc
, char **argv
)
569 int c
, ret
, n
, n1
, bs_n
, bs_i
, flags
, cluster_size
, cluster_sectors
;
570 const char *fmt
, *out_fmt
, *out_baseimg
, *out_filename
;
572 BlockDriverState
**bs
, *out_bs
;
573 int64_t total_sectors
, nb_sectors
, sector_num
, bs_offset
;
575 uint8_t buf
[IO_BUF_SIZE
];
578 QEMUOptionParameter
*param
= NULL
;
579 char *options
= NULL
;
586 c
= getopt(argc
, argv
, "f:O:B:hce6o:");
600 out_baseimg
= optarg
;
603 flags
|= BLOCK_FLAG_COMPRESS
;
606 flags
|= BLOCK_FLAG_ENCRYPT
;
609 flags
|= BLOCK_FLAG_COMPAT6
;
617 bs_n
= argc
- optind
- 1;
618 if (bs_n
< 1) help();
620 out_filename
= argv
[argc
- 1];
622 if (bs_n
> 1 && out_baseimg
)
623 error("-B makes no sense when concatenating multiple input images");
625 bs
= calloc(bs_n
, sizeof(BlockDriverState
*));
627 error("Out of memory");
630 for (bs_i
= 0; bs_i
< bs_n
; bs_i
++) {
631 bs
[bs_i
] = bdrv_new_open(argv
[optind
+ bs_i
], fmt
);
633 error("Could not open '%s'", argv
[optind
+ bs_i
]);
634 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
635 total_sectors
+= bs_sectors
;
638 /* Find driver and parse its options */
639 drv
= bdrv_find_format(out_fmt
);
641 error("Unknown file format '%s'", out_fmt
);
643 if (options
&& !strcmp(options
, "?")) {
644 print_option_help(drv
->create_options
);
650 param
= parse_option_parameters(options
, drv
->create_options
, param
);
652 error("Invalid options for file format '%s'.", out_fmt
);
655 param
= parse_option_parameters("", drv
->create_options
, param
);
658 set_option_parameter_int(param
, BLOCK_OPT_SIZE
, total_sectors
* 512);
659 add_old_style_options(out_fmt
, param
, flags
, out_baseimg
, NULL
);
661 /* Check if compression is supported */
662 if (flags
& BLOCK_FLAG_COMPRESS
) {
663 QEMUOptionParameter
*encryption
=
664 get_option_parameter(param
, BLOCK_OPT_ENCRYPT
);
666 if (!drv
->bdrv_write_compressed
) {
667 error("Compression not supported for this file format");
670 if (encryption
&& encryption
->value
.n
) {
671 error("Compression and encryption not supported at the same time");
675 /* Create the new image */
676 ret
= bdrv_create(drv
, out_filename
, param
);
677 free_option_parameters(param
);
680 if (ret
== -ENOTSUP
) {
681 error("Formatting not supported for file format '%s'", out_fmt
);
682 } else if (ret
== -EFBIG
) {
683 error("The image size is too large for file format '%s'", out_fmt
);
685 error("Error while formatting '%s'", out_filename
);
689 out_bs
= bdrv_new_open(out_filename
, out_fmt
);
693 bdrv_get_geometry(bs
[0], &bs_sectors
);
695 if (flags
& BLOCK_FLAG_COMPRESS
) {
696 if (bdrv_get_info(out_bs
, &bdi
) < 0)
697 error("could not get block driver info");
698 cluster_size
= bdi
.cluster_size
;
699 if (cluster_size
<= 0 || cluster_size
> IO_BUF_SIZE
)
700 error("invalid cluster size");
701 cluster_sectors
= cluster_size
>> 9;
708 nb_sectors
= total_sectors
- sector_num
;
711 if (nb_sectors
>= cluster_sectors
)
716 bs_num
= sector_num
- bs_offset
;
717 assert (bs_num
>= 0);
720 while (remainder
> 0) {
722 while (bs_num
== bs_sectors
) {
724 assert (bs_i
< bs_n
);
725 bs_offset
+= bs_sectors
;
726 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
728 /* printf("changing part: sector_num=%lld, "
729 "bs_i=%d, bs_offset=%lld, bs_sectors=%lld\n",
730 sector_num, bs_i, bs_offset, bs_sectors); */
732 assert (bs_num
< bs_sectors
);
734 nlow
= (remainder
> bs_sectors
- bs_num
) ? bs_sectors
- bs_num
: remainder
;
736 if (bdrv_read(bs
[bs_i
], bs_num
, buf2
, nlow
) < 0)
737 error("error while reading");
744 assert (remainder
== 0);
746 if (n
< cluster_sectors
)
747 memset(buf
+ n
* 512, 0, cluster_size
- n
* 512);
748 if (is_not_zero(buf
, cluster_size
)) {
749 if (bdrv_write_compressed(out_bs
, sector_num
, buf
,
750 cluster_sectors
) != 0)
751 error("error while compressing sector %" PRId64
,
756 /* signal EOF to align */
757 bdrv_write_compressed(out_bs
, 0, NULL
, 0);
759 sector_num
= 0; // total number of sectors converted so far
761 nb_sectors
= total_sectors
- sector_num
;
764 if (nb_sectors
>= (IO_BUF_SIZE
/ 512))
765 n
= (IO_BUF_SIZE
/ 512);
769 while (sector_num
- bs_offset
>= bs_sectors
) {
771 assert (bs_i
< bs_n
);
772 bs_offset
+= bs_sectors
;
773 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
774 /* printf("changing part: sector_num=%lld, bs_i=%d, "
775 "bs_offset=%lld, bs_sectors=%lld\n",
776 sector_num, bs_i, bs_offset, bs_sectors); */
779 if (n
> bs_offset
+ bs_sectors
- sector_num
)
780 n
= bs_offset
+ bs_sectors
- sector_num
;
782 if (!drv
->no_zero_init
) {
783 /* If the output image is being created as a copy on write image,
784 assume that sectors which are unallocated in the input image
785 are present in both the output's and input's base images (no
786 need to copy them). */
788 if (!bdrv_is_allocated(bs
[bs_i
], sector_num
- bs_offset
,
793 /* The next 'n1' sectors are allocated in the input image. Copy
794 only those as they may be followed by unallocated sectors. */
801 if (bdrv_read(bs
[bs_i
], sector_num
- bs_offset
, buf
, n
) < 0)
802 error("error while reading");
803 /* NOTE: at the same time we convert, we do not write zero
804 sectors to have a chance to compress the image. Ideally, we
805 should add a specific call to have the info to go faster */
808 /* If the output image is being created as a copy on write image,
809 copy all sectors even the ones containing only NUL bytes,
810 because they may differ from the sectors in the base image.
812 If the output is to a host device, we also write out
813 sectors that are entirely 0, since whatever data was
814 already there is garbage, not 0s. */
815 if (drv
->no_zero_init
|| out_baseimg
||
816 is_allocated_sectors(buf1
, n
, &n1
)) {
817 if (bdrv_write(out_bs
, sector_num
, buf1
, n1
) < 0)
818 error("error while writing");
827 for (bs_i
= 0; bs_i
< bs_n
; bs_i
++)
828 bdrv_delete(bs
[bs_i
]);
834 static int64_t get_allocated_file_size(const char *filename
)
836 typedef DWORD (WINAPI
* get_compressed_t
)(const char *filename
, DWORD
*high
);
837 get_compressed_t get_compressed
;
840 /* WinNT support GetCompressedFileSize to determine allocate size */
841 get_compressed
= (get_compressed_t
) GetProcAddress(GetModuleHandle("kernel32"), "GetCompressedFileSizeA");
842 if (get_compressed
) {
844 low
= get_compressed(filename
, &high
);
845 if (low
!= 0xFFFFFFFFlu
|| GetLastError() == NO_ERROR
)
846 return (((int64_t) high
) << 32) + low
;
849 if (_stati64(filename
, &st
) < 0)
854 static int64_t get_allocated_file_size(const char *filename
)
857 if (stat(filename
, &st
) < 0)
859 return (int64_t)st
.st_blocks
* 512;
863 static void dump_snapshots(BlockDriverState
*bs
)
865 QEMUSnapshotInfo
*sn_tab
, *sn
;
869 nb_sns
= bdrv_snapshot_list(bs
, &sn_tab
);
872 printf("Snapshot list:\n");
873 printf("%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), NULL
));
874 for(i
= 0; i
< nb_sns
; i
++) {
876 printf("%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), sn
));
881 static int img_info(int argc
, char **argv
)
884 const char *filename
, *fmt
;
886 BlockDriverState
*bs
;
887 char fmt_name
[128], size_buf
[128], dsize_buf
[128];
888 uint64_t total_sectors
;
889 int64_t allocated_size
;
890 char backing_filename
[1024];
891 char backing_filename2
[1024];
896 c
= getopt(argc
, argv
, "f:h");
910 filename
= argv
[optind
++];
914 error("Not enough memory");
916 drv
= bdrv_find_format(fmt
);
918 error("Unknown file format '%s'", fmt
);
922 if (bdrv_open2(bs
, filename
, BRDV_O_FLAGS
| BDRV_O_NO_BACKING
, drv
) < 0) {
923 error("Could not open '%s'", filename
);
925 bdrv_get_format(bs
, fmt_name
, sizeof(fmt_name
));
926 bdrv_get_geometry(bs
, &total_sectors
);
927 get_human_readable_size(size_buf
, sizeof(size_buf
), total_sectors
* 512);
928 allocated_size
= get_allocated_file_size(filename
);
929 if (allocated_size
< 0)
930 snprintf(dsize_buf
, sizeof(dsize_buf
), "unavailable");
932 get_human_readable_size(dsize_buf
, sizeof(dsize_buf
),
936 "virtual size: %s (%" PRId64
" bytes)\n"
938 filename
, fmt_name
, size_buf
,
939 (total_sectors
* 512),
941 if (bdrv_is_encrypted(bs
))
942 printf("encrypted: yes\n");
943 if (bdrv_get_info(bs
, &bdi
) >= 0) {
944 if (bdi
.cluster_size
!= 0)
945 printf("cluster_size: %d\n", bdi
.cluster_size
);
947 bdrv_get_backing_filename(bs
, backing_filename
, sizeof(backing_filename
));
948 if (backing_filename
[0] != '\0') {
949 path_combine(backing_filename2
, sizeof(backing_filename2
),
950 filename
, backing_filename
);
951 printf("backing file: %s (actual path: %s)\n",
960 #define SNAPSHOT_LIST 1
961 #define SNAPSHOT_CREATE 2
962 #define SNAPSHOT_APPLY 3
963 #define SNAPSHOT_DELETE 4
965 static int img_snapshot(int argc
, char **argv
)
967 BlockDriverState
*bs
;
969 char *filename
, *snapshot_name
= NULL
;
970 int c
, ret
, bdrv_oflags
;
974 bdrv_oflags
= BDRV_O_RDWR
;
975 /* Parse commandline parameters */
977 c
= getopt(argc
, argv
, "la:c:d:h");
989 action
= SNAPSHOT_LIST
;
990 bdrv_oflags
&= ~BDRV_O_RDWR
; /* no need for RW */
997 action
= SNAPSHOT_APPLY
;
998 snapshot_name
= optarg
;
1005 action
= SNAPSHOT_CREATE
;
1006 snapshot_name
= optarg
;
1013 action
= SNAPSHOT_DELETE
;
1014 snapshot_name
= optarg
;
1021 filename
= argv
[optind
++];
1023 /* Open the image */
1026 error("Not enough memory");
1028 if (bdrv_open2(bs
, filename
, bdrv_oflags
, NULL
) < 0) {
1029 error("Could not open '%s'", filename
);
1032 /* Perform the requested action */
1038 case SNAPSHOT_CREATE
:
1039 memset(&sn
, 0, sizeof(sn
));
1040 pstrcpy(sn
.name
, sizeof(sn
.name
), snapshot_name
);
1042 qemu_gettimeofday(&tv
);
1043 sn
.date_sec
= tv
.tv_sec
;
1044 sn
.date_nsec
= tv
.tv_usec
* 1000;
1046 ret
= bdrv_snapshot_create(bs
, &sn
);
1048 error("Could not create snapshot '%s': %d (%s)",
1049 snapshot_name
, ret
, strerror(-ret
));
1052 case SNAPSHOT_APPLY
:
1053 ret
= bdrv_snapshot_goto(bs
, snapshot_name
);
1055 error("Could not apply snapshot '%s': %d (%s)",
1056 snapshot_name
, ret
, strerror(-ret
));
1059 case SNAPSHOT_DELETE
:
1060 ret
= bdrv_snapshot_delete(bs
, snapshot_name
);
1062 error("Could not delete snapshot '%s': %d (%s)",
1063 snapshot_name
, ret
, strerror(-ret
));
1073 static int img_rebase(int argc
, char **argv
)
1075 BlockDriverState
*bs
, *bs_old_backing
, *bs_new_backing
;
1076 BlockDriver
*old_backing_drv
, *new_backing_drv
;
1078 const char *out_basefmt
, *out_baseimg
;
1082 /* Parse commandline parameters */
1087 c
= getopt(argc
, argv
, "uhF:b:");
1095 out_basefmt
= optarg
;
1098 out_baseimg
= optarg
;
1106 if ((optind
>= argc
) || !out_baseimg
)
1108 filename
= argv
[optind
++];
1113 * Ignore the old backing file for unsafe rebase in case we want to correct
1114 * the reference to a renamed or moved backing file.
1118 error("Not enough memory");
1120 flags
= BRDV_O_FLAGS
| BDRV_O_RDWR
| (unsafe
? BDRV_O_NO_BACKING
: 0);
1121 if (bdrv_open2(bs
, filename
, flags
, NULL
) < 0) {
1122 error("Could not open '%s'", filename
);
1125 /* Find the right drivers for the backing files */
1126 old_backing_drv
= NULL
;
1127 new_backing_drv
= NULL
;
1129 if (!unsafe
&& bs
->backing_format
[0] != '\0') {
1130 old_backing_drv
= bdrv_find_format(bs
->backing_format
);
1131 if (old_backing_drv
== NULL
) {
1132 error("Invalid format name: '%s'", bs
->backing_format
);
1136 if (out_basefmt
!= NULL
) {
1137 new_backing_drv
= bdrv_find_format(out_basefmt
);
1138 if (new_backing_drv
== NULL
) {
1139 error("Invalid format name: '%s'", out_basefmt
);
1143 /* For safe rebasing we need to compare old and new backing file */
1145 /* Make the compiler happy */
1146 bs_old_backing
= NULL
;
1147 bs_new_backing
= NULL
;
1149 char backing_name
[1024];
1151 bs_old_backing
= bdrv_new("old_backing");
1152 bdrv_get_backing_filename(bs
, backing_name
, sizeof(backing_name
));
1153 if (bdrv_open2(bs_old_backing
, backing_name
, BRDV_O_FLAGS
,
1156 error("Could not open old backing file '%s'", backing_name
);
1160 bs_new_backing
= bdrv_new("new_backing");
1161 if (bdrv_open2(bs_new_backing
, out_baseimg
, BRDV_O_FLAGS
| BDRV_O_RDWR
,
1164 error("Could not open new backing file '%s'", backing_name
);
1170 * Check each unallocated cluster in the COW file. If it is unallocated,
1171 * accesses go to the backing file. We must therefore compare this cluster
1172 * in the old and new backing file, and if they differ we need to copy it
1173 * from the old backing file into the COW file.
1175 * If qemu-img crashes during this step, no harm is done. The content of
1176 * the image is the same as the original one at any time.
1179 uint64_t num_sectors
;
1182 uint8_t buf_old
[IO_BUF_SIZE
];
1183 uint8_t buf_new
[IO_BUF_SIZE
];
1185 bdrv_get_geometry(bs
, &num_sectors
);
1187 for (sector
= 0; sector
< num_sectors
; sector
+= n
) {
1189 /* How many sectors can we handle with the next read? */
1190 if (sector
+ (IO_BUF_SIZE
/ 512) <= num_sectors
) {
1191 n
= (IO_BUF_SIZE
/ 512);
1193 n
= num_sectors
- sector
;
1196 /* If the cluster is allocated, we don't need to take action */
1197 if (bdrv_is_allocated(bs
, sector
, n
, &n1
)) {
1202 /* Read old and new backing file */
1203 if (bdrv_read(bs_old_backing
, sector
, buf_old
, n
) < 0) {
1204 error("error while reading from old backing file");
1206 if (bdrv_read(bs_new_backing
, sector
, buf_new
, n
) < 0) {
1207 error("error while reading from new backing file");
1210 /* If they differ, we need to write to the COW file */
1211 uint64_t written
= 0;
1213 while (written
< n
) {
1216 if (compare_sectors(buf_old
+ written
* 512,
1217 buf_new
+ written
* 512, n
, &pnum
))
1219 ret
= bdrv_write(bs
, sector
+ written
,
1220 buf_old
+ written
* 512, pnum
);
1222 error("Error while writing to COW image: %s",
1233 * Change the backing file. All clusters that are different from the old
1234 * backing file are overwritten in the COW file now, so the visible content
1235 * doesn't change when we switch the backing file.
1237 ret
= bdrv_change_backing_file(bs
, out_baseimg
, out_basefmt
);
1238 if (ret
== -ENOSPC
) {
1239 error("Could not change the backing file to '%s': No space left in "
1240 "the file header", out_baseimg
);
1241 } else if (ret
< 0) {
1242 error("Could not change the backing file to '%s': %s",
1243 out_baseimg
, strerror(-ret
));
1247 * TODO At this point it is possible to check if any clusters that are
1248 * allocated in the COW file are the same in the backing file. If so, they
1249 * could be dropped from the COW file. Don't do this before switching the
1250 * backing file, in case of a crash this would lead to corruption.
1255 bdrv_delete(bs_old_backing
);
1256 bdrv_delete(bs_new_backing
);
1264 static const img_cmd_t img_cmds
[] = {
1265 #define DEF(option, callback, arg_string) \
1266 { option, callback },
1267 #include "qemu-img-cmds.h"
1273 int main(int argc
, char **argv
)
1275 const img_cmd_t
*cmd
;
1276 const char *cmdname
;
1284 /* find the command */
1285 for(cmd
= img_cmds
; cmd
->name
!= NULL
; cmd
++) {
1286 if (!strcmp(cmdname
, cmd
->name
)) {
1287 return cmd
->handler(argc
, argv
);