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.

TODO

rewrite DESCRIPTION about direct hardware access.

BUG in 20080128

The grub-emu screen is black ! press "c" then Escape-twice..

(8)GRUB-EMU - Grub emulator.

SYNOPSIS

grub-emu [OPTIONS]

DESCRIPTION

The program grub-emu is a grub bootloader emulator, for testing and debugging purposes.

this paragraph is partially wrong : Since grub-emu runs inside the operating system, it can't make direct access to the hardware, it can't make direct access to the disk (unless you run it as root), it can't call any function implemented in the computer firmware... and it can't load or boot another operating system.

grub-emu uses the host operating system to access the disk, the terminal, etc :

The module [hostfs] emulates a hard-disk, and provides access the files on the host OS, through the disk (host).
The terminal is a simple console-like emulation (no unicode support).
The command halt, or reboot exists the emulator.

For a real life emulation, you might want to use an image made by (8)grub-mkrescue with a virtual machine like qemu.

-r, --root-device=DEV

Use DEV as the root device [default=guessed]

-m, --device-map=FILE

Use FILE as device map [default=/boot/grub/device.map, or /grub/device.map on *BSD* systems)]

-d, --directory=DIR

Use GRUB files in the directory DIR [default=/boot/grub/device.map, or /grub/device.map on *BSD* systems)]

-H, --hold[=SECONDS]

Wait for a debugger to attach. if you don't specify SECONDS, it will wait forever.

-v, --verbose

Print verbose messages.

-h, --help

Print help page and exit.

-V, --version

Print the version information and exit.

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