X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=fuse%2Fguestmount.pod;h=fe19a07d82c817cf3c34a9ab660a15f113ba70ba;hb=247324a4b3d9bf4782e18a629463a808d361fada;hp=263959e7158294a0f907e7ea2182b4380416e718;hpb=429de2254176e470035eef05e0f3e9910d46863c;p=libguestfs.git

diff --git a/fuse/guestmount.pod b/fuse/guestmount.pod
index 263959e..fe19a07 100644
--- a/fuse/guestmount.pod
+++ b/fuse/guestmount.pod
@@ -23,7 +23,7 @@ userspace") to make it appear as a mountable device.
 Along with other options, you have to give at least one device (I<-a>
 option) and at least one mountpoint (I<-m> option).  How this works is
 better explained in the L<guestfish(1)> manual page, or you can use
-L<virt-inspector(1)> and/or the the wrapper script
+L<virt-inspector(1)> and/or the wrapper script
 C<guestmount-wrapper> to help you.
 
 FUSE lets you mount filesystems as non-root.  The mountpoint must be
@@ -53,6 +53,11 @@ mountpoints for you:
 option is called I<--ro-fish> or I<--fish> because these parameters
 are compatible with L<guestfish(1)>.
 
+If you don't know what filesystems are contained in a guest or
+disk image, use L<virt-list-filesystems(1)> first:
+
+ virt-list-filesystems MyGuest
+
 If you want to trace the libguestfs calls but without excessive
 debugging, we recommend:
 
@@ -70,6 +75,9 @@ If you want to debug the program, we recommend:
 
 Add a block device or virtual machine image.
 
+The format of the disk image is auto-detected.  To override this and
+force a particular format use the I<--format=..> option.
+
 =item B<--dir-cache-timeout N>
 
 Set the readdir cache timeout to I<N> seconds, the default being 60
@@ -82,6 +90,18 @@ There is also a different attribute cache implemented by FUSE
 (see the FUSE option I<-o attr_timeout>), but the FUSE cache
 does not anticipate future requests, only cache existing ones.
 
+=item B<--format=raw|qcow2|..> | B<--format>
+
+The default for the I<-a> option is to auto-detect the format of the
+disk image.  Using this forces the disk format for I<-a> options which
+follow on the command line.  Using I<--format> with no argument
+switches back to auto-detection for subsequent I<-a> options.
+
+If you have untrusted raw-format guest disk images, you should use
+this option to specify the disk format.  This avoids a possible
+security problem with malicious guests (CVE-2010-3851).  See also
+L</add-drive-opts>.
+
 =item B<--fuse-help>
 
 Display help on special FUSE options (see I<-o> below).