source: chapter08/grub.xml@ fa510ae

11.0 11.0-rc1 11.0-rc2 11.0-rc3 ml-11.0 multilib trunk xry111/git-transition xry111/glibc-2.34 xry111/tester-nohack xry111/usr-move
Last change on this file since fa510ae was fa510ae, checked in by Bruce Dubbs <bdubbs@…>, 9 months ago

Update to vim-8.2.2604.
Update to iana-etc-20210304.
Update to zstd-1.4.9.
Update to sysvinit-2.99.
Update to linux-5.11.6.
Update to libcap-2.49.
Update to iproute2-5.11.0.
Update to e2fsprogs-1.46.2.
Update to bison-3.7.6.
Update to bc-3.3.3.
Update to attr-2.5.0.
Update to acl-2.3.0.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@12164 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

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