You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

99 lines
5.1 KiB
HTML

<html lang="en">
<head>
<title>Headers - GNU Compiler Collection (GCC) Internals</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Compiler Collection (GCC) Internals">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="gcc-Directory.html#gcc-Directory" title="gcc Directory">
<link rel="prev" href="Library-Files.html#Library-Files" title="Library Files">
<link rel="next" href="Documentation.html#Documentation" title="Documentation">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
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.-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="Headers"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Documentation.html#Documentation">Documentation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Library-Files.html#Library-Files">Library Files</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="gcc-Directory.html#gcc-Directory">gcc Directory</a>
<hr>
</div>
<h4 class="subsection">6.3.6 Headers Installed by GCC</h4>
<p>In general, GCC expects the system C library to provide most of the
headers to be used with it. However, GCC will fix those headers if
necessary to make them work with GCC, and will install some headers
required of freestanding implementations. These headers are installed
in <samp><var>libsubdir</var><span class="file">/include</span></samp>. Headers for non-C runtime
libraries are also installed by GCC; these are not documented here.
(FIXME: document them somewhere.)
<p>Several of the headers GCC installs are in the <samp><span class="file">ginclude</span></samp>
directory. These headers, <samp><span class="file">iso646.h</span></samp>,
<samp><span class="file">stdarg.h</span></samp>, <samp><span class="file">stdbool.h</span></samp>, and <samp><span class="file">stddef.h</span></samp>,
are installed in <samp><var>libsubdir</var><span class="file">/include</span></samp>,
unless the target Makefile fragment (see <a href="Target-Fragment.html#Target-Fragment">Target Fragment</a>)
overrides this by setting <code>USER_H</code>.
<p>In addition to these headers and those generated by fixing system
headers to work with GCC, some other headers may also be installed in
<samp><var>libsubdir</var><span class="file">/include</span></samp>. <samp><span class="file">config.gcc</span></samp> may set
<code>extra_headers</code>; this specifies additional headers under
<samp><span class="file">config</span></samp> to be installed on some systems.
<p>GCC installs its own version of <code>&lt;float.h&gt;</code>, from <samp><span class="file">ginclude/float.h</span></samp>.
This is done to cope with command-line options that change the
representation of floating point numbers.
<p>GCC also installs its own version of <code>&lt;limits.h&gt;</code>; this is generated
from <samp><span class="file">glimits.h</span></samp>, together with <samp><span class="file">limitx.h</span></samp> and
<samp><span class="file">limity.h</span></samp> if the system also has its own version of
<code>&lt;limits.h&gt;</code>. (GCC provides its own header because it is
required of ISO C freestanding implementations, but needs to include
the system header from its own header as well because other standards
such as POSIX specify additional values to be defined in
<code>&lt;limits.h&gt;</code>.) The system's <code>&lt;limits.h&gt;</code> header is used via
<samp><var>libsubdir</var><span class="file">/include/syslimits.h</span></samp>, which is copied from
<samp><span class="file">gsyslimits.h</span></samp> if it does not need fixing to work with GCC; if it
needs fixing, <samp><span class="file">syslimits.h</span></samp> is the fixed copy.
<p>GCC can also install <code>&lt;tgmath.h&gt;</code>. It will do this when
<samp><span class="file">config.gcc</span></samp> sets <code>use_gcc_tgmath</code> to <code>yes</code>.
</body></html>