GRUB-EMU(1)

📦
version 2.12 · 6 versions
, in fedora 43, fedora 44

💖 GRUB-EMU ✨

okay bestie, welcome to grub-emu — the GRUB emulator 👑 (yes, from the User Commands corner of your manual, the GRUB fam 💅)

🌸 SYNOPSIS 🌸

grub-emu [OPTION...]

that's it. that's the whole vibe. options go in, emulator comes out 🦋

✨ DESCRIPTION ✨

so like. it's a GRUB emulator 🎀 that's the main character energy right there.

🫶 the options (yes, all of them, no skips)

  • -d, --directory=DIR — use the GRUB files chillin' in the directory DIR 💖 [default=/boot/grub2]
  • -H, --hold[=SECS] — just… wait. hold still until a debugger attaches 🙈
  • --memdisk=FILE — use FILE as the memdisk ⭐
  • -m, --device-map=FILE — use FILE as the device map 🌈 [default=/boot/grub2/device.map]
  • -r, --root=DEVICE_NAME — set the root device, periodt 👑
  • -v, --verbose — print verbose messages, aka it will not stop yapping 💬
  • -W, --switch-root — use switch-root so you only switch the root filesystem without restarting the kernel 🧚 lowkey elegant
  • -X, --kexec — use kexec to boot Linux kernels via systemctl 🔥 (pass it twice to enable the dangerous fallback to non-systemctl… bestie, they said dangerous, so like, be careful 💀)
  • -?, --help — give this help list 🥰
  • --usage — give a short usage message 🍓
  • -V, --version — print program version, slay 💅
heads up: mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options. the rules do not change just because the flag got shorter, iykyk ✨

😭 REPORTING BUGS 😭

found a bug? spill the tea to <bug-grub@gnu.org> 📧

🦋 SEE ALSO 🦋

if you're trying to install GRUB, then bestie you should be using grub-install(8) and not this program 🙈 fr fr, wrong tool for the job.

the full documentation for grub-emu is maintained as a Texinfo manual 📚 and if the info and grub-emu programs are properly installed at your site, then this command:

info grub-emu

should give you access to the complete manual 💜

and that's the whole page 🎀 this was GRUB 2.12, dated April 2026, filed under GRUB-EMU(1) — ty for coming to my ted talk, go emulate something iconic, mwah 💖✨🫶

📦 where this page comes from