source: general/prog/gcc3.xml@ 86af98a

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY gcc3-download-http "http://ftp.gnu.org/gnu/gcc/gcc-&gcc3-version;/gcc-&gcc3-version;.tar.bz2">
  <!ENTITY gcc3-download-ftp  "ftp://ftp.gnu.org/gnu/gcc/gcc-&gcc3-version;/gcc-&gcc3-version;.tar.bz2">
  <!ENTITY gcc3-md5sum        "a1c267b34f05c8660b24251865614d8b">
  <!ENTITY gcc3-size          "23 MB">
  <!ENTITY gcc3-buildsize     "489 MB">
  <!ENTITY gcc3-time          "5.72 SBU (additional 12.54 SBU to run the test suite)">
]>

<sect1 id="gcc3" xreflabel="GCC-&gcc3-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="gcc3.html" ?>
<title><application><acronym>GCC</acronym></application>-&gcc3-version;</title>
<indexterm zone="gcc3">
<primary sortas="a-GCC-3-3">GCC-&gcc3-version;</primary></indexterm>

<sect2>
<title>Introduction to 
<application><acronym>GCC</acronym></application>-&gcc3-version;</title>

<para>The reason for installing 
<application><acronym>GCC</acronym></application>-&gcc3-version; is that 
some <acronym>BLFS</acronym> packages (such as compiled 
<application>Java</application> and <application>OpenOffice</application>) 
have not been updated to be compilable by 
<application><acronym>GCC</acronym></application>-&gcc-version;. Additionally, 
some pre-compiled packages may require the 
<application><acronym>GCC</acronym></application>-&gcc3-version; 
libraries.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&gcc3-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&gcc3-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &gcc3-md5sum;</para></listitem>
<listitem><para>Download size: &gcc3-size;</para></listitem>
<listitem><para>Estimated disk space required:
&gcc3-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&gcc3-time;</para></listitem></itemizedlist>
</sect3>

<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required patch: <ulink 
url="&patch-root;/gcc-&gcc3-version;-no_fixincludes-1.patch"/></para>
</listitem>
<listitem><para>Required patch: <ulink 
url="&patch-root;/gcc-&gcc3-version;-linkonce-1.patch"/></para>
</listitem>
</itemizedlist>
</sect3>

<sect3><title><application><acronym>GCC</acronym>-3</application> 
dependencies</title>
<sect4><title>Optional</title>
<para><xref linkend="dejagnu"/> (required to run the full test suite)</para>
</sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of 
<application><acronym>GCC</acronym>-3</application></title>

<screen><userinput><command>patch -Np1 -i ../gcc-&gcc3-version;-no_fixincludes-1.patch &amp;&amp;
patch -Np1 -i ../gcc-&gcc3-version;-linkonce-1.patch &amp;&amp;
mkdir ../gcc-build &amp;&amp;
cd ../gcc-build &amp;&amp;
../gcc-&gcc3-version;/configure \
    --prefix=/opt/gcc-&gcc3-version; \
    --enable-shared --enable-languages=c,c++ \
    --enable-threads=posix &amp;&amp;
make bootstrap</command></userinput></screen>

<para>If desired, run the test suite using the following commands. The 
<command>test_summary</command> commands create log files which can be 
compared to known good results located at <ulink 
url="http://linuxfromscratch.org/~randy/gcc-334-lfs-6.0-test_summary.log"/> 
and <ulink 
url="http://linuxfromscratch.org/~randy/gcc-334-lfs-6.0-test_summary_short.log"/>.
</para>

<screen><userinput><command>make -k check &amp;&amp;
../gcc-3.3.4/contrib/test_summary >test_summary.log 2>&amp;1 &amp;&amp;
../gcc-3.3.4/contrib/test_summary | \
    grep -A7 Summ >test_summary_short.log 2>&amp;1</command></userinput></screen>

<para>Now, as the root user:</para>

<screen><userinput role='root'><command>make install &amp;&amp;
mv /opt/gcc-&gcc3-version;/lib/libstdc++.so.5* /usr/lib &amp;&amp;
ln -sf /usr/lib/libstdc++.so.5.0.6 /opt/gcc-&gcc3-version;/lib &amp;&amp;
ln -sf libstdc++.so.5.0.6 /opt/gcc-&gcc3-version;/lib/libstdc++.so.5 &amp;&amp;
chown -R root:root \
    /opt/gcc-&gcc3-version;/lib/gcc-lib/i686-pc-linux-gnu/&gcc3-version;/include</command></userinput></screen>

</sect2>

<sect2>
<title>Command explanations</title>

<para><command>mkdir ../gcc-build; cd ../gcc-build</command>: The 
<application><acronym>GCC</acronym></application> development team recommends 
building in a separate directory.</para>

<para><parameter>--enable-shared --enable-languages=c,c++ 
--enable-threads=posix</parameter>: Configures 
<application><acronym>GCC</acronym></application> to build the 
<application>C</application> and <application>C++</application> compilers and 
enable the related <application>C++</application> options.</para>

<para><command>mv /opt/gcc-&gcc3-version;/lib/libstdc++.so.5* 
/usr/lib</command>: Moves the <application>C++</application> libraries to the 
standard lib directory to avoid having to add 
<userinput>/opt/gcc-&gcc3-version;/lib</userinput> to 
<filename>/etc/ld.so.conf</filename>.</para>

</sect2>

<sect2>
<title>Configuring <application><acronym>GCC</acronym></application></title>

<sect3><title>Configuration information</title>

<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" 
href="../../lib-config.xml"/>

<para>If you only need the GCC-&gcc3-version; libraries, you may delete
<filename>/opt/gcc-&gcc3-version;</filename>.</para>

<para>Whenever you need to use GCC-&gcc3-version; instead of your system
installed compiler, add
<filename class="directory">/opt/gcc-&gcc3-version;/bin</filename> to the 
front of your <envar>PATH</envar> or (preferably) set the <envar>CC</envar>
environment variable before compiling the concerned package.</para>

</sect3>

</sect2>

<sect2>
<title>Contents</title>

<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>c++, cpp, g++, gcc, gccbug, gcov and architecture specific names of these 
programs.</seg>
<seg>libgcc_s.so, libiberty.a, libstdc++.[a,so], libsupc++.a and other 
support libraries and files.</seg>
<seg>/opt/gcc-&gcc3-version;</seg>
</seglistitem>
</segmentedlist>

<sect3><title>Short Descriptions</title>
<para>The GCC-&gcc3-version; package contains the
<command>gcc</command>-&gcc3-version; <application>C</application> and
<application>C++</application> compilers and GCC-&gcc3-version;
<filename>libstdc++.so</filename> that is required by some commercial and
pre-compiled packages.</para>
</sect3>

</sect2>

</sect1>