blob: 948527e4d6faf53c8ad65f9adf96e942253900a8 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 1988-2015 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being "Funding Free Software", the Front-Cover
Texts being (a) (see below), and with the Back-Cover Texts being (b)
(see below). A copy of the license is included in the section entitled
"GNU Free Documentation License".
(a) The FSF's Front-Cover Text is:
A GNU Manual
(b) The FSF's Back-Cover Text is:
You have freedom to copy and modify this GNU Manual, like GNU
software. Copies published by the Free Software Foundation raise
funds for GNU development. -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Compiler Collection (GCC) Internals: Top Level</title>
<meta name="description" content="GNU Compiler Collection (GCC) Internals: Top Level">
<meta name="keywords" content="GNU Compiler Collection (GCC) Internals: Top Level">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Option-Index.html#Option-Index" rel="index" title="Option Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Source-Tree.html#Source-Tree" rel="up" title="Source Tree">
<link href="gcc-Directory.html#gcc-Directory" rel="next" title="gcc Directory">
<link href="Configure-Terms.html#Configure-Terms" rel="prev" title="Configure Terms">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Top-Level"></a>
<div class="header">
<p>
Next: <a href="gcc-Directory.html#gcc-Directory" accesskey="n" rel="next">gcc Directory</a>, Previous: <a href="Configure-Terms.html#Configure-Terms" accesskey="p" rel="prev">Configure Terms</a>, Up: <a href="Source-Tree.html#Source-Tree" accesskey="u" rel="up">Source Tree</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Top-Level-Source-Directory"></a>
<h3 class="section">6.2 Top Level Source Directory</h3>
<p>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:
</p>
<dl compact="compact">
<dt><samp>boehm-gc</samp></dt>
<dd><p>The Boehm conservative garbage collector, used as part of the Java
runtime library.
</p>
</dd>
<dt><samp>config</samp></dt>
<dd><p>Autoconf macros and Makefile fragments used throughout the tree.
</p>
</dd>
<dt><samp>contrib</samp></dt>
<dd><p>Contributed scripts that may be found useful in conjunction with GCC.
One of these, <samp>contrib/texi2pod.pl</samp>, is used to generate man
pages from Texinfo manuals as part of the GCC build process.
</p>
</dd>
<dt><samp>fixincludes</samp></dt>
<dd><p>The support for fixing system headers to work with GCC. See
<samp>fixincludes/README</samp> for more information. The headers fixed by
this mechanism are installed in <samp><var>libsubdir</var>/include-fixed</samp>.
Along with those headers, <samp>README-fixinc</samp> is also installed, as
<samp><var>libsubdir</var>/include-fixed/README</samp>.
</p>
</dd>
<dt><samp>gcc</samp></dt>
<dd><p>The main sources of GCC itself (except for runtime libraries),
including optimizers, support for different target architectures,
language front ends, and testsuites. See <a href="gcc-Directory.html#gcc-Directory">The
<samp>gcc</samp> Subdirectory</a>, for details.
</p>
</dd>
<dt><samp>gnattools</samp></dt>
<dd><p>Support tools for GNAT.
</p>
</dd>
<dt><samp>include</samp></dt>
<dd><p>Headers for the <code>libiberty</code> library.
</p>
</dd>
<dt><samp>intl</samp></dt>
<dd><p>GNU <code>libintl</code>, from GNU <code>gettext</code>, for systems which do not
include it in <code>libc</code>.
</p>
</dd>
<dt><samp>libada</samp></dt>
<dd><p>The Ada runtime library.
</p>
</dd>
<dt><samp>libatomic</samp></dt>
<dd><p>The runtime support library for atomic operations (e.g. for <code>__sync</code>
and <code>__atomic</code>).
</p>
</dd>
<dt><samp>libcpp</samp></dt>
<dd><p>The C preprocessor library.
</p>
</dd>
<dt><samp>libdecnumber</samp></dt>
<dd><p>The Decimal Float support library.
</p>
</dd>
<dt><samp>libffi</samp></dt>
<dd><p>The <code>libffi</code> library, used as part of the Java runtime library.
</p>
</dd>
<dt><samp>libgcc</samp></dt>
<dd><p>The GCC runtime library.
</p>
</dd>
<dt><samp>libgfortran</samp></dt>
<dd><p>The Fortran runtime library.
</p>
</dd>
<dt><samp>libgo</samp></dt>
<dd><p>The Go runtime library. The bulk of this library is mirrored from the
<a href="http://code.google.com/p/go/">master Go repository</a>.
</p>
</dd>
<dt><samp>libgomp</samp></dt>
<dd><p>The GNU OpenMP runtime library.
</p>
</dd>
<dt><samp>libiberty</samp></dt>
<dd><p>The <code>libiberty</code> library, used for portability and for some
generally useful data structures and algorithms. See <a href="http://gcc.gnu.org/onlinedocs/libiberty/index.html#Top">Introduction</a> in <cite><small>GNU</small> libiberty</cite>, for more information
about this library.
</p>
</dd>
<dt><samp>libitm</samp></dt>
<dd><p>The runtime support library for transactional memory.
</p>
</dd>
<dt><samp>libjava</samp></dt>
<dd><p>The Java runtime library.
</p>
</dd>
<dt><samp>libobjc</samp></dt>
<dd><p>The Objective-C and Objective-C++ runtime library.
</p>
</dd>
<dt><samp>libquadmath</samp></dt>
<dd><p>The runtime support library for quad-precision math operations.
</p>
</dd>
<dt><samp>libssp</samp></dt>
<dd><p>The Stack protector runtime library.
</p>
</dd>
<dt><samp>libstdc++-v3</samp></dt>
<dd><p>The C++ runtime library.
</p>
</dd>
<dt><samp>lto-plugin</samp></dt>
<dd><p>Plugin used by the linker if link-time optimizations are enabled.
</p>
</dd>
<dt><samp>maintainer-scripts</samp></dt>
<dd><p>Scripts used by the <code>gccadmin</code> account on <code>gcc.gnu.org</code>.
</p>
</dd>
<dt><samp>zlib</samp></dt>
<dd><p>The <code>zlib</code> compression library, used by the Java front end, as
part of the Java runtime library, and for compressing and uncompressing
GCC&rsquo;s intermediate language in LTO object files.
</p></dd>
</dl>
<p>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 <a href="../configure/index.html#Top">GNU configure and build system</a> in <cite>The GNU configure and build system</cite>, for details.
</p>
<hr>
<div class="header">
<p>
Next: <a href="gcc-Directory.html#gcc-Directory" accesskey="n" rel="next">gcc Directory</a>, Previous: <a href="Configure-Terms.html#Configure-Terms" accesskey="p" rel="prev">Configure Terms</a>, Up: <a href="Source-Tree.html#Source-Tree" accesskey="u" rel="up">Source Tree</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>