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

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since f6c354f was 3f8be484, checked in by Jim Gifford <clfs@…>, 19 years ago

r627@server (orig r625): jim | 2005-10-31 12:59:34 -0800
Import of Cross-LFS Book

  • Property mode set to 100644
File size: 5.3 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 <!ENTITY % patches-entities SYSTEM "../../patches.ent">
6 %general-entities;
7 %patches-entities;
8]>
9<sect1 id="ch-system-grub" role="wrap">
10 <?dbhtml filename="grub.html"?>
11
12 <title>GRUB-&grub-version;</title>
13
14 <indexterm zone="ch-system-grub">
15 <primary sortas="a-GRUB">GRUB</primary>
16 </indexterm>
17
18 <sect2 role="package">
19 <title/>
20
21 <para>The GRUB package contains the GRand Unified Bootloader.</para>
22
23 <segmentedlist>
24 <segtitle>&buildtime;</segtitle>
25 <segtitle>&diskspace;</segtitle>
26
27 <seglistitem>
28 <seg>Not checked yet</seg>
29 <seg>Not checked yet</seg>
30 </seglistitem>
31 </segmentedlist>
32
33 <segmentedlist>
34 <segtitle>&dependencies;</segtitle>
35
36 <seglistitem>
37 <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Grep,
38 Make, Ncurses, and Sed</seg>
39 </seglistitem>
40 </segmentedlist>
41
42 </sect2>
43
44 <sect2 role="installation">
45 <title>Installation of GRUB</title>
46
47 <para os="a">This package is known to have issues when its default optimization
48 flags (including the <option>-march</option> and <option>-mcpu</option>
49 options) are changed. If any environment variables that override default
50 optimizations have been defined, such as <envar>CFLAGS</envar> and
51 <envar>CXXFLAGS</envar>, unset them when building GRUB.</para>
52
53 <para os="b">Prepare GRUB for compilation:</para>
54
55<screen><userinput>./configure --prefix=/usr</userinput></screen>
56
57 <para os="c">Compile the package:</para>
58
59<screen os="d"><userinput>make</userinput></screen>
60
61 <para os="e">To test the results, issue:
62 <userinput>sed -i '/ufs2/d' stage2/size_test &amp;&amp;
63 make check</userinput>.</para>
64
65 <para os="f">The UFS test is known to fail due to a compiler issue. The failure
66 prevents the rest of the tests from being run, so the <command>sed</command>
67 command is used to avoid the failure. The UFS test failure can be ignored
68 unless you plan to boot from a UFS partition. The partitions are normally
69 only used by Sun workstations.</para>
70
71 <para os="g">Install the package:</para>
72
73<screen os="h"><userinput>make install
74mkdir /boot/grub
75cp /usr/lib/grub/i386-pc/stage{1,2} /boot/grub</userinput></screen>
76
77 <para os="i">Replace <filename class="directory">i386-pc</filename> with whatever
78 directory is appropriate for the hardware in use.</para>
79
80 <para os="j">The <filename class="directory">i386-pc</filename> directory
81 contains a number of <filename>*stage1_5</filename> files, different
82 ones for different file systems. Review the files available and copy
83 the appropriate ones to the <filename
84 class="directory">/boot/grub</filename> directory. Most users will
85 copy the <filename>e2fs_stage1_5</filename> and/or
86 <filename>reiserfs_stage1_5</filename> files.</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
96 <seglistitem>
97 <seg>grub, grub-install, grub-md5-crypt, grub-terminfo, and mbchk</seg>
98 </seglistitem>
99 </segmentedlist>
100
101 <variablelist>
102 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
103 <?dbfo list-presentation="list"?>
104 <?dbhtml list-presentation="table"?>
105
106 <varlistentry id="grub">
107 <term><command>grub</command></term>
108 <listitem>
109 <para>The Grand Unified Bootloader's command shell</para>
110 <indexterm zone="ch-system-grub grub">
111 <primary sortas="b-grub">grub</primary>
112 </indexterm>
113 </listitem>
114 </varlistentry>
115
116 <varlistentry id="grub-install">
117 <term><command>grub-install</command></term>
118 <listitem>
119 <para>Installs GRUB on the given device</para>
120 <indexterm zone="ch-system-grub grub-install">
121 <primary sortas="b-grub-install">grub-install</primary>
122 </indexterm>
123 </listitem>
124 </varlistentry>
125
126 <varlistentry id="grub-md5-crypt">
127 <term><command>grub-md5-crypt</command></term>
128 <listitem>
129 <para>Encrypts a password in MD5 format</para>
130 <indexterm zone="ch-system-grub grub-md5-crypt">
131 <primary sortas="b-grub-md5-crypt">grub-md5-crypt</primary>
132 </indexterm>
133 </listitem>
134 </varlistentry>
135
136 <varlistentry id="grub-terminfo">
137 <term><command>grub-terminfo</command></term>
138 <listitem>
139 <para>Generates a terminfo command from a terminfo name; it can be
140 employed if an unknown terminal is being used</para>
141 <indexterm zone="ch-system-grub grub-terminfo">
142 <primary sortas="b-grub-terminfo">grub-terminfo</primary>
143 </indexterm>
144 </listitem>
145 </varlistentry>
146
147 <varlistentry id="mbchk">
148 <term><command>mbchk</command></term>
149 <listitem>
150 <para>Checks the format of a multi-boot kernel</para>
151 <indexterm zone="ch-system-grub mbchk">
152 <primary sortas="b-mbchk">mbchk</primary>
153 </indexterm>
154 </listitem>
155 </varlistentry>
156
157 </variablelist>
158
159 </sect2>
160
161</sect1>
Note: See TracBrowser for help on using the repository browser.