---
name: "grub-emu"
section: "1"
platform: "linux"
package: "grub-emu"
version: "2.12-9+deb13u2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/grub-emu"
---

# grub-emu(1)

GRUB emulator

## NAME

grub-emu - GRUB emulator

## SYNOPSIS

**grub-emu** \[*OPTION*...\]

## DESCRIPTION

GRUB emulator.

- **-d**, **--directory**=*DIR*

  use GRUB files in the directory DIR \[default=/boot/grub\]

- **-H**, **--hold**\[=*SECS*\]

  wait until a debugger will attach

- **--memdisk**=*FILE*

  use FILE as memdisk

- **-m**, **--device-map**=*FILE*

  use FILE as the device map \[default=/boot/grub/device.map\]

- **-r**, **--root**=*DEVICE\_NAME*

  Set root device.

- **-v**, **--verbose**

  print verbose messages.

- **-X**, **--kexec**

  use kexec to boot Linux kernels via systemctl (pass twice to enable dangerous fallback to non-systemctl).

- \-?, **--help**

  give this help list

- **--usage**

  give a short usage message

- **-V**, **--version**

  print program version

Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options.

## REPORTING BUGS

Report bugs to \<bug-grub@gnu.org\>.

## SEE ALSO

If you are trying to install GRUB, then you should use [**grub-install**(8)](/grub-install/8.md) rather than this program.

The full documentation for **grub-emu** is maintained as a Texinfo manual.  If the **info** and **grub-emu** programs are properly installed at your site, the command

-

  **info grub-emu**

should give you access to the complete manual.