BOOK/chapter05/binutils-pass2.xml

   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">
   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 <screen>&buildtime; 1.5 SBU
  15 &diskspace; 108 MB</screen>
  16
  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
  26 <para>Now prepare Binutils for compilation:</para>
  27
  28 <screen><userinput>../binutils-&binutils-version;/configure --prefix=/tools \
  29     --enable-shared --with-lib-path=/tools/lib</userinput></screen>
  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
  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>
  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
  46 <screen><userinput>make</userinput></screen>
  47
  48 <para>Compilation is now complete. As discussed earlier, we don't recommend
  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>
  52
  53 <screen><userinput>make check</userinput></screen>
  54
  55 <para>There should be no unexpected failures here, expected failures are fine.
  56 Unfortunately, there is no easy way to view the test results summary like there
  57 was for the GCC package. However, if a failure occurs here, it should be easy
  58 to spot. The output shown will contain something like:</para>
  59
  60 <blockquote><screen>make[1]: *** [check-binutils] Error 2</screen></blockquote>
  61
  62 <para>And install the package:</para>
  63
  64 <screen><userinput>make install</userinput></screen>
  65
  66 <para>Now prepare the linker for the "Re-adjusting" phase in the next
  67 chapter:</para>
  68
  69 <screen><userinput>make -C ld clean
  70 make -C ld LIB_PATH=/usr/lib:/lib</userinput></screen>
  71
  72
  73 <warning><para><emphasis>Do not yet remove</emphasis> the Binutils source and
  74 build directories. You will need these directories again in the next chapter
  75 in the state they are in now.</para></warning>
  76
  77
  78 </sect2>
  79
  80 <sect2><title> </title><para> </para>
  81 <para>The details on this package are found in <xref linkend="contents-binutils"/>.</para>
  82 <para> </para></sect2>
  83
  84 </sect1>