source: BOOK/final-system/common/gcc.xml@ be48ca7

clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since be48ca7 was cc858ed, checked in by William Harrington <kb0iic@…>, 11 years ago

Update date.

  • Property mode set to 100644
File size: 9.7 KB
RevLine 
[3f8be484]1<?xml version="1.0" encoding="ISO-8859-1"?>
[aa18ac0]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[3f8be484]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-system-gcc" role="wrap">
9 <?dbhtml filename="gcc.html"?>
10
11 <title>GCC-&gcc-version;</title>
12
13 <indexterm zone="ch-system-gcc">
14 <primary sortas="a-GCC">GCC</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
20 <para>The GCC package contains the GNU compiler collection, which includes
21 the C and C++ compilers.</para>
22
23 </sect2>
24
25 <sect2 role="installation">
26 <title>Installation of GCC</title>
27
[cc858ed]28 <para os="p1">The following patch contains a number of updates to the
29 &gcc-version; branch by the GCC developers:</para>
30
31 <screen os="p2"><userinput>patch -Np1 -i ../&gcc-branch_update-patch;</userinput></screen>
32
[7327f1f]33 <para os="fix1">Apply a <command>sed</command> subsitution that will
34 suppress the execution of the <command>fixincludes</command> script:</para>
35
36<screen os="fix2"><userinput>cp -v gcc/Makefile.in{,.orig}
[7748c0f]37sed 's@\./fixinc\.sh@-c true@' gcc/Makefile.in.orig > gcc/Makefile.in</userinput></screen>
[7327f1f]38
[3f8be484]39 <para os="d">Apply a <command>sed</command> substitution that will suppress the
40 installation of <filename class="libraryfile">libiberty.a</filename>. The
41 version of <filename class="libraryfile">libiberty.a</filename> provided by
42 Binutils will be used instead:</para>
43
44<screen os="e"><userinput>sed -i 's/install_to_$(INSTALL_DEST) //' libiberty/Makefile.in</userinput></screen>
45
46 <para os="f">The GCC documentation recommends building GCC outside of the source
47 directory in a dedicated build directory:</para>
48
[94e6142]49<screen os="g"><userinput>mkdir -v ../gcc-build
[3f8be484]50cd ../gcc-build</userinput></screen>
51
52 <para os="h">Prepare GCC for compilation:</para>
53
[b6831b6]54<screen os="i"><userinput>CC="gcc -isystem /usr/include" \
55CXX="g++ -isystem /usr/include" \
56LDFLAGS="-Wl,-rpath-link,/usr/lib:/lib" \
57 ../gcc-&gcc-version;/configure --prefix=/usr \
[3f8be484]58 --libexecdir=/usr/lib --enable-shared --enable-threads=posix \
59 --enable-__cxa_atexit --enable-c99 --enable-long-long \
[43f3140]60 --enable-clocale=gnu --enable-languages=c,c++ \
[84b164e]61 --disable-multilib --disable-libstdcxx-pch \
[c2df4dc]62 --enable-cloog-backend=isl --disable-isl-version-check --with-system-zlib \
[3c54c0a]63 --enable-checking=release --enable-libstdcxx-time \
64 --disable-install-libiberty</userinput></screen>
[3f8be484]65
[d55f00bc]66 <para os="j">Compile the package:</para>
[3f8be484]67
[f568131]68<screen os="k"><userinput>make</userinput></screen>
[3f8be484]69
[d55f00bc]70 <important os="l">
[121c48a]71 <para>The test suite for GCC is considered
[3f8be484]72 critical. Do not skip it under any circumstance.</para>
73 </important>
74
[d55f00bc]75 <para os="m">Test the results, but do not stop at errors:</para>
[3f8be484]76
[d55f00bc]77<screen os="n"><userinput>make -k check</userinput></screen>
[3f8be484]78
[d55f00bc]79 <para os="o">The <parameter>-k</parameter> flag is used to make the test suite
[3f8be484]80 run through to completion and not stop at the first failure. The GCC test
81 suite is very comprehensive and is almost guaranteed to generate a few
82 failures. To receive a summary of the test suite results, run:</para>
83
[d55f00bc]84<screen os="p"><userinput>../gcc-&gcc-version;/contrib/test_summary</userinput></screen>
[3f8be484]85
[d55f00bc]86 <para os="q">For only the summaries, pipe the output through
[3f8be484]87 <userinput>grep -A7 Summ</userinput>.</para>
88
89 <para os="r">A few unexpected failures cannot always be avoided. The
90 GCC developers are usually aware of these issues, but have not
[d55f00bc]91 resolved them yet.</para>
[3f8be484]92
93 <para os="s">Install the package:</para>
94
95<screen os="t"><userinput>make install</userinput></screen>
96
97 <para os="u">Some packages expect the C preprocessor to be installed in the
98 <filename class="directory">/lib</filename> directory.
99 To support those packages, create this symlink:</para>
100
[94e6142]101<screen os="v"><userinput>ln -sv ../usr/bin/cpp /lib</userinput></screen>
[3f8be484]102
103 <para os="w">Many packages use the name <command>cc</command> to call the C
104 compiler. To satisfy those packages, create a symlink:</para>
105
[94e6142]106<screen os="x"><userinput>ln -sv gcc /usr/bin/cc</userinput></screen>
[3f8be484]107
108 </sect2>
109
110 <sect2 id="contents-gcc" role="content">
111 <title>Contents of GCC</title>
112
113 <segmentedlist>
114 <segtitle>Installed programs</segtitle>
115 <segtitle>Installed libraries</segtitle>
[61ad0b7f]116 <segtitle>Installed directories</segtitle>
[3f8be484]117
118 <seglistitem>
[2b220db9]119 <seg>c++, cc (link to gcc), cpp, g++, gcc, and gcov</seg>
[2cca6fd]120 <seg>libgcc.a, libgcc_eh.a, libgcc_s.so, libgcov.a, libgomp.[a,so],
[188b6b2]121 libmudflap.[a,so], libmudflapth.[a,so], libssp.[a,so],
122 libssp_nonshared.a, libstdc++.[a,so], and libsupc++.a</seg>
[2b220db9]123 <seg>/usr/include/c++, /usr/lib/gcc, /usr/share/gcc-&gcc-version;</seg>
[3f8be484]124 </seglistitem>
125 </segmentedlist>
126
127 <variablelist>
128 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
129 <?dbfo list-presentation="list"?>
130 <?dbhtml list-presentation="table"?>
131
132 <varlistentry id="cc">
133 <term><command>cc</command></term>
134 <listitem>
135 <para>The C compiler</para>
136 <indexterm zone="ch-system-gcc cc">
137 <primary sortas="b-cc">cc</primary>
138 </indexterm>
139 </listitem>
140 </varlistentry>
141
142 <varlistentry id="cpp">
143 <term><command>cpp</command></term>
144 <listitem>
145 <para>The C preprocessor; it is used by the compiler to expand the
146 #include, #define, and similar statements in the source files</para>
147 <indexterm zone="ch-system-gcc cpp">
148 <primary sortas="b-cpp">cpp</primary>
149 </indexterm>
150 </listitem>
151 </varlistentry>
152
153 <varlistentry id="c">
154 <term><command>c++</command></term>
155 <listitem>
156 <para>The C++ compiler</para>
157 <indexterm zone="ch-system-gcc c">
158 <primary sortas="b-c++">c++</primary>
159 </indexterm>
160 </listitem>
161 </varlistentry>
162
163 <varlistentry id="g">
164 <term><command>g++</command></term>
165 <listitem>
166 <para>The C++ compiler</para>
167 <indexterm zone="ch-system-gcc g">
168 <primary sortas="b-g++">g++</primary>
169 </indexterm>
170 </listitem>
171 </varlistentry>
172
173 <varlistentry id="gcc">
174 <term><command>gcc</command></term>
175 <listitem>
176 <para>The C compiler</para>
177 <indexterm zone="ch-system-gcc gcc">
178 <primary sortas="b-gcc">gcc</primary>
179 </indexterm>
180 </listitem>
181 </varlistentry>
182
183 <varlistentry id="gcov">
184 <term><command>gcov</command></term>
185 <listitem>
186 <para>A coverage testing tool; it is used to analyze programs to
187 determine where optimizations will have the most effect</para>
188 <indexterm zone="ch-system-gcc gcov">
189 <primary sortas="b-gcov">gcov</primary>
190 </indexterm>
191 </listitem>
192 </varlistentry>
193
194 <varlistentry id="libgcc">
195 <term><filename class="libraryfile">libgcc</filename></term>
196 <listitem>
197 <para>Contains run-time support for <command>gcc</command></para>
198 <indexterm zone="ch-system-gcc libgcc">
199 <primary sortas="c-libgcc*">libgcc*</primary>
200 </indexterm>
201 </listitem>
202 </varlistentry>
203
[2cca6fd]204 <varlistentry id="libgcov">
205 <term><filename class="libraryfile">libgcov</filename></term>
206 <listitem>
207 <para>Library that is linked into a program when
208 <command>gcc</command> is instructed to enable profiling</para>
209 <indexterm zone="ch-system-gcc libgcov">
210 <primary sortas="c-libgcov">libgcov</primary>
211 </indexterm>
212 </listitem>
213 </varlistentry>
214
[188b6b2]215 <varlistentry id="libgomp">
216 <term><filename class="libraryfile">libgomp</filename></term>
217 <listitem>
218 <para>GNU implementation of the OpenMP API for multi-platform
219 shared-memory parallel programming in C/C++ and Fortran</para>
220 <indexterm zone="ch-system-gcc libgomp">
221 <primary sortas="c-libgomp">libgomp</primary>
222 </indexterm>
223 </listitem>
224 </varlistentry>
225
[12a457e]226 <varlistentry id="libmudflap">
227 <term><filename class="libraryfile">libmudflap</filename></term>
228 <listitem>
229 <para>The libmudflap libraries are used by GCC for instrumenting
[3bec8f3]230 pointer and array dereferencing operations.</para>
[12a457e]231 <indexterm zone="ch-system-gcc libmudflap">
232 <primary sortas="c-libmudflap*">libmudflap*</primary>
233 </indexterm>
234 </listitem>
235 </varlistentry>
236
[188b6b2]237 <varlistentry id="libssp">
238 <term><filename class="libraryfile">libssp</filename></term>
239 <listitem>
240 <para>Contains routines supporting GCC's stack-smashing protection
241 functionality</para>
242 <indexterm zone="ch-system-gcc libssp">
243 <primary sortas="c-libssp*">libssp*</primary>
244 </indexterm>
245 </listitem>
246 </varlistentry>
247
[3f8be484]248 <varlistentry id="libstdc">
249 <term><filename class="libraryfile">libstdc++</filename></term>
250 <listitem>
251 <para>The standard C++ library</para>
252 <indexterm zone="ch-system-gcc libstdc">
253 <primary sortas="c-libstdc++">libstdc++</primary>
254 </indexterm>
255 </listitem>
256 </varlistentry>
257
258 <varlistentry id="libsupc">
259 <term><filename class="libraryfile">libsupc++</filename></term>
260 <listitem>
261 <para>Provides supporting routines for the C++ programming
262 language</para>
263 <indexterm zone="ch-system-gcc libsupc">
264 <primary sortas="c-libsupc++">libsupc++</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268
269 </variablelist>
270
271 </sect2>
272
273</sect1>
Note: See TracBrowser for help on using the repository browser.