source: chapter05/gcc-pass1.xml@ 3a72ffa

multilib
Last change on this file since 3a72ffa was 3a72ffa, checked in by Thomas Trepl (Moody) <thomas@…>, 7 months ago

Adopt upstream changes

  • Property mode set to 100644
File size: 9.5 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-pass1</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="../chapter08/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-tmpp1-sbu;</seg>
37 <seg>&gcc-tmpp1-du;</seg>
38 </seglistitem>
39 </segmentedlist>
40
41 </sect2>
42
43 <sect2 role="installation">
44 <title>Installation of Cross GCC</title>
45
46 <para>GCC requires the GMP, MPFR and MPC packages. As these packages may
47 not be included in your host distribution, they will be built with
48 GCC. Unpack each package into the GCC source directory and rename the
49 resulting directories so the GCC build procedures will automatically
50 use them:</para>
51
52 <note><para>There are frequent misunderstandings about this chapter. The
53 procedures are the same as every other chapter as explained earlier (<xref
54 linkend='buildinstr'/>). First extract the gcc tarball from the sources
55 directory and then change to the directory created. Only then should you
56 proceed with the instructions below.</para></note>
57
58<screen><userinput remap="pre">tar -xf ../mpfr-&mpfr-version;.tar.xz
59mv -v mpfr-&mpfr-version; mpfr
60tar -xf ../gmp-&gmp-version;.tar.xz
61mv -v gmp-&gmp-version; gmp
62tar -xf ../mpc-&mpc-version;.tar.gz
63mv -v mpc-&mpc-version; mpc</userinput></screen>
64
65 <para arch="default">On x86_64 hosts, set the default directory name for
66 64-bit libraries to <quote>lib</quote>:</para>
67
68<screen arch="default"><userinput remap="pre">case $(uname -m) in
69 x86_64)
70 sed -e '/m64=/s/lib64/lib/' \
71 -i.orig gcc/config/i386/t-linux64
72 ;;
73esac</userinput></screen>
74
75 <para arch="ml_32,ml_x32,ml_all">Change the default directory name for
76 libraries:</para>
77
78<screen arch="ml_32,ml_x32,ml_all"><userinput remap="pre">sed -e '/m64=/s/lib64/lib/' \
79 -e '/m32=/s/m32=.*/m32=..\/lib32$(call if_multiarch,:i386-linux-gnu)/' \
80 -i.orig gcc/config/i386/t-linux64
81</userinput></screen>
82
83 <para>The GCC documentation recommends building GCC
84 in a dedicated build directory:</para>
85
86<screen><userinput remap="pre">mkdir -v build
87cd build</userinput></screen>
88
89 <para>Prepare GCC for compilation:</para>
90
91<screen arch="default"><userinput remap="configure">../configure \
92 --target=$LFS_TGT \
93 --prefix=$LFS/tools \
94 --with-glibc-version=&glibc-version; \
95 --with-sysroot=$LFS \
96 --with-newlib \
97 --without-headers \
98 --disable-nls \
99 --disable-shared \
100 --disable-multilib \
101 --disable-decimal-float \
102 --disable-threads \
103 --disable-libatomic \
104 --disable-libgomp \
105 --disable-libquadmath \
106 --disable-libssp \
107 --disable-libvtv \
108 --disable-libstdcxx \
109 --enable-languages=c,c++</userinput></screen>
110<screen arch="ml_32,ml_x32,ml_all"><userinput remap="configure"
111 arch="ml_32">mlist=m64,m32</userinput><userinput remap="configure"
112 arch="ml_x32">mlist=m64,mx32</userinput><userinput remap="configure"
113 arch="ml_all">mlist=m64,m32,mx32</userinput>
114<userinput remap="configure">../configure \
115 --target=$LFS_TGT \
116 --prefix=$LFS/tools \
117 --with-glibc-version=&glibc-version; \
118 --with-sysroot=$LFS \
119 --with-newlib \
120 --without-headers \
121 --enable-initfini-array \
122 --disable-nls \
123 --disable-shared \
124 --enable-multilib --with-multilib-list=$mlist \
125 --disable-decimal-float \
126 --disable-threads \
127 --disable-libatomic \
128 --disable-libgomp \
129 --disable-libquadmath \
130 --disable-libssp \
131 --disable-libvtv \
132 --disable-libstdcxx \
133 --enable-languages=c,c++</userinput></screen>
134
135 <variablelist>
136 <title>The meaning of the configure options:</title>
137
138 <varlistentry>
139 <term><parameter>--with-glibc-version=&glibc-version;</parameter></term>
140 <listitem>
141 <para>This option specifies the version of glibc which will be
142 used on the target. It is not relevant to the libc of the host
143 distro because everything compiled by pass1 gcc will run in the
144 chroot environment, which is isolated from libc of the host
145 distro.</para>
146 </listitem>
147 </varlistentry>
148
149 <varlistentry>
150 <term><parameter>--with-newlib</parameter></term>
151 <listitem>
152 <para>Since a working C library is not yet available, this ensures
153 that the inhibit_libc constant is defined when building libgcc. This prevents
154 the compiling of any code that requires libc support.</para>
155 </listitem>
156 </varlistentry>
157
158 <varlistentry>
159 <term><parameter>--without-headers</parameter></term>
160 <listitem>
161 <para>When creating a complete cross-compiler, GCC requires
162 standard headers compatible with the target system. For our
163 purposes these headers will not be needed. This switch prevents
164 GCC from looking for them.</para>
165 </listitem>
166 </varlistentry>
167
168 <varlistentry>
169 <term><parameter>--disable-shared</parameter></term>
170 <listitem>
171 <para>This switch forces GCC to link its internal libraries
172 statically. We need this because the shared libraries require glibc,
173 which is not yet installed on the target system.</para>
174 </listitem>
175 </varlistentry>
176
177 <varlistentry arch="default">
178 <term><parameter>--disable-multilib</parameter></term>
179 <listitem>
180 <para>On x86_64, LFS does not support a multilib configuration.
181 This switch is harmless for x86.</para>
182 </listitem>
183 </varlistentry>
184 <varlistentry arch="ml_32,ml_x32,ml_all">
185 <term><parameter>--enable-multilib --with-multilib-list=...</parameter></term>
186 <listitem>
187 <para>LFS canbe used to support multilib. Which they are is
188 specified in the multilib list.</para>
189 </listitem>
190 </varlistentry>
191
192 <varlistentry>
193 <term><parameter>--disable-decimal-float, --disable-threads,
194 --disable-libatomic, --disable-libgomp,
195 --disable-libquadmath, --disable-libssp, --disable-libvtv,
196 --disable-libstdcxx</parameter></term>
197 <listitem>
198 <para>These switches disable support for the decimal floating point
199 extension, threading, libatomic, libgomp, libquadmath, libssp,
200 libvtv, and the C++ standard library respectively. These features
201 will fail to compile when building a cross-compiler and are not
202 necessary for the task of cross-compiling the temporary libc.</para>
203 </listitem>
204 </varlistentry>
205
206 <varlistentry>
207 <term><parameter>--enable-languages=c,c++</parameter></term>
208 <listitem>
209 <para>This option ensures that only the C and C++ compilers are built.
210 These are the only languages needed now.</para>
211 </listitem>
212 </varlistentry>
213
214 </variablelist>
215
216 <para>Compile GCC by running:</para>
217
218<screen><userinput remap="make">make</userinput></screen>
219
220 <para>Install the package:</para>
221
222 <screen><userinput remap="install">make install</userinput></screen>
223
224 <para>This build of GCC has installed a couple of internal system
225 headers. Normally one of them, <filename>limits.h</filename>, would in turn
226 include the corresponding system <filename>limits.h</filename> header, in
227 this case, <filename>$LFS/usr/include/limits.h</filename>. However, at the
228 time of this build of GCC <filename>$LFS/usr/include/limits.h</filename>
229 does not exist, so the internal header that has just been installed is a
230 partial, self-contained file and does not include the extended features of
231 the system header. This is adequate for building glibc, but the full
232 internal header will be needed later. Create a full version of the internal
233 header using a command that is identical to what the GCC build system does
234 in normal circumstances:</para>
235
236<screen><userinput remap="install">cd ..
237cat gcc/limitx.h gcc/glimits.h gcc/limity.h > \
238 `dirname $($LFS_TGT-gcc -print-libgcc-file-name)`/install-tools/include/limits.h</userinput></screen>
239 </sect2>
240
241 <sect2 role="content">
242 <title/>
243
244 <para>Details on this package are located in
245 <xref linkend="contents-gcc" role="."/></para>
246
247 </sect2>
248
249</sect1>
Note: See TracBrowser for help on using the repository browser.