source: chapter02/hostreqs.xml@ d6006ef

11.1 11.2 11.2-rc1 arm multilib s6-init trunk xry111/arm64 xry111/clfs-ng xry111/lfs-next xry111/pip3 xry111/queue-11.3 xry111/rust-wip-20221008
Last change on this file since d6006ef was d6006ef, checked in by Xi Ruoyao <xry111@…>, 9 months ago

relax host system requirements

A requirement on Glibc is not needed at all. It's enough once
$LFS_TGT-* is runnable. A test on Alpine (using musl as libc) has
practically proved this.

We'd raised binutils and GCC requirements mostly for Glibc. But now
Glibc is cross compiled by our cross toolchain with latest GCC and
binutils release, the host tools really does not matter. In the Glibc
building process only two .c files are build with BUILD_CC (the C
compiler from the host), and they are highly conservative (mostly
unchanged for years).

Binutils does not have too much requirement on host GCC & Binutils:
there is even a Binutils commit in this week fixing a build failure with
GCC-4.2!

So the most strict limitation comes from GCC. GCC requires host GCC to
support ISO C++ 11 so GCC >= 4.8 is needed. And both GCC-4.8 and latest
GCC-11.2 claims a requirement for Binutils-2.12 (for x86_64) or 2.13.1
(for 32-bit x86), so we make minimal Binutils version 2.13.1.

And, host bzip2 is never used now: the only .tar.bz2 files are elfutils
and python docs. They are not decompressed before entering chroot.

  • Property mode set to 100644
