chapter05/binutils-pass2.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
   4   <!ENTITY % general-entities SYSTEM "../general.ent">
   5   %general-entities;
   6 ]>
   7
   8 <sect1 id="ch-tools-binutils-pass2" role="wrap">
   9   <?dbhtml filename="binutils-pass2.html"?>
  10
  11   <sect1info condition="script">
  12     <productname>binutils-pass2</productname>
  13     <productnumber>&binutils-version;</productnumber>
  14     <address>&binutils-url;</address>
  15   </sect1info>
  16
  17   <title>Binutils-&binutils-version; - Pass 2</title>
  18
  19   <indexterm zone="ch-tools-binutils-pass2">
  20     <primary sortas="a-Binutils">Binutils</primary>
  21     <secondary>tools, pass 2</secondary>
  22   </indexterm>
  23
  24   <sect2 role="package">
  25     <title/>
  26
  27     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
  28     href="../chapter06/binutils.xml"
  29     xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
  30
  31     <segmentedlist>
  32       <segtitle>&buildtime;</segtitle>
  33       <segtitle>&diskspace;</segtitle>
  34
  35       <seglistitem>
  36         <seg>&binutils-ch5p2-sbu;</seg>
  37         <seg>&binutils-ch5p2-du;</seg>
  38       </seglistitem>
  39     </segmentedlist>
  40
  41   </sect2>
  42
  43   <sect2 role="installation">
  44     <title>Installation of Binutils</title>
  45
  46     <para>Create a separate build directory again:</para>
  47
  48 <screen><userinput remap="pre">mkdir -v build
  49 cd       build</userinput></screen>
  50
  51     <para>Prepare Binutils for compilation:</para>
  52
  53 <screen><userinput remap="configure">CC=$LFS_TGT-gcc                \
  54 AR=$LFS_TGT-ar                 \
  55 RANLIB=$LFS_TGT-ranlib         \
  56 ../configure                   \
  57     --prefix=/tools            \
  58     --disable-nls              \
  59     --disable-werror           \
  60     --with-lib-path=/tools/lib \
  61     --with-sysroot</userinput></screen>
  62
  63     <variablelist>
  64       <title>The meaning of the new configure options:</title>
  65
  66       <varlistentry>
  67         <term><parameter>CC=$LFS_TGT-gcc AR=$LFS_TGT-ar RANLIB=$LFS_TGT-ranlib</parameter></term>
  68         <listitem>
  69           <para>Because this is really a native build of Binutils, setting these
  70           variables ensures that the build system uses the cross-compiler and
  71           associated tools instead of the ones on the host system.</para>
  72         </listitem>
  73       </varlistentry>
  74
  75       <varlistentry>
  76         <term><parameter>--with-lib-path=/tools/lib</parameter></term>
  77         <listitem>
  78           <para>This tells the configure script to specify the library
  79           search path during the compilation of Binutils, resulting in
  80           <filename class="directory">/tools/lib</filename> being passed
  81           to the linker. This prevents the linker from searching through
  82           library directories on the host.</para>
  83         </listitem>
  84       </varlistentry>
  85
  86       <varlistentry>
  87         <term><parameter>--with-sysroot</parameter></term>
  88         <listitem>
  89           <para>The sysroot feature enables the linker to find shared objects
  90           which are required by other shared objects explicitly included on the
  91           linker's command line. Without this, some packages may not build
  92           successfully on some hosts.</para>
  93         </listitem>
  94       </varlistentry>
  95
  96     </variablelist>
  97
  98     <para>Compile the package:</para>
  99
 100 <screen><userinput remap="make">make</userinput></screen>
 101
 102     <para>Install the package:</para>
 103
 104 <screen><userinput remap="install">make install</userinput></screen>
 105
 106     <para>Now prepare the linker for the <quote>Re-adjusting</quote> phase in
 107     the next chapter:</para>
 108
 109 <screen><userinput remap="adjust">make -C ld clean
 110 make -C ld LIB_PATH=/usr/lib:/lib
 111 cp -v ld/ld-new /tools/bin</userinput></screen>
 112
 113     <variablelist>
 114       <title>The meaning of the make parameters:</title>
 115
 116       <varlistentry>
 117         <term><parameter>-C ld clean</parameter></term>
 118         <listitem>
 119           <para>This tells the make program to remove all compiled
 120           files in the <filename class="directory">ld</filename>
 121           subdirectory.</para>
 122         </listitem>
 123       </varlistentry>
 124
 125       <varlistentry>
 126         <term><parameter>-C ld LIB_PATH=/usr/lib:/lib</parameter></term>
 127         <listitem>
 128           <para>This option rebuilds everything in the <filename
 129           class="directory">ld</filename> subdirectory. Specifying the
 130           <envar>LIB_PATH</envar> Makefile variable on the command line
 131           allows us to override the default value of the temporary tools
 132           and point it to the proper final path. The value of this variable
 133           specifies the linker's default library search path. This
 134           preparation is used in the next chapter.</para>
 135         </listitem>
 136       </varlistentry>
 137
 138     </variablelist>
 139
 140   </sect2>
 141
 142   <sect2 role="content">
 143     <title/>
 144
 145     <para>Details on this package are located in
 146     <xref linkend="contents-binutils" role="."/></para>
 147
 148   </sect2>
 149
 150 </sect1>