%general-entities; ]> GCC-&gcc-version; GCC <para>The GCC package contains the GNU compiler collection, which includes the C and C++ compilers.</para> </sect2> <sect2 role="installation"> <title>Installation of GCC The following patch contains a number of updates to the &gcc-version; branch by the GCC developers: patch -Np1 -i ../&gcc-branch_update-patch; 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" \ CXX="g++ -isystem /usr/include" \ LDFLAGS="-Wl,-rpath-link,/usr/lib:/lib" \ ../gcc-&gcc-version;/configure --prefix=/usr \ --libexecdir=/usr/lib --enable-languages=c,c++ \ --disable-multilib --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 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-&gcc-version;/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 Many packages use the name cc to call the C compiler. To satisfy those packages, create a symlink: ln -sv gcc /usr/bin/cc Finally, move a misplaced file: mv -v /usr/lib/libstdc++*gdb.py /usr/share/gdb/auto-load/usr/lib Contents of GCC Installed programs Installed libraries Installed directories c++, cc (link to gcc), cpp, g++, gcc, gcov, gcov-tool 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] /usr/include/[c++,libiberty], /usr/lib/gcc, /usr/share/gcc-&gcc-version; Short Descriptions cc The C compiler cc cpp The C preprocessor; it is used by the compiler to expand the #include, #define, and similar statements in the source files cpp c++ The C++ compiler c++ g++ The C++ compiler g++ gcc The C compiler gcc gcov A coverage testing tool; it is used to analyze programs to determine where optimizations will have the most effect gcov gcov-tool An offline tool to handle gcda counts gcov-tool libasan The Address Sanitizer runtime library libasan libatomic A GCC support runtime library for atomic operations not supported by hardware libatomic libcc1 Translates API into RPC calls libcc1 libcilkrts Intel® Cilk™ Plus runtime library libcilkrts libgcc Contains run-time support for gcc libgcc* libgcov Library that is linked into a program when gcc is instructed to enable profiling libgcov libgomp GNU implementation of the OpenMP API for multi-platform shared-memory parallel programming in C/C++ and Fortran libgomp libiberty Contains routines used by various GNU programs, including getopt, obstack, strerror, strtol, and strtoul libiberty libitm The GNU Transactional Memory Library, which provides transaction support for accesses to a process's memory libitm* liblsan The Leak Sanitizer runtime library liblsan liblto_plugin Runtime library for GCC's link-time optimization plugin liblto_plugin libquadmath The GCC Quad-Precision Math Libarary API libquadmath* libssp Contains routines supporting GCC's stack-smashing protection functionality libssp* libstdc++ The standard C++ library libstdc++ libsupc++ Provides supporting routines for the C++ programming language libsupc++ libtsan The Thread Sanitizer runtime library libtsan libubsan The Undefined Behavior Sanitizer runtime library libubsan libvtv The Virtual Table Verification runtime library libvtv