# boot-update

**Repository Path**: funtoo/boot-update

## Basic Information

- **Project Name**: boot-update
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-19
- **Last Updated**: 2025-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

==================
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.8.2

Man Pages
=========

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

.. _boot-update(8): doc/boot-update.8.html
.. _boot.conf(5): doc/boot.conf.5.html

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

GRUB 1.97+ Quick Start
======================

.. _GPT/GUID: /en/funtoo/core/partition/

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.


.. include:: ./LICENSE