source: chapter05/gcc-pass1.xml@ 8eb3fe4

multilib-10.1 multilib-before-cross
Last change on this file since 8eb3fe4 was 8eb3fe4, checked in by Thomas Trepl <thomas@…>, 3 years ago

First apply of multilib-patch of April 1st, 2019

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

  • Property mode set to 100644
File size: 14.3 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-gcc-pass1" role="wrap" xreflabel="gcc-pass1">
9 <?dbhtml filename="gcc-pass1.html"?>
10
11 <sect1info condition="script">
12 <productname>gcc</productname>
13 <productnumber>&gcc-version;</productnumber>
14 <address>&gcc-url;</address>
15 </sect1info>
16
17 <title>GCC-&gcc-version; - Pass 1</title>
18
19 <indexterm zone="ch-tools-gcc-pass1">
20 <primary sortas="a-GCC">GCC</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/gcc.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>&gcc-ch5p1-sbu;</seg>
37 <seg>&gcc-ch5p1-du;</seg>
38 </seglistitem>
39 </segmentedlist>
40
41 </sect2>
42
43 <sect2 role="installation">
44 <title>Installation of Cross GCC</title>
45
46 <para arch="default">GCC now requires the GMP, MPFR, and MPC packages. As
47 these packages may not be included in your host distribution, they will be
48 built with GCC. Unpack each package into the GCC source directory and
49 rename the resulting directories so the GCC build procedures will
50 automatically use them:</para>
51
52 <para arch="multilib">GCC now requires the GMP, ISL, MPFR, and MPC packages.
53 As these packages may not be included in your host distribution, they will
54 be built with GCC. Unpack each package into the GCC source directory and
55 rename the resulting directories so the GCC build procedures will
56 automatically use them:</para>
57
58 <note><para>There are frequent misunderstandings about this chapter. The
59 procedures are the same as every other chapter as explained earlier (<xref
60 linkend='buildinstr'/>). First extract the gcc tarball from the sources
61 directory and then change to the directory created. Only then should you
62 proceed with the instructions below.</para></note>
63
64<screen arch="default"><userinput remap="pre">tar -xf ../mpfr-&mpfr-version;.tar.xz
65mv -v mpfr-&mpfr-version; mpfr
66tar -xf ../gmp-&gmp-version;.tar.xz
67mv -v gmp-&gmp-version; gmp
68tar -xf ../mpc-&mpc-version;.tar.gz
69mv -v mpc-&mpc-version; mpc</userinput></screen>
70<screen arch="multilib"><userinput remap="pre">tar -xf ../mpfr-&mpfr-version;.tar.xz
71mv -v mpfr-&mpfr-version; mpfr
72tar -xf ../gmp-&gmp-version;.tar.xz
73mv -v gmp-&gmp-version; gmp
74tar -xf ../mpc-&mpc-version;.tar.gz
75mv -v mpc-&mpc-version; mpc
76tar -xf ../isl-&isl-version;.tar.xz
77mv -v isl-&isl-version; isl</userinput></screen>
78
79 <para>The following command will change the location of GCC's default
80 dynamic linker to use the one installed in <filename
81 class="directory">/tools</filename>. It also removes <filename
82 class="directory">/usr/include</filename> from GCC's include search path.
83 Issue:</para>
84
85<screen><userinput remap="pre">for file in gcc/config/{linux,i386/linux{,64}}.h
86do
87 cp -uv $file{,.orig}
88 sed -e 's@/lib\(64\)\?\(32\)\?\(x32\)\?/ld@/tools&amp;@g' \
89 -e 's@/usr@/tools@g' $file.orig &gt; $file
90 echo '
91#undef STANDARD_STARTFILE_PREFIX_1
92#undef STANDARD_STARTFILE_PREFIX_2
93#define STANDARD_STARTFILE_PREFIX_1 "/tools/lib/"
94#define STANDARD_STARTFILE_PREFIX_2 ""' &gt;&gt; $file
95 touch $file.orig
96done</userinput></screen>
97
98 <para>In case the above seems hard to follow, let's break it down a bit.
99 First we copy the files <filename>gcc/config/linux.h</filename>,
100 <filename>gcc/config/i386/linux.h</filename>, and
101 <filename>gcc/config/i368/linux64.h</filename> to a file of
102 the same name but with an added suffix of <quote>.orig</quote>. Then the
103 first sed expression prepends <quote>/tools</quote> to every instance of
104 <quote>/lib/ld</quote>, <quote>/lib64/ld</quote> or
105 <quote>/lib32/ld</quote>, while the second one replaces hard-coded
106 instances of <quote>/usr</quote>. Next, we add our define statements which
107 alter the default startfile prefix to the end of the file. Note that the
108 trailing <quote>/</quote> in <quote>/tools/lib/</quote> is required.
109 Finally, we use <command>touch</command> to update the timestamp on the
110 copied files. When used in conjunction with <command>cp -u</command>, this
111 prevents unexpected changes to the original files in case the commands are
112 inadvertently run twice.</para>
113
114 <para arch="default">Finally, on x86_64 hosts, set the default directory
115 name for 64-bit libraries to <quote>lib</quote>:</para>
116
117<screen arch="default"><userinput remap="pre">case $(uname -m) in
118 x86_64)
119 sed -e '/m64=/s/lib64/lib/' \
120 -i.orig gcc/config/i386/t-linux64
121 ;;
122esac</userinput></screen>
123
124<screen arch="multilib"><userinput remap="pre">sed -e '/m64=/s/lib64/lib/' \
125 -i.orig gcc/config/i386/t-linux64
126cat > gcc/config/i386/t-linux64 &lt;&lt;"EOF"
127comma=,
128MULTILIB_OPTIONS = $(subst $(comma),/,$(TM_MULTILIB_CONFIG))
129MULTILIB_DIRNAMES = $(patsubst m%, %, $(subst /, ,$(MULTILIB_OPTIONS)))
130MULTILIB_OSDIRNAMES = m64=../lib$(call if_multiarch,:x86_64-linux-gnu)
131MULTILIB_OSDIRNAMES+= m32=../lib32$(call if_multiarch,:i386-linux-gnu)
132MULTILIB_OSDIRNAMES+= mx32=../libx32$(call if_multiarch,:x86_64-linux-gnux32)
133EOF</userinput></screen>
134
135<!--
136 <para>GCC doesn't detect stack protection correctly, which causes problems
137 for the build of Glibc-&glibc-version;, so fix that by issuing the following
138 command:</para>
139
140<screen><userinput remap="pre">sed -i '/k prot/agcc_cv_libc_provides_ssp=yes' gcc/configure</userinput></screen>
141-->
142
143<!--
144 <para>Also fix a problem identified upstream:</para>
145
146<screen><userinput remap="pre">sed -i 's/if \((code.*))\)/if (\1 \&amp;\&amp; \!DEBUG_INSN_P (insn))/' gcc/sched-deps.c</userinput></screen>
147-->
148
149 <!-- Following patch might be obsolete with gcc >= 8.2.1 -->
150 <!-- see: https://gcc.gnu.org/bugzilla/show_bug.cgi?id=86724 -->
151 <!-- Fix applied in ch5-gcc-pass{1,2}, ch6-gcc -->
152 <para arch="multilib">Fix an issue with isl-&isl-version;:</para>
153
154<screen arch="multilib"><userinput remap="pre">sed -e "/#include &lt;isl\/schedule_node.h&gt;/ a#include &lt;isl/id.h&gt;\n#include &lt;isl/space.h&gt;" \
155 -i gcc/graphite.h</userinput></screen>
156
157 <para>The GCC documentation recommends building GCC
158 in a dedicated build directory:</para>
159
160<screen><userinput remap="pre">mkdir -v build
161cd build</userinput></screen>
162
163 <para>Prepare GCC for compilation:</para>
164
165<screen arch="default"><userinput remap="configure">../configure \
166 --target=$LFS_TGT \
167 --prefix=/tools \
168 --with-glibc-version=2.11 \
169 --with-sysroot=$LFS \
170 --with-newlib \
171 --without-headers \
172 --with-local-prefix=/tools \
173 --with-native-system-header-dir=/tools/include \
174 --disable-nls \
175 --disable-shared \
176 --disable-multilib \
177 --disable-decimal-float \
178 --disable-threads \
179 --disable-libatomic \
180 --disable-libgomp \
181 --disable-libmpx \
182 --disable-libquadmath \
183 --disable-libssp \
184 --disable-libvtv \
185 --disable-libstdcxx \
186 --enable-languages=c,c++</userinput></screen>
187
188<screen arch="multilib"><userinput remap="configure">../configure \
189 --target=$LFS_TGT \
190 --prefix=/tools \
191 --with-glibc-version=2.11 \
192 --with-sysroot=$LFS \
193 --with-newlib \
194 --without-headers \
195 --with-local-prefix=/tools \
196 --with-native-system-header-dir=/tools/include \
197 --disable-nls \
198 --disable-shared \
199 --enable-multilib \
200 --with-multilib-list=m32,m64,mx32 \
201 --disable-decimal-float \
202 --disable-threads \
203 --disable-libatomic \
204 --disable-libgomp \
205 --disable-libmpx \
206 --disable-libquadmath \
207 --disable-libssp \
208 --disable-libvtv \
209 --disable-libstdcxx \
210 --enable-languages=c,c++</userinput></screen>
211
212 <variablelist>
213 <title>The meaning of the configure options:</title>
214
215 <varlistentry>
216 <term><parameter>--with-newlib</parameter></term>
217 <listitem>
218 <para>Since a working C library is not yet available, this ensures
219 that the inhibit_libc constant is defined when building libgcc. This prevents
220 the compiling of any code that requires libc support.</para>
221 </listitem>
222 </varlistentry>
223
224 <varlistentry>
225 <term><parameter>--without-headers</parameter></term>
226 <listitem>
227 <para>When creating a complete cross-compiler, GCC requires
228 standard headers compatible with the target system. For our
229 purposes these headers will not be needed. This switch prevents
230 GCC from looking for them.</para>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry>
235 <term><parameter>--with-local-prefix=/tools</parameter></term>
236 <listitem>
237 <para>The local prefix is the location in the system that GCC will search
238 for locally installed include files. The default is <filename>/usr/local</filename>.
239 Setting this to <filename>/tools</filename> helps keep the host location of
240 <filename>/usr/local</filename> out of this GCC's search path.</para>
241 </listitem>
242 </varlistentry>
243
244 <varlistentry>
245 <term><parameter>--with-native-system-header-dir=/tools/include</parameter></term>
246 <listitem>
247 <para>By default GCC searches <filename>/usr/include</filename> for
248 system headers. In conjunction with the sysroot switch, this would
249 normally translate to <filename>$LFS/usr/include</filename>. However
250 the headers that will be installed in the next two sections will go
251 to <filename>$LFS/tools/include</filename>. This switch ensures that
252 gcc will find them correctly. In the second pass of GCC, this same
253 switch will ensure that no headers from the host system are
254 found.</para>
255 </listitem>
256 </varlistentry>
257
258 <varlistentry>
259 <term><parameter>--disable-shared</parameter></term>
260 <listitem>
261 <para>This switch forces GCC to link its internal libraries
262 statically. We do this to avoid possible issues with the host
263 system.</para>
264 </listitem>
265 </varlistentry>
266
267 <varlistentry>
268 <term><parameter>--disable-decimal-float, --disable-threads,
269 --disable-libatomic, --disable-libgomp, --disable-libmpx,
270 --disable-libquadmath, --disable-libssp, --disable-libvtv,
271 --disable-libstdcxx</parameter></term>
272 <listitem>
273 <para>These switches disable support for the decimal floating point
274 extension, threading, libatomic, libgomp, libmpx, libquadmath, libssp,
275 libvtv, and the C++ standard library respectively. These features
276 will fail to compile when building a cross-compiler and are not
277 necessary for the task of cross-compiling the temporary libc.</para>
278 </listitem>
279 </varlistentry>
280
281 <varlistentry arch="default">
282 <term><parameter>--disable-multilib</parameter></term>
283 <listitem>
284 <para>On x86_64, LFS does not yet support a multilib configuration.
285 This switch is harmless for x86.</para>
286 </listitem>
287 </varlistentry>
288
289 <varlistentry arch="multilib">
290 <term><parameter>--enable-multilib,
291 --with-multilib-list=m32,m64,mx32</parameter></term>
292 <listitem>
293 <para>LFS now supports a multilib configuration. Enable it for the
294 32bit, the 64-bit, and the mixed mode.</para>
295 </listitem>
296 </varlistentry>
297
298 <varlistentry>
299 <term><parameter>--enable-languages=c,c++</parameter></term>
300 <listitem>
301 <para>This option ensures that only the C and C++ compilers are built.
302 These are the only languages needed now.</para>
303 </listitem>
304 </varlistentry>
305
306 </variablelist>
307
308 <para>Compile GCC by running:</para>
309
310<screen><userinput remap="make">make</userinput></screen>
311
312 <para>Compilation is now complete. At this point, the test suite would
313 normally be run, but, as mentioned before, the test suite framework is
314 not in place yet. The benefits of running the tests at this point
315 are minimal since the programs from this first pass will soon be
316 replaced.</para>
317
318 <para>Install the package:</para>
319
320<screen><userinput remap="install">make install</userinput></screen>
321<!--
322 <para>Using <parameter>- -disable-shared</parameter> means that the
323 <filename>libgcc_eh.a</filename> file isn't created and installed. The
324 Glibc package depends on this library as it uses
325 <parameter>-lgcc_eh</parameter> within its build system. This dependency
326 can be satisfied by creating a symlink to <filename>libgcc.a</filename>,
327 since that file will end up containing the objects normally contained in
328 <filename>libgcc_eh.a</filename>:</para>
329
330<screen><userinput remap="install">ln -sv libgcc.a `$LFS_TGT-gcc -print-libgcc-file-name | sed 's/libgcc/&amp;_eh/'`</userinput></screen>
331-->
332 </sect2>
333
334 <sect2 role="content">
335 <title/>
336
337 <para>Details on this package are located in
338 <xref linkend="contents-gcc" role="."/></para>
339
340 </sect2>
341
342</sect1>
Note: See TracBrowser for help on using the repository browser.