source: chapter08/grub.xml@ 1c16a05

11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 arm ml-11.0 multilib trunk xry111/clfs-ng xry111/glibc-2.34 xry111/lfs-next xry111/tester-nohack xry111/usr-move
Last change on this file since 1c16a05 was 1c16a05, checked in by Xi Ruoyao <xry111@…>, 15 months ago

modify the reference to lfs-uefi hint to BLFS instead

  • Property mode set to 100644
File size: 13.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
8<sect1 id="ch-system-grub" role="wrap">
9 <?dbhtml filename="grub.html"?>
10
11 <sect1info condition="script">
12 <productname>grub</productname>
13 <productnumber>&grub-version;</productnumber>
14 <address>&grub-url;</address>
15 </sect1info>
16
17 <title>GRUB-&grub-version;</title>
18
19 <indexterm zone="ch-system-grub">
20 <primary sortas="a-Grub">GRUB</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The GRUB package contains the GRand Unified Bootloader.</para>
27
28 <segmentedlist>
29 <segtitle>&buildtime;</segtitle>
30 <segtitle>&diskspace;</segtitle>
31
32 <seglistitem>
33 <seg>&grub-fin-sbu;</seg>
34 <seg>&grub-fin-du;</seg>
35 </seglistitem>
36 </segmentedlist>
37
38 </sect2>
39
40 <sect2 role="installation">
41 <title>Installation of GRUB</title>
42
43 <note>
44 <para>
45 If your system has UEFI support and you wish to boot LFS with UEFI,
46 you can skip this package in LFS,
47 and install GRUB with UEFI support (and its dependencies) following
48 <ulink url="&blfs-book;postlfs/grub-efi.html">the BLFS page</ulink>
49 at the end of this chapter.
50 </para>
51 </note>
52
53 <para>Prepare GRUB for compilation:</para>
54
55<screen><userinput remap="configure">./configure --prefix=/usr \
56 --sbindir=/sbin \
57 --sysconfdir=/etc \
58 --disable-efiemu \
59 --disable-werror</userinput></screen>
60
61 <variablelist>
62 <title>The meaning of the new configure options:</title>
63
64 <varlistentry>
65 <term><parameter>--disable-werror</parameter></term>
66 <listitem>
67 <para>This allows the build to complete with warnings introduced
68 by more recent Flex versions.</para>
69 </listitem>
70 </varlistentry>
71
72 <varlistentry>
73 <term><parameter>--disable-efiemu</parameter></term>
74 <listitem>
75 <para>This option minimizes what is built by disabling a feature and
76 testing programs not needed for LFS.</para>
77 </listitem>
78 </varlistentry>
79
80 </variablelist>
81
82 <para>Compile the package:</para>
83
84<screen><userinput remap="make">make</userinput></screen>
85
86 <para>The test suite for this packages is not recommended. Most of
87 the tests depend on packages that are not available in the limited
88 LFS environment. To run the tests anyway, run <command>make check</command>.</para>
89
90 <para>Install the package:</para>
91
92<screen><userinput remap="install">make install
93mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userinput></screen>
94
95 <para>Using GRUB to make your LFS system bootable will be discussed in
96 <xref linkend="ch-bootable-grub"/>.</para>
97
98 </sect2>
99
100 <sect2 id="contents-gRUB" role="content">
101 <title>Contents of GRUB</title>
102
103 <segmentedlist>
104 <segtitle>Installed programs</segtitle>
105 <segtitle>Installed directories</segtitle>
106
107 <seglistitem>
108
109 <seg>grub-bios-setup, grub-editenv, grub-file, grub-fstest,
110 grub-glue-efi, grub-install, grub-kbdcomp, grub-macbless,
111 grub-menulst2cfg, grub-mkconfig,
112 grub-mkimage, grub-mklayout, grub-mknetdir,
113 grub-mkpasswd-pbkdf2, grub-mkrelpath, grub-mkrescue, grub-mkstandalone,
114 grub-ofpathname, grub-probe, grub-reboot, grub-render-label,
115 grub-script-check,
116 grub-set-default, grub-sparc64-setup, and grub-syslinux2cfg</seg>
117
118 <seg>/usr/lib/grub, /etc/grub.d, /usr/share/grub, and /boot/grub (when grub-install
119 is first run)</seg>
120 </seglistitem>
121 </segmentedlist>
122
123 <variablelist>
124 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
125 <?dbfo list-presentation="list"?>
126 <?dbhtml list-presentation="table"?>
127
128 <varlistentry id="grub-bios-setup">
129 <term><command>grub-bios-setup</command></term>
130 <listitem>
131 <para>Is a helper program for grub-install</para>
132 <indexterm zone="ch-system-grub grub-bios-setup">
133 <primary sortas="b-grub-bios-setup">grub-bios-setup</primary>
134 </indexterm>
135 </listitem>
136 </varlistentry>
137
138 <varlistentry id="grub-editenv">
139 <term><command>grub-editenv</command></term>
140 <listitem>
141 <para>A tool to edit the environment block</para>
142 <indexterm zone="ch-system-grub grub-editenv">
143 <primary sortas="b-grub-editenv">grub-editenv</primary>
144 </indexterm>
145 </listitem>
146 </varlistentry>
147
148 <varlistentry id="grub-file">
149 <term><command>grub-file</command></term>
150 <listitem>
151 <para>Checks if FILE is of the specified type.</para>
152 <indexterm zone="ch-system-grub grub-file">
153 <primary sortas="b-grub-file">grub-file</primary>
154 </indexterm>
155 </listitem>
156 </varlistentry>
157
158 <varlistentry id="grub-fstest">
159 <term><command>grub-fstest</command></term>
160 <listitem>
161 <para>Tool to debug the filesystem driver</para>
162 <indexterm zone="ch-system-grub grub-fstest">
163 <primary sortas="b-grub-fstest">grub-fstest</primary>
164 </indexterm>
165 </listitem>
166 </varlistentry>
167
168 <varlistentry id="grub-glue-efi">
169 <term><command>grub-glue-efi</command></term>
170 <listitem>
171 <para>Processes ia32 and amd64 EFI images and glues them
172 according to Apple format.</para>
173 <indexterm zone="ch-system-grub grub-glue-efi">
174 <primary sortas="b-grub-glue-efi">grub-glue-efi</primary>
175 </indexterm>
176 </listitem>
177 </varlistentry>
178
179 <varlistentry id="grub-install">
180 <term><command>grub-install</command></term>
181 <listitem>
182 <para>Install GRUB on your drive</para>
183 <indexterm zone="ch-system-grub grub-install">
184 <primary sortas="b-grub-install">grub-install</primary>
185 </indexterm>
186 </listitem>
187 </varlistentry>
188
189 <varlistentry id="grub-kbdcomp">
190 <term><command>grub-kbdcomp</command></term>
191 <listitem>
192 <para>Script that converts an xkb layout into one recognized by
193 GRUB</para>
194 <indexterm zone="ch-system-grub grub-kbdcomp">
195 <primary sortas="b-grub-kbdcomp">grub-kbdcomp</primary>
196 </indexterm>
197 </listitem>
198 </varlistentry>
199
200 <varlistentry id="grub-macbless">
201 <term><command>grub-macbless</command></term>
202 <listitem>
203 <para>Mac-style bless on HFS or HFS+ files</para>
204 <indexterm zone="ch-system-grub grub-macbless">
205 <primary sortas="b-grub-macbless">grub-macbless</primary>
206 </indexterm>
207 </listitem>
208 </varlistentry>
209
210 <varlistentry id="grub-menulst2cfg">
211 <term><command>grub-menulst2cfg</command></term>
212 <listitem>
213 <para>Converts a GRUB Legacy <filename>menu.lst</filename>
214 into a <filename>grub.cfg</filename> for use with GRUB 2</para>
215 <indexterm zone="ch-system-grub grub-menulst2cfg">
216 <primary sortas="b-grub-menulst2cfg">grub-menulst2cfg</primary>
217 </indexterm>
218 </listitem>
219 </varlistentry>
220
221 <varlistentry id="grub-mkconfig">
222 <term><command>grub-mkconfig</command></term>
223 <listitem>
224 <para>Generate a grub config file</para>
225 <indexterm zone="ch-system-grub grub-mkconfig">
226 <primary sortas="b-grub-mkconfig">grub-mkconfig</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231 <varlistentry id="grub-mkimage">
232 <term><command>grub-mkimage</command></term>
233 <listitem>
234 <para>Make a bootable image of GRUB</para>
235 <indexterm zone="ch-system-grub grub-mkimage">
236 <primary sortas="b-grub-mkimage">grub-mkimage</primary>
237 </indexterm>
238 </listitem>
239 </varlistentry>
240
241 <varlistentry id="grub-mklayout">
242 <term><command>grub-mklayout</command></term>
243 <listitem>
244 <para>Generates a GRUB keyboard layout file</para>
245 <indexterm zone="ch-system-grub grub-mklayout">
246 <primary sortas="b-grub-mklayout">grub-mklayout</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250
251 <varlistentry id="grub-mknetdir">
252 <term><command>grub-mknetdir</command></term>
253 <listitem>
254 <para>Prepares a GRUB netboot directory</para>
255 <indexterm zone="ch-system-grub grub-mknetdir">
256 <primary sortas="b-grub-mknetdir">grub-mknetdir</primary>
257 </indexterm>
258 </listitem>
259 </varlistentry>
260
261 <varlistentry id="grub-mkpasswd-pbkdf2">
262 <term><command>grub-mkpasswd-pbkdf2</command></term>
263 <listitem>
264 <para>Generates an encrypted PBKDF2 password for use in the boot
265 menu</para>
266 <indexterm zone="ch-system-grub grub-mkpasswd-pbkdf2">
267 <primary sortas="b-grub-mkpasswd-pbkdf2">grub-mkpasswd-pbkdf2</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 <varlistentry id="grub-mkrelpath">
273 <term><command>grub-mkrelpath</command></term>
274 <listitem>
275 <para>Makes a system pathname relative to its root</para>
276 <indexterm zone="ch-system-grub grub-mkrelpath">
277 <primary sortas="b-grub-mkrelpath">grub-mkrelpath</primary>
278 </indexterm>
279 </listitem>
280 </varlistentry>
281
282 <varlistentry id="grub-mkrescue">
283 <term><command>grub-mkrescue</command></term>
284 <listitem>
285 <para>Make a bootable image of GRUB suitable for a floppy disk or CDROM/DVD</para>
286 <indexterm zone="ch-system-grub grub-mkrescue">
287 <primary sortas="b-grub-mkrescue">grub-mkrescue</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 <varlistentry id="grub-mkstandalone">
293 <term><command>grub-mkstandalone</command></term>
294 <listitem>
295 <para>Generates a standalone image</para>
296 <indexterm zone="ch-system-grub grub-mkstandalone">
297 <primary sortas="b-grub-mkstandalone">grub-mkstandalone</primary>
298 </indexterm>
299 </listitem>
300 </varlistentry>
301
302 <varlistentry id="grub-ofpathname">
303 <term><command>grub-ofpathname</command></term>
304 <listitem>
305 <para>Is a helper program that prints the path of a GRUB device</para>
306 <indexterm zone="ch-system-grub grub-ofpathname">
307 <primary sortas="b-grub-ofpathname">grub-ofpathname</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311
312 <varlistentry id="grub-probe">
313 <term><command>grub-probe</command></term>
314 <listitem>
315 <para>Probe device information for a given path or device</para>
316 <indexterm zone="ch-system-grub grub-probe">
317 <primary sortas="b-grub-probe">grub-probe</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="grub-reboot">
323 <term><command>grub-reboot</command></term>
324 <listitem>
325 <para>Sets the default boot entry for GRUB for the next boot only</para>
326 <indexterm zone="ch-system-grub grub-reboot">
327 <primary sortas="b-grub-reboot">grub-reboot</primary>
328 </indexterm>
329 </listitem>
330 </varlistentry>
331
332 <varlistentry id="grub-render-label">
333 <term><command>grub-render-label</command></term>
334 <listitem>
335 <para>Render Apple .disk_label for Apple Macs</para>
336 <indexterm zone="ch-system-grub grub-render-label">
337 <primary sortas="b-grub-render-label">grub-render-label</primary>
338 </indexterm>
339 </listitem>
340 </varlistentry>
341
342 <varlistentry id="grub-script-check">
343 <term><command>grub-script-check</command></term>
344 <listitem>
345 <para>Checks GRUB configuration script for syntax errors</para>
346 <indexterm zone="ch-system-grub grub-script-check">
347 <primary sortas="b-grub-script-check">grub-script-check</primary>
348 </indexterm>
349 </listitem>
350 </varlistentry>
351
352 <varlistentry id="grub-set-default">
353 <term><command>grub-set-default</command></term>
354 <listitem>
355 <para>Sets the default boot entry for GRUB</para>
356 <indexterm zone="ch-system-grub grub-set-default">
357 <primary sortas="b-grub-set-default">grub-set-default</primary>
358 </indexterm>
359 </listitem>
360 </varlistentry>
361
362 <varlistentry id="grub-sparc64-setup">
363 <term><command>grub-sparc64-setup</command></term>
364 <listitem>
365 <para>Is a helper program for grub-setup</para>
366 <indexterm zone="ch-system-grub grub-sparc64-setup">
367 <primary sortas="b-grub-sparc64-setup">grub-setup</primary>
368 </indexterm>
369 </listitem>
370 </varlistentry>
371
372 <varlistentry id="grub-syslinux2cfg">
373 <term><command>grub-syslinux2cfg</command></term>
374 <listitem>
375 <para>Transform a syslinux config file into grub.cfg format</para>
376 <indexterm zone="ch-system-grub grub-syslinux2cfg">
377 <primary sortas="b-grub-syslinux2cfg">grub-syslinux2cfg</primary>
378 </indexterm>
379 </listitem>
380 </varlistentry>
381
382 </variablelist>
383
384 </sect2>
385
386</sect1>
Note: See TracBrowser for help on using the repository browser.