Revision as of 07:48, October 30, 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 1: / Line 1: @@
 {{Ebuild
-|Summary=Accelerated ATI/AMD binary drivers for Radeon HD 5000 and newer chipsets.
+|Summary=Funtoo Core Boot Framework for global boot loader configuration
-|CatPkg=x11-drivers/ati-drivers
+|CatPkg=sys-boot/boot-update
 |Maintainer=Drobbins
 |Repository=Funtoo Overlay
+|Organization=Funtoo Technologies
 |Overlay=Funtoo
 }}
-== Introduction ==
+Funtoo boot-update provides a unified mechanism for configuring the GRUB 1.9x ({{Package|sys-boot/grub}}) and GRUB 0.97 ({{Package|sys-boot/grub-legacy}}) boot loaders. It is the recommended, official way to configure Funtoo Linux systems for booting.
-<tt>x11-drivers/ati-drivers</tt> (often referred to as "<tt>fglrx</tt>", the name of its kernel module) is the proprietary, accelerated driver for AMD (ATI) graphics cards.
+== Current Version ==
-== Preparing to Install ==
+* {{Package|sys-boot/boot-update}}
-=== Mask xorg > 1.16 ===
+== Man Pages ==
+Consult the following man pages for detailed, up-to-date information on configuration file settings and command-line arguments:
-This package doesn't work with the latest unmasked version of xorg-server (1.16). However, xorg-server-1.15 works just fine, so it's easy enough to fix this. Add the following to <code>/etc/portage/package.mask</code>:
+* boot-update(8)
+* boot.conf(5)
-{{File|name=/etc/portage/package.mask|body=
+== GRUB 1.97+ Quick Start ==
->=x11-base/xorg-server-1.16
-}}
+If using <code>sys-boot/grub-1.97</code> or later, perform the following steps:
-If X is already installed, force it to downgrade by typing:
+* Partition disk using GPT/GUID (recommended) or MBR partitions.
+* Install kernel/initrd to <code>/boot</code>
 <console>
-# ##i##emerge -auDN world
+###i## emerge sys-boot/boot-update
+###i## grub-install --no-floppy /dev/sda
 </console>
+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:
-A few packages will downgrade, and you'll be ready to go.
+<console>
+###i## boot-update
-=== Configuring the kernel ===
+</console>
+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.
-Configure the kernel as follows. Note that the Direct Rendering Manager is '''not''' enabled. It's possible to have it selected as a kernel module, but should not be built-in to your kernel.
+= GRUB 0.97 (grub-legacy) Quick Start =
-{{kernelop|desc=
+If using <code>sys-boot/grub-legacy-0.97</code>, perform the following steps:
-[*] Enable loadable module support
-Processor type and features --->
-      [*] MTRR (Memory Type Range Register) support
-Bus options (PCI etc.) --->
-      [*] PCI Express Port Bus Support
-      [*] Message Signaled Interrupts (MSI and MSI-X)
-Device Drivers --->
-      Graphics support --->
-            < > Direct Rendering Manager (xFree86 4.1.0 and higher DRI support) --->
-}}
-{{note|If you need support for AGP cards, enable the following kernel options:}}
+* Partition disk using MBR partitions '''(GPT not supported)'''
-{{kernelop|desc=
+* Install kernel/initrd to <code>/boot</code>
-Device Drivers --->
-      Graphics support --->
-            <*> /dev/agpgart (AGP Support) --->
-                  Select an appropriate AGP driver:
-                  <*> AMD Opteron/Athlon64 on-CPU GART support
-}}
-=== Editing make.conf ===
-Add the following to your <code>/etc/make.conf</code>:
-<console>
-# ##i##nano /etc/make.conf
-VIDEO_CARDS="fglrx"
-</console>
-=== Editing package.use ===
-Then, add the following to <code>/etc/portage/package.use</code>:
 <console>
-###i## nano /etc/portage/package.use
+###i## emerge sys-boot/boot-update
-x11-drivers/ati-drivers qt4
+###i## emerge ">=sys-boot/grub-legacy-0.97-r11"
+###i## grub-install-legacy /dev/sda
 </console>
-{{note|Feel free to add or remove use flags as you see fit. For example, if you do not want amdcccle support, remove the qt4 use flag.}}
+Due to an issue with <code>grub-legacy</code>, you may see the following message:
-== Installing ==
-=== Emerging the package ===
-To emerge the drivers, run the following command:
 <console>
-###i## emerge -av --changed-use --deep @world
+###i## grub-install-legacy /dev/sda
+The file /boot/grub-legacy/stage1 not read correctly.
 </console>
+Should you receive this message, you will have to install <code>grub-legacy</code> from the grub shell.
-== Configuring ==
+Assuming <code>/boot</code> is the partition <code>/dev/sda1</code> and you want to install grub to the MBR, you would run the following:
-Next, set ati-drivers to manage the system's OpenGL implementation:
 <console>
-###i## eselect opengl set ati
+###i## grub-legacy
+root (hd0,0)
+setup (hd0)
+quit
 </console>
+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:
-Afterwards, run <code>aticonfig</code> to modify the X-server configuration file to work with the ati-drivers:
 <console>
-###i## aticonfig --initial
+###i## info grub-legacy
 </console>
-{{tip|If you would like to have a full-resolution framebuffer with ati-drivers, check out [[uvesafb| uvesafb]]}}
+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:
-== Troubleshooting ==
-=== I am using a HDMI connection, and my monitor's display has a black border around it. ===
-Disable overscan using the following command, as root:
 <console>
-# ##i##aticonfig --set-pcs-val=MCIL,DigitalHDTVDefaultUnderscan,0
+###i## boot-update
 </console>
+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.
-You may need to restart your X session.
+Re-run <code>boot-update</code> every time your available kernels / initrds or <code>/etc/boot.conf</code> configuration changes.
-=== GNOME 3 windows only refresh when I drag them. ===
-This is a known issue, reported in [http://bugs.funtoo.org/browse/FL-1130 Funtoo Bug 1130]. This issue has been fixed by addressing a bug in cogl -- upgrade to cogl-1.12.2-r2 to fix it.
-=== Compton with backend glx does not work well with ati-drivers ===
-Try running compton with the following switches:
-<console>
-###i## compton --backend glx --vsync none --paint-on-overlay
-</console>
-[[Category:Video Cards]]
+[[Category:Projects]]
-[[Category:First Steps]]
+[[Category:Funtoo features]]
 {{EbuildFooter}}

Difference between pages "Package:AMD Catalyst Video Drivers" and "Package:Boot-Update"