source: final-system/x86/grub.xml@ 30e566e

Last change on this file since 30e566e was 2659c74, checked in by Jim Gifford <clfs@…>, 19 years ago

r677@server (orig r675): manuel | 2005-11-10 03:13:57 -0800
Including patches.ent from general.ent

  • Property mode set to 100644
File size: 5.0 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 <segmentedlist>
22 <segtitle>&dependencies;</segtitle>
23
24 <seglistitem>
25 <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Grep,
26 Make, Ncurses, and Sed</seg>
27 </seglistitem>
28 </segmentedlist>
29
30 </sect2>
31
32 <sect2 role="installation">
33 <title>Installation of GRUB</title>
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>sed -i '/ufs2/d' stage2/size_test &amp;&amp;
51 make check</userinput>.</para>
52
53 <para os="f">The UFS test is known to fail due to a compiler issue. The failure
54 prevents the rest of the tests from being run, so the <command>sed</command>
55 command is used to avoid the failure. The UFS test failure can be ignored
56 unless you plan to boot from a UFS partition. The partitions are normally
57 only used by Sun workstations.</para>
58
59 <para os="g">Install the package:</para>
60
61<screen os="h"><userinput>make install
62mkdir /boot/grub
63cp /usr/lib/grub/i386-pc/stage{1,2} /boot/grub</userinput></screen>
64
65 <para os="i">Replace <filename class="directory">i386-pc</filename> with whatever
66 directory is appropriate for the hardware in use.</para>
67
68 <para os="j">The <filename class="directory">i386-pc</filename> directory
69 contains a number of <filename>*stage1_5</filename> files, different
70 ones for different file systems. Review the files available and copy
71 the appropriate ones to the <filename
72 class="directory">/boot/grub</filename> directory. Most users will
73 copy the <filename>e2fs_stage1_5</filename> and/or
74 <filename>reiserfs_stage1_5</filename> files.</para>
75
76 </sect2>
77
78 <sect2 id="contents-grub" role="content">
79 <title>Contents of GRUB</title>
80
81 <segmentedlist>
82 <segtitle>Installed programs</segtitle>
83
84 <seglistitem>
85 <seg>grub, grub-install, grub-md5-crypt, grub-terminfo, and mbchk</seg>
86 </seglistitem>
87 </segmentedlist>
88
89 <variablelist>
90 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
91 <?dbfo list-presentation="list"?>
92 <?dbhtml list-presentation="table"?>
93
94 <varlistentry id="grub">
95 <term><command>grub</command></term>
96 <listitem>
97 <para>The Grand Unified Bootloader's command shell</para>
98 <indexterm zone="ch-system-grub grub">
99 <primary sortas="b-grub">grub</primary>
100 </indexterm>
101 </listitem>
102 </varlistentry>
103
104 <varlistentry id="grub-install">
105 <term><command>grub-install</command></term>
106 <listitem>
107 <para>Installs GRUB on the given device</para>
108 <indexterm zone="ch-system-grub grub-install">
109 <primary sortas="b-grub-install">grub-install</primary>
110 </indexterm>
111 </listitem>
112 </varlistentry>
113
114 <varlistentry id="grub-md5-crypt">
115 <term><command>grub-md5-crypt</command></term>
116 <listitem>
117 <para>Encrypts a password in MD5 format</para>
118 <indexterm zone="ch-system-grub grub-md5-crypt">
119 <primary sortas="b-grub-md5-crypt">grub-md5-crypt</primary>
120 </indexterm>
121 </listitem>
122 </varlistentry>
123
124 <varlistentry id="grub-terminfo">
125 <term><command>grub-terminfo</command></term>
126 <listitem>
127 <para>Generates a terminfo command from a terminfo name; it can be
128 employed if an unknown terminal is being used</para>
129 <indexterm zone="ch-system-grub grub-terminfo">
130 <primary sortas="b-grub-terminfo">grub-terminfo</primary>
131 </indexterm>
132 </listitem>
133 </varlistentry>
134
135 <varlistentry id="mbchk">
136 <term><command>mbchk</command></term>
137 <listitem>
138 <para>Checks the format of a multi-boot kernel</para>
139 <indexterm zone="ch-system-grub mbchk">
140 <primary sortas="b-mbchk">mbchk</primary>
141 </indexterm>
142 </listitem>
143 </varlistentry>
144
145 </variablelist>
146
147 </sect2>
148
149</sect1>
Note: See TracBrowser for help on using the repository browser.