File size: 7.2 KB
Line 
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.13.1</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">Coreutils-6.9</emphasis></para>
44 </listitem>
45
46 <listitem>
47 <para><emphasis role="strong">Diffutils-2.8.1</emphasis></para>
48 </listitem>
49
50 <listitem>
51 <para><emphasis role="strong">Findutils-4.2.31</emphasis></para>
52 </listitem>
53
54 <listitem>
55 <para><emphasis role="strong">Gawk-4.0.1</emphasis> (/usr/bin/awk
56 should be a link to gawk)</para>
57 </listitem>
58
59 <listitem>
60 <para><emphasis role="strong">GCC-4.8</emphasis> including the C++
61 compiler, <command>g++</command> (Versions greater than &gcc-version; are
62 not recommended as they have not been tested). C and C++ standard
63 libraries (with headers) must also be present so the C++ compiler can
64 build hosted programs</para>
65 </listitem>
66
67 <listitem>
68 <para><emphasis role="strong">Grep-2.5.1a</emphasis></para>
69 </listitem>
70
71 <listitem>
72 <para><emphasis role="strong">Gzip-1.3.12</emphasis></para>
73 </listitem>
74
75 <listitem>
76 <para><emphasis role="strong">Linux Kernel-&min-kernel;</emphasis></para>
77
78 <para>The reason for the kernel version requirement is that we specify
79 that version when building <application>glibc</application> in
80 <xref linkend="chapter-cross-tools"/> and
81 <xref linkend="chapter-building-system"/>,
82 at the recommendation of the developers. It is also required by
83 udev.</para>
84
85 <para>If the host kernel is earlier than &min-kernel; you will need to replace
86 the kernel with a more up to date version. There are two ways
87 you can go about this. First, see if your Linux vendor provides a &min-kernel;
88 or later kernel package. If so, you may wish to install it. If your
89 vendor doesn't offer an acceptable kernel package, or you would prefer not to
90 install it, you can compile a kernel yourself. Instructions for
91 compiling the kernel and configuring the boot loader (assuming the host
92 uses GRUB) are located in <xref linkend="chapter-bootable"/>.</para>
93
94 </listitem>
95
96 <listitem>
97 <para><emphasis role="strong">M4-1.4.10</emphasis></para>
98 </listitem>
99
100 <listitem>
101 <para><emphasis role="strong">Make-4.0</emphasis></para>
102 </listitem>
103
104 <listitem>
105 <para><emphasis role="strong">Patch-2.5.4</emphasis></para>
106 </listitem>
107
108 <listitem>
109 <para><emphasis role="strong">Perl-5.8.8</emphasis></para>
110 </listitem>
111
112 <listitem>
113 <para><emphasis role="strong">Python-3.4</emphasis></para>
114 </listitem>
115
116 <listitem>
117 <para><emphasis role="strong">Sed-4.1.5</emphasis></para>
118 </listitem>
119
120 <listitem>
121 <para><emphasis role="strong">Tar-1.22</emphasis></para>
122 </listitem>
123
124 <listitem>
125 <para><emphasis role="strong">Texinfo-4.7</emphasis></para>
126 </listitem>
127
128 <listitem>
129 <para><emphasis role="strong">Xz-5.0.0</emphasis></para>
130 </listitem>
131
132 </itemizedlist>
133
134 <important>
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 </important>
142
143 <!-- Use an empty sect2 element to prevent a pdf warning. -->
144 <bridgehead renderas="sect2"
145 id="version-check"
146 xreflabel="Host System Requirements">
147 </bridgehead>
148 <!--<title> </title>-->
149
150 <para >To see whether your host system has all the appropriate versions, and
151 the ability to compile programs, run the following:</para>
152
153<screen role="nodump"><userinput>cat &gt; version-check.sh &lt;&lt; "EOF"
154<literal>#!/bin/bash
155# Simple script to list version numbers of critical development tools
156export LC_ALL=C
157bash --version | head -n1 | cut -d" " -f2-4
158MYSH=$(readlink -f /bin/sh)
159echo "/bin/sh -&gt; $MYSH"
160echo $MYSH | grep -q bash || echo "ERROR: /bin/sh does not point to bash"
161unset MYSH
162
163echo -n "Binutils: "; ld --version | head -n1 | cut -d" " -f3-
164bison --version | head -n1
165
166if [ -h /usr/bin/yacc ]; then
167 echo "/usr/bin/yacc -> `readlink -f /usr/bin/yacc`";
168elif [ -x /usr/bin/yacc ]; then
169 echo yacc is `/usr/bin/yacc --version | head -n1`
170else
171 echo "yacc not found"
172fi
173
174echo -n "Coreutils: "; chown --version | head -n1 | cut -d")" -f2
175diff --version | head -n1
176find --version | head -n1
177gawk --version | head -n1
178
179if [ -h /usr/bin/awk ]; then
180 echo "/usr/bin/awk -&gt; `readlink -f /usr/bin/awk`";
181elif [ -x /usr/bin/awk ]; then
182 echo awk is `/usr/bin/awk --version | head -n1`
183else
184 echo "awk not found"
185fi
186
187gcc --version | head -n1
188g++ --version | head -n1
189grep --version | head -n1
190gzip --version | head -n1
191cat /proc/version
192m4 --version | head -n1
193make --version | head -n1
194patch --version | head -n1
195echo Perl `perl -V:version`
196python3 --version
197sed --version | head -n1
198tar --version | head -n1
199makeinfo --version | head -n1 # texinfo version
200xz --version | head -n1
201
202echo 'int main(){}' &gt; dummy.c &amp;&amp; g++ -o dummy dummy.c
203if [ -x dummy ]
204 then echo "g++ compilation OK";
205 else echo "g++ compilation failed"; fi
206rm -f dummy.c dummy</literal>
207EOF
208
209bash version-check.sh</userinput></screen>
210<!--
211 <para>Also check for some library consistency:</para>
212
213<screen role="nodump"><userinput>cat &gt; library-check.sh &lt;&lt; "EOF"
214<literal>#!/bin/bash
215for lib in lib{gmp,mpfr,mpc}.la; do
216 echo $lib: $(if find /usr/lib* -name $lib|
217 grep -q $lib;then :;else echo not;fi) found
218done
219unset lib</literal>
220EOF
221
222bash library-check.sh</userinput></screen>
223
224<para>The files identified by this script should be all present
225or all absent, but not only one or two present.</para>
226-->
227
228</sect1>
Note: See TracBrowser for help on using the repository browser.