chapter05/binutils-pass1.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-pass1" role="wrap">
   9   <?dbhtml filename="binutils-pass1.html"?>
  10
  11   <sect1info condition="script">
  12     <productname>binutils</productname>
  13     <productnumber>&binutils-version;</productnumber>
  14     <address>&binutils-url;</address>
  15   </sect1info>
  16
  17   <title>Binutils-&binutils-version; - Pass 1</title>
  18
  19   <indexterm zone="ch-tools-binutils-pass1">
  20     <primary sortas="a-Binutils">Binutils</primary>
  21     <secondary>tools, pass 1</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-ch5p1-sbu;</seg>
  37         <seg>&binutils-ch5p1-du;</seg>
  38       </seglistitem>
  39     </segmentedlist>
  40
  41   </sect2>
  42
  43   <sect2 role="installation">
  44     <title>Installation of Cross Binutils</title>
  45
  46     <note><para>Go back and re-read the notes in the previous section.
  47     Understanding the notes labeled important will save you a lot
  48     of problems later.</para></note>
  49
  50     <para>It is important that Binutils be the first package compiled
  51     because both Glibc and GCC perform various tests on the available
  52     linker and assembler to determine which of their own features to
  53     enable.</para>
  54
  55     <para>The Binutils documentation recommends building Binutils outside of the
  56     source directory in a dedicated build directory:</para>
  57
  58 <screen><userinput remap="pre">mkdir -v ../binutils-build
  59 cd ../binutils-build</userinput></screen>
  60
  61     <note>
  62       <para>In order for the SBU values listed in the rest of the book
  63       to be of any use, measure the time it takes to build this package from
  64       the configuration, up to and including the first install. To achieve
  65       this easily, wrap the commands in a <command>time</command>
  66       command like this: <userinput>time { ./configure ... &amp;&amp; ...
  67       &amp;&amp; make install; }</userinput>.</para>
  68     </note>
  69
  70     <note><para>The approximate build SBU values and required disk space
  71     in Chapter 5 does not include test suite data.</para></note>
  72
  73     <para>Now prepare Binutils for compilation:</para>
  74
  75 <screen><userinput remap="configure">../binutils-&binutils-version;/configure     \
  76     --prefix=/tools            \
  77     --with-sysroot=$LFS        \
  78     --with-lib-path=/tools/lib \
  79     --target=$LFS_TGT          \
  80     --disable-nls              \
  81     --disable-werror</userinput></screen>
  82
  83     <variablelist>
  84       <title>The meaning of the configure options:</title>
  85
  86       <varlistentry>
  87         <term><parameter>--prefix=/tools</parameter></term>
  88         <listitem>
  89           <para>This tells the configure script to prepare to install the
  90           Binutils programs in the <filename class="directory">/tools</filename>
  91           directory.</para>
  92         </listitem>
  93       </varlistentry>
  94
  95       <varlistentry>
  96         <term><parameter>--with-sysroot=$LFS</parameter></term>
  97         <listitem>
  98           <para>For cross compilation, this tells the build system to look in
  99           $LFS for the target system libraries as needed.</para>
 100         </listitem>
 101       </varlistentry>
 102
 103       <varlistentry>
 104         <term><parameter>--with-lib-path=/tools/lib</parameter></term>
 105         <listitem>
 106           <para>This specifies which library path the linker should be
 107           configured to use.</para>
 108         </listitem>
 109       </varlistentry>
 110
 111       <varlistentry>
 112         <term><envar>--target=$LFS_TGT</envar></term>
 113         <listitem>
 114           <para>Because the machine description in the <envar>LFS_TGT</envar>
 115           variable is slightly different than the value returned by the
 116           <command>config.guess</command> script, this switch will tell the
 117           <command>configure</command> script to adjust Binutil's build system
 118           for building a cross linker.  </para>
 119         </listitem>
 120       </varlistentry>
 121
 122       <varlistentry>
 123         <term><parameter>--disable-nls</parameter></term>
 124         <listitem>
 125           <para>This disables internationalization as i18n is not needed for the
 126           temporary tools.</para>
 127         </listitem>
 128       </varlistentry>
 129
 130       <varlistentry>
 131         <term><parameter>--disable-werror</parameter></term>
 132         <listitem>
 133           <para>This prevents the build from stopping in the event that there
 134           are warnings from the host's compiler.</para>
 135         </listitem>
 136       </varlistentry>
 137
 138     </variablelist>
 139
 140     <para>Continue with compiling the package:</para>
 141
 142 <screen><userinput remap="make">make</userinput></screen>
 143
 144     <para>Compilation is now complete. Ordinarily we would now run the
 145     test suite, but at this early stage the test suite framework (Tcl,
 146     Expect, and DejaGNU) is not yet in place. The benefits of running the
 147     tests at this point are minimal since the programs from this
 148     first pass will soon be replaced by those from the second.</para>
 149
 150     <para>If building on x86_64, create a symlink to ensure the sanity of
 151     the toolchain:</para>
 152
 153 <screen><userinput remap="install">case $(uname -m) in
 154   x86_64) mkdir -v /tools/lib &amp;&amp; ln -sv lib /tools/lib64 ;;
 155 esac</userinput></screen>
 156
 157     <para>Install the package:</para>
 158
 159 <screen><userinput remap="install">make install</userinput></screen>
 160
 161   </sect2>
 162
 163   <sect2 role="content">
 164     <title/>
 165
 166     <para>Details on this package are located in
 167     <xref linkend="contents-binutils" role="."/></para>
 168
 169   </sect2>
 170
 171 </sect1>