Repository :
http://git.fedorahosted.org/cgit/docs/multiboot-guide.git
On branch : master
---------------------------------------------------------------
commit c826b4585f41c52bcf94af744fa1a0759d4bf0c3
Author: Pete Travis <immanetize(a)fedoraproject.org>
Date: Tue Jan 28 14:43:10 2014 -0700
added procedure to walk throughadding boot parameters incidentally to a GRUB entry
---------------------------------------------------------------
en-US/GRUB-runtime.xml | 160 ++++++++++++++++++++++++++++++
en-US/GRUB.xml | 2 +
en-US/images/grub-menu-countdown.png | Bin 0 -> 8806 bytes
en-US/images/grub-menu-edit_initial.png | Bin 0 -> 12005 bytes
en-US/images/grub-menu-edit_scrolled.png | Bin 0 -> 13407 bytes
5 files changed, 162 insertions(+), 0 deletions(-)
diff --git a/en-US/GRUB-runtime.xml b/en-US/GRUB-runtime.xml
new file mode 100644
index 0000000..ee3d633
--- /dev/null
+++ b/en-US/GRUB-runtime.xml
@@ -0,0 +1,160 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Fedora_Multiboot_Guide.ent">
+%BOOK_ENTITIES;
+
+]>
+
+<section id="GRUB-runtime">
+ <title>Changing GRUB entries at boot</title>
+ <para>
+ Changing selection or adding arguments to a GRUB menu entry at boot time can be
useful for testing or troubleshooting purposes. You might have a graphics issue to
troubleshoot by booting temporarily into a non-graphical
<literal>target</literal>, a hardware issue to work around with a
<varname>kernel parameter</varname>, or a problem to resolve by selecting an
alternate kernel. This section covers the procedure for adding boot arguments, see
<xref linkend="boot-arguments" /> for some arguments you might use.
+ </para>
+
+ <!-- this might work better as an independent section, or just a relocated note.
-->
+ <note id="note_rescue-option">
+ <title>The Rescue option</title>
+ <para>
+ The normal boot entries for Fedora use a trimmed down <systemitem
class="filesystem">initramfs</systemitem>, or initial boot filesystem.
This <literal>host-only</literal> <systemitem
class="filesystem">initramfs</systemitem> had information only about
the hardware on your computer, allowing the system to boot more quickly by avoid loading
unneeded drivers.
+ </para>
+ <para>
+ One of the default menu entries for Fedora is a
<literal>rescue</literal> entry. This will load the same Fedora environment as
the other entries, but loads a full <systemitem
class="filesystem">initramfs</systemitem>.
+ </para>
+ <para>
+ The rescue option is useful if you have problems after adding new hardware. You can
use the rescue option to regenerate the <systemitem
class="filesystem">initramfs</systemitem> for all boot entries using
this command, executed with root privileges:
+ <screen>
+ <command>dracut --regenerate-all --force</command>
+ </screen>
+ </para>
+ </note>
+
+ <procedure id="GRUB-add_boot_parameter">
+ <step>
+ <para>
+ Turn on or reboot your computer. When the GRUB menu ( <xref
linkend="grub-menu" /> ) appears, press the <keycap>Esc</keycap>
key to stop the countdown.
+ </para>
+ <figure id="grub-menu">
+ <title>GRUB menu during countdown</title>
+ <mediaobject>
+ <imageobject>
+ <!-- 800x450 px, 16:9 -->
+ <imagedata fileref="images/grub-menu-countdown.png"
format="PNG" scalefit="0" />
+ </imageobject>
+ <textobject>
+ <para>
+ The GRUB menu is a text based interface with a list of bootable systems.
The entries for Fedora include the kernels available to boot and the rescue option. The
menu counts down from a defined value, 5 seconds by default, before booting the default
entry.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ </step>
+ <step>
+ <para>
+ Use the arrow keys to highlight the desired boot entry.
+ </para>
+ <substeps>
+ <step>
+ <para>
+ If you want to boot an alternate menu entry without editing, press
<keycap>Enter</keycap> to continue.
+ </para>
+ </step>
+ <step>
+ <para>
+ If you want to edit the entry before booting, press
<keycap>e</keycap> to edit.
+ </para>
+ </step>
+ </substeps>
+ </step>
+ <step>
+ <substeps>
+ <step>
+ <para>
+ The initial screen displayed for editing shows information GRUB needs to
find and boot the operating system, as pictured in <xref
linkend="grub-menu-edit_initial" />. These lines should not be changed.
+ </para>
+ <figure id="grub-menu-edit_initial">
+ <title>The GRUB edit screen, Part 1</title>
+ <mediaobject>
+ <imageobject>
+ <!-- 800x450 px, 16:9 -->
+ <imagedata fileref="images/grub-menu-edit_initial.png"
format="PNG" scalefit="0" />
+ </imageobject>
+ <textobject>
+ <para>
+ The initial edit screen shows several lines of parameters and
modules that GRUB uses to boot the operating system.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ </step>
+ <step>
+ <para>
+ Using the arrow keys, move down to the line that contains the boot
arguments. On UEFI systems, this line will begin with
<parameter>linuxefi</parameter>, or on BIOS systems the line will begin with
<parameter>linux</parameter>. The next argument on the line will typically be
the kernel, a string beginning with <literal>/vmlinuz-</literal>. This is
shown in <xref linkend="grub-menu-edit_scrolled" />.
+ </para>
+ <para>
+ Press the <keycap>End</keycap> key to move to the end of the
line.
+ </para>
+ <figure id="grub-menu-edit_scrolled">
+ <title>The GRUB edit screen, Part 1</title>
+ <mediaobject>
+ <imageobject>
+ <!-- 800x450 px, 16:9 -->
+ <imagedata
fileref="images/grub-menu-edit_scrolled.png" format="PNG"
scalefit="0" />
+ </imageobject>
+ <textobject>
+ <para>
+ Scrolling down reveals the line with boot arguments.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <note id="verbose_boot-rhgb_quiet">
+ <title>Getting more information during boot</title>
+ <para>
+ The default boot parameters for Fedora include
<parameter>rghb</parameter> and <parameter>quiet</parameter>.
These enable the boot splash screen instead of showing details about services,
mountpoints, and other units as the sytem boots. If you are troubleshooting a boot issue
or want to see more information when Fedora loads, removing these parameters will disable
the splash screen.
+ </para>
+ </note>
+ </step>
+ </substeps>
+ </step>
+ <step>
+ <para>
+ Type in your desired parameters and press
<keycombo><keycap>Ctrl</keycap><keycap>x</keycap></keycombo>
to boot. See <xref linkend="boot-arguments" /> for some parameters you
might find useful.
+ </para>
+ </step>
+ </procedure>
+ </section>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/en-US/GRUB.xml b/en-US/GRUB.xml
index 3cefa3c..101e357 100644
--- a/en-US/GRUB.xml
+++ b/en-US/GRUB.xml
@@ -9,6 +9,8 @@
<para />
<!-- Basics -->
<xi:include href="GRUB-basics.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <!-- adding options to the GRUB menu during boot -->
+ <xi:include href="GRUB-runtime.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
<!-- Reinstalling GRUB -->
<xi:include href="GRUB-reinstalling.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
<!-- temporary and persistent menu entry changes -->
diff --git a/en-US/images/grub-menu-countdown.png b/en-US/images/grub-menu-countdown.png
new file mode 100644
index 0000000..bcdf483
Binary files /dev/null and b/en-US/images/grub-menu-countdown.png differ
diff --git a/en-US/images/grub-menu-edit_initial.png
b/en-US/images/grub-menu-edit_initial.png
new file mode 100644
index 0000000..864392f
Binary files /dev/null and b/en-US/images/grub-menu-edit_initial.png differ
diff --git a/en-US/images/grub-menu-edit_scrolled.png
b/en-US/images/grub-menu-edit_scrolled.png
new file mode 100644
index 0000000..1141b0b
Binary files /dev/null and b/en-US/images/grub-menu-edit_scrolled.png differ