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

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since 5d3d725 was 7278ff4, checked in by Joe Ciccone <jciccone@…>, 14 years ago

Updated GCC to 4.5.1.

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