source: BOOK/final-system/x86/grub.xml@ 7949a91

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since 7949a91 was 4e60ea5, checked in by Joe Ciccone <jciccone@…>, 14 years ago

Updated GRUB to 1.98
  • Property mode set to 100644
File size: 8.2 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6]>
7<sect1 id="ch-system-grub" role="wrap">
8 <?dbhtml filename="grub.html"?>
9
10 <title>GRUB-&grub-version;</title>
11
12 <indexterm zone="ch-system-grub">
13 <primary sortas="a-GRUB">GRUB</primary>
14 </indexterm>
15
16 <sect2 role="package">
17 <title/>
18
19 <para>The GRUB package contains the GRand Unified Bootloader.</para>
20
21 </sect2>
22
23 <sect2 role="installation">
24 <title>Installation of GRUB</title>
25
26 <note os="n1">
27 <para>If you would like use a different bootloader than this
28 one you can go to the following link for alterative bootloaders
29 and the instructions to use them.
30 <ulink url="http://trac.cross-lfs.org/wiki/bootloaders"/></para>
31 </note>
32
33 <note os="n2">
34 <para>This package is known to have issues when its default optimization
35 flags (including the <option>-march</option> and <option>-mcpu</option>
36 options) are changed. If any environment variables that override default
37 optimizations have been defined, such as <envar>CFLAGS</envar> and
38 <envar>CXXFLAGS</envar>, unset them when building GRUB.</para>
39 </note>
40
41 <para os="a">Prepare GRUB for compilation:</para>
42
43<screen os="b"><userinput>./configure --prefix=/usr \
44 --sysconfdir=/etc</userinput></screen>
45
46 <para os="c">Compile the package:</para>
47
48<screen os="d"><userinput>make</userinput></screen>
49
50 <para os="e">To test GRUB you must have QEMU installed and then, issue:
51 <userinput>make check</userinput>.</para>
52
53 <para os="f">Install the package:</para>
54
55<screen os="g"><userinput>make install</userinput></screen>
56
57 </sect2>
58
59 <sect2 id="conf-grub" role="configuration">
60 <title>Configuring GRUB</title>
61
62 <indexterm zone="conf-grub">
63 <primary sortas="a-GRUB">GRUB</primary>
64 <secondary>configuring</secondary></indexterm>
65
66 <indexterm zone="conf-grub">
67 <primary sortas="e-/etc/default/grub">/etc/default/grub</primary>
68 </indexterm>
69
70 <para>Now that grub is installed, we need to configure the defaults that
71 will be used to generate the configuration after we install the kernel.
72 Create this file with the following:</para>
73
74<screen><userinput>install -m755 -dv /etc/default
75cat &gt; /etc/default/grub &lt;&lt; "EOF"
76<literal># Begin /etc/default/grub
77
78GRUB_DEFAULT=0
79#GRUB_SAVEDEFAULT=true
80GRUB_HIDDEN_TIMEOUT=
81GRUB_HIDDEN_TIMEOUT_QUIET=false
82GRUB_TIMEOUT=10
83GRUB_DISTRIBUTOR=Cross-LFS
84
85GRUB_CMDLINE_LINUX=""
86GRUB_CMDLINE_LINUX_DEFAULT=""
87
88#GRUB_TERMINAL=console
89#GRUB_GFXMODE=640x480
90
91#GRUB_DISABLE_LINUX_UUID=true
92#GRUB_DISABLE_LINUX_RECOVERY=true
93
94#GRUB_INIT_TUNE="480 440 1"
95
96#GRUB_DISABLE_OS_PROBER=true
97
98# End /etc/default/grub</literal>
99EOF</userinput></screen>
100
101 <variablelist>
102 <title>The meaning of the above options and possible alternate
103 values:</title>
104
105 <varlistentry>
106 <term><parameter>GRUB_DEFAULT=</parameter></term>
107 <listitem>
108 <para>Write Me</para>
109 </listitem>
110 </varlistentry>
111
112 <varlistentry>
113 <term><parameter>GRUB_SAVEDEFAULT=</parameter></term>
114 <listitem>
115 <para>Write Me</para>
116 </listitem>
117 </varlistentry>
118
119 <varlistentry>
120 <term><parameter>GRUB_HIDDEN_TIMEOUT=</parameter></term>
121 <listitem>
122 <para>Write Me</para>
123 </listitem>
124 </varlistentry>
125
126 <varlistentry>
127 <term><parameter>GRUB_HIDDEN_TIMEOUT_QUIET=</parameter></term>
128 <listitem>
129 <para>Write Me</para>
130 </listitem>
131 </varlistentry>
132
133 <varlistentry>
134 <term><parameter>GRUB_TIMEOUT=</parameter></term>
135 <listitem>
136 <para>Write Me</para>
137 </listitem>
138 </varlistentry>
139
140 <varlistentry>
141 <term><parameter>GRUB_DISTRIBUTOR=</parameter></term>
142 <listitem>
143 <para>Write Me</para>
144 </listitem>
145 </varlistentry>
146
147 <varlistentry>
148 <term><parameter>GRUB_CMDLINE_LINUX=</parameter></term>
149 <listitem>
150 <para>Write Me</para>
151 </listitem>
152 </varlistentry>
153
154 <varlistentry>
155 <term><parameter>GRUB_CMDLINE_LINUX_DEFAULT=</parameter></term>
156 <listitem>
157 <para>Write Me</para>
158 </listitem>
159 </varlistentry>
160
161 <varlistentry>
162 <term><parameter>GRUB_TERMINAL=</parameter></term>
163 <listitem>
164 <para>Write Me</para>
165 </listitem>
166 </varlistentry>
167
168 <varlistentry>
169 <term><parameter>GRUB_GFXMODE=</parameter></term>
170 <listitem>
171 <para>Write Me</para>
172 </listitem>
173 </varlistentry>
174
175 <varlistentry>
176 <term><parameter>GRUB_DEFAULT=</parameter></term>
177 <listitem>
178 <para>Write Me</para>
179 </listitem>
180 </varlistentry>
181
182 <varlistentry>
183 <term><parameter>GRUB_DISABLE_LINUX_UUID=</parameter></term>
184 <listitem>
185 <para>Write Me</para>
186 </listitem>
187 </varlistentry>
188
189 <varlistentry>
190 <term><parameter>GRUB_DISABLE_LINUX_RECOVERY=</parameter></term>
191 <listitem>
192 <para>Write Me</para>
193 </listitem>
194 </varlistentry>
195
196 <varlistentry>
197 <term><parameter>GRUB_INIT_TUNE=</parameter></term>
198 <listitem>
199 <para>Write Me</para>
200 </listitem>
201 </varlistentry>
202
203 <varlistentry>
204 <term><parameter>GRUB_DISABLE_OS_PROBER=</parameter></term>
205 <listitem>
206 <para>Write Me</para>
207 </listitem>
208 </varlistentry>
209
210 </variablelist>
211
212 </sect2>
213
214 <sect2 id="contents-grub" role="content">
215 <title>Contents of GRUB</title>
216
217 <segmentedlist>
218 <segtitle>Installed programs</segtitle>
219 <segtitle>Installed directories</segtitle>
220
221 <seglistitem>
222 <seg>grub, grub-install, grub-md5-crypt, grub-set-default, grub-terminfo, and mbchk</seg>
223 <seg>/usr/lib/grub, /boot/grub</seg>
224 </seglistitem>
225 </segmentedlist>
226
227 <variablelist>
228 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
229 <?dbfo list-presentation="list"?>
230 <?dbhtml list-presentation="table"?>
231
232 <varlistentry id="grub">
233 <term><command>grub</command></term>
234 <listitem>
235 <para>The Grand Unified Bootloader's command shell</para>
236 <indexterm zone="ch-system-grub grub">
237 <primary sortas="b-grub">grub</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="grub-install">
243 <term><command>grub-install</command></term>
244 <listitem>
245 <para>Installs GRUB on the given device</para>
246 <indexterm zone="ch-system-grub grub-install">
247 <primary sortas="b-grub-install">grub-install</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251
252 <varlistentry id="grub-md5-crypt">
253 <term><command>grub-md5-crypt</command></term>
254 <listitem>
255 <para>Encrypts a password in MD5 format</para>
256 <indexterm zone="ch-system-grub grub-md5-crypt">
257 <primary sortas="b-grub-md5-crypt">grub-md5-crypt</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="grub-set-default">
263 <term><command>grub-set-default</command></term>
264 <listitem>
265 <para>Sets the default boot entry for GRUB</para>
266 <indexterm zone="ch-system-grub grub-set-default">
267 <primary sortas="b-grub-set-default">grub-set-default</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 <varlistentry id="grub-terminfo">
273 <term><command>grub-terminfo</command></term>
274 <listitem>
275 <para>Generates a terminfo command from a terminfo name; it can be
276 employed if an unknown terminal is being used</para>
277 <indexterm zone="ch-system-grub grub-terminfo">
278 <primary sortas="b-grub-terminfo">grub-terminfo</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 <varlistentry id="mbchk">
284 <term><command>mbchk</command></term>
285 <listitem>
286 <para>Checks the format of a multi-boot kernel</para>
287 <indexterm zone="ch-system-grub mbchk">
288 <primary sortas="b-mbchk">mbchk</primary>
289 </indexterm>
290 </listitem>
291 </varlistentry>
292
293 </variablelist>
294
295 </sect2>
296
297</sect1>
Note: See TracBrowser for help on using the repository browser.