X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=fuse%2Fguestmount.pod;h=e86d76c79a45a0626a8f7f00c3ec71c93d3029cc;hp=fe19a07d82c817cf3c34a9ab660a15f113ba70ba;hb=fab75c0337d7897d10ea5e95e47ac05eab81ace9;hpb=6ecaa6371a340d30c2f818500b377963cf5afdee diff --git a/fuse/guestmount.pod b/fuse/guestmount.pod index fe19a07..e86d76c 100644 --- a/fuse/guestmount.pod +++ b/fuse/guestmount.pod @@ -8,6 +8,10 @@ guestmount - Mount a guest filesystem on the host using FUSE and libguestfs guestmount [--options] -a disk.img -m device [--ro] mountpoint + guestmount [--options] -a disk.img -i [--ro] mountpoint + + guestmount [--options] -d Guest -i [--ro] mountpoint + =head1 WARNING You must I use C in read-write mode on live virtual @@ -21,10 +25,10 @@ access to the guest filesystem, and FUSE (the "filesystem in 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 manual page, or you can use -L and/or the wrapper script -C to help you. +option) or libvirt domain (I<-d> option), and at least one mountpoint +(I<-m> option) or use the I<-i> inspection option. How this works is +better explained in the L manual page, or by looking at +the examples below. FUSE lets you mount filesystems as non-root. The mountpoint must be owned by you, and the filesystem will not be visible to any other @@ -44,14 +48,13 @@ partition, and the root filesystem on a logical volume: guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt -To get L to do the hard work of detecting guest -mountpoints for you: +To get libguestfs to detect guest mountpoints for you: + + guestmount -a guest.img -i --ro /mnt - guestmount $(virt-inspector --ro-fish MyGuest) /mnt +For a libvirt guest called "Guest" you could do: -(or use --fish if you don't want it to be a read only mount). The -option is called I<--ro-fish> or I<--fish> because these parameters -are compatible with L. + guestmount -d Guest -i --ro /mnt If you don't know what filesystems are contained in a guest or disk image, use L first: @@ -59,13 +62,13 @@ disk image, use L first: virt-list-filesystems MyGuest If you want to trace the libguestfs calls but without excessive -debugging, we recommend: +debugging information, we recommend: - guestmount [-a ... -m ...] --trace /mnt + guestmount [...] --trace /mnt If you want to debug the program, we recommend: - guestmount [-a ... -m ...] --trace --verbose /mnt + guestmount [...] --trace --verbose /mnt =head1 OPTIONS @@ -78,6 +81,18 @@ 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<-c URI> | B<--connect URI> + +When used in conjunction with the I<-d> option, this specifies +the libvirt URI to use. The default is to use the default libvirt +connection. + +=item B<-d libvirt-domain> | B<--domain libvirt-domain> + +Add disks from the named libvirt domain. If the I<--ro> option is +also used, then any libvirt domain can be used. However in write +mode, only libvirt domains which are shut down can be named here. + =item B<--dir-cache-timeout N> Set the readdir cache timeout to I seconds, the default being 60 @@ -90,6 +105,13 @@ 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<--echo-keys> + +When prompting for keys and passphrases, guestfish normally turns +echoing off so you cannot see what you are typing. If you are not +worried about Tempest attacks and there is no one else in the room +you can specify this flag to see what you are typing. + =item B<--format=raw|qcow2|..> | B<--format> The default for the I<-a> option is to auto-detect the format of the @@ -100,7 +122,7 @@ 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. +L. =item B<--fuse-help> @@ -110,6 +132,17 @@ Display help on special FUSE options (see I<-o> below). Display brief help and exit. +=item B<-i> | B<--inspector> + +Using L code, inspect the disks looking for +an operating system and mount filesystems as they would be +mounted on the real virtual machine. + +=item B<--keys-from-stdin> + +Read key or passphrase parameters from stdin. The default is +to try to read passphrases from the user by opening C. + =item B<-m dev[:mnt]> | B<--mount dev[:mnt]> Mount the named partition or logical volume on the given mountpoint @@ -170,16 +203,12 @@ disk. If the guest is running and this option is I supplied, then there is a strong risk of disk corruption in the guest. We try to prevent this from happening, but it is not always possible. +See also L. + =item B<--selinux> Enable SELinux support for the guest. -=item B<--trace> - -Trace libguestfs calls (to stderr). - -This also stops the daemon from forking into the background. - =item B<-v> | B<--verbose> Enable verbose messages from underlying libguestfs. @@ -188,6 +217,17 @@ Enable verbose messages from underlying libguestfs. Display the program version and exit. +=item B<-w> | B<--rw> + +This option does nothing at the moment. +See L. + +=item B<-x> | B<--trace> + +Trace libguestfs calls. + +This also stops the daemon from forking into the background. + =back =head1 SEE ALSO @@ -207,7 +247,7 @@ Richard W.M. Jones (C) =head1 COPYRIGHT -Copyright (C) 2009 Red Hat Inc. +Copyright (C) 2009-2010 Red Hat Inc. L This program is free software; you can redistribute it and/or modify