guestmount(1) Virtualization Support guestmount(1) (NAME) guestmount - FUSE libguestfs (SYNOPSIS) guestmount [--options] -a disk.img -m device [--ro] mountpoint guestmount [--options] -a disk.img -i [--ro] mountpoint guestmount [--options] -d Guest -i [--ro] mountpoint (WARNING) "guestmount" . . --ro () "guestmount" . . (DESCRIPTION) guestmount . libguestfs FUSE ( ) . ( -a) libvirt ( -d) ( -m) -i . guestfish(1) . FUSE (non-root) . . <<>> . guestunmount(1) . (EXAMPLES) : guestmount -a windows.img -m /dev/sda1 --ro /mnt /boot (LVM) : guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt libguestfs : guestmount -a guest.img -i --ro /mnt libvirt "Guest" : guestmount -d Guest -i --ro /mnt virt-filesystems(1) : virt-filesystems -d MyGuest libguestfs : guestmount [...] --trace /mnt : guestmount [...] --trace --verbose /mnt : guestunmount /mnt (NOTES) ( root) . FUSE "allow_other" : sudo guestmount [...] -o allow_other /mnt /etc/fuse.conf. FUSE FUSE ( "fuse") . . . Red Hat Enterprise Linux . fusermount: "Device or resource busy" . <<>> (indexing) . "fusermount -u" ( guestunmount(1) ). . (mount namespace) "CLONE_NEWNS" clone(2)/unshare(2) . guestmount . guestunmount(1)/fusermount(1) guestmount . . (race condition) : guestmount -a disk.img -i /mnt # /mnt guestunmount /mnt # 'disk.img' ** ** --pid-file (PID) guestmount guestunmount PID . guestmount -a disk.img -i --pid-file guestmount.pid /mnt # ... # ... # guestmount ** guestunmount. pid="$(cat guestmount.pid)" # . guestunmount /mnt timeout=10 count=$timeout while kill -0 "$pid" 2>/dev/null && [ $count -gt 0 ]; do sleep 1 ((count--)) done if [ $count -eq 0 ]; then echo "$0: wait for guestmount to exit failed after $timeout seconds" exit 1 fi # . "guestfs_mount_local" ( "MOUNT LOCAL" guestfs(3) ) . (OPTIONS) -a IMAGE --add IMAGE . . --format=.. . -a URI --add URI . "ADDING REMOTE STORAGE" guestfish(1) . --blocksize=512 --blocksize=4096 --blocksize . . --blocksize . "guestfs_add_drive_opts" guestfs(3) . -c URI --connect URI -d (URI) libvirt . libvirt . -d LIBVIRT-DOMAIN --domain LIBVIRT-DOMAIN libvirt. --ro libvirt . libvirt . UUID . --dir-cache-timeout N () readdir N . readdir [ ] readdir(2) stat . FUSE ( FUSE -o attr_timeout ) FUSE . --echo-keys guestfish . (Tempest) . --fd=FD eventfd. guestmount . --no-fork guestmount . --format=raw|qcow2|.. --format -a . -a . --format -a . (raw) . (CVE-2010-3851). "guestfs_add_drive_opts" guestfs(3) . --fuse-help FUSE ( -o ). --help . -i --inspector virt-inspector(1) . --key SELECTOR LUKS LUKS . --key NAME:key:KEY_STRING --key UUID:key:KEY_STRING --key all:key:KEY_STRING "NAME" libguestfs ( "/dev/sda1"). "UUID" (UUID) . "all" . "KEY_STRING" . --key NAME:file:FILENAME --key UUID:file:FILENAME --key all:file:FILENAME FILENAME. --key NAME:clevis --key UUID:clevis --key all:clevis Clevis . (NBDE) "ENCRYPTED DISKS" guestfs(3) . QEMU libguestfs . --keys-from-stdin (stdin). /dev/tty . . -m dev[:mountpoint[:options[:fstype]] --mount dev[:mountpoint[:options[:fstype]]] ( ). / . / . ( ) mount . "ro" ( --ro ). . ACL : -m /dev/sda1:/:acl,user_xattr "ext3" "ntfs". (: "ext2" "ext3") libguestfs . --no-fork ( ). -n --no-sync FUSE (sync) . . autosync guestfs(3) . -o OPTION --option OPTION FUSE. FUSE . -o FUSE . guestmount --fuse-help FUSE: -o allow_other . /etc/fuse.conf . -o attr_timeout=N FUSE N . -o kernel_cache ( guestfs(3) ). . -o uid=N -o gid=N UID GID . -o use_ino (inode) . FUSE . stat(2) "ls -i" . FUSE . . --pid-file FILENAME (PID) guestmount "filename". -r --ro . FUSE . . . . "OPENING DISKS FOR READ AND WRITE" guestfish(1) . --selinux . -v --verbose libguestfs . -V --version . -w --rw -a -d -m - . "OPENING DISKS FOR READ AND WRITE" guestfish(1) . -x --trace libguestfs FUSE. ( --no-fork ). (FILES) $XDG_CONFIG_HOME/libguestfs/libguestfs-tools.conf $HOME/.libguestfs-tools.rc $XDG_CONFIG_DIRS/libguestfs/libguestfs-tools.conf /etc/libguestfs-tools.conf - (--ro --rw). libguestfs-tools.conf(5) . (EXIT STATUS) 0 . (SEE ALSO) guestunmount(1), fusermount(1), guestfish(1), virt-inspector(1), virt-cat(1), virt-edit(1), virt-tar(1), libguestfs-tools.conf(5), "MOUNT LOCAL" in guestfs(3), http://libguestfs.org, http://fuse.sf.net (AUTHORS) Richard W.M. Jones ("rjones at redhat dot com") (COPYRIGHT) Copyright (C) 2009-2025 Red Hat Inc. (LICENSE) (GNU General Public License) ( ) . . . : Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. (BUGS) libguestfs : https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools libguestfs : https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools : o libguestfs. o libguestfs ( ). o . o libguestfs-test-tool(1) . libguestfs-1.60.1 2026-07-14 guestmount(1)