source: chapter06/gcc-pass2.xml@ cb6fcea

12.1 12.1-rc1 multilib trunk xry111/arm64 xry111/clfs-ng xry111/loongarch xry111/loongarch-12.1 xry111/mips64el xry111/update-glibc
Last change on this file since cb6fcea was f652d5bb, checked in by Xi Ruoyao <xry111@…>, 12 months ago

gcc-pass2: Disable libsanitizer

Building libsanitizer needs libcrypt. Disable it so we don't need to
add libxcrypt into Chapter 6.

  • Property mode set to 100644
File size: 7.1 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>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 <para>If building on x86_64, change the default directory name for 64-bit
61 libraries to <quote>lib</quote>:</para>
62
63<screen><userinput remap="pre">case $(uname -m) in
64 x86_64)
65 sed -e '/m64=/s/lib64/lib/' -i.orig gcc/config/i386/t-linux64
66 ;;
67esac</userinput></screen>
68
69 <para>Override the building rule of libgcc and libstdc++ headers, to
70 allow building these libraries with POSIX threads support:</para>
71
72<screen><userinput remap="pre">sed '/thread_header =/s/@.*@/gthr-posix.h/' \
73 -i libgcc/Makefile.in libstdc++-v3/include/Makefile.in</userinput></screen>
74
75 <para>Create a separate build directory again:</para>
76
77<screen><userinput remap="pre">mkdir -v build
78cd build</userinput></screen>
79
80 <para>Before starting to build GCC, remember to unset any environment
81 variables that override the default optimization flags.</para>
82
83 <para>Now prepare GCC for compilation:</para>
84
85<screen><userinput remap="configure">../configure \
86 --build=$(../config.guess) \
87 --host=$LFS_TGT \
88 --target=$LFS_TGT \
89 LDFLAGS_FOR_TARGET=-L$PWD/$LFS_TGT/libgcc \
90 --prefix=/usr \
91 --with-build-sysroot=$LFS \
92 --enable-default-pie \
93 --enable-default-ssp \
94 --disable-nls \
95 --disable-multilib \
96 --disable-libatomic \
97 --disable-libgomp \
98 --disable-libquadmath \
99 --disable-libsanitizer \
100 --disable-libssp \
101 --disable-libvtv \
102 --enable-languages=c,c++</userinput></screen>
103
104 <variablelist>
105 <title>The meaning of the new configure options:</title><!-- WIP -->
106
107 <varlistentry>
108 <term><parameter>--with-build-sysroot=$LFS</parameter></term>
109 <listitem>
110 <para>Normally, using <parameter>--host</parameter> ensures that
111 a cross-compiler is used for building GCC, and that compiler knows
112 that it has to look for headers and libraries in <filename
113 class="directory">$LFS</filename>. But the build system for GCC uses
114 other tools, which are not aware of this location. This switch is
115 needed so those tools will find the needed files in <filename
116 class="directory">$LFS</filename>, and not on the host.</para>
117 </listitem>
118 </varlistentry>
119
120 <varlistentry>
121 <term><parameter>--target=$LFS_TGT</parameter></term>
122 <listitem>
123 <para>We are cross-compiling GCC, so it's impossible to build
124 target libraries (<filename class="libraryfile">libgcc</filename>
125 and <filename class="libraryfile">libstdc++</filename>) with the
126 previously compiled GCC binaries&mdash;those binaries won't run on the
127 host. The GCC build system will attempt to use the host's
128 C and C++ compilers as a workaround by default.
129 Building the GCC target libraries with a different
130 version of GCC is not supported, so using the host's compilers may cause
131 the build to fail. This parameter ensures the libraries are built by GCC
132 pass 1.</para>
133 </listitem>
134 </varlistentry>
135
136 <varlistentry>
137 <term><parameter>LDFLAGS_FOR_TARGET=...</parameter></term>
138 <listitem>
139 <para>Allow <filename class="libraryfile">libstdc++</filename> to
140 use the shared <filename class="libraryfile">libgcc</filename> being
141 built in this pass, instead of the static version that was built in GCC
142 pass 1. This is necessary to support C++ exception
143 handling.</para>
144 </listitem>
145 </varlistentry>
146
147 <varlistentry>
148 <term><parameter>--disable-libsanitizer</parameter></term>
149 <listitem>
150 <para>Disable GCC sanitizer runtime libraries. They are not
151 needed for the temporary installation. This switch is necessary
152 to build GCC without
153 <systemitem class='library'>libcrypt</systemitem> installed for
154 the target. In <xref linkend='ch-tools-gcc-pass1'/> it was
155 implied by <parameter>--disable-libstdcxx</parameter>, but now we
156 have to explicitly pass it.</para>
157 </listitem>
158 </varlistentry>
159
160 </variablelist>
161
162 <para>Compile the package:</para>
163
164<screen><userinput remap="make">make</userinput></screen>
165
166 <para>Install the package:</para>
167
168<screen><userinput remap="install">make DESTDIR=$LFS install</userinput></screen>
169
170 <para>As a finishing touch, create a utility symlink. Many programs and scripts
171 run <command>cc</command> instead of <command>gcc</command>, which is
172 used to keep programs generic and therefore usable on all kinds of UNIX
173 systems where the GNU C compiler is not always installed. Running
174 <command>cc</command> leaves the system administrator free to decide
175 which C compiler to install:</para>
176
177<screen><userinput remap="install">ln -sv gcc $LFS/usr/bin/cc</userinput></screen>
178
179 </sect2>
180
181 <sect2 role="content">
182 <title/>
183
184 <para>Details on this package are located in
185 <xref linkend="contents-gcc" role="."/></para>
186
187 </sect2>
188
189</sect1>
Note: See TracBrowser for help on using the repository browser.