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

Last change on this file since bd39e7a was 59dfbb9, checked in by Maarten Lankhorst <m.b.lankhorst@…>, 18 years ago

Fix wrong explanation

  • 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</parameter></term>
80 <listitem>
81 <para>This option ensures that only the C compiler is built. If the C++ compiler is needed, use --enable-languages=c,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.