source: chapter05/gcc-pass1.xml@ aa2d8f0

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 11.2 11.2-rc1 11.3 11.3-rc1 12.0 12.0-rc1 12.1 12.1-rc1 12.2 12.2-rc1 7.2 7.3 7.4 7.5 7.5-systemd 7.6 7.6-systemd 7.7 7.7-systemd 7.8 7.8-systemd 7.9 7.9-systemd 8.0 8.1 8.2 8.3 8.4 9.0 9.1 arm bdubbs/gcc13 ml-11.0 multilib renodr/libudev-from-systemd s6-init trunk xry111/arm64 xry111/arm64-12.0 xry111/clfs-ng xry111/lfs-next xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/loongarch-12.2 xry111/mips64el xry111/multilib xry111/pip3 xry111/rust-wip-20221008 xry111/update-glibc
Last change on this file since aa2d8f0 was 9f5aaf7, checked in by Bruce Dubbs <bdubbs@…>, 13 years ago

Add whitespace for better readability of instructions

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

  • Property mode set to 100644
File size: 6.6 KB
RevLine 
[673b0d8]1<?xml version="1.0" encoding="ISO-8859-1"?>
[b06ca36]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[673b0d8]4 <!ENTITY % general-entities SYSTEM "../general.ent">
5 %general-entities;
6]>
[1f7ca93]7
[9652249]8<sect1 id="ch-tools-gcc-pass1" role="wrap">
[1f7ca93]9 <?dbhtml filename="gcc-pass1.html"?>
10
[e747759]11 <sect1info condition="script">
12 <productname>gcc</productname>
13 <productnumber>&gcc-version;</productnumber>
14 <address>&gcc-url;</address>
15 </sect1info>
16
[1f7ca93]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/>
[bc82645e]26
[d9441360]27 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
[1f7ca93]28 href="../chapter06/gcc.xml"
29 xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
[81fd230]30
[1f7ca93]31 <segmentedlist>
32 <segtitle>&buildtime;</segtitle>
33 <segtitle>&diskspace;</segtitle>
[5888299]34
[1f7ca93]35 <seglistitem>
[e4a5635]36 <seg>&gcc-ch5p1-sbu;</seg>
37 <seg>&gcc-ch5p1-du;</seg>
[1f7ca93]38 </seglistitem>
39 </segmentedlist>
[673b0d8]40
[1f7ca93]41 </sect2>
[73aedd1d]42
[1f7ca93]43 <sect2 role="installation">
[4e82d47]44 <title>Installation of Cross GCC</title>
[73aedd1d]45
[4916842]46 <para>GCC now requires the GMP, MPFR and MPC packages. As these packages may
[6cc0516]47 not be included in your host distribution, they will be built with
[95c681a]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>
[6cc0516]51
[3380af3]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
[7ce01e0]58<screen><userinput remap="pre">tar -jxf ../mpfr-&mpfr-version;.tar.bz2
[e311865]59mv -v mpfr-&mpfr-version; mpfr
[5fc385a]60tar -Jxf ../gmp-&gmp-version;.tar.xz
[4916842]61mv -v gmp-&gmp-version; gmp
62tar -zxf ../mpc-&mpc-version;.tar.gz
63mv -v mpc-&mpc-version; mpc</userinput></screen>
[6cc0516]64
[8aad4385]65<para>Apply a patch that will allow the building of the libiberty and zlib
66target libraries to be disabled as these do not build correctly in a
67cross-compiled environment:</para>
68
69<screen><userinput remap="pre">patch -Np1 -i ../&gcc-crosscompile-patch;</userinput></screen>
70
[1f7ca93]71 <para>The GCC documentation recommends building GCC outside of the
72 source directory in a dedicated build directory:</para>
[3d36131c]73
[0445a3d]74<screen><userinput remap="pre">mkdir -v ../gcc-build
[73aedd1d]75cd ../gcc-build</userinput></screen>
76
[1f7ca93]77 <para>Prepare GCC for compilation:</para>
[73aedd1d]78
[9f5aaf7]79<screen><userinput remap="configure">../gcc-&gcc-version;/configure \
80 --target=$LFS_TGT \
81 --prefix=/tools \
82 --disable-nls \
83 --disable-shared \
84 --disable-multilib \
85 --disable-decimal-float \
86 --disable-threads \
87 --disable-libmudflap \
88 --disable-libssp \
89 --disable-libgomp \
90 --disable-libquadmath \
91 --disable-target-libiberty \
92 --disable-target-zlib \
93 --enable-languages=c \
94 --without-ppl \
95 --without-cloog \
[2ce327c]96 --with-mpfr-include=$(pwd)/../gcc-&gcc-version;/mpfr/src \
97 --with-mpfr-lib=$(pwd)/mpfr/src/.libs</userinput></screen>
[81fd230]98
[1f7ca93]99 <variablelist>
100 <title>The meaning of the configure options:</title>
101
102 <varlistentry>
[0eb90658]103 <term><parameter>--disable-shared</parameter></term>
[1f7ca93]104 <listitem>
[c49647b1]105 <para>This switch forces GCC to link its internal libraries
[0eb90658]106 statically. We do this to avoid possible issues with the host
107 system.</para>
[1f7ca93]108 </listitem>
109 </varlistentry>
110
[182d5d3]111 <varlistentry>
[8aad4385]112 <term><parameter>--disable-decimal-float, --disable-threads, --disable-libmudflap, --disable-libssp, --disable-libgomp, --disable-libquadmath --disable-target-libiberty --disable-target-zlib</parameter></term>
[182d5d3]113 <listitem>
[8aad4385]114 <para>These switches disable support for the decimal floating point
115 extension, threading, libmudflap, libssp and libgomp, libquadmath,
116 libiberty and zlib respectively. These features will fail to compile
117 when building a cross-compiler and are not necessary for the task of
[4e82d47]118 cross-compiling the temporary libc.</para>
[182d5d3]119 </listitem>
120 </varlistentry>
121
[1f7ca93]122 <varlistentry>
[4e82d47]123 <term><parameter>--disable-multilib</parameter></term>
[1f7ca93]124 <listitem>
[4e82d47]125 <para>On x86_64, LFS does not yet support a multilib configuration.
126 This switch is harmless for x86.</para>
[1f7ca93]127 </listitem>
128 </varlistentry>
129
[6e88633]130 <varlistentry>
[4e82d47]131 <term><parameter>--enable-languages=c</parameter></term>
[6e88633]132 <listitem>
[4e82d47]133 <para>This option ensures that only the C compiler is built.
134 This is the only language needed now.</para>
[6e88633]135 </listitem>
136 </varlistentry>
137
[6123afe]138 <varlistentry>
139 <term><parameter>--without-ppl, --without-cloog</parameter></term>
140 <listitem>
141 <para>These switches prevent GCC from building against the PPL and
142 CLooG libraries which may be present on the host system, but will not
143 be available in the chroot environment.</para>
144 </listitem>
145 </varlistentry>
146
[1f7ca93]147 </variablelist>
148
[4e82d47]149 <para>Compile GCC by running:</para>
[b0a4c9a]150
[0445a3d]151<screen><userinput remap="make">make</userinput></screen>
[81fd230]152
[1f7ca93]153 <para>Compilation is now complete. At this point, the test suite would
154 normally be run, but, as mentioned before, the test suite framework is
155 not in place yet. The benefits of running the tests at this point
156 are minimal since the programs from this first pass will soon be
157 replaced.</para>
158
159 <para>Install the package:</para>
[73aedd1d]160
[0445a3d]161<screen><userinput remap="install">make install</userinput></screen>
[73aedd1d]162
[0eb90658]163 <para>Using <parameter>--disable-shared</parameter> means that the
164 <filename>libgcc_eh.a</filename> file isn't created and installed. The
165 Glibc package depends on this library as it uses
[4e82d47]166 <parameter>-lgcc_eh</parameter> within its build system. This dependency
167 can be satisfied by creating a symlink to <filename>libgcc.a</filename>,
[0eb90658]168 since that file will end up containing the objects normally contained in
[5f7456b]169 <filename>libgcc_eh.a</filename>:</para>
[0eb90658]170
[9f5aaf7]171<screen><userinput remap="install">ln -vs libgcc.a `$LFS_TGT-gcc -print-libgcc-file-name | sed 's/libgcc/&amp;_eh/'`</userinput></screen>
[0eb90658]172
[1f7ca93]173 </sect2>
[bc82645e]174
[1f7ca93]175 <sect2 role="content">
176 <title/>
[81fd230]177
[1f7ca93]178 <para>Details on this package are located in
179 <xref linkend="contents-gcc" role="."/></para>
[81fd230]180
[1f7ca93]181 </sect2>
182
183</sect1>
Note: See TracBrowser for help on using the repository browser.