BOOK/chapter02/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="ch-partitioning-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 have
  22    not 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.25</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.7</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     <!-- glibc-2.30 requires gcc-6.2 or later -->
  64     <listitem>
  65       <para><emphasis role="strong">GCC-6.2</emphasis> including the C++
  66       compiler, <command>g++</command> (Versions greater than &gcc-version; are
  67       not recommended as they have not been tested)</para>
  68     </listitem>
  69
  70     <listitem>
  71       <para><emphasis role="strong">Glibc-2.11</emphasis> (Versions
  72       greater than &glibc-version; are not recommended as they have
  73       not been tested)</para>
  74     </listitem>
  75
  76     <listitem>
  77       <para><emphasis role="strong">Grep-2.5.1a</emphasis></para>
  78     </listitem>
  79
  80     <listitem>
  81       <para><emphasis role="strong">Gzip-1.3.12</emphasis></para>
  82     </listitem>
  83
  84     <listitem>
  85       <para><emphasis role="strong">Linux Kernel-&min-kernel;</emphasis></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&nbsp;6
  89       at the recommendation of the developers.  It is also required by
  90       udev.</para>
  91
  92       <para>If the host kernel is earlier than &min-kernel; you will need to replace
  93       the kernel with a more up to date version. There are two ways
  94       you can go about this. First, see if your Linux vendor provides a &min-kernel;
  95       or later kernel package. If so, you may wish to install it. If your
  96       vendor doesn't offer an acceptable kernel package, or you would prefer not to
  97       install it, you can compile a kernel yourself. Instructions for
  98       compiling the kernel and configuring the boot loader (assuming the host
  99       uses GRUB) are located in <xref linkend="chapter-bootable"/>.</para>
 100
 101     </listitem>
 102
 103     <listitem>
 104       <para><emphasis role="strong">M4-1.4.10</emphasis></para>
 105     </listitem>
 106
 107     <listitem>
 108       <para><emphasis role="strong">Make-4.0</emphasis></para>
 109     </listitem>
 110
 111     <listitem>
 112       <para><emphasis role="strong">Patch-2.5.4</emphasis></para>
 113     </listitem>
 114
 115     <listitem>
 116       <para><emphasis role="strong">Perl-5.8.8</emphasis></para>
 117     </listitem>
 118
 119     <listitem>
 120       <para><emphasis role="strong">Python-3.4</emphasis></para>
 121     </listitem>
 122
 123     <listitem>
 124       <para><emphasis role="strong">Sed-4.1.5</emphasis></para>
 125     </listitem>
 126
 127     <listitem>
 128       <para><emphasis role="strong">Tar-1.22</emphasis></para>
 129     </listitem>
 130
 131     <listitem>
 132       <para><emphasis role="strong">Texinfo-4.7</emphasis></para>
 133     </listitem>
 134
 135     <listitem>
 136       <para><emphasis role="strong">Xz-5.0.0</emphasis></para>
 137     </listitem>
 138
 139   </itemizedlist>
 140
 141   <important>
 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   </important>
 149
 150   <!-- Use an empty sect2 element to prevent a pdf warning.  -->
 151   <bridgehead renderas="sect2"
 152               id="version-check"
 153               xreflabel="Host System Requirements">
 154   </bridgehead>
 155   <!--<title> </title>-->
 156
 157   <para >To see whether your host system has all the appropriate versions, and
 158   the ability to compile programs, run the following:</para>
 159
 160 <screen role="nodump"><userinput>cat &gt; version-check.sh &lt;&lt; "EOF"
 161 <literal>#!/bin/bash
 162 # Simple script to list version numbers of critical development tools
 163 export LC_ALL=C
 164 bash --version | head -n1 | cut -d" " -f2-4
 165 MYSH=$(readlink -f /bin/sh)
 166 echo "/bin/sh -&gt; $MYSH"
 167 echo $MYSH | grep -q bash || echo "ERROR: /bin/sh does not point to bash"
 168 unset MYSH
 169
 170 echo -n "Binutils: "; ld --version | head -n1 | cut -d" " -f3-
 171 bison --version | head -n1
 172
 173 if [ -h /usr/bin/yacc ]; then
 174   echo "/usr/bin/yacc -> `readlink -f /usr/bin/yacc`";
 175 elif [ -x /usr/bin/yacc ]; then
 176   echo yacc is `/usr/bin/yacc --version | head -n1`
 177 else
 178   echo "yacc not found"
 179 fi
 180
 181 bzip2 --version 2&gt;&amp;1 &lt; /dev/null | head -n1 | cut -d" " -f1,6-
 182 echo -n "Coreutils: "; chown --version | head -n1 | cut -d")" -f2
 183 diff --version | head -n1
 184 find --version | head -n1
 185 gawk --version | head -n1
 186
 187 if [ -h /usr/bin/awk ]; then
 188   echo "/usr/bin/awk -&gt; `readlink -f /usr/bin/awk`";
 189 elif [ -x /usr/bin/awk ]; then
 190   echo awk is `/usr/bin/awk --version | head -n1`
 191 else
 192   echo "awk not found"
 193 fi
 194
 195 gcc --version | head -n1
 196 g++ --version | head -n1
 197 ldd --version | head -n1 | cut -d" " -f2-  # glibc version
 198 grep --version | head -n1
 199 gzip --version | head -n1
 200 cat /proc/version
 201 m4 --version | head -n1
 202 make --version | head -n1
 203 patch --version | head -n1
 204 echo Perl `perl -V:version`
 205 python3 --version
 206 sed --version | head -n1
 207 tar --version | head -n1
 208 makeinfo --version | head -n1  # texinfo version
 209 xz --version | head -n1
 210
 211 echo 'int main(){}' &gt; dummy.c &amp;&amp; g++ -o dummy dummy.c
 212 if [ -x dummy ]
 213   then echo "g++ compilation OK";
 214   else echo "g++ compilation failed"; fi
 215 rm -f dummy.c dummy</literal>
 216 EOF
 217
 218 bash version-check.sh</userinput></screen>
 219 <!--
 220   <para>Also check for some library consistency:</para>
 221
 222 <screen role="nodump"><userinput>cat &gt; library-check.sh &lt;&lt; "EOF"
 223 <literal>#!/bin/bash
 224 for lib in lib{gmp,mpfr,mpc}.la; do
 225   echo $lib: $(if find /usr/lib* -name $lib|
 226                grep -q $lib;then :;else echo not;fi) found
 227 done
 228 unset lib</literal>
 229 EOF
 230
 231 bash library-check.sh</userinput></screen>
 232
 233 <para>The files identified by this script should be all present
 234 or all absent, but not only one or two present.</para>
 235 -->
 236
 237 </sect1>