Grub v2 manual

The pages contributed here (FranklinPiat/*) were an attempt to write some documentation for Grub2. This documentation isn't updated anymore (since grub2-1.96+20080203 approximately)

This work, and (any further contribution), has copyright attribution to FSF. It's dual licensed under GPLv1 or later and GFDL.

(8)GRUB-MKRESCUE - Make GRUB rescue image.

SYNOPSIS

grub-mkrescue [OPTION] output_image

DESCRIPTION

grub-mkrescue uses (8)grub-install to build a simple rescue grub disk image (floppy or cdrom). By default, the image will contains all the modules available in the current grub distribution, thus the name rescue.

The floppy disk image is not formated : grub's boot-sector and core.img are simply dumped on the floppy disk. The extra modules and overlaid files are available through a virtual drive, named (memdisk). more about [memdisk] in (7)grub_modules page).

Bootable cdrom image use [cdboot.img] loader, which is capable of accessing the ISO9990 cdrom to load extra modules (see's (8)mkisofs -b option).

output_image is the name of the file that will contain the image.

--image-type=TYPE

Type of image to build (floppy or cdrom) [default=cdrom]. Option only available on [@i386] architecture.

--overlay=DIR

The content of the directory DIR will be added (overlaid) to the rescue image content. This is especially useful to include grub.cfg, but any small file can be included. DIR is the root folder, which will be known as (memdisk)/ at boot time. it will contain /boot/grub or (/grub on NetBSD and OpenBSD). Option only available on [@i386] architecture.

--modules=MODULES

Pre-load specified modules MODULES (by default, all current modules are pre-loaded).

-h, --help

Print this message and exit

-v, --version

Print the version information and exit

--pkglibdir=DIR

Use images from directory DIR instead of default [default=/usr/lib/grub/i386-pc/ or similar, depending on cpu and platform].

--grub-mkimage=FILE

Use FILE as grub-mkimage.

EXAMPLE

grub-mkrescue --image-type=floppy /tmp/grub-rescue.flp

Will build a rescue floppy image. You can then use dd if=/tmp/grub-rescue.flp of=/dev/df0 bs=1024 to copy the image to an actual floppy disk.

grub-mkrescue --image-type=cdrom /tmp/grub-rescue.iso

Will build a rescue floppy image. You can then use wodim /tmp/grub-rescue.iso to copy the ISO image to an actual cdrom or dvdrom.

AUTHOR

Program Written by Yoshinori K. Okuji, Robert Millan, Marco Gerards and others (see AUTHORS file).

Manpage Written by Franklin Piat.

BUGS

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

COPYRIGHT

This is free software. You may redistribute copies of it under the terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.