source: final-system/x86/grub.xml @ 0a34c2a

Last change on this file since 0a34c2a was 0a34c2a, checked in by Chris Staub <chris@…>, 14 years ago

Fixed issue that would cause a 'File exists' error if you followed the boot method on x86 (thanks jeremy)

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