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

Last change on this file since d5c7418 was d5c7418, checked in by Andrew Bradford <bradfa@…>, 12 years ago

Changed BUILD variable name to CLFS_ABI

It better represents what the variable stands for.
It picks the ABI to use when compiling GCC.

  • Property mode set to 100644
File size: 5.5 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='c'])"/>
28
29    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
30    href="gcc-static.xml"
31    xpointer="xpointer(//*[@os='d'])"/>
32
33    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
34    href="gcc-static.xml"
35    xpointer="xpointer(//*[@os='e'])"/>
36
37<screen os="ae"><userinput>AR=ar LDFLAGS="-Wl,-rpath,${CLFS}/cross-tools/lib" \
38  ../gcc-&gcc-version;/configure --prefix=${CLFS}/cross-tools \
39  --build=${CLFS_HOST} --target=${CLFS_TARGET} --host=${CLFS_HOST} \
40  --with-sysroot=${CLFS} --disable-nls --enable-shared \
41  --enable-languages=c --enable-c99 --enable-long-long \
42  --with-mpfr=${CLFS}/cross-tools --with-gmp=${CLFS}/cross-tools \
43  --with-mpc=${CLFS}/cross-tools --with-abi=${CLFS_ABI}</userinput></screen>
44
45    <variablelist os="af">
46      <title>The meaning of the configure options not used previously:</title>
47
48      <varlistentry os="af1">
49        <term><parameter>--enable-shared</parameter></term>
50        <listitem>
51          <para>Enables the creation of the shared libraries.</para>
52        </listitem>
53      </varlistentry>
54
55      <varlistentry os="af2">
56        <term><parameter>--enable-c99</parameter></term>
57        <listitem>
58          <para>Enable C99 support for C programs.</para>
59        </listitem>
60      </varlistentry>
61
62      <varlistentry os="af3">
63        <term><parameter>--enable-long-long</parameter></term>
64        <listitem>
65          <para>Enables long long support in the compiler.</para>
66        </listitem>
67      </varlistentry>
68
69    </variablelist>
70
71    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
72    href="gcc-static.xml"
73    xpointer="xpointer(//*[@os='ag'])"/>
74
75<screen os="ah"><userinput>make</userinput></screen>
76
77    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
78    href="gcc-static.xml"
79    xpointer="xpointer(//*[@os='ai'])"/>
80
81<screen os="aj"><userinput>make install</userinput></screen>
82
83  </sect2>
84
85  <sect2 id="contents-gcc" role="content">
86    <title>Contents of GCC</title>
87
88    <segmentedlist>
89      <segtitle>Installed programs</segtitle>
90      <segtitle>Installed libraries</segtitle>
91
92      <seglistitem>
93        <seg>cc (link to gcc), gcc, gccbug, and gcov</seg>
94        <seg>libgcc.a, libgcc_eh.a, libgcc_s.so, libmudflap.[a,so],
95        and libmudflapth.[a,so]</seg>
96      </seglistitem>
97    </segmentedlist>
98
99    <variablelist>
100      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
101      <?dbfo list-presentation="list"?>
102      <?dbhtml list-presentation="table"?>
103
104      <varlistentry id="cc">
105        <term><command>cc</command></term>
106        <listitem>
107          <para>The C compiler</para>
108          <indexterm zone="ch-cross-tools-gcc-final cc">
109            <primary sortas="b-cc">cc</primary>
110          </indexterm>
111        </listitem>
112      </varlistentry>
113
114      <varlistentry id="gcc">
115        <term><command>gcc</command></term>
116        <listitem>
117          <para>The C compiler</para>
118          <indexterm zone="ch-cross-tools-gcc-final gcc">
119            <primary sortas="b-gcc">gcc</primary>
120          </indexterm>
121        </listitem>
122      </varlistentry>
123
124      <varlistentry id="gccbug">
125        <term><command>gccbug</command></term>
126        <listitem>
127          <para>A shell script used to help create useful bug reports</para>
128          <indexterm zone="ch-cross-tools-gcc-final gccbug">
129            <primary sortas="b-gccbug">gccbug</primary>
130          </indexterm>
131        </listitem>
132      </varlistentry>
133
134      <varlistentry id="gcov">
135        <term><command>gcov</command></term>
136        <listitem>
137          <para>A coverage testing tool; it is used to analyze programs to
138          determine where optimizations will have the most effect</para>
139          <indexterm zone="ch-cross-tools-gcc-final gcov">
140            <primary sortas="b-gcov">gcov</primary>
141          </indexterm>
142        </listitem>
143      </varlistentry>
144
145      <varlistentry id="libgcc">
146        <term><filename class="libraryfile">libgcc</filename></term>
147        <listitem>
148          <para>Contains run-time support for <command>gcc</command></para>
149          <indexterm zone="ch-cross-tools-gcc-final libgcc">
150            <primary sortas="c-libgcc*">libgcc*</primary>
151          </indexterm>
152        </listitem>
153      </varlistentry>
154
155      <varlistentry id="libmudflap">
156        <term><filename class="libraryfile">libmudflap</filename></term>
157        <listitem>
158          <para>The libmudflap libraries are used by GCC for instrumenting
159          pointer and array dereferencing operations.</para>
160          <indexterm zone="ch-cross-tools-gcc-final libmudflap">
161            <primary sortas="c-libmudflap*">libmudflap*</primary>
162          </indexterm>
163        </listitem>
164      </varlistentry>
165
166    </variablelist>
167
168  </sect2>
169
170</sect1>
Note: See TracBrowser for help on using the repository browser.