GRU-MKIMAGE

Section: User Commands (1)
Updated: August 2025
Index Return to Main Contents

---

 

NAME

gru-mkimage - make a bootable image of GRUB  

SYNOPSIS

gru-mkimage [,OPTION/...] [,OPTION/]... [,MODULES/]  

DESCRIPTION

Make a bootable image of GRUB.

-c, --config=,FILE/

embed FILE as an early config

-C, --compression=(xz|none|auto)

choose the compression to use for core image

--disable-shim-lock

disable shim_lock verifier

-d, --directory=,DIR/

use images and modules under DIR [default=/usr/lib/grub/<platform>]

-D, --dtb=,FILE/

embed FILE as a device tree (DTB)

-k, --pubkey=,FILE/

embed FILE as public key for signature checking

-m, --memdisk=,FILE/

embed FILE as a memdisk image

Implies `-p (memdisk)/boot/grub' and overrides

any prefix supplied previously, but the prefix

itself can be overridden by later options

-n, --note

add NOTE segment for CHRP IEEE1275

-o, --output=,FILE/

output a generated image to FILE [default=stdout]

-O, --format=,FORMAT/

generate an image in FORMAT available formats: i386-coreboot, i386-multiboot, i386-pc, i386-xen_pvh, i386-pc-pxe, i386-pc-eltorito, i386-efi, i386-ieee1275, i386-qemu, x86_64-efi, i386-xen, x86_64-xen, mipsel-yeeloong-flash, mipsel-fuloong2f-flash, mipsel-loongson-elf, powerpc-ieee1275, sparc64-ieee1275-raw, sparc64-ieee1275-cdcore, sparc64-ieee1275-aout, ia64-efi, mips-arc, mipsel-arc, mipsel-qemu_mips-elf, mips-qemu_mips-flash, mipsel-qemu_mips-flash, mips-qemu_mips-elf, arm-uboot, arm-coreboot-vexpress, arm-coreboot-veyron, arm-efi, arm64-efi, loongarch64-efi, riscv32-efi, riscv64-efi

-p, --prefix=,DIR/

set prefix directory

-s, --sbat=,FILE/

SBAT metadata

-v, --verbose

print verbose messages.

-?, --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

gru-install(8), gru-mkrescue(1), gru-mknetdir(8)

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

info gru-mkimage

should give you access to the complete manual.

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

REPORTING BUGS

SEE ALSO