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

clfs-1.2clfs-2.1clfs-3.0.0-systemdclfs-3.0.0-sysvinitsystemdsysvinit
Last change on this file since 9f08378 was e1153ea, checked in by Jim Gifford <clfs@…>, 18 years ago

r3371@server (orig r1554): chris | 2006-05-10 14:03:44 -0700
Removed dependency info from individual package instructions

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