source: chapter06/gcc-pass2.xml@ 9113316

multilib xry111/multilib
Last change on this file since 9113316 was 9113316, checked in by Thomas Trepl <thomas@…>, 4 months ago

Automatic merge of trunk into multilib
  • Property mode set to 100644
File size: 8.5 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
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-pass2" role="wrap" xreflabel="gcc-pass2">
9 <?dbhtml filename="gcc-pass2.html"?>
10
11 <sect1info condition="script">
12 <productname>gcc-pass2</productname>
13 <productnumber>&gcc-version;</productnumber>
14 <address>&gcc-url;</address>
15 </sect1info>
16
17 <title>GCC-&gcc-version; - Pass 2</title>
18
19 <indexterm zone="ch-tools-gcc-pass2">
20 <primary sortas="a-GCC">GCC</primary>
21 <secondary>tools, pass 2</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-tmpp2-sbu;</seg>
37 <seg>&gcc-tmpp2-du;</seg>
38 </seglistitem>
39 </segmentedlist>
40
41 </sect2>
42
43 <sect2 role="installation">
44 <title>Installation of GCC</title>
45<!--
46 <para>First fix a problem with the latest version of glibc:</para>
47
48 <screen><userinput remap="pre">patch -Np1 -i ../&gcc-upstream-fixes-patch;</userinput></screen>
49-->
50 <para>As in the first build of GCC, the GMP, MPFR, and MPC packages are
51 required. Unpack the tarballs and move them into the required directories:</para>
52
53<screen><userinput remap="pre">tar -xf ../mpfr-&mpfr-version;.tar.xz
54mv -v mpfr-&mpfr-version; mpfr
55tar -xf ../gmp-&gmp-version;.tar.xz
56mv -v gmp-&gmp-version; gmp
57tar -xf ../mpc-&mpc-version;.tar.gz
58mv -v mpc-&mpc-version; mpc</userinput></screen>
59
60
61 <para arch="default">If building on x86_64, change the default directory name for 64-bit
62 libraries to <quote>lib</quote>:</para>
63
64<screen arch="default"><userinput remap="pre">case $(uname -m) in
65 x86_64)
66 sed -e '/m64=/s/lib64/lib/' \
67 -i.orig gcc/config/i386/t-linux64
68 ;;
69esac</userinput></screen>
70
71 <para arch="ml_32,ml_x32,ml_all">Change the default directory name for the
72 libraries:</para>
73
74<screen arch="ml_32,ml_x32,ml_all"><userinput remap="pre">sed -e '/m64=/s/lib64/lib/' \
75 -e '/m32=/s/m32=.*/m32=..\/lib32$(call if_multiarch,:i386-linux-gnu)/' \
76 -i.orig gcc/config/i386/t-linux64</userinput></screen>
77
78 <para>Override the building rule of libgcc and libstdc++ headers, to
79 allow building these libraries with POSIX threads support:</para>
80
81<screen><userinput remap="pre">sed '/thread_header =/s/@.*@/gthr-posix.h/' \
82 -i libgcc/Makefile.in libstdc++-v3/include/Makefile.in</userinput></screen>
83
84 <para>Create a separate build directory again:</para>
85
86<screen><userinput remap="pre">mkdir -v build
87cd build</userinput></screen>
88
89 <para>Before starting to build GCC, remember to unset any environment
90 variables that override the default optimization flags.</para>
91
92 <para>Now prepare GCC for compilation:</para>
93
94<screen arch="default"><userinput remap="configure">../configure \
95 --build=$(../config.guess) \
96 --host=$LFS_TGT \
97 --target=$LFS_TGT \
98 LDFLAGS_FOR_TARGET=-L$PWD/$LFS_TGT/libgcc \
99 --prefix=/usr \
100 --with-build-sysroot=$LFS \
101 --enable-default-pie \
102 --enable-default-ssp \
103 --disable-nls \
104 --disable-multilib \
105 --disable-libatomic \
106 --disable-libgomp \
107 --disable-libquadmath \
108 --disable-libsanitizer \
109 --disable-libssp \
110 --disable-libvtv \
111 --enable-languages=c,c++</userinput></screen>
112<screen arch="ml_32,ml_x32,ml_all"><userinput remap="configure"
113 arch="ml_32">mlist=m64,m32</userinput><userinput remap="configure"
114 arch="ml_x32">mlist=m64,mx32</userinput><userinput remap="configure"
115 arch="ml_all">mlist=m64,m32,mx32</userinput>
116<userinput remap="configure">../configure \
117 --build=$(../config.guess) \
118 --host=$LFS_TGT \
119 --target=$LFS_TGT \
120 LDFLAGS_FOR_TARGET=-L$PWD/$LFS_TGT/libgcc \
121 --prefix=/usr \
122 --with-build-sysroot=$LFS \
123 --enable-default-pie \
124 --enable-default-ssp \
125 --disable-nls \
126 --enable-multilib --with-multilib-list=$mlist \
127 --disable-libatomic \
128 --disable-libgomp \
129 --disable-libquadmath \
130 --disable-libsanitizer \
131 --disable-libssp \
132 --disable-libvtv \
133 --enable-languages=c,c++</userinput></screen>
134
135 <variablelist>
136 <title>The meaning of the new configure options:</title><!-- WIP -->
137
138 <varlistentry>
139 <term><parameter>--with-build-sysroot=$LFS</parameter></term>
140 <listitem>
141 <para>Normally, using <parameter>--host</parameter> ensures that
142 a cross-compiler is used for building GCC, and that compiler knows
143 that it has to look for headers and libraries in <filename
144 class="directory">$LFS</filename>. But the build system for GCC uses
145 other tools, which are not aware of this location. This switch is
146 needed so those tools will find the needed files in <filename
147 class="directory">$LFS</filename>, and not on the host.</para>
148 </listitem>
149 </varlistentry>
150
151 <varlistentry>
152 <term><parameter>--target=$LFS_TGT</parameter></term>
153 <listitem>
154 <para>We are cross-compiling GCC, so it's impossible to build
155 target libraries (<filename class="libraryfile">libgcc</filename>
156 and <filename class="libraryfile">libstdc++</filename>) with the
157 previously compiled GCC binaries&mdash;those binaries won't run on the
158 host. The GCC build system will attempt to use the host's
159 C and C++ compilers as a workaround by default.
160 Building the GCC target libraries with a different
161 version of GCC is not supported, so using the host's compilers may cause
162 the build to fail. This parameter ensures the libraries are built by GCC
163 pass 1.</para>
164 </listitem>
165 </varlistentry>
166
167 <varlistentry>
168 <term><parameter>LDFLAGS_FOR_TARGET=...</parameter></term>
169 <listitem>
170 <para>Allow <filename class="libraryfile">libstdc++</filename> to
171 use the shared <filename class="libraryfile">libgcc</filename> being
172 built in this pass, instead of the static version that was built in GCC
173 pass 1. This is necessary to support C++ exception
174 handling.</para>
175 </listitem>
176 </varlistentry>
177
178 <varlistentry>
179 <term><parameter>--disable-libsanitizer</parameter></term>
180 <listitem>
181 <para>Disable GCC sanitizer runtime libraries. They are not
182 needed for the temporary installation. In
183 <xref linkend='ch-tools-gcc-pass1'/> it was implied by
184 <parameter>--disable-libstdcxx</parameter>, and now we can
185 explicitly pass it.</para>
186 </listitem>
187 </varlistentry>
188
189 </variablelist>
190
191 <para>Compile the package:</para>
192
193<screen><userinput remap="make">make</userinput></screen>
194
195 <para>Install the package:</para>
196
197<screen><userinput remap="install">make DESTDIR=$LFS install</userinput></screen>
198
199 <para>As a finishing touch, create a utility symlink. Many programs and scripts
200 run <command>cc</command> instead of <command>gcc</command>, which is
201 used to keep programs generic and therefore usable on all kinds of UNIX
202 systems where the GNU C compiler is not always installed. Running
203 <command>cc</command> leaves the system administrator free to decide
204 which C compiler to install:</para>
205
206<screen><userinput remap="install">ln -sv gcc $LFS/usr/bin/cc</userinput></screen>
207
208 </sect2>
209
210 <sect2 role="content">
211 <title/>
212
213 <para>Details on this package are located in
214 <xref linkend="contents-gcc" role="."/></para>
215
216 </sect2>
217
218</sect1>
Note: See TracBrowser for help on using the repository browser.