source: chapter05/gcc-pass1.xml@ e079f16

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 7.10 7.10-rc1 7.6 7.6-rc1 7.7 7.7-rc1 7.8 7.8-rc1 7.9 7.9-rc1 7.9-rc2 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 BOOK.old cross-chap5 hybrid ml-11.0 multilib nosym old-trunk trunk xry111/git-transition xry111/glibc-2.34 xry111/tester-nohack xry111/usr-move
Last change on this file since e079f16 was e079f16, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Remove unneeded symlink in gcc-pass1.
Update to util-linux-2.24.2.

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

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