1 HXCOMM Use
DEFHEADING() to define headings
in both help text and texi
2 HXCOMM Text between STEXI and ETEXI are copied to texi version and
3 HXCOMM discarded from C version
4 HXCOMM
DEF(command
, callback, arg_string
) is used to construct
5 HXCOMM command structures and help message
.
6 HXCOMM HXCOMM can be used
for comments
, discarded from both texi and C
12 DEF("bench", img_bench
,
13 "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")
15 @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
}
18 DEF("check", img_check
,
19 "check [-q] [--object objectdef] [--image-opts] [-f fmt] [--output=ofmt] [-r [leaks | all]] [-T src_cache] [-U] filename")
21 @item check
[--object @
var{objectdef
}] [--image
-opts
] [-q
] [-f @
var{fmt
}] [--output
=@
var{ofmt
}] [-r
[leaks | all
]] [-T @
var{src_cache
}] [-U
] @
var{filename
}
24 DEF("create", img_create
,
25 "create [-q] [--object objectdef] [-f fmt] [-b backing_file] [-F backing_fmt] [-u] [-o options] filename [size]")
27 @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
}]
30 DEF("commit", img_commit
,
31 "commit [-q] [--object objectdef] [--image-opts] [-f fmt] [-t cache] [-b base] [-d] [-p] filename")
33 @item commit
[--object @
var{objectdef
}] [--image
-opts
] [-q
] [-f @
var{fmt
}] [-t @
var{cache
}] [-b @
var{base
}] [-d
] [-p
] @
var{filename
}
36 DEF("compare", img_compare
,
37 "compare [--object objectdef] [--image-opts] [-f fmt] [-F fmt] [-T src_cache] [-p] [-q] [-s] [-U] filename1 filename2")
39 @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
}
42 DEF("convert", img_convert
,
43 "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")
45 @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 "dd [--image-opts] [-U] [-f fmt] [-O output_fmt] [bs=block_size] [count=blocks] [skip=blocks] if=input of=output")
51 @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
}
55 "info [--object objectdef] [--image-opts] [-f fmt] [--output=ofmt] [--backing-chain] [-U] filename")
57 @item info
[--object @
var{objectdef
}] [--image
-opts
] [-f @
var{fmt
}] [--output
=@
var{ofmt
}] [--backing
-chain
] [-U
] @
var{filename
}
61 "map [--object objectdef] [--image-opts] [-f fmt] [--output=ofmt] [-U] filename")
63 @item map
[--object @
var{objectdef
}] [--image
-opts
] [-f @
var{fmt
}] [--output
=@
var{ofmt
}] [-U
] @
var{filename
}
66 DEF("measure", img_measure
,
67 "measure [--output=ofmt] [-O output_fmt] [-o options] [--size N | [--object objectdef] [--image-opts] [-f fmt] [-l snapshot_param] filename]")
69 @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
}]
72 DEF("snapshot", img_snapshot
,
73 "snapshot [--object objectdef] [--image-opts] [-U] [-q] [-l | -a snapshot | -c snapshot | -d snapshot] filename")
75 @item snapshot
[--object @
var{objectdef
}] [--image
-opts
] [-U
] [-q
] [-l |
-a @
var{snapshot
} |
-c @
var{snapshot
} |
-d @
var{snapshot
}] @
var{filename
}
78 DEF("rebase", img_rebase
,
79 "rebase [--object objectdef] [--image-opts] [-U] [-q] [-f fmt] [-t cache] [-T src_cache] [-p] [-u] -b backing_file [-F backing_fmt] filename")
81 @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
}
84 DEF("resize", img_resize
,
85 "resize [--object objectdef] [--image-opts] [-q] filename [+ | -]size")
87 @item resize
[--object @
var{objectdef
}] [--image
-opts
] [-q
] @
var{filename
} [+ |
-]@
var{size
}
90 DEF("amend", img_amend
,
91 "amend [--object objectdef] [--image-opts] [-p] [-q] [-f fmt] [-t cache] -o options filename")
93 @item amend
[--object @
var{objectdef
}] [--image
-opts
] [-p
] [-q
] [-f @
var{fmt
}] [-t @
var{cache
}] -o @
var{options
} @
var{filename
}