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

sysvinit
Last change on this file since b27081c4 was b27081c4, checked in by Chris Staub <chris@…>, 8 years ago

Put one configure option per line
  • Property mode set to 100644
File size: 8.6 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 alternative bootloaders
29      and the instructions to use them.
30      <ulink url="http://trac.clfs.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>-mtune</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="s1">Glibc-&glibc-version; does not declare gets():</para>
42
43<screen os="s2"><userinput>sed -i -e '/gets is a/d' grub-core/gnulib/stdio.in.h</userinput></screen>
44
45    <para os="a">Prepare GRUB for compilation:</para>
46
47<screen os="b"><userinput>./configure \
48    --prefix=/usr \
49    --sysconfdir=/etc \
50    --disable-werror</userinput></screen>
51
52    <para os="c">Compile the package:</para>
53
54<screen os="d"><userinput>make</userinput></screen>
55
56    <para os="e">To test GRUB you must have QEMU installed and then, issue:</para>
57
58<screen os="d2"><userinput remap="test">make check</userinput></screen>
59
60    <para os="f">Install the package:</para>
61
62<screen os="g"><userinput>make install</userinput></screen>
63
64  </sect2>
65
66  <sect2 id="conf-grub" role="configuration">
67    <title>Configuring GRUB</title>
68
69    <indexterm zone="conf-grub">
70      <primary sortas="a-GRUB">GRUB</primary>
71    <secondary>configuring</secondary></indexterm>
72
73    <indexterm zone="conf-grub">
74      <primary sortas="e-/etc/default/grub">/etc/default/grub</primary>
75    </indexterm>
76
77    <para>Now that grub is installed, we need to configure the defaults that
78    will be used to generate the configuration after we install the kernel.
79    Create this file with the following:</para>
80
81<screen><userinput>install -m755 -dv /etc/default
82cat &gt; /etc/default/grub &lt;&lt; "EOF"
83<literal># Begin /etc/default/grub
84
85GRUB_DEFAULT=0
86#GRUB_SAVEDEFAULT=true
87GRUB_HIDDEN_TIMEOUT=
88GRUB_HIDDEN_TIMEOUT_QUIET=false
89GRUB_TIMEOUT=10
90GRUB_DISTRIBUTOR=Cross-LFS
91
92GRUB_CMDLINE_LINUX=""
93GRUB_CMDLINE_LINUX_DEFAULT=""
94
95#GRUB_TERMINAL=console
96#GRUB_GFXMODE=640x480
97#GRUB_GFXPAYLOAD_LINUX=keep
98
99#GRUB_DISABLE_LINUX_UUID=true
100#GRUB_DISABLE_LINUX_RECOVERY=true
101
102#GRUB_INIT_TUNE="480 440 1"
103
104#GRUB_DISABLE_OS_PROBER=true
105
106# End /etc/default/grub</literal>
107EOF</userinput></screen>
108
109    <variablelist>
110      <title>The meaning of the above options and possible alternate
111      values:</title>
112
113    <varlistentry>
114      <term><parameter>GRUB_DEFAULT=</parameter></term>
115      <listitem>
116        <para>Write Me</para>
117      </listitem>
118    </varlistentry>
119
120    <varlistentry>
121      <term><parameter>GRUB_SAVEDEFAULT=</parameter></term>
122      <listitem>
123        <para>Write Me</para>
124      </listitem>
125    </varlistentry>
126
127    <varlistentry>
128      <term><parameter>GRUB_HIDDEN_TIMEOUT=</parameter></term>
129      <listitem>
130        <para>Write Me</para>
131      </listitem>
132    </varlistentry>
133
134    <varlistentry>
135      <term><parameter>GRUB_HIDDEN_TIMEOUT_QUIET=</parameter></term>
136      <listitem>
137        <para>Write Me</para>
138      </listitem>
139    </varlistentry>
140
141    <varlistentry>
142      <term><parameter>GRUB_TIMEOUT=</parameter></term>
143      <listitem>
144        <para>Write Me</para>
145      </listitem>
146    </varlistentry>
147
148    <varlistentry>
149      <term><parameter>GRUB_DISTRIBUTOR=</parameter></term>
150      <listitem>
151        <para>Write Me</para>
152      </listitem>
153    </varlistentry>
154
155    <varlistentry>
156      <term><parameter>GRUB_CMDLINE_LINUX=</parameter></term>
157      <listitem>
158        <para>Write Me</para>
159      </listitem>
160    </varlistentry>
161
162    <varlistentry>
163      <term><parameter>GRUB_CMDLINE_LINUX_DEFAULT=</parameter></term>
164      <listitem>
165        <para>Write Me</para>
166      </listitem>
167    </varlistentry>
168
169    <varlistentry>
170      <term><parameter>GRUB_TERMINAL=</parameter></term>
171      <listitem>
172        <para>Write Me</para>
173      </listitem>
174    </varlistentry>
175
176    <varlistentry>
177      <term><parameter>GRUB_GFXMODE=</parameter></term>
178      <listitem>
179        <para>Write Me</para>
180      </listitem>
181    </varlistentry>
182
183    <varlistentry>
184      <term><parameter>GRUB_GFXPAYLOAD_LINUX=</parameter></term>
185      <listitem>
186        <para>Write Me</para>
187      </listitem>
188    </varlistentry>
189
190    <varlistentry>
191      <term><parameter>GRUB_DEFAULT=</parameter></term>
192      <listitem>
193        <para>Write Me</para>
194      </listitem>
195    </varlistentry>
196
197    <varlistentry>
198      <term><parameter>GRUB_DISABLE_LINUX_UUID=</parameter></term>
199      <listitem>
200        <para>Write Me</para>
201      </listitem>
202    </varlistentry>
203
204    <varlistentry>
205      <term><parameter>GRUB_DISABLE_LINUX_RECOVERY=</parameter></term>
206      <listitem>
207        <para>Write Me</para>
208      </listitem>
209    </varlistentry>
210
211    <varlistentry>
212      <term><parameter>GRUB_INIT_TUNE=</parameter></term>
213      <listitem>
214        <para>Write Me</para>
215      </listitem>
216    </varlistentry>
217
218    <varlistentry>
219      <term><parameter>GRUB_DISABLE_OS_PROBER=</parameter></term>
220      <listitem>
221        <para>Write Me</para>
222      </listitem>
223    </varlistentry>
224
225    </variablelist>
226
227  </sect2>
228
229  <sect2 id="contents-grub" role="content">
230    <title>Contents of GRUB</title>
231
232    <segmentedlist>
233      <segtitle>Installed programs</segtitle>
234      <segtitle>Installed directories</segtitle>
235
236      <seglistitem>
237        <seg>grub, grub-install, grub-md5-crypt, grub-set-default, grub-terminfo, and mbchk</seg>
238        <seg>/usr/lib/grub, /boot/grub</seg>
239      </seglistitem>
240    </segmentedlist>
241
242    <variablelist>
243      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
244      <?dbfo list-presentation="list"?>
245      <?dbhtml list-presentation="table"?>
246
247      <varlistentry id="grub">
248        <term><command>grub</command></term>
249        <listitem>
250          <para>The Grand Unified Bootloader's command shell</para>
251          <indexterm zone="ch-system-grub grub">
252            <primary sortas="b-grub">grub</primary>
253          </indexterm>
254        </listitem>
255      </varlistentry>
256
257      <varlistentry id="grub-install">
258        <term><command>grub-install</command></term>
259        <listitem>
260          <para>Installs GRUB on the given device</para>
261          <indexterm zone="ch-system-grub grub-install">
262            <primary sortas="b-grub-install">grub-install</primary>
263          </indexterm>
264        </listitem>
265      </varlistentry>
266
267      <varlistentry id="grub-md5-crypt">
268        <term><command>grub-md5-crypt</command></term>
269        <listitem>
270          <para>Encrypts a password in MD5 format</para>
271          <indexterm zone="ch-system-grub grub-md5-crypt">
272            <primary sortas="b-grub-md5-crypt">grub-md5-crypt</primary>
273          </indexterm>
274        </listitem>
275      </varlistentry>
276
277      <varlistentry id="grub-set-default">
278        <term><command>grub-set-default</command></term>
279        <listitem>
280          <para>Sets the default boot entry for GRUB</para>
281          <indexterm zone="ch-system-grub grub-set-default">
282            <primary sortas="b-grub-set-default">grub-set-default</primary>
283          </indexterm>
284        </listitem>
285      </varlistentry>
286
287      <varlistentry id="grub-terminfo">
288        <term><command>grub-terminfo</command></term>
289        <listitem>
290          <para>Generates a terminfo command from a terminfo name; it can be
291          employed if an unknown terminal is being used</para>
292          <indexterm zone="ch-system-grub grub-terminfo">
293            <primary sortas="b-grub-terminfo">grub-terminfo</primary>
294          </indexterm>
295        </listitem>
296      </varlistentry>
297
298      <varlistentry id="mbchk">
299        <term><command>mbchk</command></term>
300        <listitem>
301          <para>Checks the format of a multi-boot kernel</para>
302          <indexterm zone="ch-system-grub mbchk">
303            <primary sortas="b-mbchk">mbchk</primary>
304          </indexterm>
305        </listitem>
306      </varlistentry>
307
308    </variablelist>
309
310  </sect2>
311
312</sect1>
Note: See TracBrowser for help on using the repository browser.