source: clfs-embedded/BOOK/cross-tools/common/gcc-final.xml @ 841271e

Last change on this file since 841271e was 841271e, checked in by Jim Gifford <clfs@…>, 17 years ago

uClibc updates

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