prologue/hostreqs.xml

   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
   8 <sect1 id="pre-hostreqs">
   9   <?dbhtml filename="hostreqs.html"?>
  10
  11   <title>Host System Requirements</title>
  12
  13     <para>Your host system should have the following software with the
  14     minimum versions indicated. This should not be an issue for most
  15     modern Linux distributions. Also note that many distributions will
  16     place software headers into separate packages, often in the form of
  17     <quote>&lt;package-name&gt;-devel</quote> or
  18     <quote>&lt;package-name&gt;-dev</quote>. Be sure to install those if
  19     your distribution provides them.</para>
  20
  21    <para>Earlier versions of the listed software packages may work, but has not
  22    been tested.</para>
  23
  24   <itemizedlist spacing="compact">
  25
  26     <listitem>
  27       <para><emphasis role="strong">Bash-3.2</emphasis> (/bin/sh
  28       should be a symbolic or hard link to bash)</para>
  29     </listitem>
  30
  31     <listitem>
  32       <para><emphasis role="strong">Binutils-2.17</emphasis> (Versions
  33       greater than &binutils-version; are not recommended as they have
  34       not been tested)</para>
  35     </listitem>
  36
  37     <listitem>
  38       <para><emphasis role="strong">Bison-2.3</emphasis> (/usr/bin/yacc
  39       should be a link to bison or small script that executes bison)</para>
  40     </listitem>
  41
  42     <listitem>
  43       <para><emphasis role="strong">Bzip2-1.0.4</emphasis></para>
  44     </listitem>
  45
  46     <listitem>
  47       <para><emphasis role="strong">Coreutils-6.9</emphasis></para>
  48     </listitem>
  49
  50     <listitem>
  51       <para><emphasis role="strong">Diffutils-2.8.1</emphasis></para>
  52     </listitem>
  53
  54     <listitem>
  55       <para><emphasis role="strong">Findutils-4.2.31</emphasis></para>
  56     </listitem>
  57
  58     <listitem>
  59       <para><emphasis role="strong">Gawk-3.1.5</emphasis> (/usr/bin/awk
  60       should be a link to gawk)</para>
  61     </listitem>
  62
  63     <listitem>
  64       <para><emphasis role="strong">Gcc-4.1.2</emphasis> (Versions
  65       greater than &gcc-version; are not recommended as they have not
  66       been tested)</para>
  67     </listitem>
  68
  69     <listitem>
  70       <para><emphasis role="strong">Glibc-2.5.1</emphasis> (Versions
  71       greater than &glibc-version; are not recommended as they have
  72       not been tested)</para>
  73     </listitem>
  74
  75     <listitem>
  76       <para><emphasis role="strong">Grep-2.5.1a</emphasis></para>
  77     </listitem>
  78
  79     <listitem>
  80       <para><emphasis role="strong">Gzip-1.3.12</emphasis></para>
  81     </listitem>
  82
  83     <listitem>
  84       <para><emphasis role="strong">Linux Kernel-2.6.25</emphasis>
  85       (having been compiled with GCC-4.1.2 or greater)</para>
  86
  87       <para>The reason for the kernel version requirement is that we specify
  88       that version when building <application>glibc</application> in Chapter 6
  89       at the recommendation of the developers.  It is also required by
  90       udev.</para>
  91
  92       <para>If the host kernel is either earlier than 2.6.25, or it was not
  93       compiled using a GCC-4.1.2 (or later) compiler, you will need to replace
  94       the kernel with one adhering to the specifications. There are two ways
  95       you can go about this. First, see if your Linux vendor provides a 2.6.25
  96       or later kernel package. If so, you may wish to install it. If your
  97       vendor doesn't offer an acceptable kernel package, or you would prefer not to
  98       install it, you can compile a kernel yourself. Instructions for
  99       compiling the kernel and configuring the boot loader (assuming the host
 100       uses GRUB) are located in <xref linkend="chapter-bootable"/>.</para>
 101
 102     </listitem>
 103
 104     <listitem>
 105       <para><emphasis role="strong">M4-1.4.10</emphasis></para>
 106     </listitem>
 107
 108     <listitem>
 109       <para><emphasis role="strong">Make-3.81</emphasis></para>
 110     </listitem>
 111
 112     <listitem>
 113       <para><emphasis role="strong">Patch-2.5.4</emphasis></para>
 114     </listitem>
 115
 116     <listitem>
 117       <para><emphasis role="strong">Perl-5.8.8</emphasis></para>
 118     </listitem>
 119
 120     <listitem>
 121       <para><emphasis role="strong">Sed-4.1.5</emphasis></para>
 122     </listitem>
 123
 124     <listitem>
 125       <para><emphasis role="strong">Tar-1.18</emphasis></para>
 126     </listitem>
 127
 128     <!-- Needed by the apparently broken Binutils-2.18 -->
 129     <listitem>
 130       <para><emphasis role="strong">Texinfo-4.9</emphasis></para>
 131     </listitem>
 132
 133   </itemizedlist>
 134
 135   <para>Note that the symlinks mentioned above are required to build an LFS
 136   system using the instructions contained within this book. Symlinks that
 137   point to other software (such as dash, mawk, etc.) may work, but are not
 138   tested or supported by the LFS development team, and may require either
 139   deviation from the instructions or additional patches to some
 140   packages.</para>
 141
 142   <para id="version-check">To see whether your host system has all the appropriate versions, and
 143   the ability to compile programs, run the following:</para>
 144
 145 <!--<anchor xreflabel="Version Check Script" id="version-check"/>-->
 146 <screen role="nodump"><userinput>cat &gt; version-check.sh &lt;&lt; "EOF"
 147 <literal>#!/bin/bash
 148 export LC_ALL=C
 149
 150 # Simple script to list version numbers of critical development tools
 151
 152 bash --version | head -n1 | cut -d" " -f2-4
 153 echo "/bin/sh -> `readlink -f /bin/sh`"
 154 echo -n "Binutils: "; ld --version | head -n1 | cut -d" " -f3-
 155 bison --version | head -n1
 156 if [ -e /usr/bin/yacc ];
 157   then echo "/usr/bin/yacc -> `readlink -f /usr/bin/yacc`";
 158   else echo "yacc not found"; fi
 159 bzip2 --version 2&gt;&amp;1 &lt; /dev/null | head -n1 | cut -d" " -f1,6-
 160 echo -n "Coreutils: "; chown --version | head -n1 | cut -d")" -f2
 161 diff --version | head -n1
 162 find --version | head -n1
 163 gawk --version | head -n1
 164 if [ -e /usr/bin/awk ];
 165   then echo "/usr/bin/awk -> `readlink -f /usr/bin/awk`";
 166   else echo "awk not found"; fi
 167 gcc --version | head -n1
 168 /lib/libc.so.6 | head -n1 | cut -d"," -f1
 169 grep --version | head -n1
 170 gzip --version | head -n1
 171 cat /proc/version
 172 m4 --version | head -n1
 173 make --version | head -n1
 174 patch --version | head -n1
 175 echo Perl `perl -V:version`
 176 sed --version | head -n1
 177 tar --version | head -n1
 178 echo "Texinfo: `makeinfo --version | head -n1`"
 179 echo 'main(){}' > dummy.c &amp;&amp; gcc -o dummy dummy.c
 180 if [ -x dummy ]; then echo "Compilation OK";
 181   else echo "Compilation failed"; fi
 182 rm -f dummy.c dummy
 183 </literal>
 184 EOF
 185
 186 bash version-check.sh</userinput></screen>
 187
 188 </sect1>