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

Last change on this file since 08718a4 was 3961d27, checked in by Joe Ciccone <jciccone@…>, 13 years ago

Fix typo.

  • Property mode set to 100644
File size: 6.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<!-- Common GCC-Final -->
9
10<sect1 id="ch-cross-tools-gcc-final" role="wrap">
11  <?dbhtml filename="gcc-final.html"?>
12
13  <title>GCC-&gcc-version; - Cross Compiler Final</title>
14
15  <indexterm zone="ch-cross-tools-gcc-final">
16    <primary sortas="a-GCC">GCC</primary>
17    <secondary>cross tools, final</secondary>
18  </indexterm>
19
20  <xi:include role="package" xmlns:xi="http://www.w3.org/2003/XInclude"
21  href="gcc-static.xml"
22  xpointer="xpointer(//*[@role='package'])"/>
23
24  <sect2 role="installation">
25    <title>Installation of GCC Cross Compiler</title>
26
27    <xi:include os="c" xmlns:xi="http://www.w3.org/2003/XInclude"
28    href="gcc-static.xml"
29    xpointer="xpointer(//*[@os='c'])"/>
30
31    <xi:include os="d" xmlns:xi="http://www.w3.org/2003/XInclude"
32    href="gcc-static.xml"
33    xpointer="xpointer(//*[@os='d'])"/>
34
35    <xi:include os="e" xmlns:xi="http://www.w3.org/2003/XInclude"
36    href="gcc-static.xml"
37    xpointer="xpointer(//*[@os='e'])"/>
38
39    <note os="f"><para>If you would like to build a C++ compiler in addition
40    to the C compiler, change the following --enable-languages=c option to be
41    --enable-languages=c,c++ instead.  A C++ compiler is not required for
42    any of the software included in this book.</para></note>
43
44<!-- This is the common configure line for GCC-Final -->
45<!-- It's not actually used by any arch but is here for reference. -->
46<screen os="ae"><userinput>AR=ar LDFLAGS="-Wl,-rpath,${CLFS}/cross-tools/lib" \
47  ../gcc-&gcc-version;/configure --prefix=${CLFS}/cross-tools \
48  --build=${CLFS_HOST} --target=${CLFS_TARGET} --host=${CLFS_HOST} \
49  --with-sysroot=${CLFS} --disable-nls --enable-shared \
50  --enable-languages=c --enable-c99 --enable-long-long \
51  --with-mpfr=${CLFS}/cross-tools --with-gmp=${CLFS}/cross-tools \
52  --with-mpc=${CLFS}/cross-tools --disable-multilib</userinput></screen>
53
54    <variablelist os="af">
55      <title>The meaning of the configure options not used previously:</title>
56
57      <varlistentry os="af1">
58        <term><parameter>--enable-shared</parameter></term>
59        <listitem>
60          <para>Enables the creation of the shared libraries.</para>
61        </listitem>
62      </varlistentry>
63
64      <varlistentry os="af2">
65        <term><parameter>--enable-c99</parameter></term>
66        <listitem>
67          <para>Enable C99 support for C programs.</para>
68        </listitem>
69      </varlistentry>
70
71      <varlistentry os="af3">
72        <term><parameter>--enable-long-long</parameter></term>
73        <listitem>
74          <para>Enables long long support in the compiler.</para>
75        </listitem>
76      </varlistentry>
77
78    </variablelist>
79
80    <xi:include os="ah" xmlns:xi="http://www.w3.org/2003/XInclude"
81    href="gcc-static.xml"
82    xpointer="xpointer(//*[@os='ah'])"/>
83
84<screen os="ai"><userinput>make</userinput></screen>
85
86    <xi:include os="aj" xmlns:xi="http://www.w3.org/2003/XInclude"
87    href="gcc-static.xml"
88    xpointer="xpointer(//*[@os='aj'])"/>
89
90<screen os="ak"><userinput>make install</userinput></screen>
91
92    <para os="al">Some programs need <filename class="libraryfile">libgcc_s.so.1</filename>
93    to be included in the target file system.  Copy it to the
94    <filename class="directory">${CLFS}/lib</filename> directory:</para>
95
96<screen os="am"><userinput>cp -v ${CLFS}/cross-tools/${CLFS_TARGET}/lib/libgcc_s.so.1 ${CLFS}/lib</userinput></screen>
97 
98  </sect2>
99
100  <sect2 id="contents-gcc" role="content">
101    <title>Contents of GCC</title>
102
103    <segmentedlist>
104      <segtitle>Installed programs</segtitle>
105      <segtitle>Installed libraries</segtitle>
106
107      <seglistitem>
108        <seg>cc (link to gcc), gcc, gccbug, and gcov</seg>
109        <seg>libgcc.a, libgcc_eh.a, libgcc_s.so, libmudflap.[a,so],
110        and libmudflapth.[a,so]</seg>
111      </seglistitem>
112    </segmentedlist>
113
114    <variablelist>
115      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
116      <?dbfo list-presentation="list"?>
117      <?dbhtml list-presentation="table"?>
118
119      <varlistentry id="cc">
120        <term><command>cc</command></term>
121        <listitem>
122          <para>The C compiler</para>
123          <indexterm zone="ch-cross-tools-gcc-final cc">
124            <primary sortas="b-cc">cc</primary>
125          </indexterm>
126        </listitem>
127      </varlistentry>
128
129      <varlistentry id="gcc">
130        <term><command>gcc</command></term>
131        <listitem>
132          <para>The C compiler</para>
133          <indexterm zone="ch-cross-tools-gcc-final gcc">
134            <primary sortas="b-gcc">gcc</primary>
135          </indexterm>
136        </listitem>
137      </varlistentry>
138
139      <varlistentry id="gccbug">
140        <term><command>gccbug</command></term>
141        <listitem>
142          <para>A shell script used to help create useful bug reports</para>
143          <indexterm zone="ch-cross-tools-gcc-final gccbug">
144            <primary sortas="b-gccbug">gccbug</primary>
145          </indexterm>
146        </listitem>
147      </varlistentry>
148
149      <varlistentry id="gcov">
150        <term><command>gcov</command></term>
151        <listitem>
152          <para>A coverage testing tool; it is used to analyze programs to
153          determine where optimizations will have the most effect</para>
154          <indexterm zone="ch-cross-tools-gcc-final gcov">
155            <primary sortas="b-gcov">gcov</primary>
156          </indexterm>
157        </listitem>
158      </varlistentry>
159
160      <varlistentry id="libgcc">
161        <term><filename class="libraryfile">libgcc</filename></term>
162        <listitem>
163          <para>Contains run-time support for <command>gcc</command></para>
164          <indexterm zone="ch-cross-tools-gcc-final libgcc">
165            <primary sortas="c-libgcc*">libgcc*</primary>
166          </indexterm>
167        </listitem>
168      </varlistentry>
169
170      <varlistentry id="libmudflap">
171        <term><filename class="libraryfile">libmudflap</filename></term>
172        <listitem>
173          <para>The libmudflap libraries are used by GCC for instrumenting
174          pointer and array dereferencing operations.</para>
175          <indexterm zone="ch-cross-tools-gcc-final libmudflap">
176            <primary sortas="c-libmudflap*">libmudflap*</primary>
177          </indexterm>
178        </listitem>
179      </varlistentry>
180
181    </variablelist>
182
183  </sect2>
184
185</sect1>
Note: See TracBrowser for help on using the repository browser.