source: chapter05/chapter05.xml@ 9684126

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 11.2 11.2-rc1 11.3 11.3-rc1 12.0 12.0-rc1 12.1 12.1-rc1 6.0 6.1 6.1.1 6.3 6.4 6.5 6.6 6.7 6.8 7.0 7.1 7.2 7.3 7.4 7.5 7.5-systemd 7.6 7.6-systemd 7.7 7.7-systemd 7.8 7.8-systemd 7.9 7.9-systemd 8.0 8.1 8.2 8.3 8.4 9.0 9.1 arm bdubbs/gcc13 ml-11.0 multilib renodr/libudev-from-systemd s6-init trunk v5_1 v5_1_1 xry111/arm64 xry111/arm64-12.0 xry111/clfs-ng xry111/lfs-next xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/mips64el xry111/pip3 xry111/rust-wip-20221008 xry111/update-glibc
Last change on this file since 9684126 was 9684126, checked in by Greg Schafer <greg@…>, 20 years ago

Chapter 5 - Adding the user lfs: Added "-k /dev/null" to the
useradd command to prevent /etc/skel files from coming across.
Suggested by Anderson Lizardo.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3184 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

  • Property mode set to 100644
File size: 28.1 KB
Line 
1<chapter id="chapter05" xreflabel="Chapter 5">
2<title>Constructing a temporary system</title>
3<?dbhtml filename="chapter05.html" dir="chapter05"?>
4
5
6<sect1 id="ch05-introduction">
7<title>Introduction</title>
8<?dbhtml filename="introduction.html" dir="chapter05"?>
9
10<para>In this chapter we will compile and install a minimal
11Linux system. This system will contain just enough tools to be able
12to start constructing the final LFS system in the next chapter.</para>
13
14<para>The building of this minimal system is done in two steps: first we
15build a brand-new and host-independent toolchain (compiler, assembler,
16linker and libraries), and then use this to build all the other essential
17tools.</para>
18
19<para>The files compiled in this chapter will be installed under the
20<filename class="directory">$LFS/tools</filename> directory
21to keep them separate from the files installed in the next chapter.
22Since the packages compiled here are merely temporary, we don't want
23them to pollute the soon-to-be LFS system.</para>
24
25<para>The build instructions assume that you are using the
26<userinput>bash</userinput> shell. It is also expected that you have already
27unpacked a source package (while logged in as user <emphasis>lfs</emphasis> --
28explained shortly) and performed a <userinput>cd</userinput> into the source
29directory of a package before issuing its build commands.</para>
30
31<para>Several of the packages are patched before compilation, but only when
32the patch is needed to circumvent a problem. Often the patch is needed in
33both this and the next chapter, but sometimes in only one of them. Therefore,
34don't worry when instructions for a downloaded patch seem to be missing. When
35applying a patch you'll occasionally see a warning message about
36<emphasis>offset</emphasis> or <emphasis>fuzz</emphasis>. These warnings are
37nothing to worry about as the patch was still successfully applied.</para>
38
39<para>During the installation of most packages you will
40see all kinds of compiler warnings scroll by on your screen. These are
41normal and can be safely ignored. They are just what they say they are:
42warnings -- mostly about deprecated, but not invalid, use of the C or C++
43syntax. It's just that C standards have changed rather often and some
44packages still use the older standard, which is not really a problem.</para>
45
46<para><emphasis>Unless</emphasis> told not to, you should normally delete the
47source and build directories after installing each package -- for cleanness
48sake and to save space.</para>
49
50<para>Before continuing, make sure the LFS environment variable is set up
51properly by executing the following:</para>
52
53<screen><userinput>echo $LFS</userinput></screen>
54
55<para>Make sure the output shows the path to your LFS partition's mount
56point, which is <filename class="directory">/mnt/lfs</filename> if you
57followed our example.</para>
58
59</sect1>
60
61
62<sect1 id="ch05-toolchaintechnotes">
63<title>Toolchain technical notes</title>
64<?dbhtml filename="toolchaintechnotes.html" dir="chapter05"?>
65
66<para>This section attempts to explain some of the rationale and technical
67details behind the overall build method. It's not essential that you understand
68everything here immediately. Most of it will make sense once you have performed
69an actual build. Feel free to refer back here at any time.</para>
70
71<para>The overall goal of <xref linkend="chapter05"/> is to provide a sane,
72temporary environment that we can chroot into, and from which we can produce a
73clean, trouble-free build of the target LFS system in
74<xref linkend="chapter06"/>. Along the way, we attempt to divorce ourselves
75from the host system as much as possible, and in so doing build a
76self-contained and self-hosted toolchain. It should be noted that the
77build process has been designed in such a way so as to minimize the risks for
78new readers and provide maximum educational value at the same time. In other
79words, more advanced techniques could be used to build the system.</para>
80
81<important>
82<para>Before continuing, you really should be aware of the name of your working
83platform, often also referred to as the <emphasis>target triplet</emphasis>. For
84many folks the target triplet will probably be
85<emphasis>i686-pc-linux-gnu</emphasis>. A simple way to determine your target
86triplet is to run the <filename>config.guess</filename> script that comes with
87the source for many packages. Unpack the Binutils sources and run the script:
88<userinput>./config.guess</userinput> and note the output.</para>
89
90<para>You'll also need to be aware of the name of your platform's
91<emphasis>dynamic linker</emphasis>, often also referred to as the
92<emphasis>dynamic loader</emphasis>, not to be confused with the standard linker
93<emphasis>ld</emphasis> that is part of Binutils. The dynamic linker is provided
94by Glibc and has the job of finding and loading the shared libraries needed by a
95program, preparing the program to run and then running it. For most folks the
96name of the dynamic linker will be <emphasis>ld-linux.so.2</emphasis>. On
97platforms that are less prevalent, the name might be
98<emphasis>ld.so.1</emphasis> and newer 64 bit platforms might even have
99something completely different. You should be able to determine the name
100of your platform's dynamic linker by looking in the
101<filename class="directory">/lib</filename> directory on your host system. A
102surefire way is to inspect a random binary from your host system by running:
103<userinput>'readelf -l &lt;name of binary&gt; | grep interpreter'</userinput>
104and noting the output. The authoritative reference covering all platforms is in
105the <filename>shlib-versions</filename> file in the root of the Glibc source
106tree.</para>
107</important>
108
109<para>Some key technical points of how the <xref linkend="chapter05"/> build
110method works:</para>
111
112<itemizedlist>
113<listitem><para>Similar in principle to cross compiling whereby tools installed
114into the same prefix work in cooperation and thus utilize a little GNU
115"magic".</para></listitem>
116
117<listitem><para>Careful manipulation of the standard linker's library search
118path to ensure programs are linked only against libraries we
119choose.</para></listitem>
120
121<listitem><para>Careful manipulation of <userinput>gcc</userinput>'s
122<emphasis>specs</emphasis> file to tell the compiler which target dynamic
123linker will be used.</para></listitem>
124</itemizedlist>
125
126<para>Binutils is installed first because both GCC and Glibc perform various
127feature tests on the assembler and linker during their respective runs of
128<userinput>./configure</userinput> to determine which software features to enable
129or disable. This is more important than one might first realize. An incorrectly
130configured GCC or Glibc can result in a subtly broken toolchain where the impact
131of such breakage might not show up until near the end of the build of a whole
132distribution. Thankfully, a test suite failure will usually alert us before too
133much time is wasted.</para>
134
135<para>Binutils installs its assembler and linker into two locations,
136<filename class="directory">/tools/bin</filename> and
137<filename class="directory">/tools/$TARGET_TRIPLET/bin</filename>. In reality,
138the tools in one location are hard linked to the other. An important facet of
139the linker is its library search order. Detailed information can be obtained
140from <userinput>ld</userinput> by passing it the <emphasis>--verbose</emphasis>
141flag. For example: <userinput>'ld --verbose | grep SEARCH'</userinput> will
142show you the current search paths and their order. You can see what files are
143actually linked by <userinput>ld</userinput> by compiling a dummy program and
144passing the <emphasis>--verbose</emphasis> switch. For example:
145<userinput>'gcc dummy.c -Wl,--verbose 2>&amp;1 | grep succeeded'</userinput>
146will show you all the files successfully opened during the link.</para>
147
148<para>The next package installed is GCC and during its run of
149<userinput>./configure</userinput> you'll see, for example:</para>
150
151<blockquote><screen>checking what assembler to use... /tools/i686-pc-linux-gnu/bin/as
152checking what linker to use... /tools/i686-pc-linux-gnu/bin/ld</screen></blockquote>
153
154<para>This is important for the reasons mentioned above. It also demonstrates
155that GCC's configure script does not search the $PATH directories to find which
156tools to use. However, during the actual operation of <userinput>gcc</userinput>
157itself, the same search paths are not necessarily used. You can find out which
158standard linker <userinput>gcc</userinput> will use by running:
159<userinput>'gcc -print-prog-name=ld'</userinput>.
160Detailed information can be obtained from <userinput>gcc</userinput> by passing
161it the <emphasis>-v</emphasis> flag while compiling a dummy program. For
162example: <userinput>'gcc -v dummy.c'</userinput> will show you detailed
163information about the preprocessor, compilation and assembly stages, including
164<userinput>gcc</userinput>'s include search paths and their order.</para>
165
166<para>The next package installed is Glibc. The most important considerations for
167building Glibc are the compiler, binary tools and kernel headers. The compiler
168is generally no problem as Glibc will always use the <userinput>gcc</userinput>
169found in a $PATH directory. The binary tools and kernel headers can be a little
170more troublesome. Therefore we take no risks and use the available configure
171switches to enforce the correct selections. After the run of
172<userinput>./configure</userinput> you can check the contents of the
173<filename>config.make</filename> file in the
174<filename class="directory">glibc-build</filename> directory for all the
175important details. You'll note some interesting items like the use of
176<userinput>CC="gcc -B/tools/bin/"</userinput> to control which binary tools are
177used, and also the use of the <emphasis>-nostdinc</emphasis> and
178<emphasis>-isystem</emphasis> flags to control the compiler's include search
179path. These items help to highlight an important aspect of the Glibc package:
180it is very self-sufficient in terms of its build machinery and generally does
181not rely on toolchain defaults.</para>
182
183<para>After the Glibc installation, we make some adjustments to ensure that
184searching and linking take place only within our <filename>/tools</filename>
185prefix. We install an adjusted <userinput>ld</userinput>, which has a hard-wired
186search path limited to <filename class="directory">/tools/lib</filename>. Then
187we amend <userinput>gcc</userinput>'s specs file to point to our new dynamic
188linker in <filename class="directory">/tools/lib</filename>. This last step is
189<emphasis>vital</emphasis> to the whole process. As mentioned above, a
190hard-wired path to a dynamic linker is embedded into every ELF shared
191executable. You can inspect this by running:
192<userinput>'readelf -l &lt;name of binary&gt; | grep interpreter'</userinput>.
193By amending <userinput>gcc</userinput>'s specs file, we are ensuring that every
194program compiled from here through the end of <xref linkend="chapter05"/> will
195use our new dynamic linker in
196<filename class="directory">/tools/lib</filename>.</para>
197
198<para>The need to use the new dynamic linker is also the reason why we apply the
199Specs patch for the second pass of GCC. Failure to do so will result in the GCC
200programs themselves having the name of the dynamic linker from the host system's
201<filename class="directory">/lib</filename> directory embedded into them, which
202would defeat our goal of getting away from the host.</para>
203
204<para>During the second pass of Binutils, we are able to utilize the
205<emphasis>--with-lib-path</emphasis> configure switch to control
206<userinput>ld</userinput>'s library search path. From this point onwards, the
207core toolchain is self-contained and self-hosted. The remainder of the
208<xref linkend="chapter05"/> packages all build against the new Glibc in
209<filename class="directory">/tools</filename> and all is well.</para>
210
211<para>Upon entering the chroot environment in <xref linkend="chapter06"/>, the
212first major package we install is Glibc, due to its self-sufficient nature that
213we mentioned above. Once this Glibc is installed into
214<filename class="directory">/usr</filename>, we perform a quick changeover of
215the toolchain defaults, then proceed for real in building the rest of the
216target <xref linkend="chapter06"/> LFS system.</para>
217
218<sect2>
219<title>Notes on static linking</title>
220
221<para>Most programs have to perform, beside their specific task, many rather
222common and sometimes trivial operations. These include allocating memory,
223searching directories, reading and writing files, string handling, pattern
224matching, arithmetic and many other tasks. Instead of obliging each program to
225reinvent the wheel, the GNU system provides all these basic functions in
226ready-made libraries. The major library on any Linux system is
227<emphasis>Glibc</emphasis>.</para>
228
229<para>There are two primary ways of linking the functions from a library to a
230program that uses them: statically or dynamically. When a program is linked
231statically, the code of the used functions is included in the executable,
232resulting in a rather bulky program. When a program is dynamically linked, what
233is included is a reference to the dynamic linker, the name of the library, and
234the name of the function, resulting in a much smaller executable. (A third way
235is to use the programming interface of the dynamic linker. See the
236<emphasis>dlopen</emphasis> man page for more information.)</para>
237
238<para>Dynamic linking is the default on Linux and has three major advantages
239over static linking. First, you need only one copy of the executable library
240code on your hard disk, instead of having many copies of the same code included
241into a whole bunch of programs -- thus saving disk space. Second, when several
242programs use the same library function at the same time, only one copy of the
243function's code is required in core -- thus saving memory space. Third, when a
244library function gets a bug fixed or is otherwise improved, you only need to
245recompile this one library, instead of having to recompile all the programs that
246make use of the improved function.</para>
247
248<para>If dynamic linking has several advantages, why then do we statically link
249the first two packages in this chapter? The reasons are threefold: historical,
250educational, and technical. Historical, because earlier versions of LFS
251statically linked every program in this chapter. Educational, because knowing
252the difference is useful. Technical, because we gain an element of independence
253from the host in doing so, meaning that those programs can be used
254independently of the host system. However, it's worth noting that an overall
255successful LFS build can still be achieved when the first two packages are
256built dynamically.</para>
257
258</sect2>
259
260</sect1>
261
262
263<sect1 id="ch05-creatingtoolsdir">
264<title>Creating the $LFS/tools directory</title>
265<?dbhtml filename="creatingtoolsdir.html" dir="chapter05"?>
266
267<para>All programs compiled in this chapter will be installed under <filename
268class="directory">$LFS/tools</filename> to keep them separate from the
269programs compiled in the next chapter. The programs compiled here are only
270temporary tools and won't be a part of the final LFS system and by keeping them
271in a separate directory, we can later easily throw them away.</para>
272
273<para>Later on you might wish to search through the binaries of your system to
274see what files they make use of or link against. To make this searching easier
275you may want to choose a unique name for the directory in which the temporary
276tools are stored. Instead of the simple "tools" you could use something like
277"tools-for-lfs". However, you'll need to be careful to adjust all references to
278"tools" throughout the book -- including those in any patches, notably the
279GCC Specs Patch.</para>
280
281<para>Create the required directory by running the following:</para>
282
283<screen><userinput>mkdir $LFS/tools</userinput></screen>
284
285<para>The next step is to create a <filename>/tools</filename> symlink on
286your host system. It will point to the directory we just created on the LFS
287partition:</para>
288
289<screen><userinput>ln -s $LFS/tools /</userinput></screen>
290
291<note><para>The above command is correct. The <userinput>ln</userinput> command
292has a few syntactic variations, so be sure to check the info page before
293reporting what you may think is an error.</para></note>
294
295<para>The created symlink enables us to compile our toolchain so that it always
296refers to <filename>/tools</filename>, meaning that the compiler, assembler
297and linker will work both in this chapter (when we are still using some tools
298from the host) <emphasis>and</emphasis> in the next (when we are chrooted to
299the LFS partition).</para>
300
301</sect1>
302
303
304<sect1 id="ch05-addinguser">
305<title>Adding the user lfs</title>
306<?dbhtml filename="addinguser.html" dir="chapter05"?>
307
308<para>When logged in as <emphasis>root</emphasis>, making a single mistake
309can damage or even wreck your system. Therefore we recommend that you
310build the packages in this chapter as an unprivileged user. You could
311of course use your own user name, but to make it easier to set up a clean
312work environment we'll create a new user <emphasis>lfs</emphasis> and
313use this one during the installation process. As <emphasis>root</emphasis>,
314issue the following commands to add the new user:</para>
315
316<screen><userinput>useradd -s /bin/bash -m -k /dev/null lfs
317passwd lfs</userinput></screen>
318
319<para>Now grant this new user <emphasis>lfs</emphasis> full access to
320<filename class="directory">$LFS/tools</filename> by giving it ownership
321of the directory:</para>
322
323<screen><userinput>chown lfs $LFS/tools</userinput></screen>
324
325<para>If you made a separate working directory as suggested, give user
326<emphasis>lfs</emphasis> ownership of this directory too:</para>
327
328<screen><userinput>chown lfs $LFS/sources</userinput></screen>
329
330<para>Next, login as user <emphasis>lfs</emphasis>. This can be done via a
331virtual console, through a display manager, or with the following substitute
332user command:</para>
333
334<screen><userinput>su - lfs</userinput></screen>
335
336<para>The "<userinput>-</userinput>" instructs <userinput>su</userinput> to
337start a <emphasis>login</emphasis> shell.</para>
338
339</sect1>
340
341
342<sect1 id="ch05-settingenviron">
343<title>Setting up the environment</title>
344<?dbhtml filename="settingenvironment.html" dir="chapter05"?>
345
346<para>We're going to set up a good working environment by creating two new
347startup files for the <userinput>bash</userinput> shell. While logged in as
348user <emphasis>lfs</emphasis>, issue the following command to create a new
349<filename>.bash_profile</filename>:</para>
350
351<screen><userinput>cat &gt; ~/.bash_profile &lt;&lt; "EOF"</userinput>
352exec env -i HOME=$HOME TERM=$TERM PS1='\u:\w\$ ' /bin/bash
353<userinput>EOF</userinput></screen>
354
355<para>Normally, when you log on as user <emphasis>lfs</emphasis>,
356the initial shell is a <emphasis>login</emphasis> shell which reads the
357<filename>/etc/profile</filename> of your host (probably containing some
358settings of environment variables) and then <filename>.bash_profile</filename>.
359The <userinput>exec env -i ... /bin/bash</userinput> command in the latter file
360replaces the running shell with a new one with a completely empty environment,
361except for the HOME, TERM and PS1 variables. This ensures that no unwanted and
362potentially hazardous environment variables from the host system leak into our
363build environment. The technique used here is a little strange, but it achieves
364the goal of enforcing a clean environment.</para>
365
366<para>The new instance of the shell is a <emphasis>non-login</emphasis> shell,
367which doesn't read the <filename>/etc/profile</filename> or
368<filename>.bash_profile</filename> files, but reads the
369<filename>.bashrc</filename> file instead. Create this latter file now:</para>
370
371<screen><userinput>cat &gt; ~/.bashrc &lt;&lt; "EOF"</userinput>
372set +h
373umask 022
374LFS=/mnt/lfs
375LC_ALL=POSIX
376PATH=/tools/bin:/bin:/usr/bin
377export LFS LC_ALL PATH
378<userinput>EOF</userinput></screen>
379
380<para>The <userinput>set +h</userinput> command turns off
381<userinput>bash</userinput>'s hash function. Normally hashing is a useful
382feature: <userinput>bash</userinput> uses a hash table to remember the
383full pathnames of executable files to avoid searching the PATH time and time
384again to find the same executable. However, we'd like the new tools to be
385used as soon as they are installed. By switching off the hash function, our
386"interactive" commands (<userinput>make</userinput>,
387<userinput>patch</userinput>, <userinput>sed</userinput>,
388<userinput>cp</userinput> and so forth) will always use
389the newest available version during the build process.</para>
390
391<para>Setting the user file-creation mask to 022 ensures that newly created
392files and directories are only writable for their owner, but readable and
393executable for anyone.</para>
394
395<para>The LFS variable should of course be set to the mount point you
396chose.</para>
397
398<para>The LC_ALL variable controls the localization of certain programs,
399making their messages follow the conventions of a specified country. If your
400host system uses a version of Glibc older than 2.2.4,
401having LC_ALL set to something other than "POSIX" or "C" during this chapter
402may cause trouble if you exit the chroot environment and wish to return later.
403By setting LC_ALL to "POSIX" (or "C", the two are equivalent) we ensure that
404everything will work as expected in the chroot environment.</para>
405
406<para>We prepend <filename>/tools/bin</filename> to the standard PATH so
407that, as we move along through this chapter, the tools we build will get used
408during the rest of the building process.</para>
409
410<para>Finally, to have our environment fully prepared for building the
411temporary tools, source the just-created profile:</para>
412
413<screen><userinput>source ~/.bash_profile</userinput></screen>
414
415</sect1>
416
417
418&c5-binutils-pass1;
419&c5-gcc-pass1;
420&c5-kernelheaders;
421&c5-glibc;
422
423
424<sect1 id="ch05-locking-glibc">
425<title>"Locking in" Glibc</title>
426<?dbhtml filename="lockingglibc.html" dir="chapter05"?>
427
428<para>Now that the temporary C libraries have been installed, we want all
429the tools compiled in the rest of this chapter to be linked against these
430libraries. To accomplish this, we need to adjust the linker and the compiler's
431specs file.</para>
432
433<para>First install the adjusted linker by running the following from within
434the <filename class="directory">binutils-build</filename> directory:</para>
435
436<screen><userinput>make -C ld install</userinput></screen>
437
438<para>The linker was adjusted a little while back, at the end of the first
439pass of Binutils. From this point onwards everything will link <emphasis>only
440</emphasis> against the libraries in <filename>/tools/lib</filename>.</para>
441
442<note><para>If you somehow missed the earlier warning to retain the Binutils
443source and build directories from the first pass or otherwise accidentally
444deleted them or just don't have access to them, don't worry, all is not lost.
445Just ignore the above command. The result is a small chance of the subsequent
446testing programs linking against libraries on the host. This is not ideal, but
447it's not a major problem. The situation is corrected when we install the
448second pass of Binutils a bit further on.</para></note>
449
450<para>Now that the adjusted linker is installed, you have to remove the
451Binutils build and source directories.</para>
452
453<para>The next thing to do is to amend our GCC specs file so that it points
454to the new dynamic linker. A simple sed will accomplish this:</para>
455
456<!-- Ampersands are needed to allow cut and paste -->
457
458<screen><userinput>SPECFILE=/tools/lib/gcc-lib/*/*/specs &amp;&amp;
459sed -e 's@ /lib/ld-linux.so.2@ /tools/lib/ld-linux.so.2@g' \
460&nbsp;&nbsp;&nbsp;&nbsp;$SPECFILE &gt; tempspecfile &amp;&amp;
461mv -f tempspecfile $SPECFILE &amp;&amp;
462unset SPECFILE</userinput></screen>
463
464<para>We recommend that you cut-and-paste the above rather than try and type it
465all in. Or you can edit the specs file by hand if you want to: just replace the
466occurrence of "/lib/ld-linux.so.2" with "/tools/lib/ld-linux.so.2". Be sure to
467visually inspect the specs file to verify the intended change was actually
468made.</para>
469
470<important><para>If you are working on a platform where the name of the dynamic
471linker is something other than <filename>ld-linux.so.2</filename>, you
472<emphasis>must</emphasis> substitute <filename>ld-linux.so.2</filename> with the
473name of your platform's dynamic linker in the above commands. Refer back to
474<xref linkend="ch05-toolchaintechnotes"/> if necessary.</para></important>
475
476<para>Lastly, there is a possibility that some include files from the host
477system have found their way into GCC's private include dir. This can happen
478because of GCC's "fixincludes" process which runs as part of the GCC build.
479We'll explain more about this further on in this chapter. For now, run the
480following commands to eliminate this possibility:</para>
481
482<screen><userinput>rm -f /tools/lib/gcc-lib/*/*/include/{pthread.h,bits/sigthread.h}</userinput></screen>
483
484<!-- HACK - Force some whitespace to appease tidy -->
485<literallayout></literallayout>
486
487<caution><para>It is imperative at this point to stop and ensure that the basic
488functions (compiling and linking) of the new toolchain are working as expected.
489For this we are going to perform a simple sanity check:</para>
490
491<screen><userinput>echo 'main(){}' &gt; dummy.c
492cc dummy.c
493readelf -l a.out | grep ': /tools'</userinput></screen>
494
495<para>If everything is working correctly, there should be no errors, and the
496output of the last command will be:</para>
497
498<blockquote><screen>[Requesting program interpreter: /tools/lib/ld-linux.so.2]</screen></blockquote>
499
500<para>(Of course allowing for platform specific differences in dynamic linker
501name). Note especially that <filename class="directory">/tools/lib</filename>
502appears as the prefix of our dynamic linker. If you did not receive the output
503as shown above, or received no output at all, then something is seriously wrong.
504You will need to investigate and retrace your steps to find out where the
505problem is and correct it. There is no point in continuing until this is done.
506First, redo the sanity check using <userinput>gcc</userinput> instead of
507<userinput>cc</userinput>. If this works it means the
508<filename class="symlink">/tools/bin/cc</filename> symlink is missing. Revisit
509<xref linkend="ch05-gcc-pass1"/> and fix the symlink. Second, ensure your $PATH
510is correct. You can check this by running <userinput>echo $PATH</userinput> and
511verifying that <filename class="directory">/tools/bin</filename> is at the head
512of the list. If the $PATH is wrong it could mean you're not logged in as user
513<emphasis>lfs</emphasis> or something went wrong back in
514<xref linkend="ch05-settingenviron"/>. Third, something may have gone wrong with
515the specs file amendment above. In this case redo the specs file amendment
516ensuring to cut-and-paste the commands as was recommended.</para>
517
518<para>Once you are satisfied that all is well, clean up the test files:</para>
519
520<screen><userinput>rm dummy.c a.out</userinput></screen>
521</caution>
522
523<!-- HACK - Force some whitespace to appease tidy -->
524<literallayout></literallayout>
525
526<para>This completes the installation of the self-contained toolchain, and it
527can now be used to build the rest of the temporary tools.</para>
528
529</sect1>
530
531
532&c5-tcl;
533&c5-expect;
534&c5-dejagnu;
535&c5-gcc-pass2;
536&c5-binutils-pass2;
537
538&c5-gawk;
539&c5-coreutils;
540&c5-bzip2;
541&c5-gzip;
542&c5-diffutils;
543&c5-findutils;
544&c5-make;
545&c5-grep;
546&c5-sed;
547&c5-gettext;
548&c5-ncurses;
549&c5-patch;
550&c5-tar;
551&c5-texinfo;
552&c5-bash;
553&c5-utillinux;
554&c5-perl;
555
556
557<sect1 id="ch05-stripping">
558<title>Stripping</title>
559<?dbhtml filename="stripping.html" dir="chapter05"?>
560
561<para>The steps in this section are optional. If your LFS partition is rather
562small, you will be glad to learn that you can throw away some unnecessary
563things. The executables and libraries you have built so far contain about 130 MB
564of unneeded debugging symbols. Remove those symbols like this:</para>
565
566<screen><userinput>strip --strip-unneeded /tools/{,s}bin/*
567strip --strip-debug /tools/lib/*</userinput></screen>
568
569<para>The first of the above commands will skip some twenty files, reporting
570that it doesn't recognize their file format. Most of them are scripts instead
571of binaries.</para>
572
573<para>Take care <emphasis>not</emphasis> to use
574<userinput>--strip-unneeded</userinput> on the libraries -- they would be
575destroyed and you would have to build Glibc all over again.</para>
576
577<para>To save another couple of megabytes, you can throw away all the
578documentation:</para>
579
580<screen><userinput>rm -rf /tools/{,share/}{doc,info,man}</userinput></screen>
581
582<para>You will now need to have at least 850 MB of free space on your LFS
583filesystem to be able to build and install Glibc in the next phase. If you can
584build and install Glibc, you can build and install the rest too.</para>
585
586</sect1>
587
588</chapter>
589
Note: See TracBrowser for help on using the repository browser.