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>This defines a default (non-existent) sysroot directory
  90           <filename class="directory">/tools/$LFS_TGT/sys-root</filename>.
  91           It is useful when looking for shared objects which are required by
  92           other shared objects explicitly included on the linker's command
  93           line. Those objects are searched into the directories listed in
  94           <filename>&lt;sysroot&gt;/etc/ld.so.conf</filename>, and failing
  95           that, into the linker search path, which is right. If this switch
  96           is not given, <filename>/etc/ld.so.conf</filename> on the host
  97           is used, that is, programs may be linked to libraries on
  98           the host, which we want to avoid.</para>
  99         </listitem>
 100       </varlistentry>
 101
 102     </variablelist>
 103
 104     <para>Compile the package:</para>
 105
 106 <screen><userinput remap="make">make</userinput></screen>
 107
 108     <para>Install the package:</para>
 109
 110 <screen><userinput remap="install">make install</userinput></screen>
 111
 112     <para>Now prepare the linker for the <quote>Re-adjusting</quote> phase in
 113     the next chapter:</para>
 114
 115 <screen><userinput remap="adjust">make -C ld clean
 116 make -C ld LIB_PATH=/usr/lib:/lib
 117 cp -v ld/ld-new /tools/bin</userinput></screen>
 118
 119     <variablelist>
 120       <title>The meaning of the make parameters:</title>
 121
 122       <varlistentry>
 123         <term><parameter>-C ld clean</parameter></term>
 124         <listitem>
 125           <para>This tells the make program to remove all compiled
 126           files in the <filename class="directory">ld</filename>
 127           subdirectory.</para>
 128         </listitem>
 129       </varlistentry>
 130
 131       <varlistentry>
 132         <term><parameter>-C ld LIB_PATH=/usr/lib:/lib</parameter></term>
 133         <listitem>
 134           <para>This option rebuilds everything in the <filename
 135           class="directory">ld</filename> subdirectory. Specifying the
 136           <envar>LIB_PATH</envar> Makefile variable on the command line
 137           allows us to override the default value of the temporary tools
 138           and point it to the proper final path. The value of this variable
 139           specifies the linker's default library search path. This
 140           preparation is used in the next chapter.</para>
 141         </listitem>
 142       </varlistentry>
 143
 144     </variablelist>
 145
 146   </sect2>
 147
 148   <sect2 role="content">
 149     <title/>
 150
 151     <para>Details on this package are located in
 152     <xref linkend="contents-binutils" role="."/></para>
 153
 154   </sect2>
 155
 156 </sect1>