aboutsummaryrefslogtreecommitdiffstats
path: root/prologue
diff options
context:
space:
mode:
Diffstat (limited to 'prologue')
-rw-r--r--prologue/hostreqs.xml157
1 files changed, 106 insertions, 51 deletions
diff --git a/prologue/hostreqs.xml b/prologue/hostreqs.xml
index a0c82c309..5cff2fe84 100644
--- a/prologue/hostreqs.xml
+++ b/prologue/hostreqs.xml
@@ -10,92 +10,147 @@
<title>Host System Requirements</title>
- <para>Your host system should have the following software with the minimum
- versions indicated. This should not be an issue for most modern Linux
- distributions. Also note that many distributions will place software headers
- into separate packages, often in the form of <quote>[package-name]-devel</quote>
- or <quote>[package-name]-dev</quote>. Be sure to install those as well, if
- your distribution provides them.</para>
+ <para>Your host system should have the following software with the
+ minimum versions indicated. This should not be an issue for most
+ modern Linux distributions. Also note that many distributions will
+ place software headers into separate packages, often in the form of
+ <quote>&lt;package-name&gt;-devel</quote> or
+ <quote>&lt;package-name&gt;-dev</quote>. Be sure to install those if
+ your distribution provides them. For each package a command has been
+ added to help you to determine what version is installed on your
+ host.</para>
<itemizedlist spacing="compact">
+
<listitem>
- <para>Bash-2.05a</para>
+ <para><emphasis role="strong">Bash-2.05a</emphasis></para>
+
+<screen role="nodump"><userinput>bash --version</userinput></screen>
</listitem>
+
<listitem>
- <para>Binutils-2.12 (Versions greater than &binutils-version; not
- recommended)</para>
+ <para><emphasis role="strong">Binutils-2.12</emphasis> (Versions
+ greater than &binutils-version; are not recommended as they have
+ not been tested)</para>
+
+<screen role="nodump"><userinput>ld --version</userinput></screen>
</listitem>
+
<listitem>
- <para>Bzip2-1.0.2</para>
+ <para><emphasis role="strong">Bzip2-1.0.2</emphasis></para>
+
+<screen role="nodump"><userinput>bzip2 --version</userinput></screen>
</listitem>
+
<listitem>
- <para>Coreutils-5.0 (or Sh-Utils-2.0, Textutils-2.0,
- and Fileutils-4.1)</para>
+ <para><emphasis role="strong">Coreutils-5.0</emphasis> (or Sh-Utils-2.0,
+ Textutils-2.0, and Fileutils-4.1)</para>
+
+<screen role="nodump"><userinput>chonw --version</userinput></screen>
</listitem>
+
<listitem>
- <para>Diffutils-2.8</para>
+ <para><emphasis role="strong">Diffutils-2.8</emphasis></para>
+
+<screen role="nodump"><userinput>diff --version</userinput></screen>
</listitem>
+
<listitem>
- <para>Findutils-4.1.20</para>
+ <para><emphasis role="strong">Findutils-4.1.20</emphasis></para>
+
+<screen role="nodump"><userinput>find --version</userinput></screen>
</listitem>
+
<listitem>
- <para>Gawk-3.0</para>
+ <para><emphasis role="strong">Gawk-3.0</emphasis></para>
+
+<screen role="nodump"><userinput>gawk --version</userinput></screen>
</listitem>
+
<listitem>
- <para>Gcc-2.95.3 (Versions greater than &gcc-version; not
- recommended)</para>
+ <para><emphasis role="strong">Gcc-2.95.3</emphasis> (Versions
+ greater than &gcc-version; are not recommended as they have not
+ been tested)</para>
+
+<screen role="nodump"><userinput>gcc --version</userinput></screen>
</listitem>
+
<listitem>
- <para>Glibc-2.2.5 (Versions greater than &glibc-version; not
- recommended)</para>
+ <para><emphasis role="strong">Glibc-2.2.5</emphasis> (Versions
+ greater than &glibc-version; are not recommended as they have
+ not been tested)</para>
+
+<screen role="nodump"><userinput>/lib/libc.so.6</userinput></screen>
</listitem>
+
<listitem>
- <para>Grep-2.5</para>
+ <para><emphasis role="strong">Grep-2.5</emphasis></para>
+
+<screen role="nodump"><userinput>grep --version</userinput></screen>
</listitem>
+
<listitem>
- <para>Gzip-1.2.4</para>
+ <para><emphasis role="strong">Gzip-1.2.4</emphasis></para>
+
+<screen role="nodump"><userinput>gzip --version</userinput></screen>
</listitem>
+
<listitem>
- <para>Linux Kernel-2.6.x (having been compiled with Gcc-3.0)</para>
+ <para><emphasis role="strong">Linux Kernel-2.6.x</emphasis>
+ (having been compiled with Gcc-3.0)</para>
+
+ <para>The reason for the kernel version requirement is that thread-local
+ storage support in Binutils will not be built and the Native POSIX
+ Threading Library (NPTL) test suite will segfault if the host's kernel
+ isn't at least a 2.6.x version compiled with a 3.0 or later release of
+ GCC.</para>
+
+ <para>In order to determine whether the host kernel meets the requirements
+ outlined above, run the following command:</para>
+
+<screen role="nodump"><userinput>cat /proc/version</userinput></screen>
+
+ <para>This will produce output similar to:</para>
+
+<screen><computeroutput>Linux version 2.6.2 (user@host) (gcc version 3.4.0) #1
+ Tue Apr 20 21:22:18 GMT 2004</computeroutput></screen>
+
+ <para>If the results of the above command do not state that the host
+ kernel is either 2.6.x, or that it was not compiled using a GCC-3.0
+ (or later) compiler, you will have to replace the kernel with one
+ adhering to the specifications. There are two methods you can take
+ to solve this. First, see if your Linux vendor provides a 2.6 kernel
+ package. If so, you may wish to install it. If your vendor doesn't
+ offer a 2.6 kernel package, or you would prefer not to install it,
+ then you can compile a 2.6 kernel yourself. Instructions for compiling
+ the kernel and configuring the boot loader (assuming the host uses GRUB)
+ are located in <xref linkend="chapter-bootable"/>.</para>
</listitem>
+
<listitem>
- <para>Make-3.79.1</para>
+ <para><emphasis role="strong">Make-3.79.1</emphasis></para>
+
+<screen role="nodump"><userinput>make --version</userinput></screen>
</listitem>
+
<listitem>
- <para>Patch-2.5.4</para>
+ <para><emphasis role="strong">Patch-2.5.4</emphasis></para>
+
+<screen role="nodump"><userinput>patch --version</userinput></screen>
</listitem>
+
<listitem>
- <para>Sed-3.0.2</para>
+ <para><emphasis role="strong">Sed-3.0.2</emphasis></para>
+
+<screen role="nodump"><userinput>sed --version</userinput></screen>
</listitem>
+
<listitem>
- <para>Tar-1.14</para>
+ <para><emphasis role="strong">Tar-1.14</emphasis></para>
+
+<screen role="nodump"><userinput>tar --version</userinput></screen>
</listitem>
</itemizedlist>
- <para>The reason for the kernel version requirement is that thread-local
- storage support in Binutils will not be built and the Native POSIX Threading
- Library (NPTL) test suite will segfault if the host's kernel isn't a 2.6
- kernel and has not been compiled with GCC-3.0 or a later version.</para>
-
- <para>In order to determine whether the host kernel meets the requirements
- outlined above, run the following command:</para>
-
-<screen role="nodump"><userinput>cat /proc/version</userinput></screen>
-
- <para>This will produce output similar to:</para>
-
-<screen><computeroutput>Linux version 2.6.2 (user@host) (gcc version 3.4.0) #1
- Tue Apr 20 21:22:18 GMT 2004</computeroutput></screen>
-
- <para>If the results of the above command do not state that the host kernel
- is either 2.6.x, or that it was not compiled using a GCC-3.0 (or
- later) compiler, one will need to be installed. There are two methods you
- can take to solve this. First, see if your Linux vendor provides a 2.6
- kernel package. If so, you may wish to install it. If your vendor
- doesn't offer a 2.6 kernel package, or you would prefer not to
- install it, then you can compile a 2.6 kernel yourself. Instructions for
- compiling the kernel and configuring the boot loader (assuming the host
- uses GRUB) are located in <xref linkend="chapter-bootable"/>.</para>
-
</sect1>