source: chapter05/binutils-pass1.xml@ ceebda5

ml-11.0 multilib
Last change on this file since ceebda5 was ceebda5, checked in by Xℹ Ruoyao <xry111@…>, 17 months ago

Merge changes from trunk to multilib

git-svn-id: http://svn.linuxfromscratch.org/LFS/branches/multilib@12176 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

  • Property mode set to 100644
File size: 5.7 KB
Line 
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-pass1</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="../chapter08/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-tmpp1-sbu;</seg>
37 <seg>&binutils-tmpp1-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 section titled <xref
47 linkend="ch-tools-generalinstructions"/>.
48 Understanding the notes labeled important can save you a lot
49 of problems later.</para></note>
50
51 <para>It is important that Binutils be the first package compiled
52 because both Glibc and GCC perform various tests on the available
53 linker and assembler to determine which of their own features to
54 enable.</para>
55
56 <para>The Binutils documentation recommends building Binutils
57 in a dedicated build directory:</para>
58
59<screen><userinput remap="pre">mkdir -v build
60cd build</userinput></screen>
61
62 <note>
63 <para>In order for the SBU values listed in the rest of the book
64 to be of any use, measure the time it takes to build this package from
65 the configuration, up to and including the first install. To achieve
66 this easily, wrap the commands in a <command>time</command>
67 command like this: <userinput>time { ../configure ... &amp;&amp; make
68 &amp;&amp; make install; }</userinput>.</para>
69 </note>
70
71 <para>Now prepare Binutils for compilation:</para>
72
73<screen arch="default"><userinput remap="configure">../configure --prefix=$LFS/tools \
74 --with-sysroot=$LFS \
75 --target=$LFS_TGT \
76 --disable-nls \
77 --disable-werror</userinput></screen>
78<screen arch="ml_32,ml_x32,ml_all"><userinput remap="configure">../configure --prefix=$LFS/tools \
79 --with-sysroot=$LFS \
80 --target=$LFS_TGT \
81 --disable-nls \
82 --disable-werror \
83 --enable-multilib</userinput></screen>
84
85 <variablelist>
86 <title>The meaning of the configure options:</title>
87
88 <varlistentry>
89 <term><parameter>--prefix=$LFS/tools</parameter></term>
90 <listitem>
91 <para>This tells the configure script to prepare to install the
92 binutils programs in the <filename
93 class="directory">$LFS/tools</filename> directory.</para>
94 </listitem>
95 </varlistentry>
96
97 <varlistentry>
98 <term><parameter>--with-sysroot=$LFS</parameter></term>
99 <listitem>
100 <para>For cross compilation, this tells the build system to look in
101 $LFS for the target system libraries as needed.</para>
102 </listitem>
103 </varlistentry>
104
105 <varlistentry>
106 <term><envar>--target=$LFS_TGT</envar></term>
107 <listitem>
108 <para>Because the machine description in the <envar>LFS_TGT</envar>
109 variable is slightly different than the value returned by the
110 <command>config.guess</command> script, this switch will tell the
111 <command>configure</command> script to adjust binutil's build system
112 for building a cross linker. </para>
113 </listitem>
114 </varlistentry>
115
116 <varlistentry>
117 <term><parameter>--disable-nls</parameter></term>
118 <listitem>
119 <para>This disables internationalization as i18n is not needed for the
120 temporary tools.</para>
121 </listitem>
122 </varlistentry>
123
124 <varlistentry>
125 <term><parameter>--disable-werror</parameter></term>
126 <listitem>
127 <para>This prevents the build from stopping in the event that there
128 are warnings from the host's compiler.</para>
129 </listitem>
130 </varlistentry>
131
132 <varlistentry arch="ml_32,ml_x32,ml_all">
133 <term><parameter>--enable-multilib</parameter></term>
134 <listitem>
135 <para>Enables multilib support.</para>
136 </listitem>
137 </varlistentry>
138
139 </variablelist>
140
141 <para>Continue with compiling the package:</para>
142
143<screen><userinput remap="make">make</userinput></screen>
144
145 <para>Install the package:</para>
146
147<screen><userinput remap="install">make install -j1</userinput></screen>
148
149 <variablelist>
150 <title>The meaning of the make parameter:</title>
151
152 <varlistentry>
153 <term><parameter>-j1</parameter></term>
154 <listitem>
155 <para>An issue in the building system may cause the installation
156 to fail with <option>-j N</option> in <envar>MAKEFLAGS</envar>.
157 Override it to workaround this issue.</para>
158 </listitem>
159 </varlistentry>
160 </variablelist>
161
162 </sect2>
163
164 <sect2 role="content">
165 <title/>
166
167 <para>Details on this package are located in
168 <xref linkend="contents-binutils" role="."/></para>
169
170 </sect2>
171
172</sect1>
Note: See TracBrowser for help on using the repository browser.