6.12. GCC-4.0.3

The GCC package contains the GNU compiler collection, which includes the C and C++ compilers.

Approximate build time: 11.7 SBU
Required disk space: 451 MB
Installation depends on: Bash, Binutils, Coreutils, DejaGNU, Diffutils, Findutils, Expect, Gawk, Gettext, Glibc, Grep, Make, Patch, Perl, Sed, Tcl, and Texinfo

6.12.1. Installation of GCC

Apply a sed substitution that will suppress the installation of libiberty.a. The version of libiberty.a provided by Binutils will be used instead:

sed -i 's/install_to_$(INSTALL_DEST) //' libiberty/Makefile.in

The bootstrap build performed in Section 5.4, “GCC-4.0.3 - Pass 1” built GCC with the -fomit-frame-pointer compiler flag. Non-bootstrap builds omit this flag by default, so apply the following sed to use it in order to ensure consistent compiler builds.

sed -i 's/^XCFLAGS =$/& -fomit-frame-pointer/' gcc/Makefile.in

The fixincludes script is known to occasionally erroneously attempt to "fix" the system headers installed so far. As the headers installed by GCC-4.0.3 and Glibc-2.3.6 are known to not require fixing, issue the following command to prevent the fixincludes script from running:

sed -i 's@\./fixinc\.sh@-c true@' gcc/Makefile.in

GCC provides a gccbug script which detects at compile time whether mktemp is present, and hardcodes the result in a test. This will cause the script to fall back to using less random names for temporary files. We will be installing mktemp later, so the following sed will simulate its presence.

sed -i 's/@have_mktemp_command@/yes/' gcc/gccbug.in

The GCC documentation recommends building GCC outside of the source directory in a dedicated build directory:

mkdir -v ../gcc-build
cd ../gcc-build

Prepare GCC for compilation:

../gcc-4.0.3/configure --prefix=/usr \
    --libexecdir=/usr/lib --enable-shared \
    --enable-threads=posix --enable-__cxa_atexit \
    --enable-clocale=gnu --enable-languages=c,c++

Compile the package:

make
[Important]

Important

In this section, the test suite for GCC is considered critical. Do not skip it under any circumstance.

Test the results, but do not stop at errors:

make -k check

Some of the errors are known issues and were noted in the previous chapter. The test suite notes from Section 5.11, “GCC-4.0.3 - Pass 2,” are still relevant here. Be sure to refer back to them as necessary.

Install the package:

make install

Some packages expect the C preprocessor to be installed in the /lib directory. To support those packages, create this symlink:

ln -sv ../usr/bin/cpp /lib

Many packages use the name cc to call the C compiler. To satisfy those packages, create a symlink:

ln -sv gcc /usr/bin/cc
[Note]

Note

At this point, it is strongly recommended to repeat the sanity check performed earlier in this chapter. Refer back to Section 6.10, “Re-adjusting the Toolchain,” and repeat the check. If the results are in error, then the most likely reason is that the GCC Specs patch from Chapter 5 was erroneously applied here.

6.12.2. Contents of GCC

Installed programs: c++, cc (link to gcc), cpp, g++, gcc, gccbug, and gcov
Installed libraries: libgcc.a, libgcc_eh.a, libgcc_s.so, libstdc++.[a,so], and libsupc++.a

Short Descriptions

cc

The C compiler

cpp

The C preprocessor; it is used by the compiler to expand the #include, #define, and similar statements in the source files

c++

The C++ compiler

g++

The C++ compiler

gcc

The C compiler

gccbug

A shell script used to help create useful bug reports

gcov

A coverage testing tool; it is used to analyze programs to determine where optimizations will have the most effect

libgcc

Contains run-time support for gcc

libstdc++

The standard C++ library

libsupc++

Provides supporting routines for the C++ programming language