newxml/chapter06/grub.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
   3   <!ENTITY % general-entities SYSTEM "../general.ent">
   4   %general-entities;
   5 ]>
   6 <sect1 id="ch-system-grub" xreflabel="Grub">
   7 <title>Grub-&grub-version;</title>
   8 <?dbhtml filename="grub.html"?>
   9
  10 <indexterm zone="ch-system-grub"><primary sortas="a-Grub">Grub</primary></indexterm>
  11
  12 <para>The Grub package contains the GRand Unified Bootloader.</para>
  13
  14 <screen>&buildtime; 0.2 SBU
  15 &diskspace; 10 MB</screen>
  16
  17 <para>Grub installation depends on: Bash, Binutils, Coreutils, Diffutils,
  18 GCC, Glibc, Grep, Make, Ncurses, Sed.</para>
  19
  20
  21
  22 <sect2>
  23 <title>Installation of Grub</title>
  24
  25 <para>This package is known to behave badly when you have changed its default
  26 optimization flags (including the -march and -mcpu options). Therefore, if you
  27 have defined any environment variables that override default optimizations,
  28 such as CFLAGS and CXXFLAGS, we recommend un-setting them when building
  29 Grub.</para>
  30
  31 <para>First prepare Grub for compilation:</para>
  32
  33 <screen><userinput>./configure --prefix=/usr</userinput></screen>
  34
  35 <para>Compile the package:</para>
  36
  37 <screen><userinput>make</userinput></screen>
  38
  39 <para>Now install it:</para>
  40
  41 <screen><userinput>make install
  42 mkdir /boot/grub
  43 cp /usr/share/grub/i386-pc/stage{1,2} /boot/grub</userinput></screen>
  44
  45 <para>Replace <filename class="directory">i386-pc</filename> with whatever
  46 directory is appropriate for your hardware.</para>
  47
  48 <para>The <filename class="directory">i386-pc</filename> directory also
  49 contains a number of <filename>*stage1_5</filename> files, different ones
  50 for different file systems. Have a look at the ones available and copy the
  51 appropriate ones to the <filename class="directory">/boot/grub</filename>
  52 directory. Most people will copy the <filename>e2fs_stage1_5</filename>
  53 and/or <filename>reiserfs_stage1_5</filename> files.</para>
  54
  55 </sect2>
  56
  57
  58 <sect2 id="contents-grub"><title>Contents of Grub</title>
  59
  60 <para><emphasis>Installed programs</emphasis>: grub, grub-install,
  61 grub-md5-crypt, grub-terminfo and mbchk</para>
  62
  63 </sect2>
  64
  65 <sect2><title>Short descriptions</title>
  66
  67 <indexterm zone="ch-system-grub grub"><primary sortas="b-grub">grub</primary></indexterm>
  68 <para id="grub"><command>grub</command> is the GRand Unified Bootloader's command
  69 shell.</para>
  70
  71 <indexterm zone="ch-system-grub grub-install"><primary sortas="b-grub-install">grub-install</primary></indexterm>
  72 <para id="grub-install"><command>grub-install</command> installs GRUB on the given device.</para>
  73
  74 <indexterm zone="ch-system-grub grub-md5-crypt"><primary sortas="b-grub-md5-crypt">grub-md5-crypt</primary></indexterm>
  75 <para id="grub-md5-crypt"><command>grub-md5-crypt</command> encrypts a password in MD5
  76 format.</para>
  77
  78 <indexterm zone="ch-system-grub grub-terminfo"><primary sortas="b-grub-terminfo">grub-terminfo</primary></indexterm>
  79 <para id="grub-terminfo"><command>grub-terminfo</command> generates a terminfo command from a
  80 terminfo name. It can be used if you have an uncommon terminal.</para>
  81
  82 <indexterm zone="ch-system-grub mbchk"><primary sortas="b-mbchk">mbchk</primary></indexterm>
  83 <para id="mbchk"><command>mbchk</command> checks the format of a multi-boot kernel.</para>
  84
  85 </sect2>
  86
  87
  88 </sect1>