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

Last change on this file since 2567553 was 0194a60, checked in by Joe Ciccone <jciccone@…>, 16 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.