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">
|
2003-11-22 00:38:41 +00:00
|
|
|
<link rel="stylesheet" href="llvm.css" type="text/css">
|
2008-10-11 18:18:28 +00:00
|
|
|
<title>LLVM 2.4 Release Notes</title>
|
2003-11-22 00:38:41 +00:00
|
|
|
</head>
|
|
|
|
<body>
|
|
|
|
|
2008-10-11 18:18:28 +00:00
|
|
|
<div class="doc_title">LLVM 2.4 Release Notes</div>
|
2008-10-13 02:08:34 +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-06-08 21:58:17 +00:00
|
|
|
<li><a href="#changes">Major Changes and Sub-project Status</a></li>
|
2003-11-22 00:38:41 +00:00
|
|
|
<li><a href="#whatsnew">What's New?</a></li>
|
2004-04-30 22:17:12 +00:00
|
|
|
<li><a href="GettingStarted.html">Installation Instructions</a></li>
|
2003-11-22 00:38:41 +00:00
|
|
|
<li><a href="#portability">Portability and Supported Platforms</a></li>
|
2003-10-02 04:57:28 +00:00
|
|
|
<li><a href="#knownproblems">Known Problems</a>
|
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">
|
2005-10-29 07:07:09 +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
|
|
|
|
|
|
|
<!-- *********************************************************************** -->
|
2003-11-22 00:38:41 +00:00
|
|
|
<div class="doc_section">
|
|
|
|
<a name="intro">Introduction</a>
|
|
|
|
</div>
|
2003-10-02 04:57:28 +00:00
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
2003-11-22 00:38:41 +00:00
|
|
|
<div class="doc_text">
|
|
|
|
|
|
|
|
<p>This document contains the release notes for the LLVM compiler
|
2008-10-11 18:18:28 +00:00
|
|
|
infrastructure, release 2.4. Here we describe the status of LLVM, including
|
2007-05-23 04:39:32 +00:00
|
|
|
major improvements from the previous release and any known problems. All LLVM
|
2007-05-09 04:58:11 +00:00
|
|
|
releases may be downloaded from the <a href="http://llvm.org/releases/">LLVM
|
2007-05-23 04:39:32 +00:00
|
|
|
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
|
2005-10-29 07:07:09 +00:00
|
|
|
release, please check out the <a href="http://llvm.org/">main LLVM
|
2003-10-07 21:38:31 +00:00
|
|
|
web site</a>. If you have questions or comments, the <a
|
|
|
|
href="http://mail.cs.uiuc.edu/mailman/listinfo/llvmdev">LLVM developer's mailing
|
2003-11-22 00:38:41 +00:00
|
|
|
list</a> is a good place to send them.</p>
|
2003-10-02 04:57:28 +00:00
|
|
|
|
2008-10-13 02:08:34 +00:00
|
|
|
<p>Note that if you are reading this file from a Subversion checkout or the
|
2007-09-21 03:54:09 +00:00
|
|
|
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 releases, please see the
|
|
|
|
<a href="http://llvm.org/releases/">releases page</a>.</p>
|
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
|
|
|
<div class="doc_section">
|
2008-06-08 21:58:17 +00:00
|
|
|
<a name="changes">Major Changes and Sub-project Status</a>
|
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
|
|
|
<div class="doc_text">
|
|
|
|
|
2008-10-13 02:08:34 +00:00
|
|
|
<p>This is the fifteenth public release of the LLVM Compiler Infrastructure.
|
2008-10-11 18:18:28 +00:00
|
|
|
It includes a large number of features and refinements from LLVM 2.3.</p>
|
2003-12-06 20:22:41 +00:00
|
|
|
|
2004-05-24 04:50:25 +00:00
|
|
|
</div>
|
|
|
|
|
2008-10-11 18:18:28 +00:00
|
|
|
<!-- Unfinished features in 2.4:
|
2008-02-10 07:46:44 +00:00
|
|
|
Machine LICM
|
|
|
|
Machine Sinking
|
|
|
|
LegalizeDAGTypes
|
2008-10-12 19:47:48 +00:00
|
|
|
llc -enable-value-prop, propagation of value info (sign/zero ext info) from
|
|
|
|
one MBB to another
|
2008-02-10 07:46:44 +00:00
|
|
|
-->
|
2008-10-13 02:08:34 +00:00
|
|
|
|
2008-10-12 19:47:48 +00:00
|
|
|
<!-- for announcement email:
|
|
|
|
mention dev mtg
|
2008-10-12 22:57:58 +00:00
|
|
|
Xcode 3.1 and 3.1.1.
|
2008-10-12 19:47:48 +00:00
|
|
|
-->
|
2008-02-10 07:46:44 +00:00
|
|
|
|
2008-02-10 07:04:35 +00:00
|
|
|
<!--=========================================================================-->
|
|
|
|
<div class="doc_subsection">
|
2008-10-11 18:18:28 +00:00
|
|
|
<a name="changes">Major Changes in LLVM 2.4</a>
|
2008-02-10 07:04:35 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
2008-10-12 19:47:48 +00:00
|
|
|
<p>The LLVM IR generated by llvm-gcc now doesn't name instructions. Use the
|
|
|
|
instnamer pass if you want them.</p>
|
|
|
|
|
2008-10-12 22:57:58 +00:00
|
|
|
<li>LoadVN and GCSE are completely gone.</li>
|
2008-10-12 19:47:48 +00:00
|
|
|
|
2008-06-08 21:19:07 +00:00
|
|
|
|
2008-06-08 02:45:07 +00:00
|
|
|
<p>LLVM API Changes:</p>
|
2008-06-05 08:02:49 +00:00
|
|
|
|
2008-06-08 02:45:07 +00:00
|
|
|
<ul>
|
2008-10-11 18:18:28 +00:00
|
|
|
<li>....</li>
|
2008-10-11 21:26:56 +00:00
|
|
|
|
|
|
|
<li>... Attributes changes ... </li>
|
|
|
|
|
2008-10-12 18:30:33 +00:00
|
|
|
<li>The <tt>DbgStopPointInst</tt> methods <tt>getDirectory</tt> and
|
|
|
|
<tt>getFileName</tt> now return <tt>Value*</tt> instead of strings. These can be
|
|
|
|
converted to strings using <tt>llvm::GetConstantStringInfo</tt> defined via
|
|
|
|
"llvm/Analysis/ValueTracking.h".</li>
|
2008-10-11 21:26:56 +00:00
|
|
|
|
2008-10-12 18:30:33 +00:00
|
|
|
<li>API change: BinaryOperator::create -> Create (CmpInst, CastInst too)</li>
|
2008-10-12 19:47:48 +00:00
|
|
|
<li>Various header files like "llvm/ADT/iterator" were given a .h suffix.
|
|
|
|
Change your code to #include "llvm/ADT/iterator.h" instead.</li>
|
2008-10-13 02:08:34 +00:00
|
|
|
|
2008-06-08 02:45:07 +00:00
|
|
|
</ul>
|
2008-10-12 22:57:58 +00:00
|
|
|
|
2008-02-10 07:04:35 +00:00
|
|
|
</div>
|
|
|
|
|
2003-12-06 20:22:41 +00:00
|
|
|
<!--=========================================================================-->
|
2005-05-15 05:44:51 +00:00
|
|
|
<div class="doc_subsection">
|
2008-06-08 21:34:41 +00:00
|
|
|
<a name="otherprojects">Other LLVM Sub-Projects</a>
|
2006-04-18 06:18:36 +00:00
|
|
|
</div>
|
|
|
|
|
2007-05-14 06:56:09 +00:00
|
|
|
<div class="doc_text">
|
2008-06-08 21:34:41 +00:00
|
|
|
<p>
|
2008-10-11 18:18:28 +00:00
|
|
|
The core LLVM 2.4 distribution currently consists of code from the core LLVM
|
2008-06-08 21:58:17 +00:00
|
|
|
repository (which roughly contains the LLVM optimizer, code generators and
|
|
|
|
supporting tools) and the llvm-gcc repository. In addition to this code, the
|
|
|
|
LLVM Project includes other sub-projects that are in development. The two which
|
2008-10-11 18:18:28 +00:00
|
|
|
are the most actively developed are the <a href="#clang">Clang Project</a> and
|
2008-10-13 02:08:34 +00:00
|
|
|
<a href="#vmkit">vmkit Project</a>.
|
2008-06-08 21:58:17 +00:00
|
|
|
</p>
|
|
|
|
</div>
|
2008-06-05 06:57:39 +00:00
|
|
|
|
2008-06-08 21:58:17 +00:00
|
|
|
<!--=========================================================================-->
|
|
|
|
<div class="doc_subsubsection">
|
|
|
|
<a name="vmkit">vmkit</a>
|
|
|
|
</div>
|
2008-06-05 06:57:39 +00:00
|
|
|
|
2008-06-08 21:58:17 +00:00
|
|
|
<div class="doc_text">
|
|
|
|
<p>
|
2008-10-11 18:18:28 +00:00
|
|
|
The <a href="http://vmkit.llvm.org/">"vmkit" project</a> is an implementation of
|
|
|
|
a JVM and a CLI Virtual Machines (Microsoft .NET is an
|
2008-06-08 21:58:17 +00:00
|
|
|
implementation of the CLI) using the Just-In-Time compiler of LLVM.</p>
|
|
|
|
|
2008-10-11 18:18:28 +00:00
|
|
|
<p>...</p>
|
2008-06-05 06:57:39 +00:00
|
|
|
|
2008-06-08 21:34:41 +00:00
|
|
|
</div>
|
2008-06-05 06:57:39 +00:00
|
|
|
|
2008-06-08 21:58:17 +00:00
|
|
|
<!--=========================================================================-->
|
|
|
|
<div class="doc_subsubsection">
|
|
|
|
<a name="clang">Clang</a>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
|
|
|
<p>The <a href="http://clang.llvm.org/">Clang project</a> is an effort to build
|
|
|
|
a set of new 'LLVM native' front-end technologies for the LLVM optimizer
|
|
|
|
and code generator. Clang is continuing to make major strides forward in all
|
|
|
|
areas. Its C and Objective-C parsing support is very solid, and the code
|
|
|
|
generation support is far enough along to build many C applications. While not
|
|
|
|
yet production quality, it is progressing very nicely. In addition, C++
|
|
|
|
front-end work has started to make significant progress.</p>
|
|
|
|
|
2008-10-11 18:18:28 +00:00
|
|
|
<p>Codegen progress/state
|
|
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
|
|
<a href="http://clang.llvm.org/StaticAnalysis.html">static analysis tool</a>
|
|
|
|
</p>
|
2008-06-08 21:58:17 +00:00
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
<div class="doc_section">
|
|
|
|
<a name="whatsnew">What's New?</a>
|
|
|
|
</div>
|
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
2008-06-08 22:59:35 +00:00
|
|
|
<div class="doc_text">
|
|
|
|
|
2008-10-11 18:18:28 +00:00
|
|
|
<p>LLVM 2.4 includes a huge number of bug fixes, performance tweaks and minor
|
2008-06-08 22:59:35 +00:00
|
|
|
improvements. Some of the major improvements and new features are listed in
|
|
|
|
this section.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
|
2008-06-08 21:34:41 +00:00
|
|
|
<!--=========================================================================-->
|
|
|
|
<div class="doc_subsection">
|
|
|
|
<a name="majorfeatures">Major New Features</a>
|
|
|
|
</div>
|
2008-06-05 18:39:01 +00:00
|
|
|
|
2008-06-08 21:34:41 +00:00
|
|
|
<div class="doc_text">
|
2008-06-05 06:57:39 +00:00
|
|
|
|
2008-10-11 18:18:28 +00:00
|
|
|
<p>LLVM 2.4 includes several major new capabilities:</p>
|
2008-06-05 06:57:39 +00:00
|
|
|
|
2008-06-08 21:34:41 +00:00
|
|
|
<ul>
|
2008-10-11 18:18:28 +00:00
|
|
|
<li>
|
2008-10-12 18:30:33 +00:00
|
|
|
<p>MRVs got generalized to FCAs. getresult is gone, ret with multiple values
|
|
|
|
is gone.</p>
|
2008-10-11 18:18:28 +00:00
|
|
|
</li>
|
|
|
|
|
2008-10-12 19:47:48 +00:00
|
|
|
<li><p>-O0 compile times overall much faster</p></li>
|
2008-10-13 02:08:34 +00:00
|
|
|
|
2008-10-11 18:18:28 +00:00
|
|
|
<li><p>Attrs changes?</p></li>
|
|
|
|
|
2008-10-12 18:30:33 +00:00
|
|
|
|
|
|
|
<li><p>Initial PIC16 port</p></li>
|
|
|
|
|
2008-10-12 19:47:48 +00:00
|
|
|
<li><p> Support the rest of the atomic __sync builtins</p></li>
|
2008-10-12 18:30:33 +00:00
|
|
|
|
2008-10-11 18:18:28 +00:00
|
|
|
<li><p>...</p></li>
|
2008-06-05 06:57:39 +00:00
|
|
|
|
2008-06-05 06:25:56 +00:00
|
|
|
</ul>
|
2008-02-06 18:00:06 +00:00
|
|
|
|
|
|
|
</div>
|
|
|
|
|
2008-06-05 06:25:56 +00:00
|
|
|
|
2008-02-06 18:00:06 +00:00
|
|
|
<!--=========================================================================-->
|
|
|
|
<div class="doc_subsection">
|
2008-06-08 21:34:41 +00:00
|
|
|
<a name="llvm-gcc">llvm-gcc 4.2 Improvements</a>
|
2008-02-06 18:00:06 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
2008-10-11 18:18:28 +00:00
|
|
|
<p>LLVM 2.4 fully supports the llvm-gcc 4.2 front-end, and includes support
|
2008-06-08 22:59:35 +00:00
|
|
|
for the C, C++, Objective-C, Ada, and Fortran front-ends.</p>
|
2008-02-06 18:00:06 +00:00
|
|
|
|
2008-06-08 22:59:35 +00:00
|
|
|
<p>
|
|
|
|
<ul>
|
2008-10-11 18:18:28 +00:00
|
|
|
<li>...</li>
|
2008-06-08 21:58:17 +00:00
|
|
|
|
2008-06-09 06:06:18 +00:00
|
|
|
</ul>
|
2008-06-05 06:25:56 +00:00
|
|
|
|
2007-05-14 06:56:09 +00:00
|
|
|
</div>
|
|
|
|
|
2008-06-05 06:25:56 +00:00
|
|
|
|
2008-02-10 08:17:19 +00:00
|
|
|
<!--=========================================================================-->
|
|
|
|
<div class="doc_subsection">
|
|
|
|
<a name="coreimprovements">LLVM Core Improvements</a>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
<p>New features include:
|
|
|
|
</p>
|
|
|
|
|
2008-06-08 22:59:35 +00:00
|
|
|
<ul>
|
2008-10-12 22:57:58 +00:00
|
|
|
<li>vector shifts in the IR: no codegen support yet</li>
|
2008-10-12 18:30:33 +00:00
|
|
|
<li>use diet patch landed: saved 15% IR memory footprint</li>
|
|
|
|
<li>LLVM IR now directly represents "common" linkage, instead of
|
|
|
|
representing it as a form of weak linkage.</li>
|
2008-10-12 19:47:48 +00:00
|
|
|
<li>DebugInfoBuilder</li>
|
2008-10-12 22:57:58 +00:00
|
|
|
<li>.ll printing format change: %3 = add i32 4, 2</li>
|
2008-10-11 18:18:28 +00:00
|
|
|
<li>...</li>
|
2008-02-10 08:17:19 +00:00
|
|
|
</ul>
|
2008-10-13 02:08:34 +00:00
|
|
|
|
2008-02-10 08:17:19 +00:00
|
|
|
</div>
|
|
|
|
|
2007-09-21 03:54:09 +00:00
|
|
|
<!--=========================================================================-->
|
|
|
|
<div class="doc_subsection">
|
2008-02-10 07:46:44 +00:00
|
|
|
<a name="optimizer">Optimizer Improvements</a>
|
2007-09-21 03:54:09 +00:00
|
|
|
</div>
|
2007-05-18 06:33:02 +00:00
|
|
|
|
2006-04-18 06:18:36 +00:00
|
|
|
<div class="doc_text">
|
2007-09-21 03:54:09 +00:00
|
|
|
|
2008-10-13 02:08:34 +00:00
|
|
|
<p>In addition to a huge array of bug fixes and minor performance tweaks, the
|
2008-10-11 18:18:28 +00:00
|
|
|
LLVM 2.4 optimizers support a few major enhancements:</p>
|
2007-09-26 05:44:21 +00:00
|
|
|
|
2006-11-18 07:51:14 +00:00
|
|
|
<ul>
|
2007-05-16 23:25:46 +00:00
|
|
|
|
2008-10-12 19:47:48 +00:00
|
|
|
<li>GVN now does local PRE?</li>
|
|
|
|
|
|
|
|
<li>Matthijs' Dead argument elimination rewrite</li>
|
|
|
|
|
2008-10-12 18:30:33 +00:00
|
|
|
<li>Old-ADCE used control dependence and deleted output-free infinite loops.
|
|
|
|
Added a new Loop deletion pass (for deleting output free provably-finite loops)
|
|
|
|
and rewrote ADCE to be simpler faster, and not need control dependence.</li>
|
|
|
|
|
|
|
|
<li>SparsePropagation framework for lattice-based dataflow solvers.</li>
|
|
|
|
|
2008-10-12 22:57:58 +00:00
|
|
|
<li>Tail duplication was removed from the standard optimizer sequence.</li>
|
2008-10-12 18:30:33 +00:00
|
|
|
|
2008-10-12 19:47:48 +00:00
|
|
|
<li>Various helper functions (ComputeMaskedBits, ComputeNumSignBits, etc) were
|
|
|
|
pulled out of instcombine and put into a new ValueTracking.h file, where they
|
|
|
|
can be reused by other passes.</li>
|
|
|
|
|
2008-10-12 22:57:58 +00:00
|
|
|
<li>MarkModRef etc</li>
|
2008-06-08 02:45:07 +00:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<!--=========================================================================-->
|
|
|
|
<div class="doc_subsection">
|
|
|
|
<a name="codegen">Code Generator Improvements</a>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
|
|
|
<p>We put a significant amount of work into the code generator infrastructure,
|
|
|
|
which allows us to implement more aggressive algorithms and make it run
|
|
|
|
faster:</p>
|
|
|
|
|
|
|
|
<ul>
|
2008-10-12 22:57:58 +00:00
|
|
|
<li>asm writers split out to their own library to avoid JITs having to link
|
|
|
|
them in.</li>
|
|
|
|
<li>Big asm writer refactoring + TargetAsmInfo</li>
|
|
|
|
<li>2-addr pass and coalescer can now remat trivial insts to avoid a copy.</li>
|
2008-10-12 19:47:48 +00:00
|
|
|
<li>spiller to commute instructions in order to fold a reload</li>
|
|
|
|
<li>Stack slot coloring?</li>
|
|
|
|
<li>Live intervals renumbering? Is this useful to external people?</li>
|
|
|
|
<li>'is as cheap as a move' instruction flag</li>
|
|
|
|
<li>Improvements to selection dag viewing</li>
|
|
|
|
<li>fast isel</li>
|
2008-10-11 18:18:28 +00:00
|
|
|
<li>Selection dag speedups</li>
|
2008-10-12 19:47:48 +00:00
|
|
|
<li>asmwriter + raw_ostream -> fastah</li>
|
2008-10-13 17:12:51 +00:00
|
|
|
<li>Partitioned Boolean Quadratic Programming (PBQP) based register
|
|
|
|
allocator.</li>
|
2008-10-11 18:18:28 +00:00
|
|
|
<li>...</li>
|
2008-06-08 02:45:07 +00:00
|
|
|
|
2006-11-18 07:51:14 +00:00
|
|
|
</ul>
|
2007-09-21 03:54:09 +00:00
|
|
|
|
2006-04-18 06:18:36 +00:00
|
|
|
</div>
|
|
|
|
|
2007-09-21 03:54:09 +00:00
|
|
|
|
|
|
|
<!--=========================================================================-->
|
|
|
|
<div class="doc_subsection">
|
2008-06-05 08:02:49 +00:00
|
|
|
<a name="x86specific">X86/X86-64 Specific Improvements</a>
|
2007-09-21 03:54:09 +00:00
|
|
|
</div>
|
2006-11-18 07:51:14 +00:00
|
|
|
|
2006-04-18 06:18:36 +00:00
|
|
|
<div class="doc_text">
|
2008-02-10 08:17:19 +00:00
|
|
|
<p>New target-specific features include:
|
2007-05-14 06:56:09 +00:00
|
|
|
</p>
|
|
|
|
|
|
|
|
<ul>
|
2008-10-12 19:47:48 +00:00
|
|
|
<li>Exception handling is supported by default on Linux/x86-64.</li>
|
|
|
|
<li>Position Independent Code (PIC) is now support on Linux/x86-64.</li>
|
2008-10-11 18:18:28 +00:00
|
|
|
<li>...</li>
|
2008-06-08 21:19:07 +00:00
|
|
|
|
2007-05-16 23:25:46 +00:00
|
|
|
</ul>
|
2008-10-13 02:08:34 +00:00
|
|
|
|
2007-05-14 06:56:09 +00:00
|
|
|
</div>
|
|
|
|
|
2008-06-05 08:02:49 +00:00
|
|
|
<!--=========================================================================-->
|
|
|
|
<div class="doc_subsection">
|
|
|
|
<a name="targetspecific">Other Target Specific Improvements</a>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
<p>New target-specific features include:
|
|
|
|
</p>
|
|
|
|
|
|
|
|
<ul>
|
2008-10-12 22:57:58 +00:00
|
|
|
<li>MIPS floating point support?</li>
|
2008-10-11 18:18:28 +00:00
|
|
|
<li>....</li>
|
2008-06-05 08:02:49 +00:00
|
|
|
</ul>
|
|
|
|
|
2008-10-13 02:08:34 +00:00
|
|
|
</div>
|
2008-06-05 08:02:49 +00:00
|
|
|
|
|
|
|
|
2007-09-21 03:54:09 +00:00
|
|
|
<!--=========================================================================-->
|
|
|
|
<div class="doc_subsection">
|
|
|
|
<a name="otherimprovements">Other Improvements</a>
|
|
|
|
</div>
|
2007-05-14 06:56:09 +00:00
|
|
|
|
2006-04-18 06:32:08 +00:00
|
|
|
<div class="doc_text">
|
2007-09-21 03:54:09 +00:00
|
|
|
<p>New features include:
|
|
|
|
</p>
|
2006-04-18 06:18:36 +00:00
|
|
|
|
2006-02-05 06:39:36 +00:00
|
|
|
<ul>
|
2008-10-13 02:46:01 +00:00
|
|
|
<li><tt>llvmc2</tt> (the generic compiler driver) gained plugin
|
2008-10-13 02:08:34 +00:00
|
|
|
support. It is now easier to experiment with <tt>llvmc2</tt> and
|
|
|
|
build your own tools based on it. </li>
|
2008-10-12 19:47:48 +00:00
|
|
|
<li>raw_ostream + formatting</li>
|
2008-10-12 22:57:58 +00:00
|
|
|
<li>Recycler + pool allocation stuff?</li>
|
2008-10-11 18:18:28 +00:00
|
|
|
<li>...</li>
|
2007-05-17 21:41:31 +00:00
|
|
|
</ul>
|
2008-10-13 02:08:34 +00:00
|
|
|
|
2007-05-17 21:41:31 +00:00
|
|
|
</div>
|
2006-03-03 00:34:26 +00:00
|
|
|
|
2003-10-02 16:38:05 +00:00
|
|
|
<!-- *********************************************************************** -->
|
2003-11-22 00:38:41 +00:00
|
|
|
<div class="doc_section">
|
|
|
|
<a name="portability">Portability and Supported Platforms</a>
|
|
|
|
</div>
|
2003-10-02 16:38:05 +00:00
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
2003-11-22 00:38:41 +00:00
|
|
|
<div class="doc_text">
|
|
|
|
|
2004-12-08 20:35:47 +00:00
|
|
|
<p>LLVM is known to work on the following platforms:</p>
|
2004-06-01 18:22:41 +00:00
|
|
|
|
|
|
|
<ul>
|
2008-10-13 02:08:34 +00:00
|
|
|
<li>Intel and AMD machines (IA32) running Red Hat Linux, Fedora Core and FreeBSD
|
2005-05-17 02:47:27 +00:00
|
|
|
(and probably other unix-like systems).</li>
|
2008-02-06 06:30:34 +00:00
|
|
|
<li>PowerPC and X86-based Mac OS X systems, running 10.3 and above in 32-bit and
|
2007-05-23 04:39:32 +00:00
|
|
|
64-bit modes.</li>
|
2008-02-06 18:00:06 +00:00
|
|
|
<li>Intel and AMD machines running on Win32 using MinGW libraries (native).</li>
|
2004-12-07 08:04:13 +00:00
|
|
|
<li>Intel and AMD machines running on Win32 with the Cygwin libraries (limited
|
|
|
|
support is available for native builds with Visual C++).</li>
|
2008-06-05 18:39:01 +00:00
|
|
|
<li>Sun UltraSPARC workstations running Solaris 10.</li>
|
2005-05-13 20:28:15 +00:00
|
|
|
<li>Alpha-based machines running Debian GNU/Linux.</li>
|
2008-06-05 18:39:01 +00:00
|
|
|
<li>Itanium-based (IA64) machines running Linux and HP-UX.</li>
|
2004-06-01 18:22:41 +00:00
|
|
|
</ul>
|
|
|
|
|
2008-06-05 06:57:39 +00:00
|
|
|
<p>The core LLVM infrastructure uses GNU autoconf to adapt itself
|
2004-05-09 05:28:35 +00:00
|
|
|
to the machine and operating system on which it is built. However, minor
|
|
|
|
porting may be required to get LLVM to work on new platforms. We welcome your
|
|
|
|
portability patches and reports of successful builds or error messages.</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
|
|
|
<div class="doc_section">
|
|
|
|
<a name="knownproblems">Known Problems</a>
|
|
|
|
</div>
|
2003-10-02 04:57:28 +00:00
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
2003-11-22 00:38:41 +00:00
|
|
|
<div class="doc_text">
|
|
|
|
|
|
|
|
<p>This section contains all known problems with the LLVM system, listed by
|
2003-10-02 04:57:28 +00:00
|
|
|
component. As new problems are discovered, they will be added to these
|
2003-12-12 21:22:16 +00:00
|
|
|
sections. If you run into a problem, please check the <a
|
2005-10-29 07:07:09 +00:00
|
|
|
href="http://llvm.org/bugs/">LLVM bug database</a> and submit a bug if
|
2003-12-12 21:22:16 +00:00
|
|
|
there isn't already one.</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
|
|
|
|
2004-03-14 02:03:02 +00:00
|
|
|
<!-- ======================================================================= -->
|
|
|
|
<div class="doc_subsection">
|
|
|
|
<a name="experimental">Experimental features included with this release</a>
|
|
|
|
</div>
|
2003-10-02 04:57:28 +00:00
|
|
|
|
2004-03-14 02:03:02 +00:00
|
|
|
<div class="doc_text">
|
|
|
|
|
2004-05-12 21:46:05 +00:00
|
|
|
<p>The following components of this LLVM release are either untested, known to
|
|
|
|
be broken or unreliable, or are in early development. These components should
|
|
|
|
not be relied on, and bugs should not be filed against them, but they may be
|
|
|
|
useful to some people. In particular, if you would like to work on one of these
|
2008-02-12 06:29:45 +00:00
|
|
|
components, please contact us on the <a
|
|
|
|
href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev">LLVMdev list</a>.</p>
|
2004-03-14 02:03:02 +00:00
|
|
|
|
|
|
|
<ul>
|
2008-02-12 06:29:45 +00:00
|
|
|
<li>The MSIL, IA64, Alpha, SPU, and MIPS backends are experimental.</li>
|
2008-06-08 20:18:35 +00:00
|
|
|
<li>The llc "<tt>-filetype=asm</tt>" (the default) is the only supported
|
2008-02-06 06:30:34 +00:00
|
|
|
value for this option.</li>
|
2004-03-14 02:03:02 +00:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
</div>
|
2003-10-02 04:57:28 +00:00
|
|
|
|
2005-11-08 21:11:33 +00:00
|
|
|
<!-- ======================================================================= -->
|
|
|
|
<div class="doc_subsection">
|
2006-11-18 07:51:14 +00:00
|
|
|
<a name="x86-be">Known problems with the X86 back-end</a>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
|
|
|
<ul>
|
2008-06-08 10:24:13 +00:00
|
|
|
<li>The X86 backend does not yet support
|
|
|
|
all <a href="http://llvm.org/PR879">inline assembly that uses the X86
|
|
|
|
floating point stack</a>. It supports the 'f' and 't' constraints, but not
|
|
|
|
'u'.</li>
|
2008-06-08 21:19:07 +00:00
|
|
|
<li>The X86 backend generates inefficient floating point code when configured
|
|
|
|
to generate code for systems that don't have SSE2.</li>
|
2008-06-08 19:38:43 +00:00
|
|
|
<li>Win64 code generation wasn't widely tested. Everything should work, but we
|
2008-06-08 10:24:13 +00:00
|
|
|
expect small issues to happen. Also, llvm-gcc cannot build mingw64 runtime
|
|
|
|
currently due
|
|
|
|
to <a href="http://llvm.org/PR2255">several</a>
|
2008-06-08 23:12:47 +00:00
|
|
|
<a href="http://llvm.org/PR2257">bugs</a> due to lack of support for the
|
|
|
|
'u' inline assembly constraint and X87 floating point inline assembly.</li>
|
2008-06-08 23:05:11 +00:00
|
|
|
<li>The X86-64 backend does not yet support the LLVM IR instruction
|
|
|
|
<tt>va_arg</tt>. Currently, the llvm-gcc front-end supports variadic
|
|
|
|
argument constructs on X86-64 by lowering them manually.</li>
|
2006-11-18 07:51:14 +00:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
<div class="doc_subsection">
|
|
|
|
<a name="ppc-be">Known problems with the PowerPC back-end</a>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
|
|
|
<ul>
|
2007-05-15 09:21:28 +00:00
|
|
|
<li>The Linux PPC32/ABI support needs testing for the interpreter and static
|
2007-05-23 04:39:32 +00:00
|
|
|
compilation, and lacks support for debug information.</li>
|
2006-11-18 07:51:14 +00:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
<div class="doc_subsection">
|
2007-05-14 06:56:09 +00:00
|
|
|
<a name="arm-be">Known problems with the ARM back-end</a>
|
2006-11-18 07:51:14 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
|
|
|
<ul>
|
2007-05-23 04:39:32 +00:00
|
|
|
<li>Thumb mode works only on ARMv6 or higher processors. On sub-ARMv6
|
2007-09-26 15:59:54 +00:00
|
|
|
processors, thumb programs can crash or produce wrong
|
2007-05-23 04:39:32 +00:00
|
|
|
results (<a href="http://llvm.org/PR1388">PR1388</a>).</li>
|
2007-05-14 06:56:09 +00:00
|
|
|
<li>Compilation for ARM Linux OABI (old ABI) is supported, but not fully tested.
|
|
|
|
</li>
|
2008-06-08 21:19:07 +00:00
|
|
|
<li>There is a bug in QEMU-ARM (<= 0.9.0) which causes it to incorrectly
|
|
|
|
execute
|
2007-05-23 04:39:32 +00:00
|
|
|
programs compiled with LLVM. Please use more recent versions of QEMU.</li>
|
2006-11-18 07:51:14 +00:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
<div class="doc_subsection">
|
2007-05-14 06:56:09 +00:00
|
|
|
<a name="sparc-be">Known problems with the SPARC back-end</a>
|
2006-11-18 07:51:14 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
|
|
|
<ul>
|
2007-05-14 06:56:09 +00:00
|
|
|
<li>The SPARC backend only supports the 32-bit SPARC ABI (-m32), it does not
|
|
|
|
support the 64-bit SPARC ABI (-m64).</li>
|
2006-11-18 07:51:14 +00:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
<div class="doc_subsection">
|
|
|
|
<a name="alpha-be">Known problems with the Alpha back-end</a>
|
2005-11-08 21:11:33 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
|
|
|
<ul>
|
2006-11-18 07:51:14 +00:00
|
|
|
|
|
|
|
<li>On 21164s, some rare FP arithmetic sequences which may trap do not have the
|
|
|
|
appropriate nops inserted to ensure restartability.</li>
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
<div class="doc_subsection">
|
|
|
|
<a name="ia64-be">Known problems with the IA64 back-end</a>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
|
|
|
<ul>
|
2008-06-08 23:12:47 +00:00
|
|
|
<li>The Itanium backend is highly experimental, and has a number of known
|
|
|
|
issues. We are looking for a maintainer for the Itanium backend. If you
|
|
|
|
are interested, please contact the llvmdev mailing list.</li>
|
2005-11-08 21:11:33 +00:00
|
|
|
</ul>
|
2006-11-18 07:51:14 +00:00
|
|
|
|
2005-11-08 21:11:33 +00:00
|
|
|
</div>
|
|
|
|
|
2006-11-18 07:51:14 +00:00
|
|
|
<!-- ======================================================================= -->
|
|
|
|
<div class="doc_subsection">
|
2007-05-14 06:56:09 +00:00
|
|
|
<a name="c-be">Known problems with the C back-end</a>
|
2006-11-18 07:51:14 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
|
|
|
<ul>
|
2008-06-05 06:35:40 +00:00
|
|
|
<li><a href="http://llvm.org/PR802">The C backend has only basic support for
|
|
|
|
inline assembly code</a>.</li>
|
2007-09-26 06:01:35 +00:00
|
|
|
<li><a href="http://llvm.org/PR1658">The C backend violates the ABI of common
|
|
|
|
C++ programs</a>, preventing intermixing between C++ compiled by the CBE and
|
2008-06-08 20:18:35 +00:00
|
|
|
C++ code compiled with llc or native compilers.</li>
|
2008-02-10 13:40:55 +00:00
|
|
|
<li>The C backend does not support all exception handling constructs.</li>
|
2006-11-18 07:51:14 +00:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
</div>
|
2005-11-08 21:11:33 +00:00
|
|
|
|
2003-11-22 00:38:41 +00:00
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
<div class="doc_subsection">
|
2008-06-05 06:35:40 +00:00
|
|
|
<a name="c-fe">Known problems with the llvm-gcc C front-end</a>
|
2003-11-22 00:38:41 +00:00
|
|
|
</div>
|
2003-10-02 05:07:23 +00:00
|
|
|
|
2003-11-22 00:38:41 +00:00
|
|
|
<div class="doc_text">
|
2006-03-03 00:34:26 +00:00
|
|
|
|
2008-02-06 18:00:06 +00:00
|
|
|
<p>llvm-gcc does not currently support <a href="http://llvm.org/PR869">Link-Time
|
|
|
|
Optimization</a> on most platforms "out-of-the-box". Please inquire on the
|
2007-05-14 06:56:09 +00:00
|
|
|
llvmdev mailing list if you are interested.</p>
|
2006-11-18 07:51:14 +00:00
|
|
|
|
2008-06-05 06:35:40 +00:00
|
|
|
<p>The only major language feature of GCC not supported by llvm-gcc is
|
|
|
|
the <tt>__builtin_apply</tt> family of builtins. However, some extensions
|
|
|
|
are only supported on some targets. For example, trampolines are only
|
2008-06-08 20:18:35 +00:00
|
|
|
supported on some targets (these are used when you take the address of a
|
|
|
|
nested function).</p>
|
2007-09-26 15:59:54 +00:00
|
|
|
|
2008-06-05 06:35:40 +00:00
|
|
|
<p>If you run into GCC extensions which are not supported, please let us know.
|
|
|
|
</p>
|
2003-11-22 00:38:41 +00:00
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<!-- ======================================================================= -->
|
|
|
|
<div class="doc_subsection">
|
2008-06-05 06:35:40 +00:00
|
|
|
<a name="c++-fe">Known problems with the llvm-gcc C++ front-end</a>
|
2003-11-22 00:38:41 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
|
2007-05-14 06:56:09 +00:00
|
|
|
<p>The C++ front-end is considered to be fully
|
2004-12-07 08:04:13 +00:00
|
|
|
tested and works for a number of non-trivial programs, including LLVM
|
2007-05-14 06:56:09 +00:00
|
|
|
itself, Qt, Mozilla, etc.</p>
|
2003-10-02 04:57:28 +00:00
|
|
|
|
2003-11-22 00:38:41 +00:00
|
|
|
<ul>
|
2008-10-11 18:27:16 +00:00
|
|
|
<li>Exception handling works well on the X86 and PowerPC targets. Currently
|
|
|
|
only linux and darwin targets are supported (both 32 and 64 bit).</li>
|
2003-11-22 00:38:41 +00:00
|
|
|
</ul>
|
2003-10-07 22:14:37 +00:00
|
|
|
|
2003-11-22 00:38:41 +00:00
|
|
|
</div>
|
2003-10-07 22:14:37 +00:00
|
|
|
|
2006-04-18 06:18:36 +00:00
|
|
|
|
2008-02-12 06:29:45 +00:00
|
|
|
<!-- ======================================================================= -->
|
|
|
|
<div class="doc_subsection">
|
2008-06-05 06:35:40 +00:00
|
|
|
<a name="ada-fe">Known problems with the llvm-gcc Ada front-end</a>
|
2008-02-12 06:29:45 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="doc_text">
|
|
|
|
The llvm-gcc 4.2 Ada compiler works fairly well, however this is not a mature
|
|
|
|
technology and problems should be expected.
|
|
|
|
<ul>
|
2008-06-08 20:18:35 +00:00
|
|
|
<li>The Ada front-end currently only builds on X86-32. This is mainly due
|
2008-02-12 06:29:45 +00:00
|
|
|
to lack of trampoline support (pointers to nested functions) on other platforms,
|
2008-06-08 20:18:35 +00:00
|
|
|
however it <a href="http://llvm.org/PR2006">also fails to build on X86-64</a>
|
2008-02-12 06:29:45 +00:00
|
|
|
which does support trampolines.</li>
|
|
|
|
<li>The Ada front-end <a href="http://llvm.org/PR2007">fails to bootstrap</a>.
|
|
|
|
Workaround: configure with --disable-bootstrap.</li>
|
2008-10-13 17:27:23 +00:00
|
|
|
<li>The c380004, <a href="http://llvm.org/PR2010">c393010</a>
|
|
|
|
and <a href="http://llvm.org/PR2421">cxg2021</a> ACATS tests fail
|
|
|
|
(c380004 also fails with gcc-4.2 mainline).</li>
|
|
|
|
<li>Some gcc specific Ada tests continue to crash the compiler.</li>
|
2008-02-12 06:29:45 +00:00
|
|
|
<li>The -E binder option (exception backtraces)
|
|
|
|
<a href="http://llvm.org/PR1982">does not work</a> and will result in programs
|
|
|
|
crashing if an exception is raised. Workaround: do not use -E.</li>
|
|
|
|
<li>Only discrete types <a href="http://llvm.org/PR1981">are allowed to start
|
|
|
|
or finish at a non-byte offset</a> in a record. Workaround: do not pack records
|
|
|
|
or use representation clauses that result in a field of a non-discrete type
|
|
|
|
starting or finishing in the middle of a byte.</li>
|
2008-06-08 21:19:07 +00:00
|
|
|
<li>The <tt>lli</tt> interpreter <a href="http://llvm.org/PR2009">considers
|
|
|
|
'main' as generated by the Ada binder to be invalid</a>.
|
|
|
|
Workaround: hand edit the file to use pointers for <tt>argv</tt> and
|
|
|
|
<tt>envp</tt> rather than integers.</li>
|
|
|
|
<li>The <tt>-fstack-check</tt> option <a href="http://llvm.org/PR2008">is
|
|
|
|
ignored</a>.</li>
|
2008-02-12 06:29:45 +00:00
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
2003-10-02 04:57:28 +00:00
|
|
|
<!-- *********************************************************************** -->
|
2003-11-22 00:38:41 +00:00
|
|
|
<div class="doc_section">
|
|
|
|
<a name="additionalinfo">Additional Information</a>
|
|
|
|
</div>
|
2003-10-02 04:57:28 +00:00
|
|
|
<!-- *********************************************************************** -->
|
|
|
|
|
2003-11-22 00:38:41 +00:00
|
|
|
<div class="doc_text">
|
|
|
|
|
2005-05-16 17:13:10 +00:00
|
|
|
<p>A wide variety of additional information is available on the <a
|
2007-05-18 00:44:29 +00:00
|
|
|
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
|
2007-07-09 08:04:31 +00:00
|
|
|
contains versions of the API documentation which is up-to-date with the
|
|
|
|
Subversion version of the source code.
|
2005-03-30 19:14:24 +00:00
|
|
|
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
|
2005-10-29 07:07:09 +00:00
|
|
|
us via the <a href="http://llvm.org/docs/#maillist"> mailing
|
2003-12-12 21:22:16 +00:00
|
|
|
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
|
2003-11-22 01:23:39 +00:00
|
|
|
src="http://jigsaw.w3.org/css-validator/images/vcss" alt="Valid CSS!"></a>
|
|
|
|
<a href="http://validator.w3.org/check/referer"><img
|
2008-02-10 08:18:42 +00:00
|
|
|
src="http://www.w3.org/Icons/valid-html401" 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>
|