Text updates for cross2 Chapter 5
[linux_from_scratch.git] / chapter06 / binutils-pass2.xml
blobd88bb84e2bad123018cfcee5269cb829f0644d77
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 ]>
8 <sect1 id="ch-tools-binutils-pass2" role="wrap">
9   <?dbhtml filename="binutils-pass2.html"?>
11   <sect1info condition="script">
12     <productname>binutils-pass2</productname>
13     <productnumber>&binutils-version;</productnumber>
14     <address>&binutils-url;</address>
15   </sect1info>
17   <title>Binutils-&binutils-version; - Pass 2</title>
19   <indexterm zone="ch-tools-binutils-pass2">
20     <primary sortas="a-Binutils">Binutils</primary>
21     <secondary>tools, pass 2</secondary>
22   </indexterm>
24   <sect2 role="package">
25     <title/>
27     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
28     href="../chapter08/binutils.xml"
29     xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
31     <segmentedlist>
32       <segtitle>&buildtime;</segtitle>
33       <segtitle>&diskspace;</segtitle>
35       <seglistitem>
36         <seg>&binutils-ch5p2-sbu;</seg>
37         <seg>&binutils-ch5p2-du;</seg>
38       </seglistitem>
39     </segmentedlist>
41   </sect2>
43   <sect2 role="installation">
44     <title>Installation of Binutils</title>
46     <para>Create a separate build directory again:</para>
48 <screen><userinput remap="pre">mkdir -v build
49 cd       build</userinput></screen>
51     <para>Prepare Binutils for compilation:</para>
53 <screen><userinput remap="configure">../configure                   \
54     --prefix=/usr              \
55     --build=$(../config.guess) \
56     --host=$LFS_TGT            \
57     --disable-nls              \
58     --enable-shared            \
59     --disable-werror</userinput></screen>
61     <variablelist>
62       <title>The meaning of the new configure options:</title>
64       <varlistentry>
65         <term><parameter>--host=$LFS_TGT</parameter></term>
66         <listitem>
67           <para>This tells the configure script that we want to build
68           this pass of binutils for the $LFS_TGT machine, using our just
69           built cross-compiler.  This prevents the linker from searching
70           through library directories on the host.</para>
71         </listitem>
72       </varlistentry>
74     </variablelist>
76     <para>Compile the package:</para>
78 <screen><userinput remap="make">make</userinput></screen>
80     <para>Install the package:</para>
82 <screen><userinput remap="install">make DESTDIR=$LFS install</userinput></screen>
84   </sect2>
86   <sect2 role="content">
87     <title/>
89     <para>Details on this package are located in
90     <xref linkend="contents-binutils" role="."/></para>
92   </sect2>
94 </sect1>