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