Top Level - GNU Compiler Collection (GCC) Internals
Description: GNU Compiler Collection (GCC) Internals

Next: gcc Directory, Previous: Configure Terms, Up: Source Tree

### 6.2 Top Level Source Directory

The top level source directory in a GCC distribution contains several files and directories that are shared with other software distributions such as that of GNU Binutils. It also contains several subdirectories that contain parts of GCC and its runtime libraries:

`boehm-gc`
  The Boehm conservative garbage collector, used as part of the Java runtime library.
`config`
  Autoconf macros and Makefile fragments used throughout the tree.
`contrib`
  Contributed scripts that may be found useful in conjunction with GCC. One of these, `contrib/texi2pod.pl`, is used to generate man pages from Texinfo manuals as part of the GCC build process.
`fixincludes`
  The support for fixing system headers to work with GCC. See `fixincludes/README` for more information. The headers fixed by this mechanism are installed in `libsubdir/include-fixed`. Along with those headers, `README-fixinc` is also installed, as `libsubdir/include-fixed/README`.
`gcc`
  The main sources of GCC itself (except for runtime libraries), including optimizers, support for different target architectures, language front ends, and testsuites. See The `gcc` Subdirectory, for details.
`gnattools`
  Support tools for GNAT.
`include`
  Headers for the `libiberty` library.
`intl`
  GNU `libintl`, from GNU `gettext`, for systems which do not include it in `libc`.
`libada`
  The Ada runtime library.
`libcpp`
  The C preprocessor library.
`libdecnumber`
  The Decimal Float support library.
`libffi`
  The `libffi` library, used as part of the Java runtime library.
`libgcc`
  The GCC runtime library.
`libgfortran`
  The Fortran runtime library.
`libgo`
  The Go runtime library. The bulk of this library is mirrored from the master Go repository.
`libgomp`
  The GNU OpenMP runtime library.
`libiberty`
  The `libiberty` library, used for portability and for some generally useful data structures and algorithms. See Introduction, for more information about this library.
`libjava`
  The Java runtime library.
`libmudflap`
  The `libmudflap` library, used for instrumenting pointer and array dereferencing operations.
`libobjc`
  The Objective-C and Objective-C++ runtime library.
`libssp`
  The Stack protector runtime library.
`libstdc++-v3`
  The C++ runtime library.
`lto-plugin`
  Plugin used by `gold` if link-time optimizations are enabled.
`maintainer-scripts`
  Scripts used by the `gccadmin` account on `gcc.gnu.org`.
`zlib`
  The `zlib` compression library, used by the Java front end, as part of the Java runtime library, and for compressing and uncompressing GCC's intermediate language in LTO object files.

The build system in the top level directory, including how recursion into subdirectories works and how building runtime libraries for multilibs is handled, is documented in a separate manual, included with GNU Binutils. See GNU configure and build system, for details.