summaryrefslogtreecommitdiffstats
path: root/fish/guestfish.pod
diff options
context:
space:
mode:
authorRichard Jones <rjones@redhat.com>2010-08-02 17:43:23 +0100
committerRichard Jones <rjones@redhat.com>2010-08-17 14:09:25 +0100
commit4440e22f4f7ebffe0728a8c019319d1a2b260cf5 (patch)
treeb7ef0f266e9c505a471e50b58d9faa7e3429b82c /fish/guestfish.pod
parent1a9aa565b38eafe48621bc2fe42d35ea6a907708 (diff)
downloadlibguestfs-4440e22f4f7ebffe0728a8c019319d1a2b260cf5.tar.gz
libguestfs-4440e22f4f7ebffe0728a8c019319d1a2b260cf5.tar.xz
libguestfs-4440e22f4f7ebffe0728a8c019319d1a2b260cf5.zip
fish: Reimplement -i option using new C-based inspection.
Don't shell out to virt-inspector. Instead, use the new C-based inspection APIs. This is much faster. The new syntax is slightly different: guestfish -a disk.img -i guestfish -d guest -i However, the old syntax still works.
Diffstat (limited to 'fish/guestfish.pod')
-rw-r--r--fish/guestfish.pod37
1 files changed, 19 insertions, 18 deletions
diff --git a/fish/guestfish.pod b/fish/guestfish.pod
index 8daebc87..cf1140a5 100644
--- a/fish/guestfish.pod
+++ b/fish/guestfish.pod
@@ -16,9 +16,9 @@ guestfish - the libguestfs Filesystem Interactive SHell
guestfish -d libvirt-domain
- guestfish -i libvirt-domain
+ guestfish -a disk.img -i
- guestfish -i disk.img [disk.img ...]
+ guestfish -d libvirt-domain -i
=head1 WARNING
@@ -75,13 +75,14 @@ Edit C</boot/grub/grub.conf> interactively:
--mount /dev/sda1:/boot \
edit /boot/grub/grub.conf
-=head2 Using virt-inspector
+=head2 Mount disks automatically
-Use the I<-i> option to get virt-inspector to mount
-the filesystems automatically as they would be mounted
-in the virtual machine:
+Use the I<-i> option to automatically mount the
+disks from a virtual machine:
- guestfish --ro -i disk.img cat /etc/group
+ guestfish --ro -a disk.img -i cat /etc/group
+
+ guestfish --ro -d libvirt-domain -i cat /etc/group
=head2 As a script interpreter
@@ -170,28 +171,28 @@ scripts, use:
=item B<-i> | B<--inspector>
-Run virt-inspector on the named libvirt domain or list of disk
-images. If virt-inspector is available and if it can identify
-the domain or disk images, then partitions will be mounted
-correctly at start-up.
+Using L<virt-inspector(1)> code, inspect the disks looking for
+an operating system and mount filesystems as they would be
+mounted on the real virtual machine.
Typical usage is either:
- guestfish -i myguest
+ guestfish -d myguest -i
(for an inactive libvirt domain called I<myguest>), or:
- guestfish --ro -i myguest
+ guestfish --ro -d myguest -i
(for active domains, readonly), or specify the block device directly:
- guestfish -i /dev/Guests/MyGuest
+ guestfish -a /dev/Guests/MyGuest -i
+
+Note that the command line syntax changed slightly over older
+versions of guestfish. You can still use the old syntax:
-You cannot use I<-a>, I<-m>, I<-N>, I<--listen>, I<--remote> or
-I<--selinux> in conjunction with this option, and options other than
-I<--ro> might not behave correctly.
+ guestfish [--ro] -i disk.img
-See also: L<virt-inspector(1)>.
+ guestfish [--ro] -i libvirt-domain
=item B<--keys-from-stdin>