Context Navigation

-              r18b65e2b
+              r1f53626
 </para></listitem>
+<listitem><para>September 16th, 2003 [greg]: Chapters 5 and 6 - Locking in
+Glibc and Re-adjusting the toolchain: Added sanity checks.</para></listitem>
+<listitem><para>September 16th, 2003 [greg]: Chapters 5 and 6 - Binutils, GCC,
+and Glibc: Added notes on the test suites.</para></listitem>
 <listitem><para>September 14th, 2003 [greg]: Chapter 6 - Revised chroot
 command: Removed no longer needed set +h.</para></listitem>

chapter05/binutils-pass1-inst.xml

-              r18b65e2b
+              r1f53626
 because both Glibc and GCC perform various tests on the available linker and
 assembler to determine which of their own features to enable.</para>
+<note><para>Even though Binutils is an important toolchain package, we are not
+going to run the testsuite at this early stage. Firstly, the testsuite
+framework is not yet in place and secondly, the programs from this first pass
+will soon be overwritten by those installed in the second pass.</para></note>
 <para>This package is known to behave badly when you have changed its default

chapter05/binutils-pass2-inst.xml

-              r18b65e2b
+              r1f53626
 <sect2>
 <title>Re-installation of Binutils</title>
+<note><para>It's worth noting that the Binutils testsuite we run in this
+chapter is considered not as critical as the one we run in Chapter 6.</para>
+</note>
 <para>First create a separate build directory again:</para>

chapter05/gcc-pass1-inst.xml

-              r18b65e2b
+              r1f53626
 <para>Unpack only the GCC-core tarball, as we won't be needing a C++ compiler
 for the moment.</para>
+<note><para>Even though GCC is an important toolchain package, we are not
+going to run the testsuite at this early stage. Firstly, the testsuite
+framework is not yet in place and secondly, the programs from this first pass
+will soon be overwritten by those installed in the second pass.</para></note>
 <para>This package is known to behave badly when you have changed its

chapter05/gcc-pass2-inst.xml

-              r18b65e2b
+              r1f53626
 which does not properly support the devpts filesystem will cause most of
 these tests to fail.</para>
+<note><para>It's worth noting that the GCC testsuite we run in this chapter is
+considered not as critical as the one we run in Chapter 6.</para></note>
 <para>Unpack all three GCC tarballs in one and the same working directory.

chapter05/glibc-inst.xml

-              r18b65e2b
+              r1f53626
 Glibc-linuxthreads in that directory, not in <filename>/usr/src</filename> as
 you would normally do.</para>
+<note><para>We are going to run the testsuite for Glibc in this chapter.
+However, it's worth noting that the Glibc testsuite we run in this chapter is
+considered not as critical as the one we run in Chapter 6.</para></note>
 <para>This package is known to behave badly when you have changed its

chapter05/lockingglibc.xml

-              r18b65e2b
+              r1f53626
 <para><screen><userinput>rm -f /tools/lib/gcc-lib/*/*/include/{pthread.h,bits/sigthread.h}</userinput></screen></para>
+<caution><para>It is imperative at this point to stop and ensure that the
+basic functionality of the new toolchain is working as expected. We are going
+to perform a simple sanity check:</para>
+<para><screen><userinput>echo 'main(){}' > dummy.c
+gcc dummy.c
+readelf -l a.out | grep ': /tools'</userinput></screen></para>
+<para>If everything is working correctly, the output of the last command will
+be:</para>
+<para><screen>[Requesting program interpreter: /tools/lib/ld-linux.so.2]
+</screen></para>
+<para>If you did not receive the output as shown above then something is
+seriously wrong. You will need to investigate and retrace your steps to find
+out where the problem is and correct it. There is no point in continuing
+until this is done. Most likely, something went wrong with the specs file
+amendment above. Note especially that <filename>/tools/lib</filename> appears
+as the prefix of our dynamic linker. Of course, if you are working on a
+platform where the name of the dynamic linker is something other than
+<filename>ld-linux.so.2</filename> then the output will be slightly different.
+</para>
+<para>Once you are satisfied that all is well, clean up the test files:</para>
+<para><screen><userinput>rm dummy.c a.out</userinput></screen></para>
+</caution>
 <para>This completes the installation of the self-contained toolchain, which
 can now be used to build the rest of the temporary tools.</para>

chapter06/adjustingtoolchain.xml

-              r18b65e2b
+              r1f53626
 located in <filename class="directory">/tools/lib</filename>.</para>
+<caution><para>It is imperative at this point to stop and ensure that the
+basic functionality of the adjusted toolchain is working as expected. We are
+going to perform a simple sanity check:</para>
+<para><screen><userinput>echo 'main(){}' > dummy.c
+gcc dummy.c
+readelf -l a.out | grep ': /lib'</userinput></screen></para>
+<para>If everything is working correctly, the output of the last command will
+be:</para>
+<para><screen>[Requesting program interpreter: /lib/ld-linux.so.2]
+</screen></para>
+<para>If you did not receive the output as shown above then something is
+seriously wrong. You will need to investigate and retrace your steps to find
+out where the problem is and correct it. There is no point in continuing
+until this is done. Most likely, something went wrong with the specs file
+amendment above. Note especially that <filename>/lib</filename> now appears as
+the prefix of our dynamic linker. Of course, if you are working on a platform
+where the name of the dynamic linker is something other than <filename>
+ld-linux.so.2</filename> then the output will be slightly different.</para>
+<para>Once you are satisfied that all is well, clean up the test files:</para>
+<para><screen><userinput>rm dummy.c a.out</userinput></screen></para>
+</caution>
 </sect1>

chapter06/binutils-inst.xml

-              r18b65e2b
+              r1f53626
 <sect2><title>Installation of Binutils</title>
+<note><para>The testsuite for Binutils in this chapter is considered
+<emphasis>critical</emphasis>. Do not skip it under any circumstances.</para>
+</note>
 <para>This package is known to behave badly when you have changed its

chapter06/gcc-inst.xml

-              r18b65e2b
+              r1f53626
 <sect2>
 <title>Installation of GCC</title>
+<note><para>The testsuite for GCC in this chapter is considered <emphasis>
+critical</emphasis>. Do not skip it under any circumstances.</para></note>
 <para>This package is known to behave badly when you have changed its

chapter06/glibc-inst.xml

-              r18b65e2b
+              r1f53626
 ldscripts before the Glibc install, because the Glibc autoconf tests would then
 give bogus results and thus defeat our goal of achieving a clean build.</para>
+<note><para>The testsuite for Glibc in this chapter is considered <emphasis>
+critical</emphasis>. Do not skip it under any circumstances.</para></note>
 <para>Before starting to build Glibc, remember to unpack the Glibc-linuxthreads

index.xml

-              r18b65e2b
+              r1f53626
 <!ENTITY version "20030915">
 <!ENTITY releasedate "September 15th, 2003">
+<!ENTITY version "20030916">
+<!ENTITY releasedate "September 16th, 2003">
 <!ENTITY nbsp " ">

Note: See TracChangeset for help on using the changeset viewer.

Context Navigation

Changeset 1f53626

Legend:

Download in other formats: