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

Last change on this file since 4ef72df was 6561a0f, checked in by Manuel Canales Esparcia <manuel@…>, 18 years ago

Fixed validation issues.

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