source: BOOK/final-system/x86/grub.xml@ 73d050d

Last change on this file since 73d050d was 2218c5e, checked in by Joe Ciccone <jciccone@…>, 14 years ago

Fix a compilation error with grub.
  • Property mode set to 100644
File size: 8.4 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 --disable-werror</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#GRUB_GFXPAYLOAD_LINUX=keep
91
92#GRUB_DISABLE_LINUX_UUID=true
93#GRUB_DISABLE_LINUX_RECOVERY=true
94
95#GRUB_INIT_TUNE="480 440 1"
96
97#GRUB_DISABLE_OS_PROBER=true
98
99# End /etc/default/grub</literal>
100EOF</userinput></screen>
101
102 <variablelist>
103 <title>The meaning of the above options and possible alternate
104 values:</title>
105
106 <varlistentry>
107 <term><parameter>GRUB_DEFAULT=</parameter></term>
108 <listitem>
109 <para>Write Me</para>
110 </listitem>
111 </varlistentry>
112
113 <varlistentry>
114 <term><parameter>GRUB_SAVEDEFAULT=</parameter></term>
115 <listitem>
116 <para>Write Me</para>
117 </listitem>
118 </varlistentry>
119
120 <varlistentry>
121 <term><parameter>GRUB_HIDDEN_TIMEOUT=</parameter></term>
122 <listitem>
123 <para>Write Me</para>
124 </listitem>
125 </varlistentry>
126
127 <varlistentry>
128 <term><parameter>GRUB_HIDDEN_TIMEOUT_QUIET=</parameter></term>
129 <listitem>
130 <para>Write Me</para>
131 </listitem>
132 </varlistentry>
133
134 <varlistentry>
135 <term><parameter>GRUB_TIMEOUT=</parameter></term>
136 <listitem>
137 <para>Write Me</para>
138 </listitem>
139 </varlistentry>
140
141 <varlistentry>
142 <term><parameter>GRUB_DISTRIBUTOR=</parameter></term>
143 <listitem>
144 <para>Write Me</para>
145 </listitem>
146 </varlistentry>
147
148 <varlistentry>
149 <term><parameter>GRUB_CMDLINE_LINUX=</parameter></term>
150 <listitem>
151 <para>Write Me</para>
152 </listitem>
153 </varlistentry>
154
155 <varlistentry>
156 <term><parameter>GRUB_CMDLINE_LINUX_DEFAULT=</parameter></term>
157 <listitem>
158 <para>Write Me</para>
159 </listitem>
160 </varlistentry>
161
162 <varlistentry>
163 <term><parameter>GRUB_TERMINAL=</parameter></term>
164 <listitem>
165 <para>Write Me</para>
166 </listitem>
167 </varlistentry>
168
169 <varlistentry>
170 <term><parameter>GRUB_GFXMODE=</parameter></term>
171 <listitem>
172 <para>Write Me</para>
173 </listitem>
174 </varlistentry>
175
176 <varlistentry>
177 <term><parameter>GRUB_GFXPAYLOAD_LINUX=</parameter></term>
178 <listitem>
179 <para>Write Me</para>
180 </listitem>
181 </varlistentry>
182
183 <varlistentry>
184 <term><parameter>GRUB_DEFAULT=</parameter></term>
185 <listitem>
186 <para>Write Me</para>
187 </listitem>
188 </varlistentry>
189
190 <varlistentry>
191 <term><parameter>GRUB_DISABLE_LINUX_UUID=</parameter></term>
192 <listitem>
193 <para>Write Me</para>
194 </listitem>
195 </varlistentry>
196
197 <varlistentry>
198 <term><parameter>GRUB_DISABLE_LINUX_RECOVERY=</parameter></term>
199 <listitem>
200 <para>Write Me</para>
201 </listitem>
202 </varlistentry>
203
204 <varlistentry>
205 <term><parameter>GRUB_INIT_TUNE=</parameter></term>
206 <listitem>
207 <para>Write Me</para>
208 </listitem>
209 </varlistentry>
210
211 <varlistentry>
212 <term><parameter>GRUB_DISABLE_OS_PROBER=</parameter></term>
213 <listitem>
214 <para>Write Me</para>
215 </listitem>
216 </varlistentry>
217
218 </variablelist>
219
220 </sect2>
221
222 <sect2 id="contents-grub" role="content">
223 <title>Contents of GRUB</title>
224
225 <segmentedlist>
226 <segtitle>Installed programs</segtitle>
227 <segtitle>Installed directories</segtitle>
228
229 <seglistitem>
230 <seg>grub, grub-install, grub-md5-crypt, grub-set-default, grub-terminfo, and mbchk</seg>
231 <seg>/usr/lib/grub, /boot/grub</seg>
232 </seglistitem>
233 </segmentedlist>
234
235 <variablelist>
236 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
237 <?dbfo list-presentation="list"?>
238 <?dbhtml list-presentation="table"?>
239
240 <varlistentry id="grub">
241 <term><command>grub</command></term>
242 <listitem>
243 <para>The Grand Unified Bootloader's command shell</para>
244 <indexterm zone="ch-system-grub grub">
245 <primary sortas="b-grub">grub</primary>
246 </indexterm>
247 </listitem>
248 </varlistentry>
249
250 <varlistentry id="grub-install">
251 <term><command>grub-install</command></term>
252 <listitem>
253 <para>Installs GRUB on the given device</para>
254 <indexterm zone="ch-system-grub grub-install">
255 <primary sortas="b-grub-install">grub-install</primary>
256 </indexterm>
257 </listitem>
258 </varlistentry>
259
260 <varlistentry id="grub-md5-crypt">
261 <term><command>grub-md5-crypt</command></term>
262 <listitem>
263 <para>Encrypts a password in MD5 format</para>
264 <indexterm zone="ch-system-grub grub-md5-crypt">
265 <primary sortas="b-grub-md5-crypt">grub-md5-crypt</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="grub-set-default">
271 <term><command>grub-set-default</command></term>
272 <listitem>
273 <para>Sets the default boot entry for GRUB</para>
274 <indexterm zone="ch-system-grub grub-set-default">
275 <primary sortas="b-grub-set-default">grub-set-default</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="grub-terminfo">
281 <term><command>grub-terminfo</command></term>
282 <listitem>
283 <para>Generates a terminfo command from a terminfo name; it can be
284 employed if an unknown terminal is being used</para>
285 <indexterm zone="ch-system-grub grub-terminfo">
286 <primary sortas="b-grub-terminfo">grub-terminfo</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="mbchk">
292 <term><command>mbchk</command></term>
293 <listitem>
294 <para>Checks the format of a multi-boot kernel</para>
295 <indexterm zone="ch-system-grub mbchk">
296 <primary sortas="b-mbchk">mbchk</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 </variablelist>
302
303 </sect2>
304
305</sect1>
Note: See TracBrowser for help on using the repository browser.