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

Last change on this file since 9dc5852 was 9dc5852, checked in by Maarten Lankhorst <m.b.lankhorst@…>, 14 years ago

Get rid of CLFS_HOST

  • Property mode set to 100644
File size: 8.8 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='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='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    --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</parameter></term>
72        <listitem>
73          <para>This option ensures that only the C compiler is built. If the C++ compiler is needed, use --enable-languages=c,c++</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>
149          <indexterm zone="ch-cross-tools-gcc-final cc">
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>
160          <indexterm zone="ch-cross-tools-gcc-final cpp">
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>
170          <indexterm zone="ch-cross-tools-gcc-final c">
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>
180          <indexterm zone="ch-cross-tools-gcc-final g">
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>
190          <indexterm zone="ch-cross-tools-gcc-final gcc">
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>
200          <indexterm zone="ch-cross-tools-gcc-final gccbug">
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>
211          <indexterm zone="ch-cross-tools-gcc-final gcov">
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>
221          <indexterm zone="ch-cross-tools-gcc-final libgcc">
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>
232          <indexterm zone="ch-cross-tools-gcc-final libmudflap">
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>
242          <indexterm zone="ch-cross-tools-gcc-final libstdc">
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>
253          <indexterm zone="ch-cross-tools-gcc-final libsupc">
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.