Next: , Previous: , Up: User-space utilities   [Contents][Index]

24.6 Invoking grub-mount

The program grub-mount performs a read-only mount of any file system or file system image that GRUB understands, using GRUB’s file system drivers via FUSE. (It is only available if FUSE development files were present when GRUB was built.) This has a number of uses:

Using grub-mount is normally as simple as:

grub-mount /dev/sda1 /mnt

grub-mount must be given one or more images and a mount point as non-option arguments (if it is given more than one image, it will treat them as a RAID set), and also accepts the following options:


Print a summary of the command-line options and exit.


Print the version number of GRUB and exit.


Mount encrypted devices, prompting for a passphrase if necessary.

-d string

Show debugging output for conditions matching string.

-K prompt|file

Load a ZFS encryption key. If you use ‘prompt’ as the argument, grub-mount will read a passphrase from the terminal; otherwise, it will read key material from the specified file.

-r device

Set the GRUB root device to device. You do not normally need to set this; grub-mount will automatically set the root device to the root of the supplied file system.

If device is just a number, then it will be treated as a partition number within the supplied image. This means that, if you have an image of an entire disk in disk.img, then you can use this command to mount its second partition:

grub-mount -r 2 disk.img mount-point

Print verbose messages.

Next: , Previous: , Up: User-space utilities   [Contents][Index]