GRUB-EMU(1)

📦
version 2.14 · 11 versions
, in ubuntu stonking

🦋 GRUB-EMU(1) 🦋

okay bestie, so this is grub-emu — the GRUB emulator — and it's from the User Commands manual, which basically means it's a program you run, not a config file you agonize over. 💅

✨ NAME ✨

grub-emu — the GRUB emulator. that's it, that's the name, she's simple and she knows it 🌸

🌈 SYNOPSIS 🌈

grub-emu [OPTION...]

like. give her options or don't. she's flexible. 🫶

💖 DESCRIPTION 💖

grub-emu is… a GRUB emulator. no cap. 🎀

that's the whole vibe of the description, so let's get into the good stuff 👑

✨ OPTIONS ✨

  • -d, --directory=DIR — use the GRUB files that are livin' in the directory DIR. lowkey the default is /boot/grub so if you don't say anything she's gonna go there 🏠
  • -H, --hold[=SECS] — just. wait. hang out. vibe. she'll sit there until a debugger attaches to her 😭 the SECS bit is optional, iykyk
  • --memdisk=FILE — use FILE as the memdisk. yes it's giving tiny fake disk, we love that for her 💽
  • -m, --device-map=FILE — use FILE as the device map. default is /boot/grub/device.map 🗺️
  • -r, --root=DEVICE_NAME — set the root device, bestie 👑
  • -t, --tpm-device=DEV — set the TPM device 🔐
  • -v, --verbose — print verbose messages. she will NOT stop talking and honestly? iconic 📢
  • -X, --kexec — use kexec to boot Linux kernels via systemctl. and listen: pass it twice to enable the dangerous fallback to non-systemctl. ⚠️ DANGEROUS. I said what I said. don't be cute about this one 🙈
  • -?, --help — give this help list. she's helping!! 🫶
  • --usage — give a short usage message. the lite version, no paragraphs, just vibes ✨
  • -V, --version — print program version. go ahead, ask her how old she is 🎂
Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options. (fr fr. the short ones inherit the whole situation from the long ones, don't overthink it 💜)

😭 REPORTING BUGS 😭

found a bug? spill. report bugs to <bug-grub@gnu.org>. they wanna know, for real 💌

🌸 SEE ALSO 🌸

if you're trying to install GRUB, bestie, please — use grub-install(8) instead of this program. wrong tool, wrong moment, no shade, just facts 💅

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. go read the whole thing, she's worth it 📖✨

and that's a wrap!! this was GRUB 2.14-2ubuntu3, dated July 2026, and honestly? she ate. periodt. 👑💖🦋

📦 where this page comes from