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 | ]>
|
---|
6 | <sect1 id="ch-tools-binutils-pass2" role="wrap">
|
---|
7 | <title>Binutils-&binutils-version; - Pass 2</title>
|
---|
8 | <?dbhtml filename="binutils-pass2.html"?>
|
---|
9 |
|
---|
10 | <indexterm zone="ch-tools-binutils-pass2">
|
---|
11 | <primary sortas="a-Binutils">Binutils</primary>
|
---|
12 | <secondary>tools, pass 2</secondary></indexterm>
|
---|
13 |
|
---|
14 | <sect2 role="package"><title/>
|
---|
15 |
|
---|
16 | <segmentedlist>
|
---|
17 | <segtitle>&buildtime;</segtitle>
|
---|
18 | <segtitle>&diskspace;</segtitle>
|
---|
19 | <seglistitem><seg>1.5 SBU</seg><seg>108 MB</seg></seglistitem>
|
---|
20 | </segmentedlist>
|
---|
21 |
|
---|
22 | </sect2>
|
---|
23 |
|
---|
24 | <sect2 role="installation">
|
---|
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 |
|
---|
32 | <para>Now prepare Binutils for compilation:</para>
|
---|
33 |
|
---|
34 | <screen><userinput>../binutils-&binutils-version;/configure --prefix=/tools \
|
---|
35 | --enable-shared --with-lib-path=/tools/lib</userinput></screen>
|
---|
36 |
|
---|
37 | <para>The meaning of the new configure option:</para>
|
---|
38 |
|
---|
39 | <variablelist>
|
---|
40 | <varlistentry>
|
---|
41 | <term><parameter>--with-lib-path=/tools/lib</parameter></term>
|
---|
42 | <listitem><para>This tells the configure script to specify the library search path
|
---|
43 | during the compilation of Binutils, resulting in <parameter>/tools/lib</parameter>
|
---|
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>
|
---|
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 |
|
---|
54 | <screen><userinput>make</userinput></screen>
|
---|
55 |
|
---|
56 | <para>Compilation is now complete. As discussed earlier, we don't recommend
|
---|
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>
|
---|
60 |
|
---|
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 |
|
---|
66 | <screen><computeroutput>* 5 FAIL (unexpected failure) for visibility
|
---|
67 | * 1 FAIL for selective4
|
---|
68 | * 1 FAIL for selective5</computeroutput></screen>
|
---|
69 |
|
---|
70 | <!--
|
---|
71 |
|
---|
72 | <para>There should be no unexpected failures here, expected failures are fine.
|
---|
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>
|
---|
76 |
|
---|
77 | <blockquote><screen><computeroutput>make[1]: *** [check-binutils] Error 2</computeroutput></screen></blockquote>
|
---|
78 |
|
---|
79 | -->
|
---|
80 |
|
---|
81 | <para>And install the package:</para>
|
---|
82 |
|
---|
83 | <screen><userinput>make install</userinput></screen>
|
---|
84 |
|
---|
85 | <para>Now prepare the linker for the <quote>Re-adjusting</quote> phase in the next
|
---|
86 | chapter:</para>
|
---|
87 |
|
---|
88 | <screen><userinput>make -C ld clean
|
---|
89 | make -C ld LIB_PATH=/usr/lib:/lib</userinput></screen>
|
---|
90 |
|
---|
91 |
|
---|
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>
|
---|
95 |
|
---|
96 |
|
---|
97 | </sect2>
|
---|
98 |
|
---|
99 | <sect2 role="content"><title/>
|
---|
100 | <para>The details on this package are found in <xref linkend="contents-binutils"/>.</para>
|
---|
101 | </sect2>
|
---|
102 |
|
---|
103 | </sect1>
|
---|