Next: , Previous: Invoking grub-mkpasswd-pbkdf2, Up: Top


31 Invoking grub-mkrescue

The program grub-mkrescue generates a bootable GRUB rescue image (see Making a GRUB bootable CD-ROM).

     grub-mkrescue -o grub.iso

All arguments not explicitly listed as grub-mkrescue options are passed on directly to xorriso in mkisofs emulation mode. Options passed to xorriso will normally be interpreted as mkisofs options; if the option ‘--’ is used, then anything after that will be interpreted as native xorriso options.

Non-option arguments specify additional source directories. This is commonly used to add extra files to the image:

     mkdir -p disk/boot/grub
     (add extra files to disk/boot/grub)
     grub-mkrescue -o grub.iso disk

grub-mkrescue accepts the following options:

--help
Print a summary of the command-line options and exit.
--version
Print the version number of GRUB and exit.
-o file
--output=file
Save output in file. This "option" is required.
--modules=modules
Pre-load the named GRUB modules in the image. Multiple entries in modules should be separated by whitespace (so you will probably need to quote this for your shell).
--rom-directory=dir
If generating images for the QEMU or Coreboot platforms, copy the resulting qemu.img or coreboot.elf files respectively to the dir directory as well as including them in the image.
--xorriso=file
Use file as the xorriso program, rather than the built-in default.
--grub-mkimage=file
Use file as the grub-mkimage program, rather than the built-in default.