source: chapter06/gcc-pass2.xml@ 8e0f8a9

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

gcc pass2: use --target=$LFS_TGT instead of many {C,CXX}_FOR_TARGET

There is also a "GCC_FOR_TARGET" which was not set correctly. The
--target=$LFS_TGT parameter can set up all of these variables as we
expected.

  • Property mode set to 100644
File size: 5.6 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-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>As in the first build of GCC, the GMP, MPFR, and MPC packages are
47 required. Unpack the tarballs and move them into the required directory
48 names:</para>
49
50<screen><userinput remap="pre">tar -xf ../mpfr-&mpfr-version;.tar.xz
51mv -v mpfr-&mpfr-version; mpfr
52tar -xf ../gmp-&gmp-version;.tar.xz
53mv -v gmp-&gmp-version; gmp
54tar -xf ../mpc-&mpc-version;.tar.gz
55mv -v mpc-&mpc-version; mpc</userinput></screen>
56
57 <para>If building on x86_64, change the default directory name for 64-bit
58 libraries to <quote>lib</quote>:</para>
59
60<screen><userinput remap="pre">case $(uname -m) in
61 x86_64)
62 sed -e '/m64=/s/lib64/lib/' -i.orig gcc/config/i386/t-linux64
63 ;;
64esac</userinput></screen>
65
66 <!-- https://gcc.gnu.org/PR100017 -->
67 <para>Fix an issue causing failure cross-compiling libstdc++:</para>
68
69<screen><userinput remap="pre">sed 's/gnu++17/&amp; -nostdinc++/' \
70 -i libstdc++-v3/src/c++17/Makefile.in</userinput></screen>
71
72 <para>Override the building rule of libgcc and libstdc++ headers, to
73 allow building these libraries with POSIX threads support:</para>
74
75<screen><userinput remap="pre">sed '/thread_header =/s/@.*@/gthr-posix.h/' \
76 -i libgcc/Makefile.in libstdc++-v3/include/Makefile.in</userinput></screen>
77
78 <para>Create a separate build directory again:</para>
79
80<screen><userinput remap="pre">mkdir -v build
81cd build</userinput></screen>
82
83 <para>Before starting to build GCC, remember to unset any environment
84 variables that override the default optimization flags.</para>
85
86 <para>Now prepare GCC for compilation:</para>
87
88<screen><userinput remap="configure">../configure \
89 --build=$(../config.guess) \
90 --host=$LFS_TGT \
91 --target=$LFS_TGT \
92 LDFLAGS_FOR_TARGET=-L$PWD/$LFS_TGT/libgcc \
93 --prefix=/usr \
94 --with-build-sysroot=$LFS \
95 --enable-initfini-array \
96 --disable-nls \
97 --disable-multilib \
98 --disable-decimal-float \
99 --disable-libatomic \
100 --disable-libgomp \
101 --disable-libquadmath \
102 --disable-libssp \
103 --disable-libvtv \
104 --enable-languages=c,c++</userinput></screen>
105
106 <variablelist>
107 <title>The meaning of the new configure options:</title><!-- WIP -->
108
109 <varlistentry>
110 <term><parameter>-with-build-sysroot=$LFS</parameter></term>
111 <listitem>
112 <para>Normally, using <parameter>--host</parameter> ensures that
113 a cross-compiler is used for building GCC, and that compiler knows
114 that it has to look for headers and libraries in <filename
115 class="directory">$LFS</filename>. But the build system of GCC uses
116 other tools, which are not aware of this location. This switch is
117 needed to have them find the needed files in <filename
118 class="directory">$LFS</filename>, and not on the host.</para>
119 </listitem>
120 </varlistentry>
121
122 <varlistentry>
123 <term><parameter>--enable-initfini-array</parameter></term>
124 <listitem>
125 <para>This option is automatically enabled when building a native
126 compiler with a native compiler on x86. But here, we build with
127 a cross compiler, so we need to explicitly set this option.</para>
128 </listitem>
129 </varlistentry>
130
131 </variablelist>
132
133 <para>Compile the package:</para>
134
135<screen><userinput remap="make">make</userinput></screen>
136
137 <para>Install the package:</para>
138
139<screen><userinput remap="install">make DESTDIR=$LFS install</userinput></screen>
140
141 <para>As a finishing touch, create a utility symlink. Many programs and scripts
142 run <command>cc</command> instead of <command>gcc</command>, which is
143 used to keep programs generic and therefore usable on all kinds of UNIX
144 systems where the GNU C compiler is not always installed. Running
145 <command>cc</command> leaves the system administrator free to decide
146 which C compiler to install:</para>
147
148<screen><userinput remap="install">ln -sv gcc $LFS/usr/bin/cc</userinput></screen>
149
150 </sect2>
151
152 <sect2 role="content">
153 <title/>
154
155 <para>Details on this package are located in
156 <xref linkend="contents-gcc" role="."/></para>
157
158 </sect2>
159
160</sect1>
Note: See TracBrowser for help on using the repository browser.