sparsify: Add -o option for passing qemu-img output format options.

[libguestfs.git] / sparsify / virt-sparsify.pod

diff --git a/sparsify/virt-sparsify.pod b/sparsify/virt-sparsify.pod
index d25f013..6653787 100644 (file)
--- a/sparsify/virt-sparsify.pod
+++ b/sparsify/virt-sparsify.pod
@@ -126,7 +126,7 @@ eg. C<vmdk>, but support for other formats is reliant on qemu.
 Specifying the I<--convert> option is usually a good idea, because
 then virt-sparsify doesn't need to try to guess the input format.
 
-For fine-tuning the output format, see: I<--compress>.
+For fine-tuning the output format, see: I<--compress>, I<-o>.
 
 =item B<--format> raw
 
@@ -156,6 +156,18 @@ This option is used to make the output more machine friendly
 when being parsed by other programs.  See
 L</MACHINE READABLE OUTPUT> below.
 
+=item B<-o> option[,option,...]
+
+Pass I<-o> option(s) to the L<qemu-img(1)> command to fine-tune the
+output format.  Options available depend on the output format (see
+I<--convert>) and the installed version of the qemu-img program.
+
+You should use I<-o> at most once.  To pass multiple options, separate
+them with commas, eg:
+
+ virt-sparsify --convert qcow2 \
+   -o cluster_size=512,preallocation=metadata ...
+
 =item B<-q>
 
 =item B<--quiet>