Funtoo boot-update

keywords:	boot, grub, funtoo, gentoo
description:	This page contains information about the Funtoo boot-update software.
Author:	Daniel Robbins
Contact:	drobbins@funtoo.org
Copyright:	funtoo
language:	English

Introduction

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

Current Versions

• sys-boot/boot-update-1.4.8

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+, perform the following steps:

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

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

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

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

emerge sys-boot/boot-update
emerge sys-boot/grub-legacy #(0.97-r11 or greater)
grub-install-legacy /dev/sda

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:

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.