source: chapter05/gcc-pass1.xml@ e1d233c

11.2 11.2-rc1 multilib s6-init trunk xry111/arm64 xry111/clfs-ng xry111/pip3 xry111/queue-11.3 xry111/rust-wip-20221008
Last change on this file since e1d233c was e1d233c, checked in by Xi Ruoyao <xry111@…>, 7 months ago

gcc-12: remove --enable-initfini-array in pass 1

Reference: https://gcc.gnu.org/r12-1328

  • Property mode set to 100644
File size: 7.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>On x86_64 hosts, set the default directory name for
66 64-bit libraries to <quote>lib</quote>:</para>
67
68<screen><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>The GCC documentation recommends building GCC
76 in a dedicated build directory:</para>
77
78<screen><userinput remap="pre">mkdir -v build
79cd build</userinput></screen>
80
81 <para>Prepare GCC for compilation:</para>
82
83<screen><userinput remap="configure">../configure \
84 --target=$LFS_TGT \
85 --prefix=$LFS/tools \
86 --with-glibc-version=&glibc-version; \
87 --with-sysroot=$LFS \
88 --with-newlib \
89 --without-headers \
90 --disable-nls \
91 --disable-shared \
92 --disable-multilib \
93 --disable-decimal-float \
94 --disable-threads \
95 --disable-libatomic \
96 --disable-libgomp \
97 --disable-libquadmath \
98 --disable-libssp \
99 --disable-libvtv \
100 --disable-libstdcxx \
101 --enable-languages=c,c++</userinput></screen>
102 <variablelist>
103 <title>The meaning of the configure options:</title>
104
105 <varlistentry>
106 <term><parameter>--with-glibc-version=&glibc-version;</parameter></term>
107 <listitem>
108 <para>This option specifies the version of glibc which will be
109 used on the target. It is not relevant to the libc of the host
110 distro because everything compiled by pass1 gcc will run in the
111 chroot environment, which is isolated from libc of the host
112 distro.</para>
113 </listitem>
114 </varlistentry>
115
116 <varlistentry>
117 <term><parameter>--with-newlib</parameter></term>
118 <listitem>
119 <para>Since a working C library is not yet available, this ensures
120 that the inhibit_libc constant is defined when building libgcc. This prevents
121 the compiling of any code that requires libc support.</para>
122 </listitem>
123 </varlistentry>
124
125 <varlistentry>
126 <term><parameter>--without-headers</parameter></term>
127 <listitem>
128 <para>When creating a complete cross-compiler, GCC requires
129 standard headers compatible with the target system. For our
130 purposes these headers will not be needed. This switch prevents
131 GCC from looking for them.</para>
132 </listitem>
133 </varlistentry>
134
135 <varlistentry>
136 <term><parameter>--disable-shared</parameter></term>
137 <listitem>
138 <para>This switch forces GCC to link its internal libraries
139 statically. We need this because the shared libraries require glibc,
140 which is not yet installed on the target system.</para>
141 </listitem>
142 </varlistentry>
143
144 <varlistentry>
145 <term><parameter>--disable-multilib</parameter></term>
146 <listitem>
147 <para>On x86_64, LFS does not support a multilib configuration.
148 This switch is harmless for x86.</para>
149 </listitem>
150 </varlistentry>
151
152 <varlistentry>
153 <term><parameter>--disable-decimal-float, --disable-threads,
154 --disable-libatomic, --disable-libgomp,
155 --disable-libquadmath, --disable-libssp, --disable-libvtv,
156 --disable-libstdcxx</parameter></term>
157 <listitem>
158 <para>These switches disable support for the decimal floating point
159 extension, threading, libatomic, libgomp, libquadmath, libssp,
160 libvtv, and the C++ standard library respectively. These features
161 will fail to compile when building a cross-compiler and are not
162 necessary for the task of cross-compiling the temporary libc.</para>
163 </listitem>
164 </varlistentry>
165
166 <varlistentry>
167 <term><parameter>--enable-languages=c,c++</parameter></term>
168 <listitem>
169 <para>This option ensures that only the C and C++ compilers are built.
170 These are the only languages needed now.</para>
171 </listitem>
172 </varlistentry>
173
174 </variablelist>
175
176 <para>Compile GCC by running:</para>
177
178<screen><userinput remap="make">make</userinput></screen>
179
180 <para>Install the package:</para>
181
182 <screen><userinput remap="install">make install</userinput></screen>
183
184 <para>This build of GCC has installed a couple of internal system
185 headers. Normally one of them, <filename>limits.h</filename>, would in turn
186 include the corresponding system <filename>limits.h</filename> header, in
187 this case, <filename>$LFS/usr/include/limits.h</filename>. However, at the
188 time of this build of GCC <filename>$LFS/usr/include/limits.h</filename>
189 does not exist, so the internal header that has just been installed is a
190 partial, self-contained file and does not include the extended features of
191 the system header. This is adequate for building glibc, but the full
192 internal header will be needed later. Create a full version of the internal
193 header using a command that is identical to what the GCC build system does
194 in normal circumstances:</para>
195
196<screen><userinput remap="install">cd ..
197cat gcc/limitx.h gcc/glimits.h gcc/limity.h > \
198 `dirname $($LFS_TGT-gcc -print-libgcc-file-name)`/install-tools/include/limits.h</userinput></screen>
199 </sect2>
200
201 <sect2 role="content">
202 <title/>
203
204 <para>Details on this package are located in
205 <xref linkend="contents-gcc" role="."/></para>
206
207 </sect2>
208
209</sect1>
Note: See TracBrowser for help on using the repository browser.