2008-12-11 23:24:40 +00:00
|
|
|
<?xml version="1.0" encoding="utf-8" ?>
|
|
|
|
|
<!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" xml:lang="en" lang="en">
|
|
|
|
|
<head>
|
|
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
|
|
|
<meta name="generator" content="Docutils 0.4.1: http://docutils.sourceforge.net/" />
|
2008-12-11 23:33:33 +00:00
|
|
|
<title>Tutorial - Using LLVMC</title>
|
2008-12-11 23:24:40 +00:00
|
|
|
<meta name="author" content="Mikhail Glushenkov <foldr@codedegers.com>" />
|
|
|
|
|
<link rel="stylesheet" href="llvm-rst.css" type="text/css" />
|
|
|
|
|
</head>
|
|
|
|
|
<body>
|
2008-12-11 23:33:33 +00:00
|
|
|
<div class="document" id="tutorial-using-llvmc">
|
|
|
|
|
<h1 class="title">Tutorial - Using LLVMC</h1>
|
2008-12-11 23:24:40 +00:00
|
|
|
<table class="docinfo" frame="void" rules="none">
|
|
|
|
|
<col class="docinfo-name" />
|
|
|
|
|
<col class="docinfo-content" />
|
|
|
|
|
<tbody valign="top">
|
|
|
|
|
<tr><th class="docinfo-name">Author:</th>
|
|
|
|
|
<td>Mikhail Glushenkov <<a class="reference" href="mailto:foldr@codedegers.com">foldr@codedegers.com</a>></td></tr>
|
|
|
|
|
</tbody>
|
|
|
|
|
</table>
|
2008-12-11 23:33:33 +00:00
|
|
|
<p>LLVMC is a generic compiler driver, which plays the same role for LLVM
|
|
|
|
|
as the <tt class="docutils literal"><span class="pre">gcc</span></tt> program does for GCC - the difference being that LLVMC
|
|
|
|
|
is designed to be more adaptable and easier to customize. Most of
|
|
|
|
|
LLVMC functionality is implemented via plugins, which can be loaded
|
|
|
|
|
dynamically or compiled in. This tutorial describes the basic usage
|
|
|
|
|
and configuration of LLVMC.</p>
|
2008-12-11 23:24:40 +00:00
|
|
|
<div class="contents topic">
|
|
|
|
|
<p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
|
|
|
|
|
<ul class="simple">
|
2008-12-11 23:33:33 +00:00
|
|
|
<li><a class="reference" href="#compiling-with-llvmc" id="id3" name="id3">Compiling with LLVMC</a></li>
|
|
|
|
|
<li><a class="reference" href="#using-llvmc-to-generate-toolchain-drivers" id="id4" name="id4">Using LLVMC to generate toolchain drivers</a></li>
|
|
|
|
|
<li><a class="reference" href="#references" id="id5" name="id5">References</a></li>
|
2008-12-11 23:24:40 +00:00
|
|
|
</ul>
|
|
|
|
|
</div>
|
|
|
|
|
<div class="section">
|
2008-12-11 23:33:33 +00:00
|
|
|
<h1><a class="toc-backref" href="#id3" id="compiling-with-llvmc" name="compiling-with-llvmc">Compiling with LLVMC</a></h1>
|
|
|
|
|
<p>In general, LLVMC tries to be command-line compatible with <tt class="docutils literal"><span class="pre">gcc</span></tt> as
|
|
|
|
|
much as possible, so most of the familiar options work:</p>
|
2008-12-11 23:24:40 +00:00
|
|
|
<pre class="literal-block">
|
|
|
|
|
$ llvmc -O3 -Wall hello.cpp
|
|
|
|
|
$ ./a.out
|
|
|
|
|
hello
|
|
|
|
|
</pre>
|
2008-12-11 23:33:33 +00:00
|
|
|
<p>This will invoke <tt class="docutils literal"><span class="pre">llvm-g++</span></tt> under the hood (you can see which
|
|
|
|
|
commands are executed by using the <tt class="docutils literal"><span class="pre">-v</span></tt> option). For further help on
|
|
|
|
|
command-line LLVMC usage, refer to the <tt class="docutils literal"><span class="pre">llvmc</span> <span class="pre">--help</span></tt> output.</p>
|
2008-12-11 23:24:40 +00:00
|
|
|
</div>
|
|
|
|
|
<div class="section">
|
2008-12-11 23:33:33 +00:00
|
|
|
<h1><a class="toc-backref" href="#id4" id="using-llvmc-to-generate-toolchain-drivers" name="using-llvmc-to-generate-toolchain-drivers">Using LLVMC to generate toolchain drivers</a></h1>
|
|
|
|
|
<p>LLVMC plugins are written mostly using TableGen <a class="footnote-reference" href="#id2" id="id1" name="id1">[1]</a>, so you need to
|
|
|
|
|
be familiar with it to get anything done.</p>
|
|
|
|
|
<p>Start by compiling <tt class="docutils literal"><span class="pre">plugins/Simple/Simple.td</span></tt>, which is a primitive
|
|
|
|
|
wrapper for <tt class="docutils literal"><span class="pre">gcc</span></tt>:</p>
|
|
|
|
|
<pre class="literal-block">
|
|
|
|
|
$ cd $LLVM_DIR/tools/llvmc
|
|
|
|
|
$ make DRIVER_NAME=mygcc BUILTIN_PLUGINS=Simple
|
|
|
|
|
$ cat > hello.c
|
|
|
|
|
[...]
|
|
|
|
|
$ mygcc hello.c
|
|
|
|
|
$ ./hello.out
|
|
|
|
|
Hello
|
|
|
|
|
</pre>
|
|
|
|
|
<p>Here we link our plugin with the LLVMC core statically to form an
|
|
|
|
|
executable file called <tt class="docutils literal"><span class="pre">mygcc</span></tt>. It is also possible to build our
|
|
|
|
|
plugin as a standalone dynamic library; this is described in the
|
|
|
|
|
reference manual.</p>
|
|
|
|
|
<p>Contents of the file <tt class="docutils literal"><span class="pre">Simple.td</span></tt> look like this:</p>
|
|
|
|
|
<pre class="literal-block">
|
|
|
|
|
// Include common definitions
|
2008-12-11 23:24:40 +00:00
|
|
|
include "llvm/CompilerDriver/Common.td"
|
|
|
|
|
|
2008-12-11 23:33:33 +00:00
|
|
|
// Tool descriptions
|
|
|
|
|
def gcc : Tool<
|
|
|
|
|
[(in_language "c"),
|
|
|
|
|
(out_language "executable"),
|
|
|
|
|
(output_suffix "out"),
|
|
|
|
|
(cmd_line "gcc $INFILE -o $OUTFILE"),
|
|
|
|
|
(sink)
|
2008-12-11 23:24:40 +00:00
|
|
|
]>;
|
|
|
|
|
|
2008-12-11 23:33:33 +00:00
|
|
|
// Language map
|
|
|
|
|
def LanguageMap : LanguageMap<[LangToSuffixes<"c", ["c"]>]>;
|
2008-12-11 23:24:40 +00:00
|
|
|
|
2008-12-11 23:33:33 +00:00
|
|
|
// Compilation graph
|
|
|
|
|
def CompilationGraph : CompilationGraph<[Edge<"root", "gcc">]>;
|
|
|
|
|
</pre>
|
|
|
|
|
<p>As you can see, this file consists of three parts: tool descriptions,
|
|
|
|
|
language map, and the compilation graph definition.</p>
|
|
|
|
|
<p>At the heart of LLVMC is the idea of a compilation graph: vertices in
|
|
|
|
|
this graph are tools, and edges represent a transformation path
|
|
|
|
|
between two tools (for example, assembly source produced by the
|
|
|
|
|
compiler can be transformed into executable code by an assembler). The
|
|
|
|
|
compilation graph is basically a list of edges; a special node named
|
|
|
|
|
<tt class="docutils literal"><span class="pre">root</span></tt> is used to mark graph entry points.</p>
|
|
|
|
|
<p>Tool descriptions are represented as property lists: most properties
|
|
|
|
|
in the example above should be self-explanatory; the <tt class="docutils literal"><span class="pre">sink</span></tt> property
|
|
|
|
|
means that all options lacking an explicit description should be
|
|
|
|
|
forwarded to this tool.</p>
|
|
|
|
|
<p>The <tt class="docutils literal"><span class="pre">LanguageMap</span></tt> associates a language name with a list of suffixes
|
|
|
|
|
and is used for deciding which toolchain corresponds to a given input
|
|
|
|
|
file.</p>
|
|
|
|
|
<p>To learn more about LLVMC customization, refer to the reference
|
|
|
|
|
manual and plugin source code in the <tt class="docutils literal"><span class="pre">plugins</span></tt> directory.</p>
|
2008-12-11 23:24:40 +00:00
|
|
|
</div>
|
|
|
|
|
<div class="section">
|
2008-12-11 23:33:33 +00:00
|
|
|
<h1><a class="toc-backref" href="#id5" id="references" name="references">References</a></h1>
|
|
|
|
|
<table class="docutils footnote" frame="void" id="id2" rules="none">
|
2008-12-11 23:24:40 +00:00
|
|
|
<colgroup><col class="label" /><col /></colgroup>
|
|
|
|
|
<tbody valign="top">
|
2008-12-11 23:33:33 +00:00
|
|
|
<tr><td class="label"><a class="fn-backref" href="#id1" name="id2">[1]</a></td><td>TableGen Fundamentals
|
2008-12-11 23:24:40 +00:00
|
|
|
<a class="reference" href="http://llvm.cs.uiuc.edu/docs/TableGenFundamentals.html">http://llvm.cs.uiuc.edu/docs/TableGenFundamentals.html</a></td></tr>
|
|
|
|
|
</tbody>
|
|
|
|
|
</table>
|
2008-12-11 23:43:14 +00:00
|
|
|
<hr />
|
2008-12-11 23:24:40 +00:00
|
|
|
<address>
|
2008-12-11 23:43:14 +00:00
|
|
|
<a href="http://jigsaw.w3.org/css-validator/check/referer"><img src="http://jigsaw.w3.org/css-validator/images/vcss-blue"
|
|
|
|
|
alt="Valid CSS" /></a>
|
|
|
|
|
<a href="http://validator.w3.org/check?uri=referer"><img src="http://www.w3.org/Icons/valid-xhtml10-blue"
|
|
|
|
|
alt="Valid XHTML 1.0 Transitional"/></a>
|
2008-12-11 23:24:40 +00:00
|
|
|
|
2008-12-11 23:43:14 +00:00
|
|
|
<a href="mailto:foldr@codedgers.com">Mikhail Glushenkov</a><br />
|
|
|
|
|
<a href="http://llvm.org">LLVM Compiler Infrastructure</a><br />
|
2008-12-11 23:24:40 +00:00
|
|
|
|
|
|
|
|
Last modified: $Date: 2008-12-11 11:34:48 -0600 (Thu, 11 Dec 2008) $
|
|
|
|
|
</address>
|
|
|
|
|
</div>
|
|
|
|
|
</div>
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
