/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) — 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>
«  <a href="CommandGuide/clang.html">clang - the Clang C, C++, and Objective-C compiler</a>
  ::  
<a class="uplink" href="index.html">Contents</a>
  ::  
<a href="Tooling.html">Choosing the Right Interface for Your Application</a>  »
</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"><stdio.h></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">"Hello world</span><span class="se">\n</span><span class="s">"</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: 'stdio.h' file not found</span>
<span class="gp">#</span>include <stdio.h>
<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 (“a <code class="docutils literal"><span class="pre">-cc1</span></code> option”), 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"><option></span> <span class="pre">...</span></code> to force the driver pass <code class="docutils literal"><span class="pre"><option></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 — 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>
«  <a href="CommandGuide/clang.html">clang - the Clang C, C++, and Objective-C compiler</a>
  ::  
<a class="uplink" href="index.html">Contents</a>
  ::  
<a href="Tooling.html">Choosing the Right Interface for Your Application</a>  »
</p>
</div>
<div class="footer" role="contentinfo">
© Copyright 2007-2017, The Clang Team.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.4.9.
</div>
</body>
</html>
|