1guestmount(1)               Virtualization Support               guestmount(1)
2
3
4

NAME

6       guestmount - Mount a guest filesystem on the host using FUSE and
7       libguestfs
8

SYNOPSIS

10        guestmount [--options] -a disk.img -m device [--ro] mountpoint
11
12        guestmount [--options] -a disk.img -i [--ro] mountpoint
13
14        guestmount [--options] -d Guest -i [--ro] mountpoint
15

WARNING

17       Using "guestmount" in write mode on live virtual machines, or
18       concurrently with other disk editing tools, can be dangerous,
19       potentially causing disk corruption.  The virtual machine must be shut
20       down before you use this command, and disk images must not be edited
21       concurrently.
22
23       Use the --ro (read-only) option to use "guestmount" safely if the disk
24       image or virtual machine might be live.  You may see strange or
25       inconsistent results if running concurrently with other changes, but
26       with this option you won't risk disk corruption.
27

DESCRIPTION

29       The guestmount program can be used to mount virtual machine filesystems
30       and other disk images on the host.  It uses libguestfs for access to
31       the guest filesystem, and FUSE (the "filesystem in userspace") to make
32       it appear as a mountable device.
33
34       Along with other options, you have to give at least one device (-a
35       option) or libvirt domain (-d option), and at least one mountpoint (-m
36       option) or use the -i inspection option or the --live option.  How this
37       works is better explained in the guestfish(1) manual page, or by
38       looking at the examples below.
39
40       FUSE lets you mount filesystems as non-root.  The mountpoint must be
41       owned by you.  The filesystem will not be visible to any other users
42       unless you make configuration changes, see "NOTES" below.
43
44       To unmount the filesystem, use the guestunmount(1) command.
45

EXAMPLES

47       For a typical Windows guest which has its main filesystem on the first
48       partition:
49
50        guestmount -a windows.img -m /dev/sda1 --ro /mnt
51
52       For a typical Linux guest which has a /boot filesystem on the first
53       partition, and the root filesystem on a logical volume:
54
55        guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt
56
57       To get libguestfs to detect guest mountpoints for you:
58
59        guestmount -a guest.img -i --ro /mnt
60
61       For a libvirt guest called "Guest" you could do:
62
63        guestmount -d Guest -i --ro /mnt
64
65       If you don’t know what filesystems are contained in a guest or disk
66       image, use virt-filesystems(1) first:
67
68        virt-filesystems -d MyGuest
69
70       If you want to trace the libguestfs calls but without excessive
71       debugging information, we recommend:
72
73        guestmount [...] --trace /mnt
74
75       If you want to debug the program, we recommend:
76
77        guestmount [...] --trace --verbose /mnt
78
79       To unmount the filesystem after using it:
80
81        guestunmount /mnt
82

NOTES

84   Other users cannot see the filesystem by defaul