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

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since da9bb19 was ca9712f, checked in by Joe Ciccone <jciccone@…>, 16 years ago

Add the 256-byte innode patch to grub.

  • 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.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 <para os="p1">GRUB has an issue where it sometimes doesn't detect
27 the disk geometry correctly when used with Linux 2.6, resulting
28 in the error message <literal>Error 24: Attempt to access block outside
29 partition</literal>. The following patch contains a fix for this issue
30 as well as various fixes for raid controllers and support for the
31 new Intel Mac:</para>
32
33<screen os="p2"><userinput>patch -Np1 -i ../&grub-fixes-patch;</userinput></screen>
34
35 <para os="p3">By default, GRUB doesn't support ext2 filesystems with 256-byte inodes. Fix this by applying the following patch:</para>
36
37<screen os="p4"><userinput>patch -Np1 -i ../&grub-256byte_inode-patch;</userinput></screen>
38
39 <para os="a">This package is known to have issues when its default optimization
40 flags (including the <option>-march</option> and <option>-mcpu</option>
41 options) are changed. If any environment variables that override default
42 optimizations have been defined, such as <envar>CFLAGS</envar> and
43 <envar>CXXFLAGS</envar>, unset them when building GRUB.</para>
44
45 <para os="b">Prepare GRUB for compilation:</para>
46
47<screen><userinput>./configure --prefix=/usr</userinput></screen>
48
49 <para os="c">Compile the package:</para>
50
51<screen os="d"><userinput>make</userinput></screen>
52
53 <para os="e">To test the results, issue:
54 <userinput>make check</userinput>.</para>
55
56 <para os="f">Install the package:</para>
57
58<screen os="g"><userinput>make install
59mkdir -pv /boot/grub
60cp -v /usr/lib/grub/*/stage{1,2} /boot/grub</userinput></screen>
61
62 <para os="h">The directory in
63 <filename class="directory">/usr/lib/grub</filename> (its name depends
64 on your arch) contains a number of <filename>*stage1_5</filename> files,
65 different ones for different file systems. Review the files available and
66 copy the appropriate ones to the <filename
67 class="directory">/boot/grub</filename> directory. Most users will
68 copy the <filename>e2fs_stage1_5</filename> and/or
69 <filename>reiserfs_stage1_5</filename> files.</para>
70
71 </sect2>
72
73 <sect2 id="contents-grub" role="content">
74 <title>Contents of GRUB</title>
75
76 <segmentedlist>
77 <segtitle>Installed programs</segtitle>
78
79 <seglistitem>
80 <seg>grub, grub-install, grub-md5-crypt, grub-set-default, grub-terminfo, and mbchk</seg>
81 </seglistitem>
82 </segmentedlist>
83
84 <variablelist>
85 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
86 <?dbfo list-presentation="list"?>
87 <?dbhtml list-presentation="table"?>
88
89 <varlistentry id="grub">
90 <term><command>grub</command></term>
91 <listitem>
92 <para>The Grand Unified Bootloader's command shell</para>
93 <indexterm zone="ch-system-grub grub">
94 <primary sortas="b-grub">grub</primary>
95 </indexterm>
96 </listitem>
97 </varlistentry>
98
99 <varlistentry id="grub-install">
100 <term><command>grub-install</command></term>
101 <listitem>
102 <para>Installs GRUB on the given device</para>
103 <indexterm zone="ch-system-grub grub-install">
104 <primary sortas="b-grub-install">grub-install</primary>
105 </indexterm>
106 </listitem>
107 </varlistentry>
108
109 <varlistentry id="grub-md5-crypt">
110 <term><command>grub-md5-crypt</command></term>
111 <listitem>
112 <para>Encrypts a password in MD5 format</para>
113 <indexterm zone="ch-system-grub grub-md5-crypt">
114 <primary sortas="b-grub-md5-crypt">grub-md5-crypt</primary>
115 </indexterm>
116 </listitem>
117 </varlistentry>
118
119 <varlistentry id="grub-set-default">
120 <term><command>grub-set-default</command></term>
121 <listitem>
122 <para>Sets the default boot entry for GRUB</para>
123 <indexterm zone="ch-system-grub grub-set-default">
124 <primary sortas="b-grub-set-default">grub-set-default</primary>
125 </indexterm>
126 </listitem>
127 </varlistentry>
128
129 <varlistentry id="grub-terminfo">
130 <term><command>grub-terminfo</command></term>
131 <listitem>
132 <para>Generates a terminfo command from a terminfo name; it can be
133 employed if an unknown terminal is being used</para>
134 <indexterm zone="ch-system-grub grub-terminfo">
135 <primary sortas="b-grub-terminfo">grub-terminfo</primary>
136 </indexterm>
137 </listitem>
138 </varlistentry>
139
140 <varlistentry id="mbchk">
141 <term><command>mbchk</command></term>
142 <listitem>
143 <para>Checks the format of a multi-boot kernel</para>
144 <indexterm zone="ch-system-grub mbchk">
145 <primary sortas="b-mbchk">mbchk</primary>
146 </indexterm>
147 </listitem>
148 </varlistentry>
149
150 </variablelist>
151
152 </sect2>
153
154</sect1>
Note: See TracBrowser for help on using the repository browser.