Eric Blake | 57b2d9d | 2017-08-03 11:33:50 -0500 | [diff] [blame] | 1 | HXCOMM Keep the list of subcommands sorted by name. |
Stuart Brady | 153859b | 2009-06-07 00:42:17 +0100 | [diff] [blame] | 2 | HXCOMM Use DEFHEADING() to define headings in both help text and texi |
Peter Maydell | 96ddefb | 2020-01-24 16:26:04 +0000 | [diff] [blame] | 3 | HXCOMM Text between SRST and ERST are copied to rST version and |
Stuart Brady | 153859b | 2009-06-07 00:42:17 +0100 | [diff] [blame] | 4 | HXCOMM discarded from C version |
| 5 | HXCOMM DEF(command, callback, arg_string) is used to construct |
| 6 | HXCOMM command structures and help message. |
Peter Maydell | 96ddefb | 2020-01-24 16:26:04 +0000 | [diff] [blame] | 7 | HXCOMM HXCOMM can be used for comments, discarded from both rST and C |
Stuart Brady | 153859b | 2009-06-07 00:42:17 +0100 | [diff] [blame] | 8 | |
Peter Maydell | 96ddefb | 2020-01-24 16:26:04 +0000 | [diff] [blame] | 9 | HXCOMM When amending the rST sections, please remember to copy the usage |
John Snow | 4885b0c | 2018-05-03 18:56:48 -0400 | [diff] [blame] | 10 | HXCOMM over to the per-command sections in qemu-img.texi. |
| 11 | |
Eric Blake | 57b2d9d | 2017-08-03 11:33:50 -0500 | [diff] [blame] | 12 | DEF("amend", img_amend, |
| 13 | "amend [--object objectdef] [--image-opts] [-p] [-q] [-f fmt] [-t cache] -o options filename") |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 14 | SRST |
| 15 | .. option:: amend [--object OBJECTDEF] [--image-opts] [-p] [-q] [-f FMT] [-t CACHE] -o OPTIONS FILENAME |
| 16 | ERST |
Eric Blake | 57b2d9d | 2017-08-03 11:33:50 -0500 | [diff] [blame] | 17 | |
Kevin Wolf | b6133b8 | 2014-08-05 14:17:13 +0200 | [diff] [blame] | 18 | DEF("bench", img_bench, |
Julia Suvorova | 890fb1f | 2020-02-05 17:30:08 +0100 | [diff] [blame] | 19 | "bench [-c count] [-d depth] [-f fmt] [--flush-interval=flush_interval] [-i aio] [-n] [--no-drain] [-o offset] [--pattern=pattern] [-q] [-s buffer_size] [-S step_size] [-t cache] [-w] [-U] filename") |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 20 | SRST |
Julia Suvorova | 890fb1f | 2020-02-05 17:30:08 +0100 | [diff] [blame] | 21 | .. option:: bench [-c COUNT] [-d DEPTH] [-f FMT] [--flush-interval=FLUSH_INTERVAL] [-i AIO] [-n] [--no-drain] [-o OFFSET] [--pattern=PATTERN] [-q] [-s BUFFER_SIZE] [-S STEP_SIZE] [-t CACHE] [-w] [-U] FILENAME |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 22 | ERST |
Stuart Brady | 153859b | 2009-06-07 00:42:17 +0100 | [diff] [blame] | 23 | DEF("check", img_check, |
John Snow | 65f389c | 2018-05-03 18:56:44 -0400 | [diff] [blame] | 24 | "check [--object objectdef] [--image-opts] [-q] [-f fmt] [--output=ofmt] [-r [leaks | all]] [-T src_cache] [-U] filename") |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 25 | SRST |
| 26 | .. option:: check [--object OBJECTDEF] [--image-opts] [-q] [-f FMT] [--output=OFMT] [-r [leaks | all]] [-T SRC_CACHE] [-U] FILENAME |
| 27 | ERST |
Stuart Brady | 153859b | 2009-06-07 00:42:17 +0100 | [diff] [blame] | 28 | |
Stuart Brady | 153859b | 2009-06-07 00:42:17 +0100 | [diff] [blame] | 29 | DEF("commit", img_commit, |
John Snow | 65f389c | 2018-05-03 18:56:44 -0400 | [diff] [blame] | 30 | "commit [--object objectdef] [--image-opts] [-q] [-f fmt] [-t cache] [-b base] [-d] [-p] filename") |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 31 | SRST |
| 32 | .. option:: commit [--object OBJECTDEF] [--image-opts] [-q] [-f FMT] [-t CACHE] [-b BASE] [-d] [-p] FILENAME |
| 33 | ERST |
Stuart Brady | 153859b | 2009-06-07 00:42:17 +0100 | [diff] [blame] | 34 | |
Miroslav Rezanina | d14ed18 | 2013-02-13 09:09:41 +0100 | [diff] [blame] | 35 | DEF("compare", img_compare, |
Fam Zheng | a8d16f9 | 2017-05-03 00:35:40 +0800 | [diff] [blame] | 36 | "compare [--object objectdef] [--image-opts] [-f fmt] [-F fmt] [-T src_cache] [-p] [-q] [-s] [-U] filename1 filename2") |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 37 | SRST |
| 38 | .. option:: compare [--object OBJECTDEF] [--image-opts] [-f FMT] [-F FMT] [-T SRC_CACHE] [-p] [-q] [-s] [-U] FILENAME1 FILENAME2 |
| 39 | ERST |
Miroslav Rezanina | d14ed18 | 2013-02-13 09:09:41 +0100 | [diff] [blame] | 40 | |
Stuart Brady | 153859b | 2009-06-07 00:42:17 +0100 | [diff] [blame] | 41 | DEF("convert", img_convert, |
David Edmondson | 168468f | 2020-02-05 11:02:48 +0000 | [diff] [blame] | 42 | "convert [--object objectdef] [--image-opts] [--target-image-opts] [--target-is-zero] [-U] [-C] [-c] [-p] [-q] [-n] [-f fmt] [-t cache] [-T src_cache] [-O output_fmt] [-B backing_file] [-o options] [-l snapshot_param] [-S sparse_size] [-m num_coroutines] [-W] [--salvage] filename [filename2 [...]] output_filename") |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 43 | SRST |
David Edmondson | 168468f | 2020-02-05 11:02:48 +0000 | [diff] [blame] | 44 | .. option:: convert [--object OBJECTDEF] [--image-opts] [--target-image-opts] [--target-is-zero] [-U] [-C] [-c] [-p] [-q] [-n] [-f FMT] [-t CACHE] [-T SRC_CACHE] [-O OUTPUT_FMT] [-B BACKING_FILE] [-o OPTIONS] [-l SNAPSHOT_PARAM] [-S SPARSE_SIZE] [-m NUM_COROUTINES] [-W] [--salvage] FILENAME [FILENAME2 [...]] OUTPUT_FILENAME |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 45 | ERST |
Stuart Brady | 153859b | 2009-06-07 00:42:17 +0100 | [diff] [blame] | 46 | |
Eric Blake | 57b2d9d | 2017-08-03 11:33:50 -0500 | [diff] [blame] | 47 | DEF("create", img_create, |
John Snow | 65f389c | 2018-05-03 18:56:44 -0400 | [diff] [blame] | 48 | "create [--object objectdef] [-q] [-f fmt] [-b backing_file] [-F backing_fmt] [-u] [-o options] filename [size]") |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 49 | SRST |
| 50 | .. option:: create [--object OBJECTDEF] [-q] [-f FMT] [-b BACKING_FILE] [-F BACKING_FMT] [-u] [-o OPTIONS] FILENAME [SIZE] |
| 51 | ERST |
Eric Blake | 57b2d9d | 2017-08-03 11:33:50 -0500 | [diff] [blame] | 52 | |
Reda Sallahi | 86ce1f6 | 2016-08-10 04:43:12 +0200 | [diff] [blame] | 53 | DEF("dd", img_dd, |
Fam Zheng | a8d16f9 | 2017-05-03 00:35:40 +0800 | [diff] [blame] | 54 | "dd [--image-opts] [-U] [-f fmt] [-O output_fmt] [bs=block_size] [count=blocks] [skip=blocks] if=input of=output") |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 55 | SRST |
| 56 | .. option:: dd [--image-opts] [-U] [-f FMT] [-O OUTPUT_FMT] [bs=BLOCK_SIZE] [count=BLOCKS] [skip=BLOCKS] if=INPUT of=OUTPUT |
| 57 | ERST |
Reda Sallahi | 86ce1f6 | 2016-08-10 04:43:12 +0200 | [diff] [blame] | 58 | |
Stuart Brady | 153859b | 2009-06-07 00:42:17 +0100 | [diff] [blame] | 59 | DEF("info", img_info, |
Fam Zheng | a8d16f9 | 2017-05-03 00:35:40 +0800 | [diff] [blame] | 60 | "info [--object objectdef] [--image-opts] [-f fmt] [--output=ofmt] [--backing-chain] [-U] filename") |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 61 | SRST |
| 62 | .. option:: info [--object OBJECTDEF] [--image-opts] [-f FMT] [--output=OFMT] [--backing-chain] [-U] FILENAME |
| 63 | ERST |
Stuart Brady | 153859b | 2009-06-07 00:42:17 +0100 | [diff] [blame] | 64 | |
Paolo Bonzini | 4c93a13b | 2013-09-04 19:00:33 +0200 | [diff] [blame] | 65 | DEF("map", img_map, |
Fam Zheng | a8d16f9 | 2017-05-03 00:35:40 +0800 | [diff] [blame] | 66 | "map [--object objectdef] [--image-opts] [-f fmt] [--output=ofmt] [-U] filename") |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 67 | SRST |
| 68 | .. option:: map [--object OBJECTDEF] [--image-opts] [-f FMT] [--output=OFMT] [-U] FILENAME |
| 69 | ERST |
Paolo Bonzini | 4c93a13b | 2013-09-04 19:00:33 +0200 | [diff] [blame] | 70 | |
Stefan Hajnoczi | fd03c2b | 2017-07-05 13:57:36 +0100 | [diff] [blame] | 71 | DEF("measure", img_measure, |
| 72 | "measure [--output=ofmt] [-O output_fmt] [-o options] [--size N | [--object objectdef] [--image-opts] [-f fmt] [-l snapshot_param] filename]") |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 73 | SRST |
| 74 | .. option:: measure [--output=OFMT] [-O OUTPUT_FMT] [-o OPTIONS] [--size N | [--object OBJECTDEF] [--image-opts] [-f FMT] [-l SNAPSHOT_PARAM] FILENAME] |
| 75 | ERST |
Stefan Hajnoczi | fd03c2b | 2017-07-05 13:57:36 +0100 | [diff] [blame] | 76 | |
Stuart Brady | 153859b | 2009-06-07 00:42:17 +0100 | [diff] [blame] | 77 | DEF("snapshot", img_snapshot, |
Fam Zheng | a8d16f9 | 2017-05-03 00:35:40 +0800 | [diff] [blame] | 78 | "snapshot [--object objectdef] [--image-opts] [-U] [-q] [-l | -a snapshot | -c snapshot | -d snapshot] filename") |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 79 | SRST |
| 80 | .. option:: snapshot [--object OBJECTDEF] [--image-opts] [-U] [-q] [-l | -a SNAPSHOT | -c SNAPSHOT | -d SNAPSHOT] FILENAME |
| 81 | ERST |
Kevin Wolf | 3e85c6f | 2010-01-12 12:55:18 +0100 | [diff] [blame] | 82 | |
| 83 | DEF("rebase", img_rebase, |
Fam Zheng | a8d16f9 | 2017-05-03 00:35:40 +0800 | [diff] [blame] | 84 | "rebase [--object objectdef] [--image-opts] [-U] [-q] [-f fmt] [-t cache] [-T src_cache] [-p] [-u] -b backing_file [-F backing_fmt] filename") |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 85 | SRST |
| 86 | .. option:: rebase [--object OBJECTDEF] [--image-opts] [-U] [-q] [-f FMT] [-t CACHE] [-T SRC_CACHE] [-p] [-u] -b BACKING_FILE [-F BACKING_FMT] FILENAME |
| 87 | ERST |
Stefan Hajnoczi | ae6b0ed | 2010-04-24 09:12:12 +0100 | [diff] [blame] | 88 | |
| 89 | DEF("resize", img_resize, |
John Snow | 9775fcd | 2018-05-03 18:56:47 -0400 | [diff] [blame] | 90 | "resize [--object objectdef] [--image-opts] [-f fmt] [--preallocation=prealloc] [-q] [--shrink] filename [+ | -]size") |
Peter Maydell | 195b510 | 2020-01-24 16:26:02 +0000 | [diff] [blame] | 91 | SRST |
| 92 | .. option:: resize [--object OBJECTDEF] [--image-opts] [-f FMT] [--preallocation=PREALLOC] [-q] [--shrink] FILENAME [+ | -]SIZE |
| 93 | ERST |