[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 |
|
---|
| 27 | <para>Create a separate build directory again:</para>
|
---|
| 28 |
|
---|
| 29 | <screen><userinput>mkdir ../binutils-build
|
---|
| 30 | cd ../binutils-build</userinput></screen>
|
---|
| 31 |
|
---|
[d27a27b] | 32 | <para>Now prepare Binutils for compilation:</para>
|
---|
[73aedd1d] | 33 |
|
---|
[673b0d8] | 34 | <screen><userinput>../binutils-&binutils-version;/configure --prefix=/tools \
|
---|
| 35 | --enable-shared --with-lib-path=/tools/lib</userinput></screen>
|
---|
[73aedd1d] | 36 |
|
---|
| 37 | <para>The meaning of the new configure option:</para>
|
---|
| 38 |
|
---|
[9652249] | 39 | <variablelist>
|
---|
| 40 | <varlistentry>
|
---|
[574b0ea] | 41 | <term><parameter>--with-lib-path=/tools/lib</parameter></term>
|
---|
[9652249] | 42 | <listitem><para>This tells the configure script to specify the library search path
|
---|
[574b0ea] | 43 | during the compilation of Binutils, resulting in <parameter>/tools/lib</parameter>
|
---|
[9652249] | 44 | to be passed to the linker. This prevents the linker from searching through library
|
---|
| 45 | directories on the host.</para></listitem>
|
---|
| 46 | </varlistentry>
|
---|
| 47 | </variablelist>
|
---|
[73aedd1d] | 48 |
|
---|
| 49 | <para>Before starting to build Binutils, remember to unset any environment
|
---|
| 50 | variables that override the default optimization flags.</para>
|
---|
| 51 |
|
---|
| 52 | <para>Compile the package:</para>
|
---|
| 53 |
|
---|
[b3adaba] | 54 | <screen><userinput>make</userinput></screen>
|
---|
[73aedd1d] | 55 |
|
---|
[443cace] | 56 | <para>Compilation is now complete. As discussed earlier, we don't recommend
|
---|
[ede9b9b] | 57 | running the test suites for the temporary tools here in this chapter. If
|
---|
| 58 | nevertheless you want to run the Binutils test suite, the following command
|
---|
| 59 | will do so:</para>
|
---|
[73aedd1d] | 60 |
|
---|
[9dfc02f] | 61 | <screen><userinput>make -k check</userinput></screen>
|
---|
| 62 |
|
---|
| 63 | <para>Except for a few known failures, the binutils tests should all pass. The
|
---|
| 64 | exceptions to this rule are as follows:</para>
|
---|
| 65 |
|
---|
[574b0ea] | 66 | <screen><computeroutput>* 5 FAIL (unexpected failure) for visibility
|
---|
[9dfc02f] | 67 | * 1 FAIL for selective4
|
---|
[574b0ea] | 68 | * 1 FAIL for selective5</computeroutput></screen>
|
---|
[9dfc02f] | 69 |
|
---|
| 70 | <!--
|
---|
[73aedd1d] | 71 |
|
---|
[443cace] | 72 | <para>There should be no unexpected failures here, expected failures are fine.
|
---|
[ede9b9b] | 73 | Unfortunately, there is no easy way to view the test results summary like there
|
---|
| 74 | was for the GCC package. However, if a failure occurs here, it should be easy
|
---|
| 75 | to spot. The output shown will contain something like:</para>
|
---|
[73aedd1d] | 76 |
|
---|
[574b0ea] | 77 | <blockquote><screen><computeroutput>make[1]: *** [check-binutils] Error 2</computeroutput></screen></blockquote>
|
---|
[73aedd1d] | 78 |
|
---|
[9dfc02f] | 79 | -->
|
---|
| 80 |
|
---|
[17476c5] | 81 | <para>And install the package:</para>
|
---|
[73aedd1d] | 82 |
|
---|
| 83 | <screen><userinput>make install</userinput></screen>
|
---|
| 84 |
|
---|
[574b0ea] | 85 | <para>Now prepare the linker for the <quote>Re-adjusting</quote> phase in the next
|
---|
[73aedd1d] | 86 | chapter:</para>
|
---|
| 87 |
|
---|
| 88 | <screen><userinput>make -C ld clean
|
---|
| 89 | make -C ld LIB_PATH=/usr/lib:/lib</userinput></screen>
|
---|
| 90 |
|
---|
| 91 |
|
---|
[a0b689e] | 92 | <warning><para><emphasis>Do not yet remove</emphasis> the Binutils source and
|
---|
| 93 | build directories. You will need these directories again in the next chapter
|
---|
| 94 | in the state they are in now.</para></warning>
|
---|
[73aedd1d] | 95 |
|
---|
| 96 |
|
---|
| 97 | </sect2>
|
---|
[bc82645e] | 98 |
|
---|
[9652249] | 99 | <sect2 role="content"><title/>
|
---|
[5888299] | 100 | <para>The details on this package are found in <xref linkend="contents-binutils"/>.</para>
|
---|
[0868461] | 101 | </sect2>
|
---|
[5888299] | 102 |
|
---|
[bc82645e] | 103 | </sect1>
|
---|