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 /* Default to cache=writeback as data integrity is not important for qemu-tcg. */
35 #define BRDV_O_FLAGS BDRV_O_CACHE_WB
37 static void QEMU_NORETURN
error(const char *fmt
, ...)
41 fprintf(stderr
, "qemu-img: ");
42 vfprintf(stderr
, fmt
, ap
);
43 fprintf(stderr
, "\n");
48 static void format_print(void *opaque
, const char *name
)
53 /* Please keep in synch with qemu-img.texi */
54 static void help(void)
56 printf("qemu-img version " QEMU_VERSION
", Copyright (c) 2004-2008 Fabrice Bellard\n"
57 "usage: qemu-img command [command options]\n"
58 "QEMU disk image utility\n"
61 " check [-f fmt] filename\n"
62 " create [-e] [-6] [-F fmt] [-b base_image] [-f fmt] filename [size]\n"
63 " commit [-f fmt] filename\n"
64 " convert [-c] [-e] [-6] [-f fmt] [-O output_fmt] [-B output_base_image] filename [filename2 [...]] output_filename\n"
65 " info [-f fmt] filename\n"
66 " snapshot [-l | -a snapshot | -c snapshot | -d snapshot] filename\n"
68 "Command parameters:\n"
69 " 'filename' is a disk image filename\n"
70 " 'base_image' is the read-only disk image which is used as base for a copy on\n"
71 " write image; the copy on write image only stores the modified data\n"
72 " 'output_base_image' forces the output image to be created as a copy on write\n"
73 " image of the specified base image; 'output_base_image' should have the same\n"
74 " content as the input's base image, however the path, image format, etc may\n"
76 " 'fmt' is the disk image format. It is guessed automatically in most cases\n"
77 " 'size' is the disk image size in kilobytes. Optional suffixes\n"
78 " 'M' (megabyte, 1024 * 1024) and 'G' (gigabyte, 1024 * 1024 * 1024) are\n"
79 " supported any 'k' or 'K' is ignored\n"
80 " 'output_filename' is the destination disk image filename\n"
81 " 'output_fmt' is the destination format\n"
82 " '-c' indicates that target image must be compressed (qcow format only)\n"
83 " '-e' indicates that the target image must be encrypted (qcow format only)\n"
84 " '-6' indicates that the target image must use compatibility level 6 (vmdk format only)\n"
85 " '-h' with or without a command shows this help and lists the supported formats\n"
87 "Parameters to snapshot subcommand:\n"
88 " 'snapshot' is the name of the snapshot to create, apply or delete\n"
89 " '-a' applies a snapshot (revert disk to saved state)\n"
90 " '-c' creates a snapshot\n"
91 " '-d' deletes a snapshot\n"
92 " '-l' lists all snapshots in the given image\n"
94 printf("\nSupported formats:");
95 bdrv_iterate_format(format_print
, NULL
);
101 /* XXX: put correct support for win32 */
102 static int read_password(char *buf
, int buf_size
)
105 printf("Password: ");
112 if (i
< (buf_size
- 1))
123 static struct termios oldtty
;
125 static void term_exit(void)
127 tcsetattr (0, TCSANOW
, &oldtty
);
130 static void term_init(void)
137 tty
.c_iflag
&= ~(IGNBRK
|BRKINT
|PARMRK
|ISTRIP
138 |INLCR
|IGNCR
|ICRNL
|IXON
);
139 tty
.c_oflag
|= OPOST
;
140 tty
.c_lflag
&= ~(ECHO
|ECHONL
|ICANON
|IEXTEN
);
141 tty
.c_cflag
&= ~(CSIZE
|PARENB
);
146 tcsetattr (0, TCSANOW
, &tty
);
151 static int read_password(char *buf
, int buf_size
)
156 printf("password: ");
161 ret
= read(0, &ch
, 1);
163 if (errno
== EAGAIN
|| errno
== EINTR
) {
169 } else if (ret
== 0) {
177 if (i
< (buf_size
- 1))
188 static BlockDriverState
*bdrv_new_open(const char *filename
,
191 BlockDriverState
*bs
;
197 error("Not enough memory");
199 drv
= bdrv_find_format(fmt
);
201 error("Unknown file format '%s'", fmt
);
205 if (bdrv_open2(bs
, filename
, BRDV_O_FLAGS
, drv
) < 0) {
206 error("Could not open '%s'", filename
);
208 if (bdrv_is_encrypted(bs
)) {
209 printf("Disk image '%s' is encrypted.\n", filename
);
210 if (read_password(password
, sizeof(password
)) < 0)
211 error("No password given");
212 if (bdrv_set_key(bs
, password
) < 0)
213 error("invalid password");
218 static void add_old_style_options(const char *fmt
, QEMUOptionParameter
*list
,
219 int flags
, const char *base_filename
, const char *base_fmt
)
221 if (flags
& BLOCK_FLAG_ENCRYPT
) {
222 if (set_option_parameter(list
, BLOCK_OPT_ENCRYPT
, "on")) {
223 error("Encryption not supported for file format '%s'", fmt
);
226 if (flags
& BLOCK_FLAG_COMPAT6
) {
227 if (set_option_parameter(list
, BLOCK_OPT_COMPAT6
, "on")) {
228 error("VMDK version 6 not supported for file format '%s'", fmt
);
233 if (set_option_parameter(list
, BLOCK_OPT_BACKING_FILE
, base_filename
)) {
234 error("Backing file not supported for file format '%s'", fmt
);
238 if (set_option_parameter(list
, BLOCK_OPT_BACKING_FMT
, base_fmt
)) {
239 error("Backing file format not supported for file format '%s'", fmt
);
244 static int img_create(int argc
, char **argv
)
247 const char *fmt
= "raw";
248 const char *base_fmt
= NULL
;
249 const char *filename
;
250 const char *base_filename
= NULL
;
252 QEMUOptionParameter
*param
= NULL
;
253 char *options
= NULL
;
257 c
= getopt(argc
, argv
, "F:b:f:he6o:");
268 base_filename
= optarg
;
274 flags
|= BLOCK_FLAG_ENCRYPT
;
277 flags
|= BLOCK_FLAG_COMPAT6
;
286 filename
= argv
[optind
++];
288 /* Find driver and parse its options */
289 drv
= bdrv_find_format(fmt
);
291 error("Unknown file format '%s'", fmt
);
294 param
= parse_option_parameters(options
, drv
->create_options
, param
);
296 error("Invalid options for file format '%s'.", fmt
);
299 param
= parse_option_parameters("", drv
->create_options
, param
);
302 /* Add size to parameters */
304 set_option_parameter(param
, BLOCK_OPT_SIZE
, argv
[optind
++]);
307 /* Add old-style options to parameters */
308 add_old_style_options(fmt
, param
, flags
, base_filename
, base_fmt
);
310 // The size for the image must always be specified, with one exception:
311 // If we are using a backing file, we can obtain the size from there
312 if (get_option_parameter(param
, BLOCK_OPT_SIZE
)->value
.n
== 0) {
314 QEMUOptionParameter
*backing_file
=
315 get_option_parameter(param
, BLOCK_OPT_BACKING_FILE
);
316 QEMUOptionParameter
*backing_fmt
=
317 get_option_parameter(param
, BLOCK_OPT_BACKING_FMT
);
319 if (backing_file
&& backing_file
->value
.s
) {
320 BlockDriverState
*bs
;
322 const char *fmt
= NULL
;
325 if (backing_fmt
&& backing_fmt
->value
.s
) {
326 if (bdrv_find_format(backing_fmt
->value
.s
)) {
327 fmt
= backing_fmt
->value
.s
;
329 error("Unknown backing file format '%s'",
330 backing_fmt
->value
.s
);
334 bs
= bdrv_new_open(backing_file
->value
.s
, fmt
);
335 bdrv_get_geometry(bs
, &size
);
339 snprintf(buf
, sizeof(buf
), "%" PRId64
, size
);
340 set_option_parameter(param
, BLOCK_OPT_SIZE
, buf
);
342 error("Image creation needs a size parameter");
346 printf("Formatting '%s', fmt=%s ", filename
, fmt
);
347 print_option_parameters(param
);
350 ret
= bdrv_create(drv
, filename
, param
);
351 free_option_parameters(param
);
354 if (ret
== -ENOTSUP
) {
355 error("Formatting or formatting option not supported for file format '%s'", fmt
);
356 } else if (ret
== -EFBIG
) {
357 error("The image size is too large for file format '%s'", fmt
);
359 error("Error while formatting");
365 static int img_check(int argc
, char **argv
)
368 const char *filename
, *fmt
;
370 BlockDriverState
*bs
;
374 c
= getopt(argc
, argv
, "f:h");
388 filename
= argv
[optind
++];
392 error("Not enough memory");
394 drv
= bdrv_find_format(fmt
);
396 error("Unknown file format '%s'", fmt
);
400 if (bdrv_open2(bs
, filename
, BRDV_O_FLAGS
, drv
) < 0) {
401 error("Could not open '%s'", filename
);
403 ret
= bdrv_check(bs
);
406 printf("No errors were found on the image.\n");
409 error("This image format does not support checks");
413 error("An error occurred during the check");
415 printf("%d errors were found on the image.\n", ret
);
424 static int img_commit(int argc
, char **argv
)
427 const char *filename
, *fmt
;
429 BlockDriverState
*bs
;
433 c
= getopt(argc
, argv
, "f:h");
447 filename
= argv
[optind
++];
451 error("Not enough memory");
453 drv
= bdrv_find_format(fmt
);
455 error("Unknown file format '%s'", fmt
);
459 if (bdrv_open2(bs
, filename
, BRDV_O_FLAGS
, drv
) < 0) {
460 error("Could not open '%s'", filename
);
462 ret
= bdrv_commit(bs
);
465 printf("Image committed.\n");
468 error("No disk inserted");
471 error("Image is read-only");
474 error("Image is already committed");
477 error("Error while committing image");
485 static int is_not_zero(const uint8_t *sector
, int len
)
489 for(i
= 0;i
< len
; i
++) {
490 if (((uint32_t *)sector
)[i
] != 0)
497 * Returns true iff the first sector pointed to by 'buf' contains at least
500 * 'pnum' is set to the number of sectors (including and immediately following
501 * the first one) that are known to be in the same allocated/unallocated state.
503 static int is_allocated_sectors(const uint8_t *buf
, int n
, int *pnum
)
511 v
= is_not_zero(buf
, 512);
512 for(i
= 1; i
< n
; i
++) {
514 if (v
!= is_not_zero(buf
, 512))
521 #define IO_BUF_SIZE 65536
523 static int img_convert(int argc
, char **argv
)
525 int c
, ret
, n
, n1
, bs_n
, bs_i
, flags
, cluster_size
, cluster_sectors
;
526 const char *fmt
, *out_fmt
, *out_baseimg
, *out_filename
;
528 BlockDriverState
**bs
, *out_bs
;
529 int64_t total_sectors
, nb_sectors
, sector_num
, bs_offset
;
531 uint8_t buf
[IO_BUF_SIZE
];
534 QEMUOptionParameter
*param
= NULL
;
535 char *options
= NULL
;
542 c
= getopt(argc
, argv
, "f:O:B:hce6o:");
556 out_baseimg
= optarg
;
559 flags
|= BLOCK_FLAG_COMPRESS
;
562 flags
|= BLOCK_FLAG_ENCRYPT
;
565 flags
|= BLOCK_FLAG_COMPAT6
;
573 bs_n
= argc
- optind
- 1;
574 if (bs_n
< 1) help();
576 out_filename
= argv
[argc
- 1];
578 if (bs_n
> 1 && out_baseimg
)
579 error("-B makes no sense when concatenating multiple input images");
581 bs
= calloc(bs_n
, sizeof(BlockDriverState
*));
583 error("Out of memory");
586 for (bs_i
= 0; bs_i
< bs_n
; bs_i
++) {
587 bs
[bs_i
] = bdrv_new_open(argv
[optind
+ bs_i
], fmt
);
589 error("Could not open '%s'", argv
[optind
+ bs_i
]);
590 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
591 total_sectors
+= bs_sectors
;
594 /* Find driver and parse its options */
595 drv
= bdrv_find_format(out_fmt
);
597 error("Unknown file format '%s'", out_fmt
);
600 param
= parse_option_parameters(options
, drv
->create_options
, param
);
602 error("Invalid options for file format '%s'.", out_fmt
);
605 param
= parse_option_parameters("", drv
->create_options
, param
);
608 set_option_parameter_int(param
, BLOCK_OPT_SIZE
, total_sectors
* 512);
609 add_old_style_options(out_fmt
, param
, flags
, out_baseimg
, NULL
);
611 /* Check if compression is supported */
612 if (flags
& BLOCK_FLAG_COMPRESS
) {
613 QEMUOptionParameter
*encryption
=
614 get_option_parameter(param
, BLOCK_OPT_ENCRYPT
);
616 if (!drv
->bdrv_write_compressed
) {
617 error("Compression not supported for this file format");
620 if (encryption
&& encryption
->value
.n
) {
621 error("Compression and encryption not supported at the same time");
625 /* Create the new image */
626 ret
= bdrv_create(drv
, out_filename
, param
);
627 free_option_parameters(param
);
630 if (ret
== -ENOTSUP
) {
631 error("Formatting not supported for file format '%s'", out_fmt
);
632 } else if (ret
== -EFBIG
) {
633 error("The image size is too large for file format '%s'", out_fmt
);
635 error("Error while formatting '%s'", out_filename
);
639 out_bs
= bdrv_new_open(out_filename
, out_fmt
);
643 bdrv_get_geometry(bs
[0], &bs_sectors
);
645 if (flags
& BLOCK_FLAG_COMPRESS
) {
646 if (bdrv_get_info(out_bs
, &bdi
) < 0)
647 error("could not get block driver info");
648 cluster_size
= bdi
.cluster_size
;
649 if (cluster_size
<= 0 || cluster_size
> IO_BUF_SIZE
)
650 error("invalid cluster size");
651 cluster_sectors
= cluster_size
>> 9;
658 nb_sectors
= total_sectors
- sector_num
;
661 if (nb_sectors
>= cluster_sectors
)
666 bs_num
= sector_num
- bs_offset
;
667 assert (bs_num
>= 0);
670 while (remainder
> 0) {
672 while (bs_num
== bs_sectors
) {
674 assert (bs_i
< bs_n
);
675 bs_offset
+= bs_sectors
;
676 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
678 /* printf("changing part: sector_num=%lld, "
679 "bs_i=%d, bs_offset=%lld, bs_sectors=%lld\n",
680 sector_num, bs_i, bs_offset, bs_sectors); */
682 assert (bs_num
< bs_sectors
);
684 nlow
= (remainder
> bs_sectors
- bs_num
) ? bs_sectors
- bs_num
: remainder
;
686 if (bdrv_read(bs
[bs_i
], bs_num
, buf2
, nlow
) < 0)
687 error("error while reading");
694 assert (remainder
== 0);
696 if (n
< cluster_sectors
)
697 memset(buf
+ n
* 512, 0, cluster_size
- n
* 512);
698 if (is_not_zero(buf
, cluster_size
)) {
699 if (bdrv_write_compressed(out_bs
, sector_num
, buf
,
700 cluster_sectors
) != 0)
701 error("error while compressing sector %" PRId64
,
706 /* signal EOF to align */
707 bdrv_write_compressed(out_bs
, 0, NULL
, 0);
709 sector_num
= 0; // total number of sectors converted so far
711 nb_sectors
= total_sectors
- sector_num
;
714 if (nb_sectors
>= (IO_BUF_SIZE
/ 512))
715 n
= (IO_BUF_SIZE
/ 512);
719 while (sector_num
- bs_offset
>= bs_sectors
) {
721 assert (bs_i
< bs_n
);
722 bs_offset
+= bs_sectors
;
723 bdrv_get_geometry(bs
[bs_i
], &bs_sectors
);
724 /* printf("changing part: sector_num=%lld, bs_i=%d, "
725 "bs_offset=%lld, bs_sectors=%lld\n",
726 sector_num, bs_i, bs_offset, bs_sectors); */
729 if (n
> bs_offset
+ bs_sectors
- sector_num
)
730 n
= bs_offset
+ bs_sectors
- sector_num
;
732 if (strcmp(drv
->format_name
, "host_device")) {
733 if (!bdrv_is_allocated(bs
[bs_i
], sector_num
- bs_offset
,
738 /* The next 'n1' sectors are allocated in the input image. Copy
739 only those as they may be followed by unallocated sectors. */
745 if (bdrv_read(bs
[bs_i
], sector_num
- bs_offset
, buf
, n
) < 0)
746 error("error while reading");
747 /* NOTE: at the same time we convert, we do not write zero
748 sectors to have a chance to compress the image. Ideally, we
749 should add a specific call to have the info to go faster */
752 /* If the output image is being created as a copy on write image,
753 copy all sectors even the ones containing only NUL bytes,
754 because they may differ from the sectors in the base image.
756 If the output is to a host device, we also write out
757 sectors that are entirely 0, since whatever data was
758 already there is garbage, not 0s. */
759 if (strcmp(drv
->format_name
, "host_device") == 0 || out_baseimg
||
760 is_allocated_sectors(buf1
, n
, &n1
)) {
761 if (bdrv_write(out_bs
, sector_num
, buf1
, n1
) < 0)
762 error("error while writing");
771 for (bs_i
= 0; bs_i
< bs_n
; bs_i
++)
772 bdrv_delete(bs
[bs_i
]);
778 static int64_t get_allocated_file_size(const char *filename
)
780 typedef DWORD (WINAPI
* get_compressed_t
)(const char *filename
, DWORD
*high
);
781 get_compressed_t get_compressed
;
784 /* WinNT support GetCompressedFileSize to determine allocate size */
785 get_compressed
= (get_compressed_t
) GetProcAddress(GetModuleHandle("kernel32"), "GetCompressedFileSizeA");
786 if (get_compressed
) {
788 low
= get_compressed(filename
, &high
);
789 if (low
!= 0xFFFFFFFFlu
|| GetLastError() == NO_ERROR
)
790 return (((int64_t) high
) << 32) + low
;
793 if (_stati64(filename
, &st
) < 0)
798 static int64_t get_allocated_file_size(const char *filename
)
801 if (stat(filename
, &st
) < 0)
803 return (int64_t)st
.st_blocks
* 512;
807 static void dump_snapshots(BlockDriverState
*bs
)
809 QEMUSnapshotInfo
*sn_tab
, *sn
;
813 nb_sns
= bdrv_snapshot_list(bs
, &sn_tab
);
816 printf("Snapshot list:\n");
817 printf("%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), NULL
));
818 for(i
= 0; i
< nb_sns
; i
++) {
820 printf("%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), sn
));
825 static int img_info(int argc
, char **argv
)
828 const char *filename
, *fmt
;
830 BlockDriverState
*bs
;
831 char fmt_name
[128], size_buf
[128], dsize_buf
[128];
832 uint64_t total_sectors
;
833 int64_t allocated_size
;
834 char backing_filename
[1024];
835 char backing_filename2
[1024];
840 c
= getopt(argc
, argv
, "f:h");
854 filename
= argv
[optind
++];
858 error("Not enough memory");
860 drv
= bdrv_find_format(fmt
);
862 error("Unknown file format '%s'", fmt
);
866 if (bdrv_open2(bs
, filename
, BRDV_O_FLAGS
, drv
) < 0) {
867 error("Could not open '%s'", filename
);
869 bdrv_get_format(bs
, fmt_name
, sizeof(fmt_name
));
870 bdrv_get_geometry(bs
, &total_sectors
);
871 get_human_readable_size(size_buf
, sizeof(size_buf
), total_sectors
* 512);
872 allocated_size
= get_allocated_file_size(filename
);
873 if (allocated_size
< 0)
874 snprintf(dsize_buf
, sizeof(dsize_buf
), "unavailable");
876 get_human_readable_size(dsize_buf
, sizeof(dsize_buf
),
880 "virtual size: %s (%" PRId64
" bytes)\n"
882 filename
, fmt_name
, size_buf
,
883 (total_sectors
* 512),
885 if (bdrv_is_encrypted(bs
))
886 printf("encrypted: yes\n");
887 if (bdrv_get_info(bs
, &bdi
) >= 0) {
888 if (bdi
.cluster_size
!= 0)
889 printf("cluster_size: %d\n", bdi
.cluster_size
);
891 bdrv_get_backing_filename(bs
, backing_filename
, sizeof(backing_filename
));
892 if (backing_filename
[0] != '\0') {
893 path_combine(backing_filename2
, sizeof(backing_filename2
),
894 filename
, backing_filename
);
895 printf("backing file: %s (actual path: %s)\n",
904 #define SNAPSHOT_LIST 1
905 #define SNAPSHOT_CREATE 2
906 #define SNAPSHOT_APPLY 3
907 #define SNAPSHOT_DELETE 4
909 static void img_snapshot(int argc
, char **argv
)
911 BlockDriverState
*bs
;
913 char *filename
, *snapshot_name
= NULL
;
918 /* Parse commandline parameters */
920 c
= getopt(argc
, argv
, "la:c:d:h");
932 action
= SNAPSHOT_LIST
;
939 action
= SNAPSHOT_APPLY
;
940 snapshot_name
= optarg
;
947 action
= SNAPSHOT_CREATE
;
948 snapshot_name
= optarg
;
955 action
= SNAPSHOT_DELETE
;
956 snapshot_name
= optarg
;
963 filename
= argv
[optind
++];
968 error("Not enough memory");
970 if (bdrv_open2(bs
, filename
, 0, NULL
) < 0) {
971 error("Could not open '%s'", filename
);
974 /* Perform the requested action */
980 case SNAPSHOT_CREATE
:
981 memset(&sn
, 0, sizeof(sn
));
982 pstrcpy(sn
.name
, sizeof(sn
.name
), snapshot_name
);
984 qemu_gettimeofday(&tv
);
985 sn
.date_sec
= tv
.tv_sec
;
986 sn
.date_nsec
= tv
.tv_usec
* 1000;
988 ret
= bdrv_snapshot_create(bs
, &sn
);
990 error("Could not create snapshot '%s': %d (%s)",
991 snapshot_name
, ret
, strerror(-ret
));
995 ret
= bdrv_snapshot_goto(bs
, snapshot_name
);
997 error("Could not apply snapshot '%s': %d (%s)",
998 snapshot_name
, ret
, strerror(-ret
));
1001 case SNAPSHOT_DELETE
:
1002 ret
= bdrv_snapshot_delete(bs
, snapshot_name
);
1004 error("Could not delete snapshot '%s': %d (%s)",
1005 snapshot_name
, ret
, strerror(-ret
));
1013 int main(int argc
, char **argv
)
1022 if (!strcmp(cmd
, "create")) {
1023 img_create(argc
, argv
);
1024 } else if (!strcmp(cmd
, "check")) {
1025 img_check(argc
, argv
);
1026 } else if (!strcmp(cmd
, "commit")) {
1027 img_commit(argc
, argv
);
1028 } else if (!strcmp(cmd
, "convert")) {
1029 img_convert(argc
, argv
);
1030 } else if (!strcmp(cmd
, "info")) {
1031 img_info(argc
, argv
);
1032 } else if (!strcmp(cmd
, "snapshot")) {
1033 img_snapshot(argc
, argv
);