This file is indexed.

/usr/share/doc/clang-3.8-doc/html/FAQ.html is in clang-3.8-doc 1:3.8.1-24.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">


<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
    <title>Frequently Asked Questions (FAQ) &#8212; Clang 3.8 documentation</title>
    
    <link rel="stylesheet" href="_static/haiku.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    './',
        VERSION:     '3.8',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
      };
    </script>
    <script type="text/javascript" src="_static/jquery.js"></script>
    <script type="text/javascript" src="_static/underscore.js"></script>
    <script type="text/javascript" src="_static/doctools.js"></script>
    <script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
    <link rel="index" title="Index" href="genindex.html" />
    <link rel="search" title="Search" href="search.html" />
    <link rel="top" title="Clang 3.8 documentation" href="index.html" />
    <link rel="next" title="Choosing the Right Interface for Your Application" href="Tooling.html" />
    <link rel="prev" title="clang - the Clang C, C++, and Objective-C compiler" href="CommandGuide/clang.html" /> 
  </head>
  <body role="document">
      <div class="header" role="banner"><h1 class="heading"><a href="index.html">
          <span>Clang 3.8 documentation</span></a></h1>
        <h2 class="heading"><span>Frequently Asked Questions (FAQ)</span></h2>
      </div>
      <div class="topnav" role="navigation" aria-label="top navigation">
      
        <p>
        «&#160;&#160;<a href="CommandGuide/clang.html">clang - the Clang C, C++, and Objective-C compiler</a>
        &#160;&#160;::&#160;&#160;
        <a class="uplink" href="index.html">Contents</a>
        &#160;&#160;::&#160;&#160;
        <a href="Tooling.html">Choosing the Right Interface for Your Application</a>&#160;&#160;»
        </p>

      </div>
      <div class="content">
        
        
  <div class="section" id="frequently-asked-questions-faq">
<h1>Frequently Asked Questions (FAQ)<a class="headerlink" href="#frequently-asked-questions-faq" title="Permalink to this headline"></a></h1>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#driver" id="id1">Driver</a><ul>
<li><a class="reference internal" href="#i-run-clang-cc1-and-get-weird-errors-about-missing-headers" id="id2">I run <code class="docutils literal"><span class="pre">clang</span> <span class="pre">-cc1</span> <span class="pre">...</span></code> and get weird errors about missing headers</a></li>
<li><a class="reference internal" href="#i-get-errors-about-some-headers-being-missing-stddef-h-stdarg-h" id="id3">I get errors about some headers being missing (<code class="docutils literal"><span class="pre">stddef.h</span></code>, <code class="docutils literal"><span class="pre">stdarg.h</span></code>)</a></li>
</ul>
</li>
</ul>
</div>
<div class="section" id="driver">
<h2><a class="toc-backref" href="#id1">Driver</a><a class="headerlink" href="#driver" title="Permalink to this headline"></a></h2>
<div class="section" id="i-run-clang-cc1-and-get-weird-errors-about-missing-headers">
<h3><a class="toc-backref" href="#id2">I run <code class="docutils literal"><span class="pre">clang</span> <span class="pre">-cc1</span> <span class="pre">...</span></code> and get weird errors about missing headers</a><a class="headerlink" href="#i-run-clang-cc1-and-get-weird-errors-about-missing-headers" title="Permalink to this headline"></a></h3>
<p>Given this source file:</p>
<div class="highlight-c"><div class="highlight"><pre><span></span><span class="cp">#include</span> <span class="cpf">&lt;stdio.h&gt;</span><span class="cp"></span>

<span class="kt">int</span> <span class="nf">main</span><span class="p">()</span> <span class="p">{</span>
  <span class="n">printf</span><span class="p">(</span><span class="s">&quot;Hello world</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">);</span>
<span class="p">}</span>
</pre></div>
</div>
<p>If you run:</p>
<div class="highlight-console"><div class="highlight"><pre><span></span><span class="gp">$</span> clang -cc1 hello.c
<span class="go">hello.c:1:10: fatal error: &#39;stdio.h&#39; file not found</span>
<span class="gp">#</span>include &lt;stdio.h&gt;
<span class="go">         ^</span>
<span class="go">1 error generated.</span>
</pre></div>
</div>
<p><code class="docutils literal"><span class="pre">clang</span> <span class="pre">-cc1</span></code> is the frontend, <code class="docutils literal"><span class="pre">clang</span></code> is the <a class="reference internal" href="DriverInternals.html"><span class="doc">driver</span></a>.  The driver invokes the frontend with options appropriate
for your system.  To see these options, run:</p>
<div class="highlight-console"><div class="highlight"><pre><span></span><span class="gp">$</span> clang -### -c hello.c
</pre></div>
</div>
<p>Some clang command line options are driver-only options, some are frontend-only
options.  Frontend-only options are intended to be used only by clang developers.
Users should not run <code class="docutils literal"><span class="pre">clang</span> <span class="pre">-cc1</span></code> directly, because <code class="docutils literal"><span class="pre">-cc1</span></code> options are not
guaranteed to be stable.</p>
<p>If you want to use a frontend-only option (&#8220;a <code class="docutils literal"><span class="pre">-cc1</span></code> option&#8221;), for example
<code class="docutils literal"><span class="pre">-ast-dump</span></code>, then you need to take the <code class="docutils literal"><span class="pre">clang</span> <span class="pre">-cc1</span></code> line generated by the
driver and add the option you need.  Alternatively, you can run
<code class="docutils literal"><span class="pre">clang</span> <span class="pre">-Xclang</span> <span class="pre">&lt;option&gt;</span> <span class="pre">...</span></code> to force the driver pass <code class="docutils literal"><span class="pre">&lt;option&gt;</span></code> to
<code class="docutils literal"><span class="pre">clang</span> <span class="pre">-cc1</span></code>.</p>
</div>
<div class="section" id="i-get-errors-about-some-headers-being-missing-stddef-h-stdarg-h">
<h3><a class="toc-backref" href="#id3">I get errors about some headers being missing (<code class="docutils literal"><span class="pre">stddef.h</span></code>, <code class="docutils literal"><span class="pre">stdarg.h</span></code>)</a><a class="headerlink" href="#i-get-errors-about-some-headers-being-missing-stddef-h-stdarg-h" title="Permalink to this headline"></a></h3>
<p>Some header files (<code class="docutils literal"><span class="pre">stddef.h</span></code>, <code class="docutils literal"><span class="pre">stdarg.h</span></code>, and others) are shipped with
Clang &#8212; these are called builtin includes.  Clang searches for them in a
directory relative to the location of the <code class="docutils literal"><span class="pre">clang</span></code> binary.  If you moved the
<code class="docutils literal"><span class="pre">clang</span></code> binary, you need to move the builtin headers, too.</p>
<p>More information can be found in the <a class="reference internal" href="LibTooling.html#libtooling-builtin-includes"><span class="std std-ref">Builtin includes</span></a>
section.</p>
</div>
</div>
</div>


      </div>
      <div class="bottomnav" role="navigation" aria-label="bottom navigation">
      
        <p>
        «&#160;&#160;<a href="CommandGuide/clang.html">clang - the Clang C, C++, and Objective-C compiler</a>
        &#160;&#160;::&#160;&#160;
        <a class="uplink" href="index.html">Contents</a>
        &#160;&#160;::&#160;&#160;
        <a href="Tooling.html">Choosing the Right Interface for Your Application</a>&#160;&#160;»
        </p>

      </div>

    <div class="footer" role="contentinfo">
        &#169; Copyright 2007-2017, The Clang Team.
      Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.4.9.
    </div>
  </body>
</html>