summaryrefslogtreecommitdiffstats
path: root/guestfish.pod
diff options
context:
space:
mode:
authorRichard W.M. Jones <rjones@redhat.com>2009-06-24 11:54:48 +0100
committerRichard W.M. Jones <rjones@redhat.com>2009-06-24 11:54:48 +0100
commite1c62f6332ae07cb6f95130dcc9852701d085e2b (patch)
treea6ec72d4fdcf78259b63c2cec2afe9a9812ad2e2 /guestfish.pod
parent46551d9c51193a4bca2e1b249b8c5f111e1dc7b5 (diff)
downloadlibguestfs-e1c62f6332ae07cb6f95130dcc9852701d085e2b.tar.gz
libguestfs-e1c62f6332ae07cb6f95130dcc9852701d085e2b.tar.xz
libguestfs-e1c62f6332ae07cb6f95130dcc9852701d085e2b.zip
Added guestfish -i option to run virt-inspector.
You can invoke guestfish with: guestfish -i libvirt-domain guestfish -i disk-image(s)
Diffstat (limited to 'guestfish.pod')
-rw-r--r--guestfish.pod28
1 files changed, 28 insertions, 0 deletions
diff --git a/guestfish.pod b/guestfish.pod
index 2d39cbf4..56d941f8 100644
--- a/guestfish.pod
+++ b/guestfish.pod
@@ -8,6 +8,10 @@ guestfish - the libguestfs filesystem interactive shell
guestfish [--options] [commands]
+ guestfish -i libvirt-domain
+
+ guestfish -i disk-image(s)
+
=head1 EXAMPLES
=head2 From shell scripts
@@ -95,6 +99,30 @@ scripts, use:
#!/usr/bin/guestfish -f
+=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.
+
+Typical usage is either:
+
+ guestfish -i myguest
+
+(for an inactive libvirt domain called I<myguest>), or:
+
+ guestfish --ro -i myguest
+
+(for active domains, readonly), or specify the block device directly:
+
+ guestfish -i /dev/Guests/MyGuest
+
+You cannot use I<-a> or I<-m> in conjunction with this option, and
+options other than I<--ro> might not behave correctly.
+
+See also: L<virt-inspector(1)>.
+
=item B<-m dev[:mountpoint]> | B<--mount dev[:mountpoint]>
Mount the named partition or logical volume on the given mountpoint.