]> git.proxmox.com Git - qemu.git/blob - qemu-img.c
Merge remote branch 'arm/for-anthony' into staging
[qemu.git] / qemu-img.c
1 /*
2 * QEMU disk image utility
3 *
4 * Copyright (c) 2003-2008 Fabrice Bellard
5 *
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:
12 *
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
15 *
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
22 * THE SOFTWARE.
23 */
24 #include "qemu-common.h"
25 #include "qemu-option.h"
26 #include "osdep.h"
27 #include "sysemu.h"
28 #include "block_int.h"
29 #include <stdio.h>
30
31 #ifdef _WIN32
32 #include <windows.h>
33 #endif
34
35 typedef struct img_cmd_t {
36 const char *name;
37 int (*handler)(int argc, char **argv);
38 } img_cmd_t;
39
40 /* Default to cache=writeback as data integrity is not important for qemu-tcg. */
41 #define BDRV_O_FLAGS BDRV_O_CACHE_WB
42
43 static void GCC_FMT_ATTR(1, 2) error(const char *fmt, ...)
44 {
45 va_list ap;
46 va_start(ap, fmt);
47 fprintf(stderr, "qemu-img: ");
48 vfprintf(stderr, fmt, ap);
49 fprintf(stderr, "\n");
50 va_end(ap);
51 }
52
53 static void format_print(void *opaque, const char *name)
54 {
55 printf(" %s", name);
56 }
57
58 /* Please keep in synch with qemu-img.texi */
59 static void help(void)
60 {
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"
65 "\n"
66 "Command syntax:\n"
67 #define DEF(option, callback, arg_string) \
68 " " arg_string "\n"
69 #include "qemu-img-cmds.h"
70 #undef DEF
71 #undef GEN_DOCS
72 "\n"
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"
83 " used format\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"
89 "\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";
96
97 printf("%s\nSupported formats:", help_msg);
98 bdrv_iterate_format(format_print, NULL);
99 printf("\n");
100 exit(1);
101 }
102
103 #if defined(WIN32)
104 /* XXX: put correct support for win32 */
105 static int read_password(char *buf, int buf_size)
106 {
107 int c, i;
108 printf("Password: ");
109 fflush(stdout);
110 i = 0;
111 for(;;) {
112 c = getchar();
113 if (c == '\n')
114 break;
115 if (i < (buf_size - 1))
116 buf[i++] = c;
117 }
118 buf[i] = '\0';
119 return 0;
120 }
121
122 #else
123
124 #include <termios.h>
125
126 static struct termios oldtty;
127
128 static void term_exit(void)
129 {
130 tcsetattr (0, TCSANOW, &oldtty);
131 }
132
133 static void term_init(void)
134 {
135 struct termios tty;
136
137 tcgetattr (0, &tty);
138 oldtty = tty;
139
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);
145 tty.c_cflag |= CS8;
146 tty.c_cc[VMIN] = 1;
147 tty.c_cc[VTIME] = 0;
148
149 tcsetattr (0, TCSANOW, &tty);
150
151 atexit(term_exit);
152 }
153
154 static int read_password(char *buf, int buf_size)
155 {
156 uint8_t ch;
157 int i, ret;
158
159 printf("password: ");
160 fflush(stdout);
161 term_init();
162 i = 0;
163 for(;;) {
164 ret = read(0, &ch, 1);
165 if (ret == -1) {
166 if (errno == EAGAIN || errno == EINTR) {
167 continue;
168 } else {
169 ret = -1;
170 break;
171 }
172 } else if (ret == 0) {
173 ret = -1;
174 break;
175 } else {
176 if (ch == '\r') {
177 ret = 0;
178 break;
179 }
180 if (i < (buf_size - 1))
181 buf[i++] = ch;
182 }
183 }
184 term_exit();
185 buf[i] = '\0';
186 printf("\n");
187 return ret;
188 }
189 #endif
190
191 static int print_block_option_help(const char *filename, const char *fmt)
192 {
193 BlockDriver *drv, *proto_drv;
194 QEMUOptionParameter *create_options = NULL;
195
196 /* Find driver and parse its options */
197 drv = bdrv_find_format(fmt);
198 if (!drv) {
199 error("Unknown file format '%s'", fmt);
200 return 1;
201 }
202
203 proto_drv = bdrv_find_protocol(filename);
204 if (!proto_drv) {
205 error("Unknown protocol '%s'", filename);
206 return 1;
207 }
208
209 create_options = append_option_parameters(create_options,
210 drv->create_options);
211 create_options = append_option_parameters(create_options,
212 proto_drv->create_options);
213 print_option_help(create_options);
214 free_option_parameters(create_options);
215 return 0;
216 }
217
218 static BlockDriverState *bdrv_new_open(const char *filename,
219 const char *fmt,
220 int flags)
221 {
222 BlockDriverState *bs;
223 BlockDriver *drv;
224 char password[256];
225
226 bs = bdrv_new("");
227 if (!bs) {
228 error("Not enough memory");
229 goto fail;
230 }
231 if (fmt) {
232 drv = bdrv_find_format(fmt);
233 if (!drv) {
234 error("Unknown file format '%s'", fmt);
235 goto fail;
236 }
237 } else {
238 drv = NULL;
239 }
240 if (bdrv_open(bs, filename, flags, drv) < 0) {
241 error("Could not open '%s'", filename);
242 goto fail;
243 }
244 if (bdrv_is_encrypted(bs)) {
245 printf("Disk image '%s' is encrypted.\n", filename);
246 if (read_password(password, sizeof(password)) < 0) {
247 error("No password given");
248 goto fail;
249 }
250 if (bdrv_set_key(bs, password) < 0) {
251 error("invalid password");
252 goto fail;
253 }
254 }
255 return bs;
256 fail:
257 if (bs) {
258 bdrv_delete(bs);
259 }
260 return NULL;
261 }
262
263 static int add_old_style_options(const char *fmt, QEMUOptionParameter *list,
264 const char *base_filename,
265 const char *base_fmt)
266 {
267 if (base_filename) {
268 if (set_option_parameter(list, BLOCK_OPT_BACKING_FILE, base_filename)) {
269 error("Backing file not supported for file format '%s'", fmt);
270 return -1;
271 }
272 }
273 if (base_fmt) {
274 if (set_option_parameter(list, BLOCK_OPT_BACKING_FMT, base_fmt)) {
275 error("Backing file format not supported for file format '%s'", fmt);
276 return -1;
277 }
278 }
279 return 0;
280 }
281
282 static int img_create(int argc, char **argv)
283 {
284 int c, ret = 0;
285 const char *fmt = "raw";
286 const char *base_fmt = NULL;
287 const char *filename;
288 const char *base_filename = NULL;
289 BlockDriver *drv, *proto_drv;
290 QEMUOptionParameter *param = NULL, *create_options = NULL;
291 QEMUOptionParameter *backing_fmt = NULL;
292 char *options = NULL;
293
294 for(;;) {
295 c = getopt(argc, argv, "F:b:f:he6o:");
296 if (c == -1) {
297 break;
298 }
299 switch(c) {
300 case '?':
301 case 'h':
302 help();
303 break;
304 case 'F':
305 base_fmt = optarg;
306 break;
307 case 'b':
308 base_filename = optarg;
309 break;
310 case 'f':
311 fmt = optarg;
312 break;
313 case 'e':
314 error("qemu-img: option -e is deprecated, please use \'-o "
315 "encryption\' instead!");
316 return 1;
317 case '6':
318 error("qemu-img: option -6 is deprecated, please use \'-o "
319 "compat6\' instead!");
320 return 1;
321 case 'o':
322 options = optarg;
323 break;
324 }
325 }
326
327 /* Get the filename */
328 if (optind >= argc) {
329 help();
330 }
331 filename = argv[optind++];
332
333 if (options && !strcmp(options, "?")) {
334 ret = print_block_option_help(filename, fmt);
335 goto out;
336 }
337
338 /* Find driver and parse its options */
339 drv = bdrv_find_format(fmt);
340 if (!drv) {
341 error("Unknown file format '%s'", fmt);
342 ret = -1;
343 goto out;
344 }
345
346 proto_drv = bdrv_find_protocol(filename);
347 if (!proto_drv) {
348 error("Unknown protocol '%s'", filename);
349 ret = -1;
350 goto out;
351 }
352
353 create_options = append_option_parameters(create_options,
354 drv->create_options);
355 create_options = append_option_parameters(create_options,
356 proto_drv->create_options);
357
358 /* Create parameter list with default values */
359 param = parse_option_parameters("", create_options, param);
360 set_option_parameter_int(param, BLOCK_OPT_SIZE, -1);
361
362 /* Parse -o options */
363 if (options) {
364 param = parse_option_parameters(options, create_options, param);
365 if (param == NULL) {
366 error("Invalid options for file format '%s'.", fmt);
367 ret = -1;
368 goto out;
369 }
370 }
371
372 /* Add size to parameters */
373 if (optind < argc) {
374 set_option_parameter(param, BLOCK_OPT_SIZE, argv[optind++]);
375 }
376
377 /* Add old-style options to parameters */
378 ret = add_old_style_options(fmt, param, base_filename, base_fmt);
379 if (ret < 0) {
380 goto out;
381 }
382
383 backing_fmt = get_option_parameter(param, BLOCK_OPT_BACKING_FMT);
384 if (backing_fmt && backing_fmt->value.s) {
385 if (!bdrv_find_format(backing_fmt->value.s)) {
386 error("Unknown backing file format '%s'",
387 backing_fmt->value.s);
388 ret = -1;
389 goto out;
390 }
391 }
392
393 // The size for the image must always be specified, with one exception:
394 // If we are using a backing file, we can obtain the size from there
395 if (get_option_parameter(param, BLOCK_OPT_SIZE)->value.n == -1) {
396
397 QEMUOptionParameter *backing_file =
398 get_option_parameter(param, BLOCK_OPT_BACKING_FILE);
399
400 if (backing_file && backing_file->value.s) {
401 BlockDriverState *bs;
402 uint64_t size;
403 const char *fmt = NULL;
404 char buf[32];
405
406 if (backing_fmt && backing_fmt->value.s) {
407 fmt = backing_fmt->value.s;
408 }
409
410 bs = bdrv_new_open(backing_file->value.s, fmt, BDRV_O_FLAGS);
411 if (!bs) {
412 ret = -1;
413 goto out;
414 }
415 bdrv_get_geometry(bs, &size);
416 size *= 512;
417 bdrv_delete(bs);
418
419 snprintf(buf, sizeof(buf), "%" PRId64, size);
420 set_option_parameter(param, BLOCK_OPT_SIZE, buf);
421 } else {
422 error("Image creation needs a size parameter");
423 ret = -1;
424 goto out;
425 }
426 }
427
428 printf("Formatting '%s', fmt=%s ", filename, fmt);
429 print_option_parameters(param);
430 puts("");
431
432 ret = bdrv_create(drv, filename, param);
433
434 if (ret < 0) {
435 if (ret == -ENOTSUP) {
436 error("Formatting or formatting option not supported for file format '%s'", fmt);
437 } else if (ret == -EFBIG) {
438 error("The image size is too large for file format '%s'", fmt);
439 } else {
440 error("%s: error while creating %s: %s", filename, fmt, strerror(-ret));
441 }
442 }
443 out:
444 free_option_parameters(create_options);
445 free_option_parameters(param);
446 if (ret) {
447 return 1;
448 }
449 return 0;
450 }
451
452 /*
453 * Checks an image for consistency. Exit codes:
454 *
455 * 0 - Check completed, image is good
456 * 1 - Check not completed because of internal errors
457 * 2 - Check completed, image is corrupted
458 * 3 - Check completed, image has leaked clusters, but is good otherwise
459 */
460 static int img_check(int argc, char **argv)
461 {
462 int c, ret;
463 const char *filename, *fmt;
464 BlockDriverState *bs;
465 BdrvCheckResult result;
466
467 fmt = NULL;
468 for(;;) {
469 c = getopt(argc, argv, "f:h");
470 if (c == -1) {
471 break;
472 }
473 switch(c) {
474 case '?':
475 case 'h':
476 help();
477 break;
478 case 'f':
479 fmt = optarg;
480 break;
481 }
482 }
483 if (optind >= argc) {
484 help();
485 }
486 filename = argv[optind++];
487
488 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS);
489 if (!bs) {
490 return 1;
491 }
492 ret = bdrv_check(bs, &result);
493
494 if (ret == -ENOTSUP) {
495 error("This image format does not support checks");
496 bdrv_delete(bs);
497 return 1;
498 }
499
500 if (!(result.corruptions || result.leaks || result.check_errors)) {
501 printf("No errors were found on the image.\n");
502 } else {
503 if (result.corruptions) {
504 printf("\n%d errors were found on the image.\n"
505 "Data may be corrupted, or further writes to the image "
506 "may corrupt it.\n",
507 result.corruptions);
508 }
509
510 if (result.leaks) {
511 printf("\n%d leaked clusters were found on the image.\n"
512 "This means waste of disk space, but no harm to data.\n",
513 result.leaks);
514 }
515
516 if (result.check_errors) {
517 printf("\n%d internal errors have occurred during the check.\n",
518 result.check_errors);
519 }
520 }
521
522 bdrv_delete(bs);
523
524 if (ret < 0 || result.check_errors) {
525 printf("\nAn error has occurred during the check: %s\n"
526 "The check is not complete and may have missed error.\n",
527 strerror(-ret));
528 return 1;
529 }
530
531 if (result.corruptions) {
532 return 2;
533 } else if (result.leaks) {
534 return 3;
535 } else {
536 return 0;
537 }
538 }
539
540 static int img_commit(int argc, char **argv)
541 {
542 int c, ret;
543 const char *filename, *fmt;
544 BlockDriverState *bs;
545
546 fmt = NULL;
547 for(;;) {
548 c = getopt(argc, argv, "f:h");
549 if (c == -1) {
550 break;
551 }
552 switch(c) {
553 case '?':
554 case 'h':
555 help();
556 break;
557 case 'f':
558 fmt = optarg;
559 break;
560 }
561 }
562 if (optind >= argc) {
563 help();
564 }
565 filename = argv[optind++];
566
567 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS | BDRV_O_RDWR);
568 if (!bs) {
569 return 1;
570 }
571 ret = bdrv_commit(bs);
572 switch(ret) {
573 case 0:
574 printf("Image committed.\n");
575 break;
576 case -ENOENT:
577 error("No disk inserted");
578 break;
579 case -EACCES:
580 error("Image is read-only");
581 break;
582 case -ENOTSUP:
583 error("Image is already committed");
584 break;
585 default:
586 error("Error while committing image");
587 break;
588 }
589
590 bdrv_delete(bs);
591 if (ret) {
592 return 1;
593 }
594 return 0;
595 }
596
597 static int is_not_zero(const uint8_t *sector, int len)
598 {
599 int i;
600 len >>= 2;
601 for(i = 0;i < len; i++) {
602 if (((uint32_t *)sector)[i] != 0)
603 return 1;
604 }
605 return 0;
606 }
607
608 /*
609 * Returns true iff the first sector pointed to by 'buf' contains at least
610 * a non-NUL byte.
611 *
612 * 'pnum' is set to the number of sectors (including and immediately following
613 * the first one) that are known to be in the same allocated/unallocated state.
614 */
615 static int is_allocated_sectors(const uint8_t *buf, int n, int *pnum)
616 {
617 int v, i;
618
619 if (n <= 0) {
620 *pnum = 0;
621 return 0;
622 }
623 v = is_not_zero(buf, 512);
624 for(i = 1; i < n; i++) {
625 buf += 512;
626 if (v != is_not_zero(buf, 512))
627 break;
628 }
629 *pnum = i;
630 return v;
631 }
632
633 /*
634 * Compares two buffers sector by sector. Returns 0 if the first sector of both
635 * buffers matches, non-zero otherwise.
636 *
637 * pnum is set to the number of sectors (including and immediately following
638 * the first one) that are known to have the same comparison result
639 */
640 static int compare_sectors(const uint8_t *buf1, const uint8_t *buf2, int n,
641 int *pnum)
642 {
643 int res, i;
644
645 if (n <= 0) {
646 *pnum = 0;
647 return 0;
648 }
649
650 res = !!memcmp(buf1, buf2, 512);
651 for(i = 1; i < n; i++) {
652 buf1 += 512;
653 buf2 += 512;
654
655 if (!!memcmp(buf1, buf2, 512) != res) {
656 break;
657 }
658 }
659
660 *pnum = i;
661 return res;
662 }
663
664 #define IO_BUF_SIZE (2 * 1024 * 1024)
665
666 static int img_convert(int argc, char **argv)
667 {
668 int c, ret = 0, n, n1, bs_n, bs_i, compress, cluster_size, cluster_sectors;
669 const char *fmt, *out_fmt, *out_baseimg, *out_filename;
670 BlockDriver *drv, *proto_drv;
671 BlockDriverState **bs = NULL, *out_bs = NULL;
672 int64_t total_sectors, nb_sectors, sector_num, bs_offset;
673 uint64_t bs_sectors;
674 uint8_t * buf = NULL;
675 const uint8_t *buf1;
676 BlockDriverInfo bdi;
677 QEMUOptionParameter *param = NULL, *create_options = NULL;
678 QEMUOptionParameter *out_baseimg_param;
679 char *options = NULL;
680 const char *snapshot_name = NULL;
681
682 fmt = NULL;
683 out_fmt = "raw";
684 out_baseimg = NULL;
685 compress = 0;
686 for(;;) {
687 c = getopt(argc, argv, "f:O:B:s:hce6o:");
688 if (c == -1) {
689 break;
690 }
691 switch(c) {
692 case '?':
693 case 'h':
694 help();
695 break;
696 case 'f':
697 fmt = optarg;
698 break;
699 case 'O':
700 out_fmt = optarg;
701 break;
702 case 'B':
703 out_baseimg = optarg;
704 break;
705 case 'c':
706 compress = 1;
707 break;
708 case 'e':
709 error("qemu-img: option -e is deprecated, please use \'-o "
710 "encryption\' instead!");
711 return 1;
712 case '6':
713 error("qemu-img: option -6 is deprecated, please use \'-o "
714 "compat6\' instead!");
715 return 1;
716 case 'o':
717 options = optarg;
718 break;
719 case 's':
720 snapshot_name = optarg;
721 break;
722 }
723 }
724
725 bs_n = argc - optind - 1;
726 if (bs_n < 1) {
727 help();
728 }
729
730 out_filename = argv[argc - 1];
731
732 if (options && !strcmp(options, "?")) {
733 ret = print_block_option_help(out_filename, out_fmt);
734 goto out;
735 }
736
737 if (bs_n > 1 && out_baseimg) {
738 error("-B makes no sense when concatenating multiple input images");
739 ret = -1;
740 goto out;
741 }
742
743 bs = qemu_mallocz(bs_n * sizeof(BlockDriverState *));
744
745 total_sectors = 0;
746 for (bs_i = 0; bs_i < bs_n; bs_i++) {
747 bs[bs_i] = bdrv_new_open(argv[optind + bs_i], fmt, BDRV_O_FLAGS);
748 if (!bs[bs_i]) {
749 error("Could not open '%s'", argv[optind + bs_i]);
750 ret = -1;
751 goto out;
752 }
753 bdrv_get_geometry(bs[bs_i], &bs_sectors);
754 total_sectors += bs_sectors;
755 }
756
757 if (snapshot_name != NULL) {
758 if (bs_n > 1) {
759 error("No support for concatenating multiple snapshot\n");
760 ret = -1;
761 goto out;
762 }
763 if (bdrv_snapshot_load_tmp(bs[0], snapshot_name) < 0) {
764 error("Failed to load snapshot\n");
765 ret = -1;
766 goto out;
767 }
768 }
769
770 /* Find driver and parse its options */
771 drv = bdrv_find_format(out_fmt);
772 if (!drv) {
773 error("Unknown file format '%s'", out_fmt);
774 ret = -1;
775 goto out;
776 }
777
778 proto_drv = bdrv_find_protocol(out_filename);
779 if (!proto_drv) {
780 error("Unknown protocol '%s'", out_filename);
781 ret = -1;
782 goto out;
783 }
784
785 create_options = append_option_parameters(create_options,
786 drv->create_options);
787 create_options = append_option_parameters(create_options,
788 proto_drv->create_options);
789
790 if (options) {
791 param = parse_option_parameters(options, create_options, param);
792 if (param == NULL) {
793 error("Invalid options for file format '%s'.", out_fmt);
794 ret = -1;
795 goto out;
796 }
797 } else {
798 param = parse_option_parameters("", create_options, param);
799 }
800
801 set_option_parameter_int(param, BLOCK_OPT_SIZE, total_sectors * 512);
802 ret = add_old_style_options(out_fmt, param, out_baseimg, NULL);
803 if (ret < 0) {
804 goto out;
805 }
806
807 /* Get backing file name if -o backing_file was used */
808 out_baseimg_param = get_option_parameter(param, BLOCK_OPT_BACKING_FILE);
809 if (out_baseimg_param) {
810 out_baseimg = out_baseimg_param->value.s;
811 }
812
813 /* Check if compression is supported */
814 if (compress) {
815 QEMUOptionParameter *encryption =
816 get_option_parameter(param, BLOCK_OPT_ENCRYPT);
817
818 if (!drv->bdrv_write_compressed) {
819 error("Compression not supported for this file format");
820 ret = -1;
821 goto out;
822 }
823
824 if (encryption && encryption->value.n) {
825 error("Compression and encryption not supported at the same time");
826 ret = -1;
827 goto out;
828 }
829 }
830
831 /* Create the new image */
832 ret = bdrv_create(drv, out_filename, param);
833 if (ret < 0) {
834 if (ret == -ENOTSUP) {
835 error("Formatting not supported for file format '%s'", out_fmt);
836 } else if (ret == -EFBIG) {
837 error("The image size is too large for file format '%s'", out_fmt);
838 } else {
839 error("%s: error while converting %s: %s", out_filename, out_fmt, strerror(-ret));
840 }
841 goto out;
842 }
843
844 out_bs = bdrv_new_open(out_filename, out_fmt,
845 BDRV_O_FLAGS | BDRV_O_RDWR | BDRV_O_NO_FLUSH);
846 if (!out_bs) {
847 ret = -1;
848 goto out;
849 }
850
851 bs_i = 0;
852 bs_offset = 0;
853 bdrv_get_geometry(bs[0], &bs_sectors);
854 buf = qemu_malloc(IO_BUF_SIZE);
855
856 if (compress) {
857 ret = bdrv_get_info(out_bs, &bdi);
858 if (ret < 0) {
859 error("could not get block driver info");
860 goto out;
861 }
862 cluster_size = bdi.cluster_size;
863 if (cluster_size <= 0 || cluster_size > IO_BUF_SIZE) {
864 error("invalid cluster size");
865 ret = -1;
866 goto out;
867 }
868 cluster_sectors = cluster_size >> 9;
869 sector_num = 0;
870 for(;;) {
871 int64_t bs_num;
872 int remainder;
873 uint8_t *buf2;
874
875 nb_sectors = total_sectors - sector_num;
876 if (nb_sectors <= 0)
877 break;
878 if (nb_sectors >= cluster_sectors)
879 n = cluster_sectors;
880 else
881 n = nb_sectors;
882
883 bs_num = sector_num - bs_offset;
884 assert (bs_num >= 0);
885 remainder = n;
886 buf2 = buf;
887 while (remainder > 0) {
888 int nlow;
889 while (bs_num == bs_sectors) {
890 bs_i++;
891 assert (bs_i < bs_n);
892 bs_offset += bs_sectors;
893 bdrv_get_geometry(bs[bs_i], &bs_sectors);
894 bs_num = 0;
895 /* printf("changing part: sector_num=%" PRId64 ", "
896 "bs_i=%d, bs_offset=%" PRId64 ", bs_sectors=%" PRId64
897 "\n", sector_num, bs_i, bs_offset, bs_sectors); */
898 }
899 assert (bs_num < bs_sectors);
900
901 nlow = (remainder > bs_sectors - bs_num) ? bs_sectors - bs_num : remainder;
902
903 ret = bdrv_read(bs[bs_i], bs_num, buf2, nlow);
904 if (ret < 0) {
905 error("error while reading");
906 goto out;
907 }
908
909 buf2 += nlow * 512;
910 bs_num += nlow;
911
912 remainder -= nlow;
913 }
914 assert (remainder == 0);
915
916 if (n < cluster_sectors) {
917 memset(buf + n * 512, 0, cluster_size - n * 512);
918 }
919 if (is_not_zero(buf, cluster_size)) {
920 ret = bdrv_write_compressed(out_bs, sector_num, buf,
921 cluster_sectors);
922 if (ret != 0) {
923 error("error while compressing sector %" PRId64,
924 sector_num);
925 goto out;
926 }
927 }
928 sector_num += n;
929 }
930 /* signal EOF to align */
931 bdrv_write_compressed(out_bs, 0, NULL, 0);
932 } else {
933 int has_zero_init = bdrv_has_zero_init(out_bs);
934
935 sector_num = 0; // total number of sectors converted so far
936 for(;;) {
937 nb_sectors = total_sectors - sector_num;
938 if (nb_sectors <= 0) {
939 break;
940 }
941 if (nb_sectors >= (IO_BUF_SIZE / 512)) {
942 n = (IO_BUF_SIZE / 512);
943 } else {
944 n = nb_sectors;
945 }
946
947 while (sector_num - bs_offset >= bs_sectors) {
948 bs_i ++;
949 assert (bs_i < bs_n);
950 bs_offset += bs_sectors;
951 bdrv_get_geometry(bs[bs_i], &bs_sectors);
952 /* printf("changing part: sector_num=%" PRId64 ", bs_i=%d, "
953 "bs_offset=%" PRId64 ", bs_sectors=%" PRId64 "\n",
954 sector_num, bs_i, bs_offset, bs_sectors); */
955 }
956
957 if (n > bs_offset + bs_sectors - sector_num) {
958 n = bs_offset + bs_sectors - sector_num;
959 }
960
961 if (has_zero_init) {
962 /* If the output image is being created as a copy on write image,
963 assume that sectors which are unallocated in the input image
964 are present in both the output's and input's base images (no
965 need to copy them). */
966 if (out_baseimg) {
967 if (!bdrv_is_allocated(bs[bs_i], sector_num - bs_offset,
968 n, &n1)) {
969 sector_num += n1;
970 continue;
971 }
972 /* The next 'n1' sectors are allocated in the input image. Copy
973 only those as they may be followed by unallocated sectors. */
974 n = n1;
975 }
976 } else {
977 n1 = n;
978 }
979
980 ret = bdrv_read(bs[bs_i], sector_num - bs_offset, buf, n);
981 if (ret < 0) {
982 error("error while reading");
983 goto out;
984 }
985 /* NOTE: at the same time we convert, we do not write zero
986 sectors to have a chance to compress the image. Ideally, we
987 should add a specific call to have the info to go faster */
988 buf1 = buf;
989 while (n > 0) {
990 /* If the output image is being created as a copy on write image,
991 copy all sectors even the ones containing only NUL bytes,
992 because they may differ from the sectors in the base image.
993
994 If the output is to a host device, we also write out
995 sectors that are entirely 0, since whatever data was
996 already there is garbage, not 0s. */
997 if (!has_zero_init || out_baseimg ||
998 is_allocated_sectors(buf1, n, &n1)) {
999 ret = bdrv_write(out_bs, sector_num, buf1, n1);
1000 if (ret < 0) {
1001 error("error while writing");
1002 goto out;
1003 }
1004 }
1005 sector_num += n1;
1006 n -= n1;
1007 buf1 += n1 * 512;
1008 }
1009 }
1010 }
1011 out:
1012 free_option_parameters(create_options);
1013 free_option_parameters(param);
1014 qemu_free(buf);
1015 if (out_bs) {
1016 bdrv_delete(out_bs);
1017 }
1018 if (bs) {
1019 for (bs_i = 0; bs_i < bs_n; bs_i++) {
1020 if (bs[bs_i]) {
1021 bdrv_delete(bs[bs_i]);
1022 }
1023 }
1024 qemu_free(bs);
1025 }
1026 if (ret) {
1027 return 1;
1028 }
1029 return 0;
1030 }
1031
1032 #ifdef _WIN32
1033 static int64_t get_allocated_file_size(const char *filename)
1034 {
1035 typedef DWORD (WINAPI * get_compressed_t)(const char *filename, DWORD *high);
1036 get_compressed_t get_compressed;
1037 struct _stati64 st;
1038
1039 /* WinNT support GetCompressedFileSize to determine allocate size */
1040 get_compressed = (get_compressed_t) GetProcAddress(GetModuleHandle("kernel32"), "GetCompressedFileSizeA");
1041 if (get_compressed) {
1042 DWORD high, low;
1043 low = get_compressed(filename, &high);
1044 if (low != 0xFFFFFFFFlu || GetLastError() == NO_ERROR)
1045 return (((int64_t) high) << 32) + low;
1046 }
1047
1048 if (_stati64(filename, &st) < 0)
1049 return -1;
1050 return st.st_size;
1051 }
1052 #else
1053 static int64_t get_allocated_file_size(const char *filename)
1054 {
1055 struct stat st;
1056 if (stat(filename, &st) < 0)
1057 return -1;
1058 return (int64_t)st.st_blocks * 512;
1059 }
1060 #endif
1061
1062 static void dump_snapshots(BlockDriverState *bs)
1063 {
1064 QEMUSnapshotInfo *sn_tab, *sn;
1065 int nb_sns, i;
1066 char buf[256];
1067
1068 nb_sns = bdrv_snapshot_list(bs, &sn_tab);
1069 if (nb_sns <= 0)
1070 return;
1071 printf("Snapshot list:\n");
1072 printf("%s\n", bdrv_snapshot_dump(buf, sizeof(buf), NULL));
1073 for(i = 0; i < nb_sns; i++) {
1074 sn = &sn_tab[i];
1075 printf("%s\n", bdrv_snapshot_dump(buf, sizeof(buf), sn));
1076 }
1077 qemu_free(sn_tab);
1078 }
1079
1080 static int img_info(int argc, char **argv)
1081 {
1082 int c;
1083 const char *filename, *fmt;
1084 BlockDriverState *bs;
1085 char fmt_name[128], size_buf[128], dsize_buf[128];
1086 uint64_t total_sectors;
1087 int64_t allocated_size;
1088 char backing_filename[1024];
1089 char backing_filename2[1024];
1090 BlockDriverInfo bdi;
1091
1092 fmt = NULL;
1093 for(;;) {
1094 c = getopt(argc, argv, "f:h");
1095 if (c == -1) {
1096 break;
1097 }
1098 switch(c) {
1099 case '?':
1100 case 'h':
1101 help();
1102 break;
1103 case 'f':
1104 fmt = optarg;
1105 break;
1106 }
1107 }
1108 if (optind >= argc) {
1109 help();
1110 }
1111 filename = argv[optind++];
1112
1113 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS | BDRV_O_NO_BACKING);
1114 if (!bs) {
1115 return 1;
1116 }
1117 bdrv_get_format(bs, fmt_name, sizeof(fmt_name));
1118 bdrv_get_geometry(bs, &total_sectors);
1119 get_human_readable_size(size_buf, sizeof(size_buf), total_sectors * 512);
1120 allocated_size = get_allocated_file_size(filename);
1121 if (allocated_size < 0) {
1122 snprintf(dsize_buf, sizeof(dsize_buf), "unavailable");
1123 } else {
1124 get_human_readable_size(dsize_buf, sizeof(dsize_buf),
1125 allocated_size);
1126 }
1127 printf("image: %s\n"
1128 "file format: %s\n"
1129 "virtual size: %s (%" PRId64 " bytes)\n"
1130 "disk size: %s\n",
1131 filename, fmt_name, size_buf,
1132 (total_sectors * 512),
1133 dsize_buf);
1134 if (bdrv_is_encrypted(bs)) {
1135 printf("encrypted: yes\n");
1136 }
1137 if (bdrv_get_info(bs, &bdi) >= 0) {
1138 if (bdi.cluster_size != 0) {
1139 printf("cluster_size: %d\n", bdi.cluster_size);
1140 }
1141 }
1142 bdrv_get_backing_filename(bs, backing_filename, sizeof(backing_filename));
1143 if (backing_filename[0] != '\0') {
1144 path_combine(backing_filename2, sizeof(backing_filename2),
1145 filename, backing_filename);
1146 printf("backing file: %s (actual path: %s)\n",
1147 backing_filename,
1148 backing_filename2);
1149 }
1150 dump_snapshots(bs);
1151 bdrv_delete(bs);
1152 return 0;
1153 }
1154
1155 #define SNAPSHOT_LIST 1
1156 #define SNAPSHOT_CREATE 2
1157 #define SNAPSHOT_APPLY 3
1158 #define SNAPSHOT_DELETE 4
1159
1160 static int img_snapshot(int argc, char **argv)
1161 {
1162 BlockDriverState *bs;
1163 QEMUSnapshotInfo sn;
1164 char *filename, *snapshot_name = NULL;
1165 int c, ret = 0, bdrv_oflags;
1166 int action = 0;
1167 qemu_timeval tv;
1168
1169 bdrv_oflags = BDRV_O_RDWR;
1170 /* Parse commandline parameters */
1171 for(;;) {
1172 c = getopt(argc, argv, "la:c:d:h");
1173 if (c == -1) {
1174 break;
1175 }
1176 switch(c) {
1177 case '?':
1178 case 'h':
1179 help();
1180 return 0;
1181 case 'l':
1182 if (action) {
1183 help();
1184 return 0;
1185 }
1186 action = SNAPSHOT_LIST;
1187 bdrv_oflags &= ~BDRV_O_RDWR; /* no need for RW */
1188 break;
1189 case 'a':
1190 if (action) {
1191 help();
1192 return 0;
1193 }
1194 action = SNAPSHOT_APPLY;
1195 snapshot_name = optarg;
1196 break;
1197 case 'c':
1198 if (action) {
1199 help();
1200 return 0;
1201 }
1202 action = SNAPSHOT_CREATE;
1203 snapshot_name = optarg;
1204 break;
1205 case 'd':
1206 if (action) {
1207 help();
1208 return 0;
1209 }
1210 action = SNAPSHOT_DELETE;
1211 snapshot_name = optarg;
1212 break;
1213 }
1214 }
1215
1216 if (optind >= argc) {
1217 help();
1218 }
1219 filename = argv[optind++];
1220
1221 /* Open the image */
1222 bs = bdrv_new_open(filename, NULL, bdrv_oflags);
1223 if (!bs) {
1224 return 1;
1225 }
1226
1227 /* Perform the requested action */
1228 switch(action) {
1229 case SNAPSHOT_LIST:
1230 dump_snapshots(bs);
1231 break;
1232
1233 case SNAPSHOT_CREATE:
1234 memset(&sn, 0, sizeof(sn));
1235 pstrcpy(sn.name, sizeof(sn.name), snapshot_name);
1236
1237 qemu_gettimeofday(&tv);
1238 sn.date_sec = tv.tv_sec;
1239 sn.date_nsec = tv.tv_usec * 1000;
1240
1241 ret = bdrv_snapshot_create(bs, &sn);
1242 if (ret) {
1243 error("Could not create snapshot '%s': %d (%s)",
1244 snapshot_name, ret, strerror(-ret));
1245 }
1246 break;
1247
1248 case SNAPSHOT_APPLY:
1249 ret = bdrv_snapshot_goto(bs, snapshot_name);
1250 if (ret) {
1251 error("Could not apply snapshot '%s': %d (%s)",
1252 snapshot_name, ret, strerror(-ret));
1253 }
1254 break;
1255
1256 case SNAPSHOT_DELETE:
1257 ret = bdrv_snapshot_delete(bs, snapshot_name);
1258 if (ret) {
1259 error("Could not delete snapshot '%s': %d (%s)",
1260 snapshot_name, ret, strerror(-ret));
1261 }
1262 break;
1263 }
1264
1265 /* Cleanup */
1266 bdrv_delete(bs);
1267 if (ret) {
1268 return 1;
1269 }
1270 return 0;
1271 }
1272
1273 static int img_rebase(int argc, char **argv)
1274 {
1275 BlockDriverState *bs, *bs_old_backing = NULL, *bs_new_backing = NULL;
1276 BlockDriver *old_backing_drv, *new_backing_drv;
1277 char *filename;
1278 const char *fmt, *out_basefmt, *out_baseimg;
1279 int c, flags, ret;
1280 int unsafe = 0;
1281
1282 /* Parse commandline parameters */
1283 fmt = NULL;
1284 out_baseimg = NULL;
1285 out_basefmt = NULL;
1286
1287 for(;;) {
1288 c = getopt(argc, argv, "uhf:F:b:");
1289 if (c == -1) {
1290 break;
1291 }
1292 switch(c) {
1293 case '?':
1294 case 'h':
1295 help();
1296 return 0;
1297 case 'f':
1298 fmt = optarg;
1299 break;
1300 case 'F':
1301 out_basefmt = optarg;
1302 break;
1303 case 'b':
1304 out_baseimg = optarg;
1305 break;
1306 case 'u':
1307 unsafe = 1;
1308 break;
1309 }
1310 }
1311
1312 if ((optind >= argc) || !out_baseimg) {
1313 help();
1314 }
1315 filename = argv[optind++];
1316
1317 /*
1318 * Open the images.
1319 *
1320 * Ignore the old backing file for unsafe rebase in case we want to correct
1321 * the reference to a renamed or moved backing file.
1322 */
1323 flags = BDRV_O_FLAGS | BDRV_O_RDWR | (unsafe ? BDRV_O_NO_BACKING : 0);
1324 bs = bdrv_new_open(filename, fmt, flags);
1325 if (!bs) {
1326 return 1;
1327 }
1328
1329 /* Find the right drivers for the backing files */
1330 old_backing_drv = NULL;
1331 new_backing_drv = NULL;
1332
1333 if (!unsafe && bs->backing_format[0] != '\0') {
1334 old_backing_drv = bdrv_find_format(bs->backing_format);
1335 if (old_backing_drv == NULL) {
1336 error("Invalid format name: '%s'", bs->backing_format);
1337 ret = -1;
1338 goto out;
1339 }
1340 }
1341
1342 if (out_basefmt != NULL) {
1343 new_backing_drv = bdrv_find_format(out_basefmt);
1344 if (new_backing_drv == NULL) {
1345 error("Invalid format name: '%s'", out_basefmt);
1346 ret = -1;
1347 goto out;
1348 }
1349 }
1350
1351 /* For safe rebasing we need to compare old and new backing file */
1352 if (unsafe) {
1353 /* Make the compiler happy */
1354 bs_old_backing = NULL;
1355 bs_new_backing = NULL;
1356 } else {
1357 char backing_name[1024];
1358
1359 bs_old_backing = bdrv_new("old_backing");
1360 bdrv_get_backing_filename(bs, backing_name, sizeof(backing_name));
1361 ret = bdrv_open(bs_old_backing, backing_name, BDRV_O_FLAGS,
1362 old_backing_drv);
1363 if (ret) {
1364 error("Could not open old backing file '%s'", backing_name);
1365 goto out;
1366 }
1367
1368 bs_new_backing = bdrv_new("new_backing");
1369 ret = bdrv_open(bs_new_backing, out_baseimg, BDRV_O_FLAGS,
1370 new_backing_drv);
1371 if (ret) {
1372 error("Could not open new backing file '%s'", out_baseimg);
1373 goto out;
1374 }
1375 }
1376
1377 /*
1378 * Check each unallocated cluster in the COW file. If it is unallocated,
1379 * accesses go to the backing file. We must therefore compare this cluster
1380 * in the old and new backing file, and if they differ we need to copy it
1381 * from the old backing file into the COW file.
1382 *
1383 * If qemu-img crashes during this step, no harm is done. The content of
1384 * the image is the same as the original one at any time.
1385 */
1386 if (!unsafe) {
1387 uint64_t num_sectors;
1388 uint64_t sector;
1389 int n;
1390 uint8_t * buf_old;
1391 uint8_t * buf_new;
1392
1393 buf_old = qemu_malloc(IO_BUF_SIZE);
1394 buf_new = qemu_malloc(IO_BUF_SIZE);
1395
1396 bdrv_get_geometry(bs, &num_sectors);
1397
1398 for (sector = 0; sector < num_sectors; sector += n) {
1399
1400 /* How many sectors can we handle with the next read? */
1401 if (sector + (IO_BUF_SIZE / 512) <= num_sectors) {
1402 n = (IO_BUF_SIZE / 512);
1403 } else {
1404 n = num_sectors - sector;
1405 }
1406
1407 /* If the cluster is allocated, we don't need to take action */
1408 ret = bdrv_is_allocated(bs, sector, n, &n);
1409 if (ret) {
1410 continue;
1411 }
1412
1413 /* Read old and new backing file */
1414 ret = bdrv_read(bs_old_backing, sector, buf_old, n);
1415 if (ret < 0) {
1416 error("error while reading from old backing file");
1417 goto out;
1418 }
1419 ret = bdrv_read(bs_new_backing, sector, buf_new, n);
1420 if (ret < 0) {
1421 error("error while reading from new backing file");
1422 goto out;
1423 }
1424
1425 /* If they differ, we need to write to the COW file */
1426 uint64_t written = 0;
1427
1428 while (written < n) {
1429 int pnum;
1430
1431 if (compare_sectors(buf_old + written * 512,
1432 buf_new + written * 512, n - written, &pnum))
1433 {
1434 ret = bdrv_write(bs, sector + written,
1435 buf_old + written * 512, pnum);
1436 if (ret < 0) {
1437 error("Error while writing to COW image: %s",
1438 strerror(-ret));
1439 goto out;
1440 }
1441 }
1442
1443 written += pnum;
1444 }
1445 }
1446
1447 qemu_free(buf_old);
1448 qemu_free(buf_new);
1449 }
1450
1451 /*
1452 * Change the backing file. All clusters that are different from the old
1453 * backing file are overwritten in the COW file now, so the visible content
1454 * doesn't change when we switch the backing file.
1455 */
1456 ret = bdrv_change_backing_file(bs, out_baseimg, out_basefmt);
1457 if (ret == -ENOSPC) {
1458 error("Could not change the backing file to '%s': No space left in "
1459 "the file header", out_baseimg);
1460 } else if (ret < 0) {
1461 error("Could not change the backing file to '%s': %s",
1462 out_baseimg, strerror(-ret));
1463 }
1464
1465 /*
1466 * TODO At this point it is possible to check if any clusters that are
1467 * allocated in the COW file are the same in the backing file. If so, they
1468 * could be dropped from the COW file. Don't do this before switching the
1469 * backing file, in case of a crash this would lead to corruption.
1470 */
1471 out:
1472 /* Cleanup */
1473 if (!unsafe) {
1474 bdrv_delete(bs_old_backing);
1475 bdrv_delete(bs_new_backing);
1476 }
1477
1478 bdrv_delete(bs);
1479 if (ret) {
1480 return 1;
1481 }
1482 return 0;
1483 }
1484
1485 static int img_resize(int argc, char **argv)
1486 {
1487 int c, ret, relative;
1488 const char *filename, *fmt, *size;
1489 int64_t n, total_size;
1490 BlockDriverState *bs = NULL;
1491 QEMUOptionParameter *param;
1492 QEMUOptionParameter resize_options[] = {
1493 {
1494 .name = BLOCK_OPT_SIZE,
1495 .type = OPT_SIZE,
1496 .help = "Virtual disk size"
1497 },
1498 { NULL }
1499 };
1500
1501 fmt = NULL;
1502 for(;;) {
1503 c = getopt(argc, argv, "f:h");
1504 if (c == -1) {
1505 break;
1506 }
1507 switch(c) {
1508 case '?':
1509 case 'h':
1510 help();
1511 break;
1512 case 'f':
1513 fmt = optarg;
1514 break;
1515 }
1516 }
1517 if (optind + 1 >= argc) {
1518 help();
1519 }
1520 filename = argv[optind++];
1521 size = argv[optind++];
1522
1523 /* Choose grow, shrink, or absolute resize mode */
1524 switch (size[0]) {
1525 case '+':
1526 relative = 1;
1527 size++;
1528 break;
1529 case '-':
1530 relative = -1;
1531 size++;
1532 break;
1533 default:
1534 relative = 0;
1535 break;
1536 }
1537
1538 /* Parse size */
1539 param = parse_option_parameters("", resize_options, NULL);
1540 if (set_option_parameter(param, BLOCK_OPT_SIZE, size)) {
1541 /* Error message already printed when size parsing fails */
1542 ret = -1;
1543 goto out;
1544 }
1545 n = get_option_parameter(param, BLOCK_OPT_SIZE)->value.n;
1546 free_option_parameters(param);
1547
1548 bs = bdrv_new_open(filename, fmt, BDRV_O_FLAGS | BDRV_O_RDWR);
1549 if (!bs) {
1550 ret = -1;
1551 goto out;
1552 }
1553
1554 if (relative) {
1555 total_size = bdrv_getlength(bs) + n * relative;
1556 } else {
1557 total_size = n;
1558 }
1559 if (total_size <= 0) {
1560 error("New image size must be positive");
1561 ret = -1;
1562 goto out;
1563 }
1564
1565 ret = bdrv_truncate(bs, total_size);
1566 switch (ret) {
1567 case 0:
1568 printf("Image resized.\n");
1569 break;
1570 case -ENOTSUP:
1571 error("This image format does not support resize");
1572 break;
1573 case -EACCES:
1574 error("Image is read-only");
1575 break;
1576 default:
1577 error("Error resizing image (%d)", -ret);
1578 break;
1579 }
1580 out:
1581 if (bs) {
1582 bdrv_delete(bs);
1583 }
1584 if (ret) {
1585 return 1;
1586 }
1587 return 0;
1588 }
1589
1590 static const img_cmd_t img_cmds[] = {
1591 #define DEF(option, callback, arg_string) \
1592 { option, callback },
1593 #include "qemu-img-cmds.h"
1594 #undef DEF
1595 #undef GEN_DOCS
1596 { NULL, NULL, },
1597 };
1598
1599 int main(int argc, char **argv)
1600 {
1601 const img_cmd_t *cmd;
1602 const char *cmdname;
1603
1604 bdrv_init();
1605 if (argc < 2)
1606 help();
1607 cmdname = argv[1];
1608 argc--; argv++;
1609
1610 /* find the command */
1611 for(cmd = img_cmds; cmd->name != NULL; cmd++) {
1612 if (!strcmp(cmdname, cmd->name)) {
1613 return cmd->handler(argc, argv);
1614 }
1615 }
1616
1617 /* not found */
1618 help();
1619 return 0;
1620 }