2. libguestfs
3. libguestfs-master
4. English (United Kingdom)
5. Translate

%s: liguest filesystems, partitions, block devices, LVM in a VM shell
%s lets you edit virtual machine filesystems
Copyright (C) 20109-2025 Red Hat Inc.
Usage:
%s [--options] -d domname
%s [--options] -a disk.img [-a disk.imgcmd [: cmd : cmd ...]
Options:
-a|--add image Add image
--all h|--cmd-help List available commands
-h|--cmd-help cmd Display everything
--blkdevs|--block-devices
Display block devicesdetailed help on ‘cmd’
-a|--add image Add image
--blocksize[=512|4096]
Set sector size of the disk for -a option
-c|--connect uri Specify libvirt URI for -d option
--csvh Output as Comma-Separated ValuesMake --listen csh-compatible
-d|--domain guest Add disks from libvirt guest
--echo-keys Don'’t turn off echo for passphrases
--extra Display swap and data filesystems
--filesystems Display mountable filesystems
--format[=raw|..] Force disk format for -a option
-h|--human-readable Human-readable sizes in --long output
--help Display brief helpf|--file file Read commands from file
--format[=raw|..] Force disk format for -a option
--help Display brief help
-i|--inspector Automatically mount filesystems
--key selector Specify a LUKS key
--keys-from-stdin Read passphrases from stdin
-l|--long-listen Long output
--lvs|--logvols|--logical-volumes
Display LVM logical volumes
--no-title No title in --long output
--parts|--partitions Display partitions
--pvs|--physvols|--physical-volumes
Display LVM physical volumes
--uuid|--uuids Add UUIDs to --long output
-v|--verbose Verbose messages
-V|--version Display version and exit
--vgs|--volgroups|--volume-groups
Display LVM volume groups
-x Trace libguestfs API callsisten for remote commands
-m|--mount dev[:mnt[:opts[:fstype]]]
Mount dev on mnt (if omitted, /)
--network Enable network
-N|--new [filename=]type
Create prepared disk (test<N>.img or filename)
-n|--no-sync Don’t autosync
--no-dest-paths Don’t tab-complete paths from guest fs
--pipe-error Pipe commands can detect write errors
--progress-bars Enable progress bars even when not interactive
--no-progress-bars Disable progress bars
--remote[=pid] Send commands to remote %s
-r|--ro Mount read-only
--selinux For backwards compat only, does nothing
-v|--verbose Verbose messages
-V|--version Display version and exit
-w|--rw Mount read-write
-x Echo each command before executing it

To examine a disk image, ISO, hard disk, filesystem etc:
%s [--ro|--rw] -i -a /path/to/disk.img
or
%s [--ro|--rw] -i -d name-of-libvirt-domain

‘--ro’ is recommended to avoid any writes to the disk image.

If ‘-i’ option fails run again without ‘-i’ and use ‘run’ +
‘list-filesystems’ + ‘mount’ cmds.

For more information, see the manpage %s(1).