Cross-Compiled Linux From Scratch - Version GIT-20170803-MIPS64-Multilib

Chapter 10. Installing Basic System Software

10.34. GCC-7.1.0

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

10.34.1. Installation of GCC

Apply a sed substitution that will suppress the execution of the fixincludes script: 

sed -i 's@\./fixinc\.sh@-c true@' gcc/Makefile.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: 

SED=sed CC="gcc -isystem /usr/include ${BUILD64}" \
CXX="g++ -isystem /usr/include ${BUILD64}" \
LDFLAGS="-Wl,-rpath-link,/usr/lib64:/lib64:/usr/lib32:/lib32:/usr/lib:/lib" \
../gcc-7.1.0/configure \
    --prefix=/usr \
    --libdir=/usr/lib64 \
    --libexecdir=/usr/lib64 \
    --with-abi=64 \
    --enable-languages=c,c++ \
    --with-system-zlib \
    --enable-install-libiberty \
    --disable-bootstrap

The meaning of the new configure options:

SED=sed

This prevents a hard-coded path to /tools/bin/sed in the fixincl program.

--disable-bootstrap

For a native build, GCC defaults to performing a 3-stage "bootstrap" of the compiler. This means that GCC is compiled a total of 3 times - it is compiled once, the first stage compiler is used to build itself again, and the second stage compiler builds itself once more. The second and third passes are then compared, verifying that GCC is able to reproduce itself successfully. However, there is no need for this with the CLFS build process so we disable it here.

Compile the package: 

make
[Important]

Important

Due to GCC's critical role in a properly functioning system, the CLFS developers strongly recommend running the testsuite.

Increase the stack size prior to running the tests: 

ulimit -s 32768

Test the results, but do not stop at errors: 

make -k check

The -k flag is used to make the test suite run through to completion and not stop at the first failure. The GCC test suite is very comprehensive and is almost guaranteed to generate a few failures. To receive a summary of the test suite results, run: 

../gcc-7.1.0/contrib/test_summary

For only the summaries, pipe the output through grep -A7 Summ.

A few unexpected failures cannot always be avoided. The GCC developers are usually aware of these issues, but have not resolved them yet.

Install the package: 

make install

Create a link to satisfy FHS requirements: 

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

Finally, move some misplaced files: 

mv -v /usr/lib/libstdc++*gdb.py /usr/share/gdb/auto-load/usr/lib
mv -v /usr/lib32/libstdc++*gdb.py /usr/share/gdb/auto-load/usr/lib32
mv -v /usr/lib64/libstdc++*gdb.py /usr/share/gdb/auto-load/usr/lib64

10.34.2. Contents of GCC

Installed programs: c++, cc (link to gcc), cpp, g++, gcc, gcov, gcov-tool
Installed libraries: libasan.[a,so], libatomic.[a,so], libcc1.so, libcilkrts.[a,so], libgcc.a, libgcc_eh.a, libgcc_s.so, libgcov.a, libgomp.[a,so], libiberty.a, libitm.[a,so], liblsan.[a,so], liblto_plugin.so, libquadmath.[a,so], libssp.[a,so], libssp_nonshared.a, libstdc++.[a,so], libsupc++.a, libtsan.[a,so], libubsan.[a,so], libvtv.[a,so]
Installed directories: /usr/include/[c++,libiberty], /usr/lib/gcc, /usr/share/gcc-7.1.0

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

gcov

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

gcov-tool

An offline tool to handle gcda counts

libasan

The Address Sanitizer runtime library

libatomic

A GCC support runtime library for atomic operations not supported by hardware

libcc1

Translates API into RPC calls

libcilkrts

Intel® Cilk™ Plus runtime library

libgcc

Contains run-time support for gcc

libgcov

Library that is linked into a program when gcc is instructed to enable profiling

libgomp

GNU implementation of the OpenMP API for multi-platform shared-memory parallel programming in C/C++ and Fortran

libiberty

Contains routines used by various GNU programs, including getopt, obstack, strerror, strtol, and strtoul

libitm

The GNU Transactional Memory Library, which provides transaction support for accesses to a process's memory

liblsan

The Leak Sanitizer runtime library

liblto_plugin

Runtime library for GCC's link-time optimization plugin

libquadmath

The GCC Quad-Precision Math Libarary API

libssp

Contains routines supporting GCC's stack-smashing protection functionality

libstdc++

The standard C++ library

libsupc++

Provides supporting routines for the C++ programming language

libtsan

The Thread Sanitizer runtime library

libubsan

The Undefined Behavior Sanitizer runtime library

libvtv

The Virtual Table Verification runtime library