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" xreflabel="Host System Requirements">
   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-4.0.1</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> including the C++
  65       compiler, <command>g++</command> (Versions greater than &gcc-version; are
  66       not recommended as they have not been tested)</para>
  67
  68       <note><para>On some distributions, there have been reports that some
  69       libraries used by gcc can be in an inconsistent state and that this
  70       interferes with building some LFS packages.  To check this, look in
  71       /usr/lib and possibly /usr/lib64 for libgmp.la, libmpfr.la, and
  72       libmpc.la.  Either all three should be present or absent, but not only
  73       one or two.  If the problem exists on your system, either rename or
  74       delete the .la files or install the appropriate missing
  75       package.</para></note>
  76
  77     </listitem>
  78
  79     <listitem>
  80       <para><emphasis role="strong">Glibc-2.5.1</emphasis> (Versions
  81       greater than &glibc-version; are not recommended as they have
  82       not been tested)</para>
  83     </listitem>
  84
  85     <listitem>
  86       <para><emphasis role="strong">Grep-2.5.1a</emphasis></para>
  87     </listitem>
  88
  89     <listitem>
  90       <para><emphasis role="strong">Gzip-1.3.12</emphasis></para>
  91     </listitem>
  92
  93     <listitem>
  94       <para><emphasis role="strong">Linux Kernel-&min-kernel;</emphasis></para>
  95
  96       <para>The reason for the kernel version requirement is that we specify
  97       that version when building <application>glibc</application> in Chapter 6
  98       at the recommendation of the developers.  It is also required by
  99       udev.</para>
 100
 101       <para>If the host kernel is earlier than &min-kernel; you will need to replace
 102       the kernel with a more up to date version. There are two ways
 103       you can go about this. First, see if your Linux vendor provides a &min-kernel;
 104       or later kernel package. If so, you may wish to install it. If your
 105       vendor doesn't offer an acceptable kernel package, or you would prefer not to
 106       install it, you can compile a kernel yourself. Instructions for
 107       compiling the kernel and configuring the boot loader (assuming the host
 108       uses GRUB) are located in <xref linkend="chapter-bootable"/>.</para>
 109
 110     </listitem>
 111
 112     <listitem>
 113       <para><emphasis role="strong">M4-1.4.10</emphasis></para>
 114     </listitem>
 115
 116     <listitem>
 117       <para><emphasis role="strong">Make-3.81</emphasis></para>
 118     </listitem>
 119
 120     <listitem>
 121       <para><emphasis role="strong">Patch-2.5.4</emphasis></para>
 122     </listitem>
 123
 124     <listitem>
 125       <para><emphasis role="strong">Perl-5.8.8</emphasis></para>
 126     </listitem>
 127
 128     <listitem>
 129       <para><emphasis role="strong">Sed-4.1.5</emphasis></para>
 130     </listitem>
 131
 132     <listitem>
 133       <para><emphasis role="strong">Tar-1.18</emphasis></para>
 134     </listitem>
 135
 136     <listitem>
 137       <para><emphasis role="strong">Xz-5.0.0</emphasis></para>
 138     </listitem>
 139
 140   </itemizedlist>
 141
 142   <para>Note that the symlinks mentioned above are required to build an LFS
 143   system using the instructions contained within this book. Symlinks that
 144   point to other software (such as dash, mawk, etc.) may work, but are not
 145   tested or supported by the LFS development team, and may require either
 146   deviation from the instructions or additional patches to some
 147   packages.</para>
 148
 149   <!-- Use an empty sect2 element to prevent a pdf warning.  -->
 150   <sect2 id="version-check">
 151   <title> </title>
 152
 153   <para >To see whether your host system has all the appropriate versions, and
 154   the ability to compile programs, run the following:</para>
 155
 156 <!-- ANY additional lines in the script cause a pdf rendering problem-->
 157 <screen role="nodump"><userinput>cat &gt; version-check.sh &lt;&lt; "EOF"
 158 <literal>#!/bin/bash
 159 # Simple script to list version numbers of critical development tools
 160
 161 export LC_ALL=C
 162 bash --version | head -n1 | cut -d" " -f2-4
 163 echo "/bin/sh -&gt; `readlink -f /bin/sh`"
 164 echo -n "Binutils: "; ld --version | head -n1 | cut -d" " -f3-
 165 bison --version | head -n1
 166 if [ -e /usr/bin/yacc ];
 167   then echo "/usr/bin/yacc -&gt; `readlink -f /usr/bin/yacc`";
 168   else echo "yacc not found"; fi
 169
 170 bzip2 --version 2&gt;&amp;1 &lt; /dev/null | head -n1 | cut -d" " -f1,6-
 171 echo -n "Coreutils: "; chown --version | head -n1 | cut -d")" -f2
 172 diff --version | head -n1
 173 find --version | head -n1
 174 gawk --version | head -n1
 175 if [ -e /usr/bin/awk ];
 176   then echo "/usr/bin/awk -&gt; `readlink -f /usr/bin/awk`";
 177   else echo "awk not found"; fi
 178
 179 gcc --version | head -n1
 180 g++ --version | head -n1
 181 ldd --version | head -n1 | cut -d" " -f2-  # glibc version
 182 grep --version | head -n1
 183 gzip --version | head -n1
 184 cat /proc/version
 185 m4 --version | head -n1
 186 make --version | head -n1
 187 patch --version | head -n1
 188 echo Perl `perl -V:version`
 189 sed --version | head -n1
 190 tar --version | head -n1
 191 xz --version | head -n1
 192
 193 echo 'main(){}' &gt; dummy.c &amp;&amp; g++ -o dummy dummy.c
 194 if [ -x dummy ]
 195   then echo "g++ compilation OK";
 196   else echo "g++ compilation failed"; fi
 197 rm -f dummy.c dummy</literal>
 198 <!--
 199 for lib in lib{gmp,mpfr,mpc}.la; do
 200   echo $lib: $(if find /usr/lib* -name $lib|
 201                grep -q $lib;then :;else echo not;fi) found
 202 done
 203 unset lib</literal>-->
 204 EOF
 205
 206 bash version-check.sh</userinput></screen>
 207
 208   <para>Also check for some library consistency:</para>
 209
 210 <screen role="nodump"><userinput>cat &gt; library-check.sh &lt;&lt; "EOF"
 211 <literal>#!/bin/bash
 212 for lib in lib{gmp,mpfr,mpc}.la; do
 213   echo $lib: $(if find /usr/lib* -name $lib|
 214                grep -q $lib;then :;else echo not;fi) found
 215 done
 216 unset lib</literal>
 217 EOF
 218
 219 bash library-check.sh</userinput></screen>
 220
 221 <para>The files identified by this script should be all present
 222 or all absent, but not only one or two present.</para>
 223
 224
 225 </sect2>
 226 </sect1>