1 HXCOMM Keep the list of subcommands sorted by name
.
2 HXCOMM Use
DEFHEADING() to define headings
in both help text and texi
3 HXCOMM Text between STEXI and ETEXI are copied to texi version and
4 HXCOMM discarded from C version
5 HXCOMM
DEF(command
, callback, arg_string
) is used to construct
6 HXCOMM command structures and help message
.
7 HXCOMM HXCOMM can be used
for comments
, discarded from both texi and C
13 DEF("amend", img_amend
,
14 "amend [--object objectdef] [--image-opts] [-p] [-q] [-f fmt] [-t cache] -o options filename")
16 @item amend
[--object @
var{objectdef
}] [--image
-opts
] [-p
] [-q
] [-f @
var{fmt
}] [-t @
var{cache
}] -o @
var{options
} @
var{filename
}
19 DEF("bench", img_bench
,
20 "bench [-c count] [-d depth] [-f fmt] [--flush-interval=flush_interval] [-n] [--no-drain] [-o offset] [--pattern=pattern] [-q] [-s buffer_size] [-S step_size] [-t cache] [-w] [-U] filename")
22 @item bench
[-c @
var{count
}] [-d @
var{depth
}] [-f @
var{fmt
}] [--flush
-interval
=@
var{flush_interval
}] [-n
] [--no
-drain
] [-o @
var{offset
}] [--pattern
=@
var{pattern
}] [-q
] [-s @
var{buffer_size
}] [-S @
var{step_size
}] [-t @
var{cache
}] [-w
] [-U
] @
var{filename
}
25 DEF("check", img_check
,
26 "check [--object objectdef] [--image-opts] [-q] [-f fmt] [--output=ofmt] [-r [leaks | all]] [-T src_cache] [-U] filename")
28 @item check
[--object @
var{objectdef
}] [--image
-opts
] [-q
] [-f @
var{fmt
}] [--output
=@
var{ofmt
}] [-r
[leaks | all
]] [-T @
var{src_cache
}] [-U
] @
var{filename
}
31 DEF("commit", img_commit
,
32 "commit [--object objectdef] [--image-opts] [-q] [-f fmt] [-t cache] [-b base] [-d] [-p] filename")
34 @item commit
[--object @
var{objectdef
}] [--image
-opts
] [-q
] [-f @
var{fmt
}] [-t @
var{cache
}] [-b @
var{base
}] [-d
] [-p
] @
var{filename
}
37 DEF("compare", img_compare
,
38 "compare [--object objectdef] [--image-opts] [-f fmt] [-F fmt] [-T src_cache] [-p] [-q] [-s] [-U] filename1 filename2")
40 @item compare
[--object @
var{objectdef
}] [--image
-opts
] [-f @
var{fmt
}] [-F @
var{fmt
}] [-T @
var{src_cache
}] [-p
] [-q
] [-s
] [-U
] @
var{filename1
} @
var{filename2
}
43 DEF("convert", img_convert
,
44 "convert [--object objectdef] [--image-opts] [--target-image-opts] [-U] [-c] [-p] [-q] [-n] [-f fmt] [-t cache] [-T src_cache] [-O output_fmt] [-B backing_file] [-o options] [-s snapshot_id_or_name] [-l snapshot_param] [-S sparse_size] [-m num_coroutines] [-W] filename [filename2 [...]] output_filename")
46 @item convert
[--object @
var{objectdef
}] [--image
-opts
] [--target
-image
-opts
] [-U
] [-c
] [-p
] [-q
] [-n
] [-f @
var{fmt
}] [-t @
var{cache
}] [-T @
var{src_cache
}] [-O @
var{output_fmt
}] [-B @
var{backing_file
}] [-o @
var{options
}] [-s @
var{snapshot_id_or_name
}] [-l @
var{snapshot_param
}] [-S @
var{sparse_size
}] [-m @
var{num_coroutines
}] [-W
] @
var{filename
} [@
var{filename2
} [...]] @
var{output_filename
}
49 DEF("create", img_create
,
50 "create [--object objectdef] [-q] [-f fmt] [-b backing_file] [-F backing_fmt] [-u] [-o options] filename [size]")
52 @item create
[--object @
var{objectdef
}] [-q
] [-f @
var{fmt
}] [-b @
var{backing_file
}] [-F @
var{backing_fmt
}] [-u
] [-o @
var{options
}] @
var{filename
} [@
var{size
}]
56 "dd [--image-opts] [-U] [-f fmt] [-O output_fmt] [bs=block_size] [count=blocks] [skip=blocks] if=input of=output")
58 @item dd
[--image
-opts
] [-U
] [-f @
var{fmt
}] [-O @
var{output_fmt
}] [bs
=@
var{block_size
}] [count
=@
var{blocks
}] [skip
=@
var{blocks
}] if=@
var{input
} of
=@
var{output
}
62 "info [--object objectdef] [--image-opts] [-f fmt] [--output=ofmt] [--backing-chain] [-U] filename")
64 @item info
[--object @
var{objectdef
}] [--image
-opts
] [-f @
var{fmt
}] [--output
=@
var{ofmt
}] [--backing
-chain
] [-U
] @
var{filename
}
68 "map [--object objectdef] [--image-opts] [-f fmt] [--output=ofmt] [-U] filename")
70 @item map
[--object @
var{objectdef
}] [--image
-opts
] [-f @
var{fmt
}] [--output
=@
var{ofmt
}] [-U
] @
var{filename
}
73 DEF("measure", img_measure
,
74 "measure [--output=ofmt] [-O output_fmt] [-o options] [--size N | [--object objectdef] [--image-opts] [-f fmt] [-l snapshot_param] filename]")
76 @item measure
[--output
=@
var{ofmt
}] [-O @
var{output_fmt
}] [-o @
var{options
}] [--size @
var{N
} |
[--object @
var{objectdef
}] [--image
-opts
] [-f @
var{fmt
}] [-l @
var{snapshot_param
}] @
var{filename
}]
79 DEF("snapshot", img_snapshot
,
80 "snapshot [--object objectdef] [--image-opts] [-U] [-q] [-l | -a snapshot | -c snapshot | -d snapshot] filename")
82 @item snapshot
[--object @
var{objectdef
}] [--image
-opts
] [-U
] [-q
] [-l |
-a @
var{snapshot
} |
-c @
var{snapshot
} |
-d @
var{snapshot
}] @
var{filename
}
85 DEF("rebase", img_rebase
,
86 "rebase [--object objectdef] [--image-opts] [-U] [-q] [-f fmt] [-t cache] [-T src_cache] [-p] [-u] -b backing_file [-F backing_fmt] filename")
88 @item rebase
[--object @
var{objectdef
}] [--image
-opts
] [-U
] [-q
] [-f @
var{fmt
}] [-t @
var{cache
}] [-T @
var{src_cache
}] [-p
] [-u
] -b @
var{backing_file
} [-F @
var{backing_fmt
}] @
var{filename
}
91 DEF("resize", img_resize
,
92 "resize [--object objectdef] [--image-opts] [-f fmt] [--preallocation=prealloc] [-q] [--shrink] filename [+ | -]size")
94 @item resize
[--object @
var{objectdef
}] [--image
-opts
] [-f @
var{fmt
}] [--preallocation
=@
var{prealloc
}] [-q
] [--shrink
] @
var{filename
} [+ |
-]@
var{size
}