This directory contains files for installing the GRUB boot loader.
This boot loader requires three installation stages:

     (1)  Edit the configuration file.
     (2)  Create a GRUB boot floppy.
     (3)  Boot from the boot floppy and install GRUB in the MBR.

(1)  Editing the configuration file.

The GRUB boot loader is configured by the file /boot/grub/menu.lst.
This file contains general commands and descriptions of boot options.
Devices and files are represented as follows:

     Disks are (fd0) (fd1) for the first and second floppies and
     (hd0) (hd1) for the first and second hard disks recognised by
     the BIOS.

     A partition may be (hd0,0) for the first partition on the first
     disk (/dev/hda1 or /dev/sda1), (hd0,2) for the third partition,
     and so forth.

     A file may be a partition followed by a path name; for example,
     (hd0,1)/boot/grub/stage2 for /boot/grub/stage2 in /dev/hda2.
     The boot sector of a partition can be represented as (hd0,2)+1
     for the first sector of /dev/hda3.

The commands are described in detail in /usr/share/doc/grub/commands.txt.
The most useful commands are these:

     timeout= nnn
	The number of seconds to wait before booting the first entry.

     title= String Appearing on Boot Menu
	This starts a new menu entry and specifies the string which
	appears on the boot menu for this entry.

     pause= String to print
	Prints the specified string and waits for you to press a key.

     root= <device>
     rootnoverify= <device>
	These set the root device to be passed to the kernel or
	bootloader.  root= may fail unless the partition you specify
	is completely accessible to GRUB.

     chainloader= <file>
	Loads <file> as a chain loader.  To boot a DOS partition or
	a partition with LILO in its boot record, specify '+1' as
	the file.

     kernel= <file> [ parameters ]
	Loads a primary boot image.  The parameters are passed to
	the kernel as command line arguments.

     makeactive
	For DOS and similar operating systems, this sets the active
	flag in the partition table; some systems require this to
	work properly.

A sample configuration file has been installed as /boot/grub/menu.lst.
You must create the correct entries and delete or comment out the
others before installing GRUB in your master boot record.

(2)  Creating a GRUB boot floppy.

The command install.grub creates a small GRUB boot floppy with an
ext2 file system containing the stage1 and stage2 boot loaders.
This has been tested only with a 3.5 inch disk.  To create a boot
floppy with no file system, give this command:

     cat /boot/grub/stage?|dd of=/dev/fd0

(3)  Installing GRUB in the Master Boot Record.

Once you have edited a configuration file in /boot/grub/menu.lst and
created a GRUB boot floppy, you must boot from the floppy to install
GRUB in the master boot record on your first hard disk.  When GRUB
boots, it displays the character 'S' when it has started and set up
its data areas, then it gets information from the BIOS, and finally
it displays the charater 'J'.

If at this stage it cannot read its second stage loader, it displays
the character 'R'.  It tries to probe for the disk geometry and displays
'P' if the probe fails.  If it tries to read beyond the end of the
disk as determined by the geometry, it displays the character 'G'
to indicate a geometry translation error.

If no errors occur, the second stage loader is loaded and you are
asked for a command.  You probably need to give only one command,
install=, which has the following format:

     install= (fd0)+1 (hd0) <file> 0x8000 p

Here the <file> is the partition and path of the second stage loader.
Normally this will be something like

     (hd0,1)/boot/grub/stage2

for the file /boot/grub/stage2 in the root partition /dev/hda2.
Then you can remove the floppy from the drive and reboot.
