chapter05.xml 29 KB

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