diff options
author | Richard W.M. Jones <rjones@redhat.com> | 2010-10-21 23:05:26 +0100 |
---|---|---|
committer | Richard W.M. Jones <rjones@redhat.com> | 2010-10-22 17:45:06 +0100 |
commit | 0c1d3c02a8147617ee0646e37d011235abdd2c22 (patch) | |
tree | aa7a73c83c09065a00383431cc04052b74e73081 /fish/guestfish.pod | |
parent | 14490c3e1aac61c6ac90f28828896683f64f0dc9 (diff) | |
download | libguestfs-0c1d3c02a8147617ee0646e37d011235abdd2c22.tar.gz libguestfs-0c1d3c02a8147617ee0646e37d011235abdd2c22.tar.xz libguestfs-0c1d3c02a8147617ee0646e37d011235abdd2c22.zip |
fish: Specify format of disks (RHBZ#642934,CVE-2010-3851).
For libvirt guests, the disk format is copied from libvirt (if
libvirt knows it).
For command line disk images, you can use --format to override
format auto-detection.
Diffstat (limited to 'fish/guestfish.pod')
-rw-r--r-- | fish/guestfish.pod | 26 |
1 files changed, 26 insertions, 0 deletions
diff --git a/fish/guestfish.pod b/fish/guestfish.pod index c92953b6..4f4e1f0b 100644 --- a/fish/guestfish.pod +++ b/fish/guestfish.pod @@ -165,6 +165,9 @@ Displays detailed help on a single command C<cmd>. Add a block device or virtual machine image to the shell. +The format of the disk image is auto-detected. To override this and +force a particular format use the I<--format=..> option. + =item B<-c URI> | B<--connect URI> When used in conjunction with the I<-d> option, this specifies @@ -198,6 +201,29 @@ scripts, use: #!/usr/bin/guestfish -f +=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. + +For example: + + guestfish --format=raw -a disk.img + +forces raw format (no auto-detection) for C<disk.img>. + + guestfish --format=raw -a disk.img --format -a another.img + +forces raw format (no auto-detection) for C<disk.img> and reverts to +auto-detection for C<another.img>. + +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<-i> | B<--inspector> Using L<virt-inspector(1)> code, inspect the disks looking for |