source: clfs-embedded/BOOK/cross-tools/common/gcc-final.xml @ 0194a60

Last change on this file since 0194a60 was 0194a60, checked in by Joe Ciccone <jciccone@…>, 14 years ago

Updated Binutils to 2.19.
Updated GCC to 4.3.2.
Dropped the uClibc Headers Page.

  • Property mode set to 100644
File size: 8.3 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-cross-tools-gcc-final" role="wrap">
9  <?dbhtml filename="gcc-final.html"?>
10
11  <title>GCC-&gcc-version; - Cross Compiler Final</title>
12
13  <indexterm zone="ch-cross-tools-gcc-final">
14    <primary sortas="a-GCC">GCC</primary>
15    <secondary>cross tools, final</secondary>
16  </indexterm>
17
18  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
19  href="gcc-static.xml"
20  xpointer="xpointer(//*[@role='package'])"/>
21
22  <sect2 role="installation">
23    <title>Installation of GCC Cross Compiler</title>
24
25    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
26    href="gcc-static.xml"
27    xpointer="xpointer(//*[@os='p1'])"/>
28
29    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
30    href="gcc-static.xml"
31    xpointer="xpointer(//*[@os='p2'])"/>
32
33    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
34    href="gcc-static.xml"
35    xpointer="xpointer(//*[@os='c'])"/>
36
37    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
38    href="gcc-static.xml"
39    xpointer="xpointer(//*[@os='d'])"/>
40
41    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
42    href="gcc-static.xml"
43    xpointer="xpointer(//*[@os='e'])"/>
44
45<screen os="ae"><userinput>../gcc-&gcc-version;/configure --prefix=${CLFS}/cross-tools \
46    --target=${CLFS_TARGET} --disable-multilib \
47    --with-sysroot=${CLFS} --disable-nls --enable-shared \
48    --enable-languages=c --enable-__cxa_atexit \
49    --enable-c99 --enable-long-long --enable-threads=posix</userinput></screen>
50
51    <variablelist os="af">
52      <title>The meaning of the new configure options:</title>
53
54      <varlistentry os="af1">
55        <term><parameter>--enable-languages=c</parameter></term>
56        <listitem>
57          <para>This option ensures that only the C compiler is built. If the C++ compiler is needed, use --enable-languages=c,c++</para>
58        </listitem>
59      </varlistentry>
60
61      <varlistentry os="af2">
62        <term><parameter>--enable-__cxa_atexit</parameter></term>
63        <listitem>
64          <para>This option allows use of __cxa_atexit, rather than atexit,
65          to register C++ destructors for local statics and global objects
66          and is essential for fully standards-compliant handling of destructors.
67          It also affects the C++ ABI and therefore results in C++ shared libraries
68          and C++ programs that are interoperable with other Linux distributions.</para>
69        </listitem>
70      </varlistentry>
71
72      <varlistentry os="af3">
73        <term><parameter>--enable-c99</parameter></term>
74        <listitem>
75          <para>Enable C99 support for C programs.</para>
76        </listitem>
77      </varlistentry>
78
79      <varlistentry os="af4">
80        <term><parameter>--enable-long-long</parameter></term>
81        <listitem>
82          <para>Enables long long support in the compiler.</para>
83        </listitem>
84      </varlistentry>
85
86      <varlistentry os="af5">
87        <term><parameter>--enable-threads=posix</parameter></term>
88        <listitem>
89          <para>This enables C++ exception handling for multi-threaded code.</para>
90        </listitem>
91      </varlistentry>
92
93    </variablelist>
94
95    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
96    href="gcc-static.xml"
97    xpointer="xpointer(//*[@os='ag'])"/>
98
99<screen os="ah"><userinput>make</userinput></screen>
100
101    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
102    href="gcc-static.xml"
103    xpointer="xpointer(//*[@os='ai'])"/>
104
105<screen os="aj"><userinput>make install</userinput></screen>
106
107  </sect2>
108
109  <sect2 id="contents-gcc" role="content">
110    <title>Contents of GCC</title>
111
112    <segmentedlist>
113      <segtitle>Installed programs</segtitle>
114      <segtitle>Installed libraries</segtitle>
115
116      <seglistitem>
117        <seg>c++, cc (link to gcc), cpp, g++, gcc, gccbug, and gcov</seg>
118        <seg>libgcc.a, libgcc_eh.a, libgcc_s.so, libmudflap.[a,so],
119        libmudflapth.[a,so], libstdc++.[a,so], and
120        libsupc++.a</seg>
121      </seglistitem>
122    </segmentedlist>
123
124    <variablelist>
125      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
126      <?dbfo list-presentation="list"?>
127      <?dbhtml list-presentation="table"?>
128
129      <varlistentry id="cc">
130        <term><command>cc</command></term>
131        <listitem>
132          <para>The C compiler</para>
133          <indexterm zone="ch-cross-tools-gcc-final cc">
134            <primary sortas="b-cc">cc</primary>
135          </indexterm>
136        </listitem>
137      </varlistentry>
138
139      <varlistentry id="cpp">
140        <term><command>cpp</command></term>
141        <listitem>
142          <para>The C preprocessor; it is used by the compiler to expand the
143          #include, #define, and similar statements in the source files</para>
144          <indexterm zone="ch-cross-tools-gcc-final cpp">
145            <primary sortas="b-cpp">cpp</primary>
146          </indexterm>
147        </listitem>
148      </varlistentry>
149
150      <varlistentry id="c">
151        <term><command>c++</command></term>
152        <listitem>
153          <para>The C++ compiler</para>
154          <indexterm zone="ch-cross-tools-gcc-final c">
155            <primary sortas="b-c++">c++</primary>
156          </indexterm>
157        </listitem>
158      </varlistentry>
159
160      <varlistentry id="g">
161        <term><command>g++</command></term>
162        <listitem>
163          <para>The C++ compiler</para>
164          <indexterm zone="ch-cross-tools-gcc-final g">
165            <primary sortas="b-g++">g++</primary>
166          </indexterm>
167        </listitem>
168      </varlistentry>
169
170      <varlistentry id="gcc">
171        <term><command>gcc</command></term>
172        <listitem>
173          <para>The C compiler</para>
174          <indexterm zone="ch-cross-tools-gcc-final gcc">
175            <primary sortas="b-gcc">gcc</primary>
176          </indexterm>
177        </listitem>
178      </varlistentry>
179
180      <varlistentry id="gccbug">
181        <term><command>gccbug</command></term>
182        <listitem>
183          <para>A shell script used to help create useful bug reports</para>
184          <indexterm zone="ch-cross-tools-gcc-final gccbug">
185            <primary sortas="b-gccbug">gccbug</primary>
186          </indexterm>
187        </listitem>
188      </varlistentry>
189
190      <varlistentry id="gcov">
191        <term><command>gcov</command></term>
192        <listitem>
193          <para>A coverage testing tool; it is used to analyze programs to
194          determine where optimizations will have the most effect</para>
195          <indexterm zone="ch-cross-tools-gcc-final gcov">
196            <primary sortas="b-gcov">gcov</primary>
197          </indexterm>
198        </listitem>
199      </varlistentry>
200
201      <varlistentry id="libgcc">
202        <term><filename class="libraryfile">libgcc</filename></term>
203        <listitem>
204          <para>Contains run-time support for <command>gcc</command></para>
205          <indexterm zone="ch-cross-tools-gcc-final libgcc">
206            <primary sortas="c-libgcc*">libgcc*</primary>
207          </indexterm>
208        </listitem>
209      </varlistentry>
210
211      <varlistentry id="libmudflap">
212        <term><filename class="libraryfile">libmudflap</filename></term>
213        <listitem>
214          <para>The libmudflap libraries are used by GCC for instrumenting
215          pointer and array dereferencing operations.</para>
216          <indexterm zone="ch-cross-tools-gcc-final libmudflap">
217            <primary sortas="c-libmudflap*">libmudflap*</primary>
218          </indexterm>
219        </listitem>
220      </varlistentry>
221
222      <varlistentry id="libstdc">
223        <term><filename class="libraryfile">libstdc++</filename></term>
224        <listitem>
225          <para>The standard C++ library</para>
226          <indexterm zone="ch-cross-tools-gcc-final libstdc">
227            <primary sortas="c-libstdc++">libstdc++</primary>
228          </indexterm>
229        </listitem>
230      </varlistentry>
231
232      <varlistentry id="libsupc">
233        <term><filename class="libraryfile">libsupc++</filename></term>
234        <listitem>
235          <para>Provides supporting routines for the C++ programming
236          language</para>
237          <indexterm zone="ch-cross-tools-gcc-final libsupc">
238            <primary sortas="c-libsupc++">libsupc++</primary>
239          </indexterm>
240        </listitem>
241      </varlistentry>
242
243    </variablelist>
244
245  </sect2>
246
247</sect1>
Note: See TracBrowser for help on using the repository browser.