chapter05.xml 29 KB

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