source: chapter05/binutils-pass1.xml@ e2c4848

7.5-systemd 7.6-systemd 7.6-systemd-rc1 7.6-systemd-rc2 7.7-systemd 7.7-systemd-rc1 7.8-systemd 7.9-systemd 7.9-systemd-rc1 7.9-systemd-rc2 systemd
Last change on this file since e2c4848 was e2c4848, checked in by Krejzi <krejzi@…>, 8 years ago

Updates from LFS development.

git-svn-id: http://svn.linuxfromscratch.org/LFS/branches/systemd/BOOK@10483 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</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
59cd ../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 ;;
155esac</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>
Note: See TracBrowser for help on using the repository browser.