From 21d845a6c3e6b3f2292d10ccf304e9148be90463 Mon Sep 17 00:00:00 2001 From: Mads Kiilerich Date: Thu, 27 Oct 2011 17:09:00 +0200 Subject: [PATCH] update README.Fedora (#734090) --- README.Fedora | 67 +++++++++++++++++++++++++++++++++------------------ 1 file changed, 43 insertions(+), 24 deletions(-) diff --git a/README.Fedora b/README.Fedora index ccfe58e..3313a5a 100644 --- a/README.Fedora +++ b/README.Fedora @@ -1,44 +1,63 @@ Using GNU GRUB 2 in Fedora ========================== -Though GRUB 2 provides various feature enhancements over previous GRUB -version (referred to as "GRUB", or "GRUB Legacy"), it did not reach its -stability and feature completness yet, and thus is not ready to replace -it for the whole user base. This package is primarily intended to -encourage testing and accelerate distribution integration. - -It is generally safe to install the package. It is able to co-exist with -existing GRUB installation and adds itself to the GRUB menu upon -installation, so you'll able to select GRUB 2 from GRUB menu during -the boot. +GRUB 2 provides various feature enhancements over the previous GRUB version +(referred to as "GRUB", or "GRUB Legacy") which has been unmaintained upstream +for years. GRUB has thus been deprecated in Fedora and replaced by GRUB 2 for +BIOS systems. (EFI systems still uses GRUB Legacy from the new grub-efi package.) Utilities --------- -The GRUB 2 utilities are prefixed (or postfixed) with 'grub2': +The GRUB 2 utilities are prefixed with 'grub2': +grub2-bin2h grub2-editenv -grub2-mkimage -grub2-mkelfimage -grub2-mkrescue -grub2-emu +grub2-fstest grub2-install +grub2-kbdcomp +grub2-menulst2cfg +grub2-mkconfig grub2-mkdevicemap +grub2-mkfont +grub2-mkimage +grub2-mklayout +grub2-mknetdir +grub2-mkpasswd-pbkdf2 +grub2-mkrelpath +grub2-mkrescue grub2-probe +grub2-reboot +grub2-script-check +grub2-set-default grub2-setup -update-grub2 + +The default location for boot loader installation is /boot/grub2/ . + +GRUB 2 in Fedora +---------------- + +The Fedora installer (anaconda) will make sure grub2 is installed for new and +updated systems. It will write /etc/default/grub and run grub2-mkconfig to +create /boot/grub2/grub.cfg, and it will run grub2-install to install the boot +loader in the MBR and in /boot/grub2/ . + +grubby will patch grub.cfg (through /etc/grub2.cfg) when new kernels are +installed. The GRUB 2 configuration system in /etc/default/grub and /etc/grub.d/ +is thus only used initially by anaconda, but it is possible to generate a new +grub.cfg with: + + grub2-mkconfig -o /boot/grub2/grub.cfg + +The active boot loader will not be changed when the GRUB 2 package is updated. +A new boot loader can be installed with something like: + + grub2-install /dev/sda Documentation ------------- -The GRUB 2 lacks documentation. While you are encouraged to contribute -the documentation, you can use the GRUB 2 Wiki [1] as primary source of -information pertaining to this development snapshot. - -[1] http://grub.enbug.org/ - -If you intend to install grub2 as your primary boot loader refer to -the GRUB 2 Wiki for information on how to set it up. +The GRUB 2 manual can be found on http://www.gnu.org/software/grub/manual/ . Support channels ----------------