GRUB Error Reference

The objective of this error collection is to list the GRUB problems and errors people can be facing. All these solutions have been acquired through the cooperation of many users of the Gentoo Forums.

Acknowledgements
Many thanks to Earthwings, penetrode, loyaltonone, pilla, airhead, nephros, yamakawa and all the others for the suggestions on the original thread.

Disclaimer warning
The examples provided are just examples. Be sure to change partition numbers and the like according to your systems specs. Follow the solutions provided by this document at your own risk.

Situation
Grub output

After this message, the system stops. If you attempt to boot the system using a grub floppy, the problem disappears.

Solution
According to The_Bell you could change the boot order in your BIOS.

Tell your BIOS to not boot from your floppy first.

penetrode wrote that this may also be due to bad CFLAGS settings. Although the current grub ebuild filters out, it can't hurt to recompile grub with clean CFLAGS if nothing else helps.

Using a clean CFLAG to rebuild GRUB

Situation
Grub Output

This error is returned if the device strings syntax is correct but other than that, an error occurred that isn't defined by any other error.

Solution
When you installed grub in your boot record using the interactive commands, did you execute the two lines below in the grub prompt?

Interactive installation commands

(hd0,0) must be replaced with your boot partition and (hd0) with the HDD you have chosen. Remember that (hd0) will install the bootloader in the Master Boot Record of the first hard disk, the primary master.

Situation
This error can occur in two different stages of the GRUB configuration, either during the initial configuration (installing GRUB in the master boot record) or after booting the system and attempting to launch Linux (or any other entry).

Grub Output - Initial Configuration

Grub Output - Booting an Entry

Solution - Initial Configuration
This error is returned if the specified file name cannot be found, but everything else (like the disk/partition info) is OK.

Frequently, the error notes a missing kernel image file. Make sure that the file it is referring to exists on your boot partition.

To find out the exact name of your kernel, boot from the installation cd, mount your root and (if applicable) boot partition. Next, chroot into your Gentoo system and do a listing of the available files to see what kernel images you have available:

This will list all the kernels that you've got on your boot partition. If your kernel is missing make sure that you compiled a kernel (using  or manually):

And that you copied it to your boot partition:

Verify that the name of the kernel is exactly the same as the one mentioned in your file. Also make sure that the  line in your  file is referring to that partition (either explicitly or implicitly).

Another reported mistake is to have the BIOS ignore the disk on which the kernel or grub stages reside. Also, the partition on which grub stores its stages should not use a software RAID-5 (or other striping technology) configuration.

Solution - Booting an Entry
First, verify that the  and   lines you have used are correct.

If you are certain they are valid, then you might be using a flawed GRUB version (0.93.20031222). Upgrade your Portage tree or mask this version of grub:

You could also try to use the  script as is recommended by the GRUB authors. The --root-directory is needed if you are using a separate boot partition, otherwise you should leave it out.

When all this fails, your boot partition may be corrupt. Check the partition for errors:

Situation
Grub Output

Solution
This error is returned if the partition requested exists, but the filesystem type cannot be recognized by GRUB.

Be sure to check your root(x,y) settings in your grub.conf.

Also, if you are trying to boot Windows, make sure that your file has the   (or   ) and   in it.

Situation
Grub Output

Solution
This error is returned when a read is attempted at a linear block address beyond the end of the BIOS translated area. This generally happens if your disk is larger than the BIOS can handle (512MB for (E)IDE disks on older machines or larger than 8GB in general).

Try an update for your BIOS and/or move your boot partition to the front (or at least into the appropriate range).

Situation
Grub Output

Solution
According to airhead this can be caused by having your bios detect your disks automatically. Try to set your bios entry to User Type HDD.

Another possibility is that you had Grub installed on your MBR and tried reinstalling it (for instance due to hard disk changes) but used the wrong  and   commands.

Situation
While trying to install grub, it hangs after displaying the following line:

Solution
One reported cause was an exotic configuration of disk devices, like ultra/non-ultra DMA disks on one cable.

Situation
When installing grub, it hangs:

At this stage, the installation stops.

Solution
If you haven't got a floppy drive, have you used the --no-floppy switch?

Situation
The system hangs after displaying the following line:

Linux Output

Solution
Strictly speaking, this is no grub error. One possible cause is that ACPI is not working correctly but is enabled in the kernel. Try to disable it in your bios or in your kernel.

Situation
When booting the system, you receive a grub prompt instead of a list of entries you have defined in your file.

Solution
Mount your boot partition and verify if the file exists.

Also make sure that the symbolic link exists:

If not, recreate the symbolic link:

If this is the case, reinstall grub:

Situation
When running  during the GRUB installation, you receive the following error:

Solution
Check that you didn't forget the following:

Situation
After hitting Return at the Grub menu during the system boot, the system reboots.

Solution
Try disabling framebuffer support in your kernel. If this does not help, disable APM and ACPI.

Situation
After hitting Return at the Grub menu during system boot, the screen blanks out, but the system is responsive (for instance, your numlock led is switcheable).

Solution
Turn off framebuffer (typically remove  from your  ) and check the processor architecture in your kernel config.

Situation
When booting the system, you do not see that spify Gentoo splashscreen.

Solution
First of all check if the splashscreen file you are referring to in your really exists. If that is the case, go and check the grub ebuild. Maybe the patch for the splash image is commented out in the version that you are using.

Situation
After selecting the Windows entry, the system refuses to boot without any clear reason as to why.

Solution
cyrillic informed us that you can "map" your disks in a different order by changing your 's Windows entry like so:

Mapping disks

Situation
The situation described below is only relevant for grub-0.95.x at the moment of installing grub at the boot sector.

Solution
This is a known bug related to this problem and has been fixed in grub 0.96. It is also known that grub 0.94 r1 and grub 0.94 r2 should work correctly. If that fails too, you can try to emerge grub-static which is currently stable on amd64 and unstable on x86 (~x86). Check out bug #79378 for additional information.

Acknowledgements
We would like to thank the following authors and editors for their contributions to this guide:


 * Hartwig Brandl
 * Ioannis Aslanidis
 * Sven Vermeulen