2003-11-22 00:38:41 +00:00
|
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
|
|
|
|
"http://www.w3.org/TR/html4/strict.dtd">
|
|
|
|
<html>
|
|
|
|
<head>
|
2004-11-18 18:38:58 +00:00
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
2012-04-19 20:20:34 +00:00
|
|
|
<link rel="stylesheet" href="_static/llvm.css" type="text/css">
|
2011-12-13 17:55:30 +00:00
|
|
|
<title>LLVM 3.1 Release Notes</title>
|
2003-11-22 00:38:41 +00:00
|
|
|
</head>
|
|
|
|
<body>
|
|
|
|
|
2011-12-13 17:55:30 +00:00
|
|
|
<h1>LLVM 3.1 Release Notes</h1>
|
2008-10-13 02:08:34 +00:00
|
|
|
|
2011-12-06 23:33:07 +00:00
|
|
|
<div>
|
|
|
|
<img style="float:right" src="http://llvm.org/img/DragonSmall.png"
|
|
|
|
width="136" height="136" alt="LLVM Dragon Logo">
|
|
|
|
</div>
|
2010-03-17 04:02:39 +00:00
|
|
|
|
2003-10-02 04:57:28 +00:00
|
|
|
<ol>
|
2003-11-22 00:38:41 +00:00
|
|
|
<li><a href="#intro">Introduction</a></li>
|
2008-10-13 18:01:01 +00:00
|
|
|
<li><a href="#subproj">Sub-project Status Update</a></li>
|
2011-12-13 17:55:30 +00:00
|
|
|
<li><a href="#externalproj">External Projects Using LLVM 3.1</a></li>
|
|
|
|
<li><a href="#whatsnew">What's New in LLVM?</a></li>
|
2004-04-30 22:17:12 +00:00
|
|
|
<li><a href="GettingStarted.html">Installation Instructions</a></li>
|
2008-10-14 16:23:02 +00:00
|
|
|
<li><a href="#knownproblems">Known Problems</a></li>
|
2003-11-22 00:38:41 +00:00
|
|
|
<li><a href="#additionalinfo">Additional Information</a></li>
|
2003-10-02 04:57:28 +00:00
|
|
|
</ol>
|
|
|
|
|
2004-05-23 21:07:27 +00:00
|
|
|
<div class="doc_author">
|
2011-04-09 02:13:37 +00:00
|
|
|
<p>Written by the <a href="http://llvm.org/">LLVM Team</a></p>
|
2003-11-22 00:38:41 +00:00
|
|
|
</div>
|
2003-10-02 04:57:28 +00:00
|
|
|
|
2011-12-13 17:55:30 +00:00
|
|
|
<h1 style="color:red">These are in-progress notes for the upcoming LLVM 3.1
|
2010-01-28 01:14:43 +00:00
|
|
|
release.<br>
|
|
|
|
You may prefer the
|
2011-12-13 17:55:30 +00:00
|
|
|
<a href="http://llvm.org/releases/3.0/docs/ReleaseNotes.html">LLVM 3.0
|
2010-05-03 23:51:05 +00:00
|
|
|
Release Notes</a>.</h1>
|
2010-01-28 01:14:43 +00:00
|
|
|
|
2003-10-02 04:57:28 +00:00
|
|
|
<!-- *********************************************************************** -->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h2>
|
2003-11-22 00:38:41 +00:00
|
|
|
<a name="intro">Introduction</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h2>
|
2003-10-02 04:57:28 +00:00
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2003-11-22 00:38:41 +00:00
|
|
|
|
2008-10-13 17:57:36 +00:00
|
|
|
<p>This document contains the release notes for the LLVM Compiler
|
2011-12-13 17:55:30 +00:00
|
|
|
Infrastructure, release 3.1. Here we describe the status of LLVM, including
|
2011-11-27 18:47:37 +00:00
|
|
|
major improvements from the previous release, improvements in various
|
|
|
|
subprojects of LLVM, and some of the current users of the code.
|
2011-10-26 18:46:16 +00:00
|
|
|
All LLVM releases may be downloaded from
|
|
|
|
the <a href="http://llvm.org/releases/">LLVM releases web site</a>.</p>
|
2003-10-02 16:38:05 +00:00
|
|
|
|
2004-12-07 08:04:13 +00:00
|
|
|
<p>For more information about LLVM, including information about the latest
|
2011-10-26 18:46:16 +00:00
|
|
|
release, please check out the <a href="http://llvm.org/">main LLVM web
|
|
|
|
site</a>. If you have questions or comments,
|
|
|
|
the <a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev">LLVM
|
|
|
|
Developer's Mailing List</a> is a good place to send them.</p>
|
2003-10-02 04:57:28 +00:00
|
|
|
|
2011-10-26 18:46:16 +00:00
|
|
|
<p>Note that if you are reading this file from a Subversion checkout or the main
|
|
|
|
LLVM web page, this document applies to the <i>next</i> release, not the
|
|
|
|
current one. To see the release notes for a specific release, please see the
|
|
|
|
<a href="http://llvm.org/releases/">releases page</a>.</p>
|
2003-11-22 00:38:41 +00:00
|
|
|
|
|
|
|
</div>
|
2011-11-28 18:20:09 +00:00
|
|
|
|
|
|
|
|
2008-10-13 18:01:01 +00:00
|
|
|
<!-- *********************************************************************** -->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h2>
|
2008-10-13 18:01:01 +00:00
|
|
|
<a name="subproj">Sub-project Status Update</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h2>
|
2008-10-13 18:01:01 +00:00
|
|
|
<!-- *********************************************************************** -->
|
2006-04-18 06:18:36 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2011-10-26 18:46:16 +00:00
|
|
|
|
2011-12-13 17:55:30 +00:00
|
|
|
<p>The LLVM 3.1 distribution currently consists of code from the core LLVM
|
2011-10-26 18:46:16 +00:00
|
|
|
repository (which roughly includes the LLVM optimizers, code generators and
|
2011-11-10 20:15:40 +00:00
|
|
|
supporting tools), and the Clang repository. In
|
2011-10-26 18:46:16 +00:00
|
|
|
addition to this code, the LLVM Project includes other sub-projects that are
|
|
|
|
in development. Here we include updates on these subprojects.</p>
|
2008-06-05 06:57:39 +00:00
|
|
|
|
2008-06-08 21:58:17 +00:00
|
|
|
<!--=========================================================================-->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h3>
|
2008-10-13 18:11:54 +00:00
|
|
|
<a name="clang">Clang: C/C++/Objective-C Frontend Toolkit</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h3>
|
2008-06-08 21:58:17 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2008-06-08 21:58:17 +00:00
|
|
|
|
2010-04-26 17:42:18 +00:00
|
|
|
<p><a href="http://clang.llvm.org/">Clang</a> is an LLVM front end for the C,
|
2011-10-26 18:46:16 +00:00
|
|
|
C++, and Objective-C languages. Clang aims to provide a better user
|
|
|
|
experience through expressive diagnostics, a high level of conformance to
|
|
|
|
language standards, fast compilation, and low memory use. Like LLVM, Clang
|
|
|
|
provides a modular, library-based architecture that makes it suitable for
|
|
|
|
creating or integrating with other development tools. Clang is considered a
|
|
|
|
production-quality compiler for C, Objective-C, C++ and Objective-C++ on x86
|
2011-11-27 18:47:37 +00:00
|
|
|
(32- and 64-bit), and for Darwin/ARM targets.</p>
|
2010-01-28 01:14:43 +00:00
|
|
|
|
2011-12-13 17:55:30 +00:00
|
|
|
<p>In the LLVM 3.1 time-frame, the Clang team has made many improvements:</p>
|
2011-10-15 00:48:01 +00:00
|
|
|
<ul>
|
2012-05-08 23:34:38 +00:00
|
|
|
<li>C++11 support is greatly expanded including lambdas, initializer lists, constexpr, user-defined literals, and atomics.</li>
|
2011-12-13 17:55:30 +00:00
|
|
|
<li>...</li>
|
2011-10-15 00:48:01 +00:00
|
|
|
</ul>
|
2011-12-13 17:55:30 +00:00
|
|
|
|
|
|
|
<p>For more details about the changes to Clang since the 2.9 release, see the
|
2011-11-29 00:32:43 +00:00
|
|
|
<a href="http://clang.llvm.org/docs/ReleaseNotes.html">Clang release notes</a>
|
|
|
|
</p>
|
2011-10-15 00:48:01 +00:00
|
|
|
|
2011-11-28 18:20:09 +00:00
|
|
|
|
2011-04-06 08:07:40 +00:00
|
|
|
<p>If Clang rejects your code but another compiler accepts it, please take a
|
2011-10-26 18:46:16 +00:00
|
|
|
look at the <a href="http://clang.llvm.org/compatibility.html">language
|
|
|
|
compatibility</a> guide to make sure this is not intentional or a known
|
|
|
|
issue.</p>
|
2011-03-10 07:43:44 +00:00
|
|
|
|
2008-10-13 18:11:54 +00:00
|
|
|
</div>
|
|
|
|
|
2009-10-13 17:48:04 +00:00
|
|
|
<!--=========================================================================-->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h3>
|
2011-04-04 11:09:08 +00:00
|
|
|
<a name="dragonegg">DragonEgg: GCC front-ends, LLVM back-end</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h3>
|
2009-10-13 17:48:04 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2011-10-26 18:46:16 +00:00
|
|
|
<p><a href="http://dragonegg.llvm.org/">DragonEgg</a> is a
|
|
|
|
<a href="http://gcc.gnu.org/wiki/plugins">gcc plugin</a> that replaces GCC's
|
2012-05-11 19:59:43 +00:00
|
|
|
optimizers and code generators with LLVM's. It works with gcc-4.5 and gcc-4.6
|
|
|
|
(and partially with gcc-4.7), can target the x86-32/x86-64 and ARM processor
|
|
|
|
families, and has been successfully used on the Darwin, FreeBSD, KFreeBSD,
|
|
|
|
Linux and OpenBSD platforms. It fully supports Ada, C, C++ and Fortran. It
|
|
|
|
has partial support for Go, Java, Obj-C and Obj-C++.</p>
|
2011-10-26 18:46:16 +00:00
|
|
|
|
2011-12-13 17:55:30 +00:00
|
|
|
<p>The 3.1 release has the following notable changes:</p>
|
2010-04-02 09:23:15 +00:00
|
|
|
|
2011-11-27 18:47:37 +00:00
|
|
|
<ul>
|
2011-11-10 18:44:29 +00:00
|
|
|
|
2012-05-11 19:59:43 +00:00
|
|
|
<li>Partial support for gcc-4.7. Ada support is poor, but other languages work
|
|
|
|
fairly well.</li>
|
|
|
|
|
|
|
|
<li>Support for ARM processors. Some essential gcc headers that are needed to
|
|
|
|
build DragonEgg for ARM are not installed by gcc. To work around this,
|
|
|
|
copy the missing headers from the gcc source tree.</li>
|
|
|
|
|
|
|
|
<li>Better optimization for Fortran by exploiting the fact that Fortran scalar
|
|
|
|
arguments have 'restrict' semantics.</li>
|
|
|
|
|
|
|
|
<li>Better optimization for all languages by passing information about type
|
|
|
|
aliasing and type ranges to the LLVM optimizers.</li>
|
|
|
|
|
|
|
|
<li>A regression test-suite was added.</li>
|
2011-11-10 18:44:29 +00:00
|
|
|
|
2010-09-30 17:37:34 +00:00
|
|
|
</ul>
|
2009-10-13 17:48:04 +00:00
|
|
|
|
|
|
|
</div>
|
|
|
|
|
2010-10-03 23:49:06 +00:00
|
|
|
<!--=========================================================================-->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h3>
|
2010-10-03 23:49:06 +00:00
|
|
|
<a name="compiler-rt">compiler-rt: Compiler Runtime Library</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h3>
|
2010-09-29 05:30:03 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2011-10-26 18:46:16 +00:00
|
|
|
|
|
|
|
<p>The new LLVM <a href="http://compiler-rt.llvm.org/">compiler-rt project</a>
|
|
|
|
is a simple library that provides an implementation of the low-level
|
|
|
|
target-specific hooks required by code generation and other runtime
|
|
|
|
components. For example, when compiling for a 32-bit target, converting a
|
|
|
|
double to a 64-bit unsigned integer is compiled into a runtime call to the
|
|
|
|
"__fixunsdfdi" function. The compiler-rt library provides highly optimized
|
|
|
|
implementations of this and other low-level routines (some are 3x faster than
|
|
|
|
the equivalent libgcc routines).</p>
|
2010-09-29 05:30:03 +00:00
|
|
|
|
2011-12-13 17:55:30 +00:00
|
|
|
<p>....</p>
|
2010-09-29 05:30:03 +00:00
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<!--=========================================================================-->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h3>
|
2010-10-03 23:49:06 +00:00
|
|
|
<a name="lldb">LLDB: Low Level Debugger</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h3>
|
2010-09-29 05:30:03 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2011-11-28 18:20:09 +00:00
|
|
|
|
2011-11-27 18:53:41 +00:00
|
|
|
<p>LLDB is a ground-up implementation of a command line debugger, as well as a
|
|
|
|
debugger API that can be used from other applications. LLDB makes use of the
|
|
|
|
Clang parser to provide high-fidelity expression parsing (particularly for
|
|
|
|
C++) and uses the LLVM JIT for target support.</p>
|
2010-09-29 05:30:03 +00:00
|
|
|
|
2011-12-13 17:55:30 +00:00
|
|
|
<p>...</p>
|
2010-09-29 05:30:03 +00:00
|
|
|
|
2010-10-03 23:49:06 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
<!--=========================================================================-->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h3>
|
2010-10-03 23:49:06 +00:00
|
|
|
<a name="libc++">libc++: C++ Standard Library</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h3>
|
2010-10-03 23:49:06 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2010-10-03 23:49:06 +00:00
|
|
|
|
2011-10-26 18:46:16 +00:00
|
|
|
<p>Like compiler_rt, libc++ is now <a href="DeveloperPolicy.html#license">dual
|
|
|
|
licensed</a> under the MIT and UIUC license, allowing it to be used more
|
|
|
|
permissively.</p>
|
2010-09-29 05:30:03 +00:00
|
|
|
|
2011-12-13 17:55:30 +00:00
|
|
|
<p>...</p>
|
2011-11-26 10:56:17 +00:00
|
|
|
|
2010-09-29 05:30:03 +00:00
|
|
|
</div>
|
|
|
|
|
2011-04-07 03:08:22 +00:00
|
|
|
<!--=========================================================================-->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h3>
|
2011-04-07 03:08:22 +00:00
|
|
|
<a name="vmkit">VMKit</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h3>
|
2011-04-07 03:08:22 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2011-10-26 18:46:16 +00:00
|
|
|
|
2011-11-10 23:37:56 +00:00
|
|
|
<p>The <a href="http://vmkit.llvm.org/">VMKit project</a> is an
|
|
|
|
implementation of a Java Virtual Machine (Java VM or JVM) that uses LLVM for
|
|
|
|
static and just-in-time compilation.
|
|
|
|
|
2011-12-13 17:55:30 +00:00
|
|
|
<p>In the LLVM 3.1 time-frame, VMKit has had significant improvements on both
|
2011-11-10 23:37:56 +00:00
|
|
|
runtime and startup performance:</p>
|
|
|
|
|
|
|
|
<ul>
|
2011-12-13 17:55:30 +00:00
|
|
|
<li>...</li>
|
2011-11-10 23:37:56 +00:00
|
|
|
</ul>
|
2011-10-26 18:46:16 +00:00
|
|
|
|
2011-04-07 03:08:22 +00:00
|
|
|
</div>
|
2011-11-28 18:20:09 +00:00
|
|
|
|
2012-04-16 17:17:00 +00:00
|
|
|
|
|
|
|
<!--=========================================================================-->
|
|
|
|
<h3>
|
2012-04-16 17:18:49 +00:00
|
|
|
<a name="Polly">Polly: Polyhedral Optimizer</a>
|
2012-04-16 17:17:00 +00:00
|
|
|
</h3>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
|
|
|
|
<p><a href="http://polly.llvm.org/">Polly</a> is an <em>experimental</em>
|
|
|
|
optimizer for data locality and parallelism. It currently provides high-level
|
|
|
|
loop optimizations and automatic parallelisation (using the OpenMP run time).
|
|
|
|
Work in the area of automatic SIMD and accelerator code generation was
|
|
|
|
started.
|
|
|
|
|
|
|
|
<p>Within the LLVM 3.1 time-frame there were the following highlights:</p>
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
<li>Polly became an official LLVM project</li>
|
|
|
|
<li>Polly can be loaded directly into clang (Enabled by '-O3 -mllvm -polly'
|
|
|
|
)</li>
|
|
|
|
<li>An automatic scheduling optimizer (derived from <a
|
|
|
|
href="http://pluto-compiler.sourceforge.net/">Pluto</a>) was integrated. It
|
|
|
|
performs loop transformations to optimize for data-locality and parallelism.
|
|
|
|
The transformations include, but are not limited to interchange, fusion,
|
|
|
|
fission, skewing and tiling.
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
</div>
|
2010-10-04 17:39:47 +00:00
|
|
|
|
2009-02-26 22:33:38 +00:00
|
|
|
<!-- *********************************************************************** -->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h2>
|
2011-12-13 17:55:30 +00:00
|
|
|
<a name="externalproj">External Open Source Projects Using LLVM 3.1</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h2>
|
2009-02-26 22:33:38 +00:00
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2009-10-13 17:48:04 +00:00
|
|
|
|
|
|
|
<p>An exciting aspect of LLVM is that it is used as an enabling technology for
|
|
|
|
a lot of other language and tools projects. This section lists some of the
|
2011-12-13 17:55:30 +00:00
|
|
|
projects that have already been updated to work with LLVM 3.1.</p>
|
2011-11-01 04:08:23 +00:00
|
|
|
|
2012-05-13 09:52:48 +00:00
|
|
|
<h3>FAUST</h3>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
|
|
|
|
<p>FAUST is a compiled language for real-time audio signal processing. The name
|
|
|
|
FAUST stands for Functional AUdio STream. Its programming model combines two
|
|
|
|
approaches: functional programming and block diagram composition. In addition
|
|
|
|
with the C, C++, Java, JavaScript output formats, the Faust compiler can
|
|
|
|
generate LLVM bitcode, and works with LLVM 2.7-3.1.</p>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
2012-05-11 21:42:37 +00:00
|
|
|
<h3>Glasgow Haskell Compiler (GHC)</h3>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
|
|
|
|
<p>GHC is an open source compiler and programming suite for Haskell, a lazy
|
|
|
|
functional programming language. It includes an optimizing static compiler
|
|
|
|
generating good code for a variety of platforms, together with an interactive
|
|
|
|
system for convenient, quick development.</p>
|
|
|
|
|
|
|
|
<p>GHC 7.0 and onwards include an LLVM code generator, supporting LLVM 2.8 and
|
|
|
|
later.</p>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
2012-05-13 09:55:24 +00:00
|
|
|
<h3>Open Shading Language</h3>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
|
|
|
|
<p>Open Shading Language (OSL) is a small but rich language for programmable
|
|
|
|
shading in advanced global illumination renderers and other applications,
|
|
|
|
ideal for describing materials, lights, displacement, and pattern
|
|
|
|
generation. It uses LLVM to JIT complex shader networks to x86 code at
|
|
|
|
runtime.</p>
|
|
|
|
|
|
|
|
<p>OSL was developed by Sony Pictures Imageworks for use in its in-house
|
|
|
|
renderer used for feature film animation and visual effects, and is
|
|
|
|
distributed as open source software with the "New BSD" license. Its project
|
|
|
|
home page is:
|
|
|
|
<a href"http://github.com/imageworks/OpenShadingLanguage/">http://github.com/imageworks/OpenShadingLanguage/</a></p>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
2012-05-11 21:42:37 +00:00
|
|
|
<h3>Pure</h3>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
|
2012-05-11 22:38:33 +00:00
|
|
|
<p><a href="http://pure-lang.googlecode.com/">Pure</a> is an
|
|
|
|
algebraic/functional programming language based on term rewriting. Programs
|
|
|
|
are collections of equations which are used to evaluate expressions in a
|
|
|
|
symbolic fashion. The interpreter uses LLVM as a backend to JIT-compile Pure
|
|
|
|
programs to fast native code. Pure offers dynamic typing, eager and lazy
|
|
|
|
evaluation, lexical closures, a hygienic macro system (also based on term
|
|
|
|
rewriting), built-in list and matrix support (including list and matrix
|
|
|
|
comprehensions) and an easy-to-use interface to C and other programming
|
|
|
|
languages (including the ability to load LLVM bitcode modules, and inline C,
|
|
|
|
C++, Fortran and Faust code in Pure programs if the corresponding
|
|
|
|
LLVM-enabled compilers are installed).</p>
|
2012-05-11 21:42:37 +00:00
|
|
|
|
|
|
|
<p>Pure version 0.54 has been tested and is known to work with LLVM 3.1 (and
|
|
|
|
continues to work with older LLVM releases >= 2.5).</p>
|
|
|
|
|
|
|
|
</div>
|
2011-10-26 09:25:01 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
</div>
|
|
|
|
|
2009-10-13 17:48:04 +00:00
|
|
|
<!-- *********************************************************************** -->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h2>
|
2011-12-13 17:55:30 +00:00
|
|
|
<a name="whatsnew">What's New in LLVM 3.1?</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h2>
|
2009-10-13 17:48:04 +00:00
|
|
|
<!-- *********************************************************************** -->
|
2009-02-26 07:29:17 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2008-06-05 06:57:39 +00:00
|
|
|
|
2009-10-13 17:48:04 +00:00
|
|
|
<p>This release includes a huge number of bug fixes, performance tweaks and
|
2011-10-26 18:46:16 +00:00
|
|
|
minor improvements. Some of the major improvements and new features are
|
|
|
|
listed in this section.</p>
|
2008-02-06 18:00:06 +00:00
|
|
|
|
|
|
|
<!--=========================================================================-->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h3>
|
2009-10-13 17:48:04 +00:00
|
|
|
<a name="majorfeatures">Major New Features</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h3>
|
2008-02-06 18:00:06 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2008-02-06 18:00:06 +00:00
|
|
|
|
2011-11-27 18:47:37 +00:00
|
|
|
<!-- Features that need text if they're finished for 3.1:
|
|
|
|
ARM EHABI
|
|
|
|
combiner-aa?
|
|
|
|
strong phi elim
|
|
|
|
loop dependence analysis
|
|
|
|
CorrelatedValuePropagation
|
|
|
|
lib/Transforms/IPO/MergeFunctions.cpp => consider for 3.1.
|
2011-11-27 20:51:47 +00:00
|
|
|
Integrated assembler on by default for arm/thumb?
|
2011-11-27 18:47:37 +00:00
|
|
|
|
2011-11-27 20:51:47 +00:00
|
|
|
-->
|
2008-02-06 18:00:06 +00:00
|
|
|
|
2011-11-27 20:51:47 +00:00
|
|
|
<!-- Near dead:
|
2011-11-15 22:13:27 +00:00
|
|
|
Analysis/RegionInfo.h + Dom Frontiers
|
|
|
|
SparseBitVector: used in LiveVar.
|
2011-11-27 08:32:32 +00:00
|
|
|
llvm/lib/Archive - replace with lib object?
|
2011-11-27 20:51:47 +00:00
|
|
|
-->
|
2011-04-05 07:19:28 +00:00
|
|
|
|
2011-12-13 17:55:30 +00:00
|
|
|
<p>LLVM 3.1 includes several major changes and big features:</p>
|
2011-04-05 07:19:28 +00:00
|
|
|
|
2011-11-27 20:51:47 +00:00
|
|
|
<ul>
|
2011-12-14 22:57:45 +00:00
|
|
|
<li><a href="../tools/clang/docs/AddressSanitizer.html">AddressSanitizer</a>,
|
|
|
|
a fast memory error detector.</li>
|
|
|
|
<li><a href="CodeGenerator.html#machineinstrbundle">MachineInstr Bundles</a>,
|
|
|
|
Support to model instruction bundling / packing.</li>
|
2012-02-23 23:52:06 +00:00
|
|
|
<li><a href="#armintegratedassembler">ARM Integrated Assembler</a>,
|
|
|
|
A full featured assembler and direct-to-object support for ARM.</li>
|
2012-04-17 01:10:35 +00:00
|
|
|
<li><a href="#blockplacement">Basic Block Placement</a>
|
|
|
|
Probability driven basic block placement.</li>
|
2011-12-13 17:55:30 +00:00
|
|
|
<li>....</li>
|
2011-04-06 00:45:11 +00:00
|
|
|
</ul>
|
2011-04-05 21:37:08 +00:00
|
|
|
|
2011-10-26 18:33:01 +00:00
|
|
|
</div>
|
|
|
|
|
2011-11-28 18:20:09 +00:00
|
|
|
|
2011-11-27 19:26:30 +00:00
|
|
|
<!--=========================================================================-->
|
|
|
|
<h3>
|
|
|
|
<a name="coreimprovements">LLVM IR and Core Improvements</a>
|
|
|
|
</h3>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
|
|
|
|
<p>LLVM IR has several new features for better support of new targets and that
|
|
|
|
expose new optimization opportunities:</p>
|
|
|
|
|
2011-11-27 21:30:28 +00:00
|
|
|
<ul>
|
2011-12-20 01:10:56 +00:00
|
|
|
<li>IR support for half float</li>
|
2012-02-06 21:59:44 +00:00
|
|
|
<li>IR support for vectors of pointers, including vector GEPs.</li>
|
2012-02-16 10:23:43 +00:00
|
|
|
<li>Module flags have been introduced. They convey information about the
|
|
|
|
module as a whole to LLVM subsystems.</li>
|
2012-03-25 11:14:35 +00:00
|
|
|
<li>Loads can now have range metadata attached to them to describe the
|
2012-03-24 19:02:32 +00:00
|
|
|
possible values being loaded.</li>
|
2012-04-17 01:13:53 +00:00
|
|
|
<li>Inline cost heuristics have been completely overhauled and now closely
|
|
|
|
model constant propagation through call sites, disregard trivially dead
|
|
|
|
code costs, and can model C++ STL iterator patterns.</li>
|
2011-12-13 17:55:30 +00:00
|
|
|
<li>....</li>
|
2011-11-27 21:30:28 +00:00
|
|
|
</ul>
|
2011-11-06 17:59:24 +00:00
|
|
|
</div>
|
|
|
|
|
2011-04-06 00:45:11 +00:00
|
|
|
<!--=========================================================================-->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h3>
|
2011-04-06 00:45:11 +00:00
|
|
|
<a name="optimizer">Optimizer Improvements</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h3>
|
2011-04-05 07:19:28 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2011-04-05 18:38:45 +00:00
|
|
|
|
2011-11-27 21:30:28 +00:00
|
|
|
<p>In addition to many minor performance tweaks and bug fixes, this
|
2011-10-26 18:46:16 +00:00
|
|
|
release includes a few major enhancements and additions to the
|
|
|
|
optimizers:</p>
|
2011-04-05 18:38:45 +00:00
|
|
|
|
2011-04-06 00:45:11 +00:00
|
|
|
<ul>
|
2012-04-14 16:54:12 +00:00
|
|
|
<li>The loop unroll pass now is able to unroll loops with run-time trip counts.
|
|
|
|
This feature is turned off by default, and is enabled with the
|
|
|
|
<code>-unroll-runtime</code> flag.</li>
|
2012-04-16 03:49:43 +00:00
|
|
|
<li>A new basic-block autovectorization pass is available. Pass
|
|
|
|
<code>-vectorize</code> to run this pass along with some associated
|
2012-04-16 17:06:49 +00:00
|
|
|
post-vectorization cleanup passes. For more information, see the EuroLLVM
|
|
|
|
2012 slides: <a href="http://llvm.org/devmtg/2012-04-12/Slides/Hal_Finkel.pdf">
|
|
|
|
Autovectorization with LLVM</a>.</li>
|
2011-12-13 17:55:30 +00:00
|
|
|
<li>....</li>
|
2010-10-04 02:42:39 +00:00
|
|
|
</ul>
|
2007-05-16 23:25:46 +00:00
|
|
|
|
2009-10-13 17:48:04 +00:00
|
|
|
</div>
|
2009-03-02 02:37:32 +00:00
|
|
|
|
2010-09-30 16:31:33 +00:00
|
|
|
<!--=========================================================================-->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h3>
|
2010-09-30 16:31:33 +00:00
|
|
|
<a name="mc">MC Level Improvements</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h3>
|
2010-09-30 16:31:33 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2011-10-26 18:46:16 +00:00
|
|
|
|
|
|
|
<p>The LLVM Machine Code (aka MC) subsystem was created to solve a number of
|
|
|
|
problems in the realm of assembly, disassembly, object file format handling,
|
|
|
|
and a number of other related areas that CPU instruction-set level tools work
|
2011-11-27 22:03:34 +00:00
|
|
|
in. For more information, please see
|
|
|
|
the <a href="http://blog.llvm.org/2010/04/intro-to-llvm-mc-project.html">Intro
|
|
|
|
to the LLVM MC Project Blog Post</a>.</p>
|
2010-10-02 21:59:30 +00:00
|
|
|
|
|
|
|
<ul>
|
2011-12-13 17:55:30 +00:00
|
|
|
<li>....</li>
|
2010-10-02 21:59:30 +00:00
|
|
|
</ul>
|
|
|
|
|
2011-04-05 08:24:22 +00:00
|
|
|
</div>
|
2010-09-30 16:31:33 +00:00
|
|
|
|
2008-06-08 02:45:07 +00:00
|
|
|
<!--=========================================================================-->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h3>
|
2009-03-02 03:24:11 +00:00
|
|
|
<a name="codegen">Target Independent Code Generator Improvements</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h3>
|
2008-06-08 02:45:07 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2008-06-08 02:45:07 +00:00
|
|
|
|
2012-02-16 10:23:43 +00:00
|
|
|
<p>We have changed the way that the Type Legalizer legalizes vectors. The type
|
|
|
|
legalizer now attempts to promote integer elements. This enabled the
|
|
|
|
implementation of vector-select. Additionally, we see a performance boost on
|
|
|
|
workloads which use vectors of chars and shorts, since they are now promoted
|
|
|
|
to 32-bit types, which are better supported by the SIMD instruction set.
|
|
|
|
Floating point types are still widened as before.</p>
|
2011-12-20 08:02:50 +00:00
|
|
|
|
|
|
|
|
2009-03-01 18:09:47 +00:00
|
|
|
<p>We have put a significant amount of work into the code generator
|
2011-10-26 18:46:16 +00:00
|
|
|
infrastructure, which allows us to implement more aggressive algorithms and
|
|
|
|
make it run faster:</p>
|
2008-06-08 02:45:07 +00:00
|
|
|
|
|
|
|
<ul>
|
2011-12-19 16:53:40 +00:00
|
|
|
<li>TableGen can now synthesize register classes that are only needed to
|
2012-02-16 10:23:43 +00:00
|
|
|
represent combinations of constraints from instructions and sub-registers.
|
|
|
|
The synthetic register classes inherit most of their properties form their
|
|
|
|
closest user-defined super-class.</li>
|
2012-01-05 00:26:49 +00:00
|
|
|
<li><code>MachineRegisterInfo</code> now allows the reserved registers to be
|
2012-02-16 10:23:43 +00:00
|
|
|
frozen when register allocation starts. Target hooks should use the
|
2012-02-26 08:35:53 +00:00
|
|
|
<code>MRI->canReserveReg(FramePtr)</code> method to avoid accidentally
|
2012-02-16 10:23:43 +00:00
|
|
|
disabling frame pointer elimination during register allocation.</li>
|
2012-01-16 19:22:00 +00:00
|
|
|
<li>A new kind of <code>MachineOperand</code> provides a compact
|
2012-02-16 10:23:43 +00:00
|
|
|
representation of large clobber lists on call instructions. The register
|
|
|
|
mask operand references a bit mask of preserved registers. Everything else
|
|
|
|
is clobbered.</li>
|
2009-03-02 02:37:32 +00:00
|
|
|
</ul>
|
2012-02-16 10:23:43 +00:00
|
|
|
|
2012-04-12 15:17:35 +00:00
|
|
|
<p> We added new TableGen infrastructure to support bundling for
|
|
|
|
Very Long Instruction Word (VLIW) architectures. TableGen can now
|
|
|
|
automatically generate a deterministic finite automaton from a VLIW
|
|
|
|
target's schedule description which can be queried to determine
|
|
|
|
legal groupings of instructions in a bundle.</p>
|
|
|
|
|
2012-04-14 20:59:13 +00:00
|
|
|
<p> We have added a new target independent VLIW packetizer based on the
|
2012-04-14 20:57:13 +00:00
|
|
|
DFA infrastructure to group machine instructions into bundles.</p>
|
|
|
|
|
2009-03-02 02:37:32 +00:00
|
|
|
</div>
|
2007-09-21 03:54:09 +00:00
|
|
|
|
2012-04-17 01:10:35 +00:00
|
|
|
<h4>
|
|
|
|
<a name="blockplacement">Basic Block Placement</a>
|
|
|
|
</h4>
|
|
|
|
<div>
|
|
|
|
<p>A probability based block placement and code layout algorithm was added to
|
|
|
|
LLVM's code generator. This layout pass supports probabilities derived from
|
|
|
|
static heuristics as well as source code annotations such as
|
|
|
|
<code>__builtin_expect</code>.</p>
|
|
|
|
</div>
|
|
|
|
|
2007-09-21 03:54:09 +00:00
|
|
|
<!--=========================================================================-->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h3>
|
2010-04-21 05:17:40 +00:00
|
|
|
<a name="x86">X86-32 and X86-64 Target Improvements</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h3>
|
2009-02-26 07:32:11 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2011-10-26 18:46:16 +00:00
|
|
|
|
|
|
|
<p>New features and major changes in the X86 target include:</p>
|
2009-02-26 07:32:11 +00:00
|
|
|
|
|
|
|
<ul>
|
2011-12-20 08:02:50 +00:00
|
|
|
<li>Bug fixes and improved support for AVX1</li>
|
|
|
|
<li>Support for AVX2 (still incomplete at this point)</li>
|
2012-02-16 18:22:39 +00:00
|
|
|
<li>Call instructions use the new register mask operands for faster compile
|
|
|
|
times and better support for different calling conventions. The old WINCALL
|
|
|
|
instructions are no longer needed.</li>
|
2012-04-07 02:24:20 +00:00
|
|
|
<li>DW2 Exception Handling is enabled on Cygwin and MinGW.</li>
|
2012-04-16 05:24:52 +00:00
|
|
|
<li>Support for implicit TLS model used with MS VC runtime</li>
|
2009-02-26 07:32:11 +00:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
2009-10-13 17:48:04 +00:00
|
|
|
<!--=========================================================================-->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h3>
|
2009-10-13 17:48:04 +00:00
|
|
|
<a name="ARM">ARM Target Improvements</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h3>
|
2009-10-13 17:48:04 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2011-10-26 18:46:16 +00:00
|
|
|
|
|
|
|
<p>New features of the ARM target include:</p>
|
2009-10-13 17:48:04 +00:00
|
|
|
|
|
|
|
<ul>
|
2011-12-16 16:07:41 +00:00
|
|
|
<li>The constant island pass now supports basic block and constant pool entry
|
2012-02-23 23:52:06 +00:00
|
|
|
alignments greater than 4 bytes.</li>
|
|
|
|
<li>On Darwin, the ARM target now has a full-featured integrated assembler.
|
|
|
|
</li>
|
|
|
|
</ul>
|
2011-11-15 22:23:46 +00:00
|
|
|
|
2012-02-23 23:52:06 +00:00
|
|
|
<h4>
|
|
|
|
<a name="armintegratedassembler">ARM Integrated Assembler</a>
|
|
|
|
</h4>
|
|
|
|
<div>
|
|
|
|
<p>The ARM target now includes a full featured macro assembler, including
|
|
|
|
direct-to-object module support for clang. The assembler is currently enabled
|
|
|
|
by default for Darwin only pending testing and any additional necessary
|
|
|
|
platform specific support for Linux.</p>
|
|
|
|
|
|
|
|
<p>Full support is included for Thumb1, Thumb2 and ARM modes, along with
|
|
|
|
subtarget and CPU specific extensions for VFP2, VFP3 and NEON.</p>
|
2011-11-28 18:20:09 +00:00
|
|
|
|
2012-02-23 23:52:06 +00:00
|
|
|
<p>The assembler is Unified Syntax only (see ARM Architecural Reference Manual
|
|
|
|
for details). While there is some, and growing, support for pre-unfied (divided)
|
|
|
|
syntax, there are still significant gaps in that support.</p>
|
2012-03-27 11:25:16 +00:00
|
|
|
</div>
|
|
|
|
|
2012-02-23 23:52:06 +00:00
|
|
|
</div>
|
2011-11-15 21:33:05 +00:00
|
|
|
<!--=========================================================================-->
|
|
|
|
<h3>
|
|
|
|
<a name="MIPS">MIPS Target Improvements</a>
|
|
|
|
</h3>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
|
2011-11-27 22:12:32 +00:00
|
|
|
<p>This release has seen major new work on just about every aspect of the MIPS
|
|
|
|
backend. Some of the major new features include:</p>
|
2011-11-15 21:33:05 +00:00
|
|
|
|
|
|
|
<ul>
|
2011-12-13 17:55:30 +00:00
|
|
|
<li>....</li>
|
2011-11-15 21:33:05 +00:00
|
|
|
</ul>
|
|
|
|
</div>
|
2011-11-15 22:23:46 +00:00
|
|
|
|
2011-04-06 00:45:11 +00:00
|
|
|
<!--=========================================================================-->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h3>
|
2011-04-06 00:45:11 +00:00
|
|
|
<a name="OtherTS">Other Target Specific Improvements</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h3>
|
2008-06-05 08:02:49 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2011-10-26 18:46:16 +00:00
|
|
|
|
2012-04-13 19:09:44 +00:00
|
|
|
<p>Support for Qualcomm's Hexagon VLIW processor has been added.</p>
|
|
|
|
|
2011-04-06 00:45:11 +00:00
|
|
|
<ul>
|
2011-12-13 17:55:30 +00:00
|
|
|
<li>....</li>
|
2011-11-28 18:20:09 +00:00
|
|
|
|
2011-11-27 22:36:22 +00:00
|
|
|
|
2011-04-06 00:45:11 +00:00
|
|
|
</ul>
|
2011-10-26 18:46:16 +00:00
|
|
|
|
2011-04-06 00:45:11 +00:00
|
|
|
</div>
|
2008-06-05 08:02:49 +00:00
|
|
|
|
2008-10-13 17:57:36 +00:00
|
|
|
<!--=========================================================================-->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h3>
|
2008-10-13 17:57:36 +00:00
|
|
|
<a name="changes">Major Changes and Removed Features</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h3>
|
2008-10-13 17:57:36 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2008-10-13 17:57:36 +00:00
|
|
|
|
2011-08-03 22:18:20 +00:00
|
|
|
<p>If you're already an LLVM user or developer with out-of-tree changes based on
|
2011-12-13 17:55:30 +00:00
|
|
|
LLVM 3.1, this section lists some "gotchas" that you may run into upgrading
|
2011-08-03 22:18:20 +00:00
|
|
|
from the previous release.</p>
|
2008-10-13 18:01:01 +00:00
|
|
|
|
2008-10-13 22:06:31 +00:00
|
|
|
<ul>
|
2012-02-16 10:23:43 +00:00
|
|
|
<li>LLVM 3.1 removes support for reading LLVM 2.9 bitcode files. Going
|
|
|
|
forward, we aim for all future versions of LLVM to read bitcode files and
|
|
|
|
<tt>.ll</tt> files produced by LLVM 3.0 and later.</li>
|
|
|
|
<li>The <tt>unwind</tt> instruction is now gone. With the introduction of the
|
|
|
|
new exception handling system in LLVM 3.0, the <tt>unwind</tt> instruction
|
|
|
|
became obsolete.</li>
|
2012-04-26 20:10:07 +00:00
|
|
|
<li>LLVM 3.0 and earlier automatically added the returns_twice fo functions
|
|
|
|
like setjmp based on the name. This functionality was removed in 3.1.
|
|
|
|
This affects Clang users, if -ffreestanding is used.</li>
|
2011-12-13 17:55:30 +00:00
|
|
|
<li>....</li>
|
2011-08-22 23:22:05 +00:00
|
|
|
</ul>
|
2011-10-26 18:46:16 +00:00
|
|
|
|
2011-08-22 23:22:05 +00:00
|
|
|
</div>
|
|
|
|
|
2010-10-04 20:11:41 +00:00
|
|
|
<!--=========================================================================-->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h3>
|
2011-04-06 00:45:11 +00:00
|
|
|
<a name="api_changes">Internal API Changes</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h3>
|
2010-10-04 20:11:41 +00:00
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2010-10-04 20:11:41 +00:00
|
|
|
|
2011-04-06 00:45:11 +00:00
|
|
|
<p>In addition, many APIs have changed in this release. Some of the major
|
2011-08-02 06:20:17 +00:00
|
|
|
LLVM API changes are:</p>
|
2010-10-04 20:11:41 +00:00
|
|
|
|
|
|
|
<ul>
|
2012-03-21 22:58:28 +00:00
|
|
|
<li>Target specific options have been moved from global variables to members
|
|
|
|
on the new <code>TargetOptions</code> class, which is local to each
|
|
|
|
<code>TargetMachine</code>. As a consequence, the associated flags will
|
|
|
|
no longer be accepted by <tt>clang -mllvm</tt>. This includes:
|
|
|
|
<ul>
|
2012-03-23 00:56:26 +00:00
|
|
|
<li><code>llvm::PrintMachineCode</code></li>
|
|
|
|
<li><code>llvm::NoFramePointerElim</code></li>
|
|
|
|
<li><code>llvm::NoFramePointerElimNonLeaf</code></li>
|
|
|
|
<li><code>llvm::DisableFramePointerElim(const MachineFunction &)</code></li>
|
|
|
|
<li><code>llvm::LessPreciseFPMADOption</code></li>
|
|
|
|
<li><code>llvm::LessPrecideFPMAD()</code></li>
|
|
|
|
<li><code>llvm::NoExcessFPPrecision</code></li>
|
|
|
|
<li><code>llvm::UnsafeFPMath</code></li>
|
|
|
|
<li><code>llvm::NoInfsFPMath</code></li>
|
|
|
|
<li><code>llvm::NoNaNsFPMath</code></li>
|
|
|
|
<li><code>llvm::HonorSignDependentRoundingFPMathOption</code></li>
|
|
|
|
<li><code>llvm::HonorSignDependentRoundingFPMath()</code></li>
|
|
|
|
<li><code>llvm::UseSoftFloat</code></li>
|
|
|
|
<li><code>llvm::FloatABIType</code></li>
|
|
|
|
<li><code>llvm::NoZerosInBSS</code></li>
|
|
|
|
<li><code>llvm::JITExceptionHandling</code></li>
|
|
|
|
<li><code>llvm::JITEmitDebugInfo</code></li>
|
|
|
|
<li><code>llvm::JITEmitDebugInfoToDisk</code></li>
|
|
|
|
<li><code>llvm::GuaranteedTailCallOpt</code></li>
|
|
|
|
<li><code>llvm::StackAlignmentOverride</code></li>
|
|
|
|
<li><code>llvm::RealignStack</code></li>
|
|
|
|
<li><code>llvm::DisableJumpTables</code></li>
|
|
|
|
<li><code>llvm::EnableFastISel</code></li>
|
|
|
|
<li><code>llvm::getTrapFunctionName()</code></li>
|
|
|
|
<li><code>llvm::EnableSegmentedStacks</code></li>
|
2012-03-21 22:58:28 +00:00
|
|
|
</ul></li>
|
2012-04-15 18:03:49 +00:00
|
|
|
<li>The MDBuilder class has been added to simplify the creation of
|
|
|
|
metadata.</li>
|
2011-12-13 17:55:30 +00:00
|
|
|
<li>....</li>
|
2010-10-04 20:11:41 +00:00
|
|
|
</ul>
|
2011-10-26 18:46:16 +00:00
|
|
|
|
2010-10-04 20:11:41 +00:00
|
|
|
</div>
|
2008-10-13 17:57:36 +00:00
|
|
|
|
2012-02-26 08:35:53 +00:00
|
|
|
<!--=========================================================================-->
|
|
|
|
<h3>
|
|
|
|
<a name="tools_changes">Tools Changes</a>
|
|
|
|
</h3>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
|
|
|
|
<p>In addition, some tools have changed in this release. Some of the changes
|
|
|
|
are:</p>
|
|
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
<li>llvm-stress is a command line tool for generating random .ll files to fuzz
|
|
|
|
different LLVM components. </li>
|
2012-04-19 19:27:54 +00:00
|
|
|
<li>llvm-ld has been removed. Use llvm-link or Clang instead.</li>
|
2012-02-26 08:35:53 +00:00
|
|
|
<li>....</li>
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
<li>....</li>
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
2012-05-12 21:12:22 +00:00
|
|
|
|
|
|
|
<!--=========================================================================-->
|
|
|
|
<h3>
|
|
|
|
<a name="python">Python Bindings</a>
|
|
|
|
</h3>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
|
|
|
|
<p>Officially supported Python bindings have been added! Feature support is far
|
|
|
|
from complete. The current bindings support interfaces to:</p>
|
|
|
|
<ul>
|
|
|
|
<li>Object File Interface</li>
|
|
|
|
<li>Disassembler</li>
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
<p>Using the Object File Interface, it is possible to inspect binary object files.
|
|
|
|
Think of it as a Python version of readelf or llvm-objdump.</p>
|
|
|
|
|
|
|
|
<p>Support for additional features is currently being developed by community
|
|
|
|
contributors. If you are interested in shaping the direction of the Python
|
|
|
|
bindings, please express your intent on IRC or the developers list.</p>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
2012-02-26 08:35:53 +00:00
|
|
|
</div>
|
|
|
|
|
2003-10-02 04:57:28 +00:00
|
|
|
<!-- *********************************************************************** -->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h2>
|
2003-11-22 00:38:41 +00:00
|
|
|
<a name="knownproblems">Known Problems</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h2>
|
2003-10-02 04:57:28 +00:00
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2003-11-22 00:38:41 +00:00
|
|
|
|
2011-11-27 19:38:20 +00:00
|
|
|
<p>LLVM is generally a production quality compiler, and is used by a broad range
|
|
|
|
of applications and shipping in many products. That said, not every
|
|
|
|
subsystem is as mature as the aggregate, particularly the more obscure
|
|
|
|
targets. If you run into a problem, please check the <a
|
|
|
|
href="http://llvm.org/bugs/">LLVM bug database</a> and submit a bug if
|
|
|
|
there isn't already one or ask on the <a
|
|
|
|
href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev">LLVMdev
|
|
|
|
list</a>.</p>
|
2011-11-28 18:20:09 +00:00
|
|
|
|
2011-11-27 19:38:20 +00:00
|
|
|
<p>Known problem areas include:</p>
|
2011-11-28 18:20:09 +00:00
|
|
|
|
2006-11-18 07:51:14 +00:00
|
|
|
<ul>
|
2011-11-27 19:38:20 +00:00
|
|
|
<li>The Alpha, Blackfin, CellSPU, MSP430, PTX, SystemZ and
|
2011-11-27 20:51:47 +00:00
|
|
|
XCore backends are experimental, and the Alpha, Blackfin and SystemZ
|
|
|
|
targets have already been removed from mainline.</li>
|
2011-11-27 19:38:20 +00:00
|
|
|
|
|
|
|
<li>The integrated assembler, disassembler, and JIT is not supported by
|
|
|
|
several targets. If an integrated assembler is not supported, then a
|
|
|
|
system assembler is required. For more details, see the <a
|
|
|
|
href="CodeGenerator.html#targetfeatures">Target Features Matrix</a>.
|
|
|
|
</li>
|
2011-11-28 18:20:09 +00:00
|
|
|
|
2011-11-27 19:38:20 +00:00
|
|
|
<li>The C backend has numerous problems and is not being actively maintained.
|
|
|
|
Depending on it for anything serious is not advised.</li>
|
2006-11-18 07:51:14 +00:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
</div>
|
2005-11-08 21:11:33 +00:00
|
|
|
|
2003-10-02 04:57:28 +00:00
|
|
|
<!-- *********************************************************************** -->
|
2011-04-18 01:17:51 +00:00
|
|
|
<h2>
|
2003-11-22 00:38:41 +00:00
|
|
|
<a name="additionalinfo">Additional Information</a>
|
2011-04-18 01:17:51 +00:00
|
|
|
</h2>
|
2003-10-02 04:57:28 +00:00
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
2011-04-21 01:52:00 +00:00
|
|
|
<div>
|
2003-11-22 00:38:41 +00:00
|
|
|
|
2011-10-26 18:46:16 +00:00
|
|
|
<p>A wide variety of additional information is available on
|
|
|
|
the <a href="http://llvm.org/">LLVM web page</a>, in particular in
|
|
|
|
the <a href="http://llvm.org/docs/">documentation</a> section. The web page
|
|
|
|
also contains versions of the API documentation which is up-to-date with the
|
|
|
|
Subversion version of the source code. You can access versions of these
|
|
|
|
documents specific to this release by going into the "<tt>llvm/doc/</tt>"
|
|
|
|
directory in the LLVM tree.</p>
|
2003-10-02 04:57:28 +00:00
|
|
|
|
2003-11-22 00:38:41 +00:00
|
|
|
<p>If you have any questions or comments about LLVM, please feel free to contact
|
2011-10-26 18:46:16 +00:00
|
|
|
us via the <a href="http://llvm.org/docs/#maillist"> mailing lists</a>.</p>
|
2003-10-02 04:57:28 +00:00
|
|
|
|
2003-11-22 00:38:41 +00:00
|
|
|
</div>
|
2003-10-02 04:57:28 +00:00
|
|
|
|
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
2003-11-22 00:38:41 +00:00
|
|
|
<hr>
|
2003-11-22 01:23:39 +00:00
|
|
|
<address>
|
2003-12-21 22:53:21 +00:00
|
|
|
<a href="http://jigsaw.w3.org/css-validator/check/referer"><img
|
2008-12-11 17:34:48 +00:00
|
|
|
src="http://jigsaw.w3.org/css-validator/images/vcss-blue" alt="Valid CSS"></a>
|
2003-11-22 01:23:39 +00:00
|
|
|
<a href="http://validator.w3.org/check/referer"><img
|
2008-12-11 17:34:48 +00:00
|
|
|
src="http://www.w3.org/Icons/valid-html401-blue" alt="Valid HTML 4.01"></a>
|
2003-11-22 01:23:39 +00:00
|
|
|
|
2007-05-18 00:44:29 +00:00
|
|
|
<a href="http://llvm.org/">LLVM Compiler Infrastructure</a><br>
|
2003-11-22 00:38:41 +00:00
|
|
|
Last modified: $Date$
|
2003-11-22 01:23:39 +00:00
|
|
|
</address>
|
2003-10-02 04:57:28 +00:00
|
|
|
|
2003-11-22 00:38:41 +00:00
|
|
|
</body>
|
|
|
|
</html>
|