source: chapter05/chapter05.xml@ b157558

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 b157558 was b157558, checked in by Alex Gronenwoud <alex@…>, 20 years ago

Moving the final strip from the last chapter to the end of chapter 6.

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

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