Revision as of 11:23, August 12, 2014

Boot-Update

Tip

We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.

Funtoo boot-update provides a unified mechanism for configuring the GRUB 1.9x (No results) and GRUB 0.97 (No results) boot loaders. It is the recommended, official way to configure Funtoo Linux systems for booting.

Current Version

sys-boot/boot-update

Man Pages

Consult the following man pages for detailed, up-to-date information on configuration file settings and command-line arguments:

boot-update(8)
boot.conf(5)

GRUB 1.97+ Quick Start

If using sys-boot/grub-1.97 or later, perform the following steps:

Partition disk using GPT/GUID (recommended) or MBR partitions.
Install kernel/initrd to /boot

root # emerge sys-boot/boot-update
root # grub-install --no-floppy /dev/sda

Ensure that /etc/fstab is correct, and edit /etc/boot.conf to reflect your installation (see /etc/boot.conf.example). Then run:

root # boot-update

This will auto-generate the complex /boot/grub/grub.cfg required for booting. Re-run boot-update every time your available kernels/initrds or /etc/boot.conf configuration changes.

GRUB 0.97 (grub-legacy) Quick Start

If using sys-boot/grub-legacy-0.97, perform the following steps:

Partition disk using MBR partitions (GPT not supported)
Install kernel/initrd to /boot

root # emerge sys-boot/boot-update
root # emerge ">=sys-boot/grub-legacy-0.97-r11"
root # grub-install-legacy /dev/sda

Due to an issue with grub-legacy, you may see the following message:

root # grub-install-legacy /dev/sda
The file /boot/grub-legacy/stage1 not read correctly.

Should you receive this message, you will have to install grub-legacy from the grub shell. Assuming /boot is the partition /dev/sda1 and you want to install grub to the MBR, you would run the following:

root # grub-legacy
root (hd0,0)
setup (hd0)
quit

When adjusting to fit your setup, remember 'root' is the location of your boot partition, 'setup' is where you want to install grub, and don't forget about grub's unique naming conventions for hard drives / partitions. For more information run:

root # info grub-legacy

Ensure that /etc/fstab is correct, and edit /etc/boot.conf to reflect your installation. Ensure a generate grub-legacy setting in the boot section. Then run:

root # boot-update

This will auto-generate the /boot/grub-legacy/grub.conf required for booting. Note that grub-legacy-0.97-r11 and later stores grub.conf in the /boot/grub-legacy directory.

Re-run boot-update every time your available kernels / initrds or /etc/boot.conf configuration changes.

@@ Line 30: / Line 30: @@
 ###i## grub-install --no-floppy /dev/sda
 </console>
-Ensure that <code>/etc/fstab</code> is correct, and edit <tt>/etc/boot.conf</tt> to reflect your installation (see <code>/etc/boot.conf.example</code>). Then run:
+Ensure that <code>/etc/fstab</code> is correct, and edit <code>/etc/boot.conf</code> to reflect your installation (see <code>/etc/boot.conf.example</code>). Then run:
 <console>
 ###i## boot-update
 </console>
-This will auto-generate the complex <tt>/boot/grub/grub.cfg</tt> required for booting. Re-run <tt>boot-update</tt> every time your available kernels/initrds or <tt>/etc/boot.conf</tt> configuration changes.
+This will auto-generate the complex <code>/boot/grub/grub.cfg</code> required for booting. Re-run <code>boot-update</code> every time your available kernels/initrds or <code>/etc/boot.conf</code> configuration changes.
 = GRUB 0.97 (grub-legacy) Quick Start =
@@ Line 67: / Line 67: @@
 </console>
-Ensure that <tt>/etc/fstab</tt> is correct, and edit <tt>/etc/boot.conf</tt> to reflect your installation. Ensure a <tt>generate grub-legacy</tt> setting in the <tt>boot</tt> section. Then run:
+Ensure that <code>/etc/fstab</code> is correct, and edit <code>/etc/boot.conf</code> to reflect your installation.
+Ensure a <code>generate grub-legacy</code> setting in the <code>boot</code> section. Then run:
 <console>
 ###i## boot-update
 </console>
-This will auto-generate the <tt>/boot/grub-legacy/grub.conf</tt> required for booting. Note that <code>grub-legacy-0.97-r11</code> and later stores <tt>grub.conf</tt> in the <tt>/boot/grub-legacy</tt> directory.
+This will auto-generate the <code>/boot/grub-legacy/grub.conf</code> required for booting. Note that <code>grub-legacy-0.97-r11</code> and later stores <code>grub.conf</code> in the <code>/boot/grub-legacy</code> directory.
-Re-run <tt>boot-update</tt> every time your available kernels / initrds or <tt>/etc/boot.conf</tt> configuration changes.
+Re-run <code>boot-update</code> every time your available kernels / initrds or <code>/etc/boot.conf</code> configuration changes.
 [[Category:Projects]]
 [[Category:Funtoo features]]
 {{EbuildFooter}}

Difference between revisions of "Package:Boot-Update"