[673b0d8] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
| 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
|
---|
| 3 | <!ENTITY % general-entities SYSTEM "../general.ent">
|
---|
| 4 | %general-entities;
|
---|
| 5 | ]>
|
---|
[9652249] | 6 | <sect1 id="ch-tools-binutils-pass2" role="wrap">
|
---|
[673b0d8] | 7 | <title>Binutils-&binutils-version; - Pass 2</title>
|
---|
| 8 | <?dbhtml filename="binutils-pass2.html"?>
|
---|
[bc82645e] | 9 |
|
---|
[673b0d8] | 10 | <indexterm zone="ch-tools-binutils-pass2">
|
---|
| 11 | <primary sortas="a-Binutils">Binutils</primary>
|
---|
| 12 | <secondary>tools, pass 2</secondary></indexterm>
|
---|
[bc82645e] | 13 |
|
---|
[9652249] | 14 | <sect2 role="package"><title/>
|
---|
[5888299] | 15 |
|
---|
[9652249] | 16 | <segmentedlist>
|
---|
| 17 | <segtitle>&buildtime;</segtitle>
|
---|
| 18 | <segtitle>&diskspace;</segtitle>
|
---|
| 19 | <seglistitem><seg>1.5 SBU</seg><seg>108 MB</seg></seglistitem>
|
---|
| 20 | </segmentedlist>
|
---|
[73aedd1d] | 21 |
|
---|
[9652249] | 22 | </sect2>
|
---|
| 23 |
|
---|
| 24 | <sect2 role="installation">
|
---|
[73aedd1d] | 25 | <title>Re-installation of Binutils</title>
|
---|
| 26 |
|
---|
[af133c3] | 27 | <para>The current version of Binutils in use has a bug that causes strip to
|
---|
| 28 | remove necessary information from certain library files. This patch fixes
|
---|
| 29 | the problem:</para>
|
---|
| 30 |
|
---|
[060e2e1] | 31 | <screen><userinput>patch -Np1 -i ../binutils-&binutils-version;-fix_strip-1.patch</userinput></screen>
|
---|
[af133c3] | 32 |
|
---|
[73aedd1d] | 33 | <para>Create a separate build directory again:</para>
|
---|
| 34 |
|
---|
| 35 | <screen><userinput>mkdir ../binutils-build
|
---|
| 36 | cd ../binutils-build</userinput></screen>
|
---|
| 37 |
|
---|
[d27a27b] | 38 | <para>Now prepare Binutils for compilation:</para>
|
---|
[73aedd1d] | 39 |
|
---|
[673b0d8] | 40 | <screen><userinput>../binutils-&binutils-version;/configure --prefix=/tools \
|
---|
| 41 | --enable-shared --with-lib-path=/tools/lib</userinput></screen>
|
---|
[73aedd1d] | 42 |
|
---|
| 43 | <para>The meaning of the new configure option:</para>
|
---|
| 44 |
|
---|
[9652249] | 45 | <variablelist>
|
---|
| 46 | <varlistentry>
|
---|
[574b0ea] | 47 | <term><parameter>--with-lib-path=/tools/lib</parameter></term>
|
---|
[9652249] | 48 | <listitem><para>This tells the configure script to specify the library search path
|
---|
[574b0ea] | 49 | during the compilation of Binutils, resulting in <parameter>/tools/lib</parameter>
|
---|
[9652249] | 50 | to be passed to the linker. This prevents the linker from searching through library
|
---|
| 51 | directories on the host.</para></listitem>
|
---|
| 52 | </varlistentry>
|
---|
| 53 | </variablelist>
|
---|
[73aedd1d] | 54 |
|
---|
| 55 | <para>Before starting to build Binutils, remember to unset any environment
|
---|
| 56 | variables that override the default optimization flags.</para>
|
---|
| 57 |
|
---|
| 58 | <para>Compile the package:</para>
|
---|
| 59 |
|
---|
[b3adaba] | 60 | <screen><userinput>make</userinput></screen>
|
---|
[73aedd1d] | 61 |
|
---|
[d878ce3] | 62 | <para>Compilation is now complete. As discussed earlier, running the test suite
|
---|
| 63 | isn't mandatory for the temporary tools here in this chapter. If you do want to
|
---|
| 64 | run the Binutils test suite though, the following command will do so:</para>
|
---|
[73aedd1d] | 65 |
|
---|
[9dfc02f] | 66 | <screen><userinput>make -k check</userinput></screen>
|
---|
| 67 |
|
---|
| 68 | <para>Except for a few known failures, the binutils tests should all pass. The
|
---|
| 69 | exceptions to this rule are as follows:</para>
|
---|
| 70 |
|
---|
[574b0ea] | 71 | <screen><computeroutput>* 5 FAIL (unexpected failure) for visibility
|
---|
[9dfc02f] | 72 | * 1 FAIL for selective4
|
---|
[574b0ea] | 73 | * 1 FAIL for selective5</computeroutput></screen>
|
---|
[9dfc02f] | 74 |
|
---|
| 75 | <!--
|
---|
[73aedd1d] | 76 |
|
---|
[443cace] | 77 | <para>There should be no unexpected failures here, expected failures are fine.
|
---|
[ede9b9b] | 78 | Unfortunately, there is no easy way to view the test results summary like there
|
---|
| 79 | was for the GCC package. However, if a failure occurs here, it should be easy
|
---|
| 80 | to spot. The output shown will contain something like:</para>
|
---|
[73aedd1d] | 81 |
|
---|
[574b0ea] | 82 | <blockquote><screen><computeroutput>make[1]: *** [check-binutils] Error 2</computeroutput></screen></blockquote>
|
---|
[73aedd1d] | 83 |
|
---|
[9dfc02f] | 84 | -->
|
---|
| 85 |
|
---|
[17476c5] | 86 | <para>And install the package:</para>
|
---|
[73aedd1d] | 87 |
|
---|
| 88 | <screen><userinput>make install</userinput></screen>
|
---|
| 89 |
|
---|
[574b0ea] | 90 | <para>Now prepare the linker for the <quote>Re-adjusting</quote> phase in the next
|
---|
[73aedd1d] | 91 | chapter:</para>
|
---|
| 92 |
|
---|
| 93 | <screen><userinput>make -C ld clean
|
---|
| 94 | make -C ld LIB_PATH=/usr/lib:/lib</userinput></screen>
|
---|
| 95 |
|
---|
| 96 |
|
---|
[a0b689e] | 97 | <warning><para><emphasis>Do not yet remove</emphasis> the Binutils source and
|
---|
| 98 | build directories. You will need these directories again in the next chapter
|
---|
| 99 | in the state they are in now.</para></warning>
|
---|
[73aedd1d] | 100 |
|
---|
| 101 |
|
---|
| 102 | </sect2>
|
---|
[bc82645e] | 103 |
|
---|
[9652249] | 104 | <sect2 role="content"><title/>
|
---|
[5888299] | 105 | <para>The details on this package are found in <xref linkend="contents-binutils"/>.</para>
|
---|
[0868461] | 106 | </sect2>
|
---|
[5888299] | 107 |
|
---|
[bc82645e] | 108 | </sect1>
|
---|