source: chapter05/gcc-pass1.xml@ b2f3f15

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 8.0 8.0-rc1 8.1 8.1-rc1 8.1-rc2 8.2 8.2-rc1 8.3 8.3-rc1 8.3-rc2 8.4 8.4-rc1 9.0 9.0-rc1 9.1 9.1-rc1 cross-chap5 ml-11.0 multilib old-trunk trunk xry111/git-transition xry111/glibc-2.34 xry111/tester-nohack xry111/usr-move
Last change on this file since b2f3f15 was b2f3f15, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update to gcc-6.3.0.
Update to gmp-6.1.2.
Update to iproute2-4.9.0.
Update to man-pages-4.09.
Update to man-db-2.7.6.1.
Update to linux-4.9.
Update to eudev-3.2.1.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11157 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

  • Property mode set to 100644
File size: 11.0 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">
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>GCC now 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>The following command will change the location of GCC's default
66 dynamic linker to use the one installed in <filename
67 class="directory">/tools</filename>. It also removes <filename
68 class="directory">/usr/include</filename> from GCC's include search path.
69 Issue:</para>
70
71<screen><userinput remap="pre">for file in gcc/config/{linux,i386/linux{,64}}.h
72do
73 cp -uv $file{,.orig}
74 sed -e 's@/lib\(64\)\?\(32\)\?/ld@/tools&amp;@g' \
75 -e 's@/usr@/tools@g' $file.orig &gt; $file
76 echo '
77#undef STANDARD_STARTFILE_PREFIX_1
78#undef STANDARD_STARTFILE_PREFIX_2
79#define STANDARD_STARTFILE_PREFIX_1 "/tools/lib/"
80#define STANDARD_STARTFILE_PREFIX_2 ""' &gt;&gt; $file
81 touch $file.orig
82done</userinput></screen>
83
84 <para>In case the above seems hard to follow, let's break it down a bit.
85 First we find all the files under the <filename
86 class="directory">gcc/config</filename> directory that are named either
87 <filename>linux.h</filename>, <filename>linux64.h</filename> or
88 <filename>sysv4.h</filename>. For each file found, we copy it to a file of
89 the same name but with an added suffix of <quote>.orig</quote>. Then the
90 first sed expression prepends <quote>/tools</quote> to every instance of
91 <quote>/lib/ld</quote>, <quote>/lib64/ld</quote> or
92 <quote>/lib32/ld</quote>, while the second one replaces hard-coded
93 instances of <quote>/usr</quote>. Next, we add our define statements which
94 alter the default startfile prefix to the end of the file. Note that the
95 trailing <quote>/</quote> in <quote>/tools/lib/</quote> is required.
96 Finally, we use <command>touch</command> to update the timestamp on the
97 copied files. When used in conjunction with <command>cp -u</command>, this
98 prevents unexpected changes to the original files in case the commands are
99 inadvertently run twice.</para>
100
101 <para>Finally, on x86_64 hosts, set the default directory name for
102 64-bit libraries to <quote>lib</quote>:</para>
103
104<screen><userinput remap="pre">case $(uname -m) in
105 x86_64)
106 sed -e '/m64=/s/lib64/lib/' \
107 -i.orig gcc/config/i386/t-linux64
108 ;;
109esac</userinput></screen>
110
111<!--
112 <para>GCC doesn't detect stack protection correctly, which causes problems
113 for the build of Glibc-&glibc-version;, so fix that by issuing the following
114 command:</para>
115
116<screen><userinput remap="pre">sed -i '/k prot/agcc_cv_libc_provides_ssp=yes' gcc/configure</userinput></screen>
117-->
118
119<!--
120 <para>Also fix a problem identified upstream:</para>
121
122<screen><userinput remap="pre">sed -i 's/if \((code.*))\)/if (\1 \&amp;\&amp; \!DEBUG_INSN_P (insn))/' gcc/sched-deps.c</userinput></screen>
123-->
124 <para>The GCC documentation recommends building GCC
125 in a dedicated build directory:</para>
126
127<screen><userinput remap="pre">mkdir -v build
128cd build</userinput></screen>
129
130 <para>Prepare GCC for compilation:</para>
131
132<screen><userinput remap="configure">../configure \
133 --target=$LFS_TGT \
134 --prefix=/tools \
135 --with-glibc-version=2.11 \
136 --with-sysroot=$LFS \
137 --with-newlib \
138 --without-headers \
139 --with-local-prefix=/tools \
140 --with-native-system-header-dir=/tools/include \
141 --disable-nls \
142 --disable-shared \
143 --disable-multilib \
144 --disable-decimal-float \
145 --disable-threads \
146 --disable-libatomic \
147 --disable-libgomp \
148 --disable-libmpx \
149 --disable-libquadmath \
150 --disable-libssp \
151 --disable-libvtv \
152 --disable-libstdcxx \
153 --enable-languages=c,c++</userinput></screen>
154 <variablelist>
155 <title>The meaning of the configure options:</title>
156
157 <varlistentry>
158 <term><parameter>--with-newlib</parameter></term>
159 <listitem>
160 <para>Since a working C library is not yet available, this ensures
161 that the inhibit_libc constant is defined when building libgcc. This prevents
162 the compiling of any code that requires libc support.</para>
163 </listitem>
164 </varlistentry>
165
166 <varlistentry>
167 <term><parameter>--without-headers</parameter></term>
168 <listitem>
169 <para>When creating a complete cross-compiler, GCC requires
170 standard headers compatible with the target system. For our
171 purposes these headers will not be needed. This switch prevents
172 GCC from looking for them.</para>
173 </listitem>
174 </varlistentry>
175
176 <varlistentry>
177 <term><parameter>--with-local-prefix=/tools</parameter></term>
178 <listitem>
179 <para>The local prefix is the location in the system that GCC will search
180 for locally installed include files. The default is <filename>/usr/local</filename>.
181 Setting this to <filename>/tools</filename> helps keep the host location of
182 <filename>/usr/local</filename> out of this GCC's search path.</para>
183 </listitem>
184 </varlistentry>
185
186 <varlistentry>
187 <term><parameter>--with-native-system-header-dir=/tools/include</parameter></term>
188 <listitem>
189 <para>By default GCC searches <filename>/usr/include</filename> for system
190 headers. In conjunction with the sysroot switch, this would translate normally
191 to <filename>$LFS/usr/include</filename>. However the headers that will be installed
192 in the next two sections will go to <filename>$LFS/tools/include</filename>. This
193 switch ensures that gcc will find them correctly. In the second pass of GCC, this
194 same switch will ensure that no headers from the host system are found.</para>
195 </listitem>
196 </varlistentry>
197
198 <varlistentry>
199 <term><parameter>--disable-shared</parameter></term>
200 <listitem>
201 <para>This switch forces GCC to link its internal libraries
202 statically. We do this to avoid possible issues with the host
203 system.</para>
204 </listitem>
205 </varlistentry>
206
207 <varlistentry>
208 <term><parameter>--disable-decimal-float, --disable-threads,
209 --disable-libatomic, --disable-libgomp, --disable-libmpx,
210 --disable-libquadmath, --disable-libssp, --disable-libvtv,
211 --disable-libstdcxx</parameter></term>
212 <listitem>
213 <para>These switches disable support for the decimal floating point
214 extension, threading, libatomic, libgomp, libmpx, libquadmath, libssp,
215 libvtv, and the C++ standard library respectively. These features
216 will fail to compile when building a cross-compiler and are not
217 necessary for the task of cross-compiling the temporary libc.</para>
218 </listitem>
219 </varlistentry>
220
221 <varlistentry>
222 <term><parameter>--disable-multilib</parameter></term>
223 <listitem>
224 <para>On x86_64, LFS does not yet support a multilib configuration.
225 This switch is harmless for x86.</para>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry>
230 <term><parameter>--enable-languages=c,c++</parameter></term>
231 <listitem>
232 <para>This option ensures that only the C and C++ compilers are built.
233 These are the only languages needed now.</para>
234 </listitem>
235 </varlistentry>
236
237 </variablelist>
238
239 <para>Compile GCC by running:</para>
240
241<screen><userinput remap="make">make</userinput></screen>
242
243 <para>Compilation is now complete. At this point, the test suite would
244 normally be run, but, as mentioned before, the test suite framework is
245 not in place yet. The benefits of running the tests at this point
246 are minimal since the programs from this first pass will soon be
247 replaced.</para>
248
249 <para>Install the package:</para>
250
251<screen><userinput remap="install">make install</userinput></screen>
252<!--
253 <para>Using <parameter>- -disable-shared</parameter> means that the
254 <filename>libgcc_eh.a</filename> file isn't created and installed. The
255 Glibc package depends on this library as it uses
256 <parameter>-lgcc_eh</parameter> within its build system. This dependency
257 can be satisfied by creating a symlink to <filename>libgcc.a</filename>,
258 since that file will end up containing the objects normally contained in
259 <filename>libgcc_eh.a</filename>:</para>
260
261<screen><userinput remap="install">ln -sv libgcc.a `$LFS_TGT-gcc -print-libgcc-file-name | sed 's/libgcc/&amp;_eh/'`</userinput></screen>
262-->
263 </sect2>
264
265 <sect2 role="content">
266 <title/>
267
268 <para>Details on this package are located in
269 <xref linkend="contents-gcc" role="."/></para>
270
271 </sect2>
272
273</sect1>
Note: See TracBrowser for help on using the repository browser.