Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" |
| 2 | "http://www.w3.org/TR/html4/strict.dtd"> |
| 3 | <html> |
| 4 | <head> |
Reid Spencer | 6454ed3 | 2004-11-18 18:38:58 +0000 | [diff] [blame] | 5 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> |
Chris Lattner | 2fb6e5c | 2010-10-03 23:09:03 +0000 | [diff] [blame] | 6 | <meta encoding="utf8"> |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 7 | <link rel="stylesheet" href="llvm.css" type="text/css"> |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 8 | <title>LLVM 2.9 Release Notes</title> |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 9 | </head> |
| 10 | <body> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 11 | |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 12 | <div class="doc_title">LLVM 2.9 Release Notes</div> |
Mikhail Glushenkov | ea65d7d | 2008-10-13 02:08:34 +0000 | [diff] [blame] | 13 | |
Chris Lattner | 0e464a9 | 2010-03-17 04:02:39 +0000 | [diff] [blame] | 14 | <img align=right src="http://llvm.org/img/DragonSmall.png" |
Gabor Greif | ee2187a | 2010-04-22 10:21:43 +0000 | [diff] [blame] | 15 | width="136" height="136" alt="LLVM Dragon Logo"> |
Chris Lattner | 0e464a9 | 2010-03-17 04:02:39 +0000 | [diff] [blame] | 16 | |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 17 | <ol> |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 18 | <li><a href="#intro">Introduction</a></li> |
Chris Lattner | 96a445e | 2008-10-13 18:01:01 +0000 | [diff] [blame] | 19 | <li><a href="#subproj">Sub-project Status Update</a></li> |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 20 | <li><a href="#externalproj">External Projects Using LLVM 2.9</a></li> |
| 21 | <li><a href="#whatsnew">What's New in LLVM 2.9?</a></li> |
Chris Lattner | 4b538b9 | 2004-04-30 22:17:12 +0000 | [diff] [blame] | 22 | <li><a href="GettingStarted.html">Installation Instructions</a></li> |
Dan Gohman | 44aa921 | 2008-10-14 16:23:02 +0000 | [diff] [blame] | 23 | <li><a href="#knownproblems">Known Problems</a></li> |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 24 | <li><a href="#additionalinfo">Additional Information</a></li> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 25 | </ol> |
| 26 | |
Chris Lattner | 7911ce2 | 2004-05-23 21:07:27 +0000 | [diff] [blame] | 27 | <div class="doc_author"> |
Dan Gohman | 44aa921 | 2008-10-14 16:23:02 +0000 | [diff] [blame] | 28 | <p>Written by the <a href="http://llvm.org">LLVM Team</a></p> |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 29 | </div> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 30 | |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 31 | <h1 style="color:red">These are in-progress notes for the upcoming LLVM 2.9 |
Jeffrey Yasskin | bec4877 | 2010-01-28 01:14:43 +0000 | [diff] [blame] | 32 | release.<br> |
| 33 | You may prefer the |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 34 | <a href="http://llvm.org/releases/2.8/docs/ReleaseNotes.html">LLVM 2.8 |
Dan Gohman | b44f6c6 | 2010-05-03 23:51:05 +0000 | [diff] [blame] | 35 | Release Notes</a>.</h1> |
Jeffrey Yasskin | bec4877 | 2010-01-28 01:14:43 +0000 | [diff] [blame] | 36 | |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 37 | <!-- *********************************************************************** --> |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 38 | <div class="doc_section"> |
| 39 | <a name="intro">Introduction</a> |
| 40 | </div> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 41 | <!-- *********************************************************************** --> |
| 42 | |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 43 | <div class="doc_text"> |
| 44 | |
Chris Lattner | f6662f9 | 2008-10-13 17:57:36 +0000 | [diff] [blame] | 45 | <p>This document contains the release notes for the LLVM Compiler |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 46 | Infrastructure, release 2.9. Here we describe the status of LLVM, including |
Chris Lattner | f6662f9 | 2008-10-13 17:57:36 +0000 | [diff] [blame] | 47 | major improvements from the previous release and significant known problems. |
Mikhail Glushenkov | f795ef0 | 2009-03-01 18:09:47 +0000 | [diff] [blame] | 48 | All LLVM releases may be downloaded from the <a |
Chris Lattner | f6662f9 | 2008-10-13 17:57:36 +0000 | [diff] [blame] | 49 | href="http://llvm.org/releases/">LLVM releases web site</a>.</p> |
Chris Lattner | 1909261 | 2003-10-02 16:38:05 +0000 | [diff] [blame] | 50 | |
Chris Lattner | 7506b1d | 2004-12-07 08:04:13 +0000 | [diff] [blame] | 51 | <p>For more information about LLVM, including information about the latest |
Chris Lattner | c463b27 | 2005-10-29 07:07:09 +0000 | [diff] [blame] | 52 | release, please check out the <a href="http://llvm.org/">main LLVM |
Chris Lattner | 47ad72c | 2003-10-07 21:38:31 +0000 | [diff] [blame] | 53 | web site</a>. If you have questions or comments, the <a |
Chris Lattner | c66bfef | 2010-03-17 04:41:49 +0000 | [diff] [blame] | 54 | href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev">LLVM Developer's |
| 55 | Mailing List</a> is a good place to send them.</p> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 56 | |
Mikhail Glushenkov | ea65d7d | 2008-10-13 02:08:34 +0000 | [diff] [blame] | 57 | <p>Note that if you are reading this file from a Subversion checkout or the |
Chris Lattner | 8497764 | 2007-09-21 03:54:09 +0000 | [diff] [blame] | 58 | main LLVM web page, this document applies to the <i>next</i> release, not the |
Gabor Greif | fa933f8 | 2008-10-14 11:00:32 +0000 | [diff] [blame] | 59 | current one. To see the release notes for a specific release, please see the |
Chris Lattner | 8497764 | 2007-09-21 03:54:09 +0000 | [diff] [blame] | 60 | <a href="http://llvm.org/releases/">releases page</a>.</p> |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 61 | |
| 62 | </div> |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 63 | |
| 64 | <!-- NOTE: last release for llvm-gcc --> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 65 | |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 66 | <!-- |
| 67 | Almost dead code. |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 68 | lib/Transforms/IPO/MergeFunctions.cpp => consider for 3.0. |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 69 | --> |
| 70 | |
| 71 | |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 72 | <!-- Features that need text if they're finished for 3.0: |
Chris Lattner | 914ce46 | 2010-04-22 06:28:20 +0000 | [diff] [blame] | 73 | combiner-aa? |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 74 | strong phi elim |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 75 | loop dependence analysis |
Chris Lattner | 885b661 | 2010-08-28 16:33:36 +0000 | [diff] [blame] | 76 | TBAA |
Chris Lattner | e07043c | 2010-09-29 05:30:03 +0000 | [diff] [blame] | 77 | CorrelatedValuePropagation |
Chris Lattner | acce85d | 2008-02-10 07:46:44 +0000 | [diff] [blame] | 78 | --> |
Chris Lattner | e07043c | 2010-09-29 05:30:03 +0000 | [diff] [blame] | 79 | |
Chris Lattner | 96a445e | 2008-10-13 18:01:01 +0000 | [diff] [blame] | 80 | <!-- *********************************************************************** --> |
| 81 | <div class="doc_section"> |
| 82 | <a name="subproj">Sub-project Status Update</a> |
Chris Lattner | ea34f64 | 2008-06-08 21:34:41 +0000 | [diff] [blame] | 83 | </div> |
Chris Lattner | 96a445e | 2008-10-13 18:01:01 +0000 | [diff] [blame] | 84 | <!-- *********************************************************************** --> |
Chris Lattner | ea34f64 | 2008-06-08 21:34:41 +0000 | [diff] [blame] | 85 | |
| 86 | <div class="doc_text"> |
Chris Lattner | 8348b47 | 2008-06-08 21:58:17 +0000 | [diff] [blame] | 87 | <p> |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 88 | The LLVM 2.9 distribution currently consists of code from the core LLVM |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 89 | repository (which roughly includes the LLVM optimizers, code generators |
| 90 | and supporting tools), the Clang repository and the llvm-gcc repository. In |
| 91 | addition to this code, the LLVM Project includes other sub-projects that are in |
| 92 | development. Here we include updates on these subprojects. |
Bill Wendling | 63d8c55 | 2009-03-02 04:28:57 +0000 | [diff] [blame] | 93 | </p> |
Chris Lattner | 96a445e | 2008-10-13 18:01:01 +0000 | [diff] [blame] | 94 | |
Chris Lattner | 8348b47 | 2008-06-08 21:58:17 +0000 | [diff] [blame] | 95 | </div> |
| 96 | |
Chris Lattner | 96a445e | 2008-10-13 18:01:01 +0000 | [diff] [blame] | 97 | |
Chris Lattner | 8348b47 | 2008-06-08 21:58:17 +0000 | [diff] [blame] | 98 | <!--=========================================================================--> |
Chris Lattner | 96a445e | 2008-10-13 18:01:01 +0000 | [diff] [blame] | 99 | <div class="doc_subsection"> |
Chris Lattner | fb97b2d | 2008-10-13 18:11:54 +0000 | [diff] [blame] | 100 | <a name="clang">Clang: C/C++/Objective-C Frontend Toolkit</a> |
Chris Lattner | 8348b47 | 2008-06-08 21:58:17 +0000 | [diff] [blame] | 101 | </div> |
| 102 | |
| 103 | <div class="doc_text"> |
| 104 | |
Chris Lattner | 095539f | 2010-04-26 17:42:18 +0000 | [diff] [blame] | 105 | <p><a href="http://clang.llvm.org/">Clang</a> is an LLVM front end for the C, |
| 106 | C++, and Objective-C languages. Clang aims to provide a better user experience |
| 107 | through expressive diagnostics, a high level of conformance to language |
| 108 | standards, fast compilation, and low memory use. Like LLVM, Clang provides a |
| 109 | modular, library-based architecture that makes it suitable for creating or |
| 110 | integrating with other development tools. Clang is considered a |
Chris Lattner | e07043c | 2010-09-29 05:30:03 +0000 | [diff] [blame] | 111 | production-quality compiler for C, Objective-C, C++ and Objective-C++ on x86 |
| 112 | (32- and 64-bit), and for darwin-arm targets.</p> |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 113 | |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 114 | <p>In the LLVM 2.9 time-frame, the Clang team has made many improvements:</p> |
Bill Wendling | 741748a | 2008-10-27 09:27:33 +0000 | [diff] [blame] | 115 | |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 116 | <ul> |
| 117 | </ul> |
Chris Lattner | fb97b2d | 2008-10-13 18:11:54 +0000 | [diff] [blame] | 118 | </div> |
| 119 | |
| 120 | <!--=========================================================================--> |
| 121 | <div class="doc_subsection"> |
| 122 | <a name="clangsa">Clang Static Analyzer</a> |
| 123 | </div> |
| 124 | |
| 125 | <div class="doc_text"> |
| 126 | |
Chris Lattner | 8cdd793 | 2010-04-22 06:38:11 +0000 | [diff] [blame] | 127 | <p>The <a href="http://clang-analyzer.llvm.org/">Clang Static Analyzer</a> |
| 128 | project is an effort to use static source code analysis techniques to |
| 129 | automatically find bugs in C and Objective-C programs (and hopefully <a |
| 130 | href="http://clang-analyzer.llvm.org/dev_cxx.html">C++ in the |
| 131 | future</a>!). The tool is very good at finding bugs that occur on specific |
| 132 | paths through code, such as on error conditions.</p> |
Chris Lattner | cc04261 | 2008-10-14 00:52:49 +0000 | [diff] [blame] | 133 | |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 134 | <p>The LLVM 2.9 release... |
Chris Lattner | 8cdd793 | 2010-04-22 06:38:11 +0000 | [diff] [blame] | 135 | </p> |
Chris Lattner | 8348b47 | 2008-06-08 21:58:17 +0000 | [diff] [blame] | 136 | |
| 137 | </div> |
| 138 | |
Chris Lattner | 96a445e | 2008-10-13 18:01:01 +0000 | [diff] [blame] | 139 | <!--=========================================================================--> |
| 140 | <div class="doc_subsection"> |
Duncan Sands | 749fd83 | 2010-04-02 09:23:15 +0000 | [diff] [blame] | 141 | <a name="dragonegg">DragonEgg: llvm-gcc ported to gcc-4.5</a> |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 142 | </div> |
| 143 | |
| 144 | <div class="doc_text"> |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 145 | NOTE: This should be written to be self-contained without referencing llvm-gcc. |
| 146 | |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 147 | <p> |
Duncan Sands | 749fd83 | 2010-04-02 09:23:15 +0000 | [diff] [blame] | 148 | <a href="http://dragonegg.llvm.org/">DragonEgg</a> is a port of llvm-gcc to |
Duncan Sands | 4b1da2b | 2010-09-30 17:37:34 +0000 | [diff] [blame] | 149 | gcc-4.5. Unlike llvm-gcc, dragonegg in theory does not require any gcc-4.5 |
| 150 | modifications whatsoever (currently one small patch is needed) thanks to the |
| 151 | new <a href="http://gcc.gnu.org/wiki/plugins">gcc plugin architecture</a>. |
| 152 | DragonEgg is a gcc plugin that makes gcc-4.5 use the LLVM optimizers and code |
| 153 | generators instead of gcc's, just like with llvm-gcc. |
Duncan Sands | 749fd83 | 2010-04-02 09:23:15 +0000 | [diff] [blame] | 154 | </p> |
| 155 | |
| 156 | <p> |
Duncan Sands | 4b1da2b | 2010-09-30 17:37:34 +0000 | [diff] [blame] | 157 | DragonEgg is still a work in progress, but it is able to compile a lot of code, |
| 158 | for example all of gcc, LLVM and clang. Currently Ada, C, C++ and Fortran work |
| 159 | well, while all other languages either don't work at all or only work poorly. |
| 160 | For the moment only the x86-32 and x86-64 targets are supported, and only on |
| 161 | linux and darwin (darwin may need additional gcc patches). |
Duncan Sands | 749fd83 | 2010-04-02 09:23:15 +0000 | [diff] [blame] | 162 | </p> |
| 163 | |
| 164 | <p> |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 165 | The 2.9 release has the following notable changes: |
Duncan Sands | 4b1da2b | 2010-09-30 17:37:34 +0000 | [diff] [blame] | 166 | <ul> |
Duncan Sands | 4b1da2b | 2010-09-30 17:37:34 +0000 | [diff] [blame] | 167 | </ul> |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 168 | |
| 169 | </div> |
| 170 | |
Chris Lattner | 7554771 | 2010-10-03 23:49:06 +0000 | [diff] [blame] | 171 | <!--=========================================================================--> |
| 172 | <div class="doc_subsection"> |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 173 | <a name="vmkit">VMKit: JVM Virtual Machine Implementation</a> |
Chris Lattner | 7554771 | 2010-10-03 23:49:06 +0000 | [diff] [blame] | 174 | </div> |
| 175 | |
| 176 | <div class="doc_text"> |
| 177 | <p> |
| 178 | The <a href="http://vmkit.llvm.org/">VMKit project</a> is an implementation of |
| 179 | a Java Virtual Machine (Java VM or JVM) that uses LLVM for static and |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 180 | just-in-time compilation. |
| 181 | |
| 182 | UPDATE. |
Chris Lattner | 7554771 | 2010-10-03 23:49:06 +0000 | [diff] [blame] | 183 | </p> |
| 184 | </div> |
| 185 | |
| 186 | <!--=========================================================================--> |
| 187 | <div class="doc_subsection"> |
| 188 | <a name="compiler-rt">compiler-rt: Compiler Runtime Library</a> |
| 189 | </div> |
| 190 | |
| 191 | <div class="doc_text"> |
| 192 | <p> |
| 193 | The new LLVM <a href="http://compiler-rt.llvm.org/">compiler-rt project</a> |
| 194 | is a simple library that provides an implementation of the low-level |
| 195 | target-specific hooks required by code generation and other runtime components. |
| 196 | For example, when compiling for a 32-bit target, converting a double to a 64-bit |
| 197 | unsigned integer is compiled into a runtime call to the "__fixunsdfdi" |
| 198 | function. The compiler-rt library provides highly optimized implementations of |
| 199 | this and other low-level routines (some are 3x faster than the equivalent |
| 200 | libgcc routines).</p> |
| 201 | |
| 202 | <p> |
| 203 | All of the code in the compiler-rt project is available under the standard LLVM |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 204 | License, a "BSD-style" license. |
| 205 | |
| 206 | NEW: MIT License as well. |
| 207 | |
| 208 | New in LLVM 2.9, UPDATE</p> |
Chris Lattner | 7554771 | 2010-10-03 23:49:06 +0000 | [diff] [blame] | 209 | |
| 210 | </div> |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 211 | |
| 212 | <!--=========================================================================--> |
| 213 | <div class="doc_subsection"> |
Chris Lattner | e07043c | 2010-09-29 05:30:03 +0000 | [diff] [blame] | 214 | <a name="lldb">LLDB: Low Level Debugger</a> |
| 215 | </div> |
| 216 | |
| 217 | <div class="doc_text"> |
| 218 | <p> |
Chris Lattner | 7554771 | 2010-10-03 23:49:06 +0000 | [diff] [blame] | 219 | <a href="http://lldb.llvm.org/">LLDB</a> is a brand new member of the LLVM |
| 220 | umbrella of projects. LLDB is a next generation, high-performance debugger. It |
| 221 | is built as a set of reusable components which highly leverage existing |
| 222 | libraries in the larger LLVM Project, such as the Clang expression parser, the |
| 223 | LLVM disassembler and the LLVM JIT.</p> |
Chris Lattner | e07043c | 2010-09-29 05:30:03 +0000 | [diff] [blame] | 224 | |
| 225 | <p> |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 226 | LLDB is in early development and not included as part of the LLVM 2.9 release, |
| 227 | UPDATE! |
| 228 | |
| 229 | <!-- |
Chris Lattner | 7554771 | 2010-10-03 23:49:06 +0000 | [diff] [blame] | 230 | but is mature enough to support basic debugging scenarios on Mac OS X in C, |
| 231 | Objective-C and C++. We'd really like help extending and expanding LLDB to |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 232 | support new platforms, new languages, new architectures, and new features.--> |
Chris Lattner | e07043c | 2010-09-29 05:30:03 +0000 | [diff] [blame] | 233 | </p> |
| 234 | |
| 235 | </div> |
| 236 | |
| 237 | <!--=========================================================================--> |
| 238 | <div class="doc_subsection"> |
| 239 | <a name="libc++">libc++: C++ Standard Library</a> |
| 240 | </div> |
| 241 | |
| 242 | <div class="doc_text"> |
| 243 | <p> |
Tobias Grosser | cdce44b | 2010-10-06 21:07:30 +0000 | [diff] [blame] | 244 | <a href="http://libcxx.llvm.org/">libc++</a> is another new member of the LLVM |
Chris Lattner | 7554771 | 2010-10-03 23:49:06 +0000 | [diff] [blame] | 245 | family. It is an implementation of the C++ standard library, written from the |
| 246 | ground up to specifically target the forthcoming C++'0X standard and focus on |
| 247 | delivering great performance.</p> |
Chris Lattner | e07043c | 2010-09-29 05:30:03 +0000 | [diff] [blame] | 248 | |
| 249 | <p> |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 250 | As of the LLVM 2.9 release, UPDATE! |
| 251 | |
| 252 | <!--libc++ is virtually feature complete, but would |
Chris Lattner | 7554771 | 2010-10-03 23:49:06 +0000 | [diff] [blame] | 253 | benefit from more testing and better integration with Clang++. It is also |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 254 | looking forward to the C++ committee finalizing the C++'0x standard.--> |
Chris Lattner | e07043c | 2010-09-29 05:30:03 +0000 | [diff] [blame] | 255 | </p> |
| 256 | |
| 257 | </div> |
| 258 | |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 259 | |
Daniel Dunbar | 97b01a8 | 2010-10-04 17:39:47 +0000 | [diff] [blame] | 260 | |
| 261 | <!--=========================================================================--> |
| 262 | <div class="doc_subsection"> |
| 263 | <a name="klee">KLEE: A Symbolic Execution Virtual Machine</a> |
| 264 | </div> |
| 265 | |
| 266 | <div class="doc_text"> |
| 267 | <p> |
| 268 | <a href="http://klee.llvm.org/">KLEE</a> is a symbolic execution framework for |
| 269 | programs in LLVM bitcode form. KLEE tries to symbolically evaluate "all" paths |
| 270 | through the application and records state transitions that lead to fault |
| 271 | states. This allows it to construct testcases that lead to faults and can even |
| 272 | be used to verify some algorithms. |
| 273 | </p> |
| 274 | |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 275 | <p>UPDATE!</p> |
Daniel Dunbar | 97b01a8 | 2010-10-04 17:39:47 +0000 | [diff] [blame] | 276 | |
| 277 | </div> |
| 278 | |
| 279 | |
Chris Lattner | ab68e9e | 2009-02-26 22:33:38 +0000 | [diff] [blame] | 280 | <!-- *********************************************************************** --> |
| 281 | <div class="doc_section"> |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 282 | <a name="externalproj">External Open Source Projects Using LLVM 2.9</a> |
Chris Lattner | ab68e9e | 2009-02-26 22:33:38 +0000 | [diff] [blame] | 283 | </div> |
| 284 | <!-- *********************************************************************** --> |
| 285 | |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 286 | <div class="doc_text"> |
| 287 | |
| 288 | <p>An exciting aspect of LLVM is that it is used as an enabling technology for |
| 289 | a lot of other language and tools projects. This section lists some of the |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 290 | projects that have already been updated to work with LLVM 2.9.</p> |
Chris Lattner | 7c8e796 | 2010-04-26 17:38:10 +0000 | [diff] [blame] | 291 | </div> |
| 292 | |
Chris Lattner | 7554771 | 2010-10-03 23:49:06 +0000 | [diff] [blame] | 293 | |
| 294 | |
Chris Lattner | e051844 | 2010-10-01 06:34:49 +0000 | [diff] [blame] | 295 | |
Chris Lattner | 8348b47 | 2008-06-08 21:58:17 +0000 | [diff] [blame] | 296 | <!-- *********************************************************************** --> |
| 297 | <div class="doc_section"> |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 298 | <a name="whatsnew">What's New in LLVM 2.9?</a> |
Chris Lattner | 8348b47 | 2008-06-08 21:58:17 +0000 | [diff] [blame] | 299 | </div> |
| 300 | <!-- *********************************************************************** --> |
| 301 | |
Chris Lattner | f8e0b4e | 2008-06-08 22:59:35 +0000 | [diff] [blame] | 302 | <div class="doc_text"> |
| 303 | |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 304 | <p>This release includes a huge number of bug fixes, performance tweaks and |
Chris Lattner | f6662f9 | 2008-10-13 17:57:36 +0000 | [diff] [blame] | 305 | minor improvements. Some of the major improvements and new features are listed |
| 306 | in this section. |
Chris Lattner | f8e0b4e | 2008-06-08 22:59:35 +0000 | [diff] [blame] | 307 | </p> |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 308 | |
Chris Lattner | 914ce46 | 2010-04-22 06:28:20 +0000 | [diff] [blame] | 309 | </div> |
| 310 | |
| 311 | <!--=========================================================================--> |
| 312 | <div class="doc_subsection"> |
Chris Lattner | 252b83d | 2008-02-06 18:00:06 +0000 | [diff] [blame] | 313 | <a name="majorfeatures">Major New Features</a> |
| 314 | </div> |
| 315 | |
| 316 | <div class="doc_text"> |
| 317 | |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 318 | <p>LLVM 2.9 includes several major new capabilities:</p> |
Chris Lattner | f3e5bc6 | 2007-05-14 06:56:09 +0000 | [diff] [blame] | 319 | |
| 320 | <ul> |
Chris Lattner | 8170c10 | 2008-02-10 08:18:42 +0000 | [diff] [blame] | 321 | </ul> |
Chris Lattner | dc91008 | 2010-03-17 06:41:58 +0000 | [diff] [blame] | 322 | |
Chris Lattner | f3e5bc6 | 2007-05-14 06:56:09 +0000 | [diff] [blame] | 323 | </div> |
| 324 | |
Chris Lattner | 8497764 | 2007-09-21 03:54:09 +0000 | [diff] [blame] | 325 | <!--=========================================================================--> |
| 326 | <div class="doc_subsection"> |
Chris Lattner | 917cc71 | 2009-03-02 02:37:32 +0000 | [diff] [blame] | 327 | <a name="coreimprovements">LLVM IR and Core Improvements</a> |
Chris Lattner | f304ffc | 2008-02-10 08:17:19 +0000 | [diff] [blame] | 328 | </div> |
| 329 | |
| 330 | <div class="doc_text"> |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 331 | <p>LLVM IR has several new features for better support of new targets and that |
| 332 | expose new optimization opportunities:</p> |
Chris Lattner | f304ffc | 2008-02-10 08:17:19 +0000 | [diff] [blame] | 333 | |
Chris Lattner | 791f77b | 2008-06-05 06:25:56 +0000 | [diff] [blame] | 334 | <ul> |
Chris Lattner | f304ffc | 2008-02-10 08:17:19 +0000 | [diff] [blame] | 335 | </ul> |
Mikhail Glushenkov | ea65d7d | 2008-10-13 02:08:34 +0000 | [diff] [blame] | 336 | |
Chris Lattner | f304ffc | 2008-02-10 08:17:19 +0000 | [diff] [blame] | 337 | </div> |
| 338 | |
| 339 | <!--=========================================================================--> |
| 340 | <div class="doc_subsection"> |
Chris Lattner | acce85d | 2008-02-10 07:46:44 +0000 | [diff] [blame] | 341 | <a name="optimizer">Optimizer Improvements</a> |
| 342 | </div> |
| 343 | |
| 344 | <div class="doc_text"> |
| 345 | |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 346 | <p>In addition to a large array of minor performance tweaks and bug fixes, this |
Chris Lattner | f301387 | 2008-10-13 21:50:36 +0000 | [diff] [blame] | 347 | release includes a few major enhancements and additions to the optimizers:</p> |
Chris Lattner | acce85d | 2008-02-10 07:46:44 +0000 | [diff] [blame] | 348 | |
| 349 | <ul> |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 350 | TBAA. |
Chris Lattner | 11b6611 | 2010-10-04 02:42:39 +0000 | [diff] [blame] | 351 | </ul> |
| 352 | |
| 353 | <!-- |
| 354 | <p>In addition to these features that are done in 2.8, there is preliminary |
| 355 | support in the release for Type Based Alias Analysis |
Chris Lattner | 7d9b6b4 | 2010-10-02 21:59:30 +0000 | [diff] [blame] | 356 | Preliminary work on TBAA but not usable in 2.8. |
| 357 | New CorrelatedValuePropagation pass, not on by default in 2.8 yet. |
Chris Lattner | 11b6611 | 2010-10-04 02:42:39 +0000 | [diff] [blame] | 358 | --> |
Chris Lattner | 917cc71 | 2009-03-02 02:37:32 +0000 | [diff] [blame] | 359 | |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 360 | </div> |
Chris Lattner | 917cc71 | 2009-03-02 02:37:32 +0000 | [diff] [blame] | 361 | |
Chris Lattner | 0b83220 | 2008-06-08 02:45:07 +0000 | [diff] [blame] | 362 | <!--=========================================================================--> |
| 363 | <div class="doc_subsection"> |
Chris Lattner | 4ba2b65 | 2010-09-30 16:31:33 +0000 | [diff] [blame] | 364 | <a name="mc">MC Level Improvements</a> |
| 365 | </div> |
| 366 | |
| 367 | <div class="doc_text"> |
| 368 | <p> |
Chris Lattner | 7d9b6b4 | 2010-10-02 21:59:30 +0000 | [diff] [blame] | 369 | The LLVM Machine Code (aka MC) subsystem was created to solve a number |
Chris Lattner | 4ba2b65 | 2010-09-30 16:31:33 +0000 | [diff] [blame] | 370 | of problems in the realm of assembly, disassembly, object file format handling, |
| 371 | and a number of other related areas that CPU instruction-set level tools work |
Chris Lattner | 7d9b6b4 | 2010-10-02 21:59:30 +0000 | [diff] [blame] | 372 | in.</p> |
| 373 | |
Chris Lattner | 7d9b6b4 | 2010-10-02 21:59:30 +0000 | [diff] [blame] | 374 | <ul> |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 375 | ELF/COFF support? |
Chris Lattner | 7d9b6b4 | 2010-10-02 21:59:30 +0000 | [diff] [blame] | 376 | </ul> |
| 377 | |
| 378 | <p>For more information, please see the <a |
Chris Lattner | 4ba2b65 | 2010-09-30 16:31:33 +0000 | [diff] [blame] | 379 | href="http://blog.llvm.org/2010/04/intro-to-llvm-mc-project.html">Intro to the |
| 380 | LLVM MC Project Blog Post</a>. |
| 381 | </p> |
| 382 | |
Chris Lattner | 4ba2b65 | 2010-09-30 16:31:33 +0000 | [diff] [blame] | 383 | </div> |
| 384 | |
| 385 | |
Chris Lattner | 4ba2b65 | 2010-09-30 16:31:33 +0000 | [diff] [blame] | 386 | <!--=========================================================================--> |
| 387 | <div class="doc_subsection"> |
Chris Lattner | 511433e | 2009-03-02 03:24:11 +0000 | [diff] [blame] | 388 | <a name="codegen">Target Independent Code Generator Improvements</a> |
Chris Lattner | 0b83220 | 2008-06-08 02:45:07 +0000 | [diff] [blame] | 389 | </div> |
| 390 | |
| 391 | <div class="doc_text"> |
| 392 | |
Mikhail Glushenkov | f795ef0 | 2009-03-01 18:09:47 +0000 | [diff] [blame] | 393 | <p>We have put a significant amount of work into the code generator |
| 394 | infrastructure, which allows us to implement more aggressive algorithms and make |
| 395 | it run faster:</p> |
Chris Lattner | 0b83220 | 2008-06-08 02:45:07 +0000 | [diff] [blame] | 396 | |
| 397 | <ul> |
Chris Lattner | 3bdcda1 | 2010-10-04 03:58:12 +0000 | [diff] [blame] | 398 | <!-- SplitKit --> |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 399 | FastISel for ARM. |
Chris Lattner | 8497764 | 2007-09-21 03:54:09 +0000 | [diff] [blame] | 400 | </ul> |
Chris Lattner | 8497764 | 2007-09-21 03:54:09 +0000 | [diff] [blame] | 401 | </div> |
| 402 | |
Chris Lattner | 917cc71 | 2009-03-02 02:37:32 +0000 | [diff] [blame] | 403 | <!--=========================================================================--> |
| 404 | <div class="doc_subsection"> |
| 405 | <a name="x86">X86-32 and X86-64 Target Improvements</a> |
| 406 | </div> |
| 407 | |
| 408 | <div class="doc_text"> |
Chris Lattner | 7714c91 | 2010-10-04 04:39:25 +0000 | [diff] [blame] | 409 | <p>New features and major changes in the X86 target include: |
Chris Lattner | 917cc71 | 2009-03-02 02:37:32 +0000 | [diff] [blame] | 410 | </p> |
| 411 | |
| 412 | <ul> |
Chris Lattner | 917cc71 | 2009-03-02 02:37:32 +0000 | [diff] [blame] | 413 | </ul> |
| 414 | |
Chris Lattner | 917cc71 | 2009-03-02 02:37:32 +0000 | [diff] [blame] | 415 | </div> |
Chris Lattner | 8497764 | 2007-09-21 03:54:09 +0000 | [diff] [blame] | 416 | |
| 417 | <!--=========================================================================--> |
| 418 | <div class="doc_subsection"> |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 419 | <a name="ARM">ARM Target Improvements</a> |
Chris Lattner | c441fb8 | 2009-03-01 02:30:21 +0000 | [diff] [blame] | 420 | </div> |
| 421 | |
| 422 | <div class="doc_text"> |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 423 | <p>New features of the ARM target include: |
| 424 | </p> |
Chris Lattner | c441fb8 | 2009-03-01 02:30:21 +0000 | [diff] [blame] | 425 | |
| 426 | <ul> |
Bob Wilson | e847277 | 2010-09-13 17:39:35 +0000 | [diff] [blame] | 427 | </ul> |
Chris Lattner | 61358ab | 2009-10-13 17:48:04 +0000 | [diff] [blame] | 428 | </div> |
Chris Lattner | c441fb8 | 2009-03-01 02:30:21 +0000 | [diff] [blame] | 429 | |
Chris Lattner | 77d29b1 | 2008-06-05 08:02:49 +0000 | [diff] [blame] | 430 | |
| 431 | <!--=========================================================================--> |
| 432 | <div class="doc_subsection"> |
Chris Lattner | f6662f9 | 2008-10-13 17:57:36 +0000 | [diff] [blame] | 433 | <a name="changes">Major Changes and Removed Features</a> |
| 434 | </div> |
| 435 | |
| 436 | <div class="doc_text"> |
| 437 | |
Chris Lattner | eeb4da0 | 2008-10-13 22:06:31 +0000 | [diff] [blame] | 438 | <p>If you're already an LLVM user or developer with out-of-tree changes based |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 439 | on LLVM 2.8, this section lists some "gotchas" that you may run into upgrading |
Chris Lattner | eeb4da0 | 2008-10-13 22:06:31 +0000 | [diff] [blame] | 440 | from the previous release.</p> |
Chris Lattner | f6662f9 | 2008-10-13 17:57:36 +0000 | [diff] [blame] | 441 | |
| 442 | <ul> |
Chris Lattner | b7c85b4 | 2010-04-21 05:17:40 +0000 | [diff] [blame] | 443 | </ul> |
Chris Lattner | eeb4da0 | 2008-10-13 22:06:31 +0000 | [diff] [blame] | 444 | |
Chris Lattner | bb11771 | 2010-10-04 01:29:06 +0000 | [diff] [blame] | 445 | |
| 446 | |
Chris Lattner | eeb4da0 | 2008-10-13 22:06:31 +0000 | [diff] [blame] | 447 | <p>In addition, many APIs have changed in this release. Some of the major LLVM |
| 448 | API changes are:</p> |
Chris Lattner | eeb4da0 | 2008-10-13 22:06:31 +0000 | [diff] [blame] | 449 | <ul> |
Devang Patel | b34dd13 | 2008-10-14 20:03:43 +0000 | [diff] [blame] | 450 | </ul> |
Chris Lattner | f6662f9 | 2008-10-13 17:57:36 +0000 | [diff] [blame] | 451 | |
Chris Lattner | f6662f9 | 2008-10-13 17:57:36 +0000 | [diff] [blame] | 452 | </div> |
| 453 | |
Daniel Dunbar | f0233c6 | 2010-10-04 20:11:41 +0000 | [diff] [blame] | 454 | <!--=========================================================================--> |
| 455 | <div class="doc_subsection"> |
| 456 | <a name="devtree_changes">Development Infrastructure Changes</a> |
| 457 | </div> |
| 458 | |
| 459 | <div class="doc_text"> |
| 460 | |
| 461 | <p>This section lists changes to the LLVM development infrastructure. This |
| 462 | mostly impacts users who actively work on LLVM or follow development on |
| 463 | mainline, but may also impact users who leverage the LLVM build infrastructure |
| 464 | or are interested in LLVM qualification.</p> |
| 465 | |
| 466 | <ul> |
Daniel Dunbar | f0233c6 | 2010-10-04 20:11:41 +0000 | [diff] [blame] | 467 | </ul> |
| 468 | </div> |
Chris Lattner | f6662f9 | 2008-10-13 17:57:36 +0000 | [diff] [blame] | 469 | |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 470 | <!-- *********************************************************************** --> |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 471 | <div class="doc_section"> |
| 472 | <a name="knownproblems">Known Problems</a> |
| 473 | </div> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 474 | <!-- *********************************************************************** --> |
| 475 | |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 476 | <div class="doc_text"> |
| 477 | |
Mikhail Glushenkov | f795ef0 | 2009-03-01 18:09:47 +0000 | [diff] [blame] | 478 | <p>This section contains significant known problems with the LLVM system, |
Chris Lattner | e18b32e | 2008-11-10 05:40:34 +0000 | [diff] [blame] | 479 | listed by component. If you run into a problem, please check the <a |
Chris Lattner | c463b27 | 2005-10-29 07:07:09 +0000 | [diff] [blame] | 480 | href="http://llvm.org/bugs/">LLVM bug database</a> and submit a bug if |
Chris Lattner | 5eccca4 | 2003-12-12 21:22:16 +0000 | [diff] [blame] | 481 | there isn't already one.</p> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 482 | |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 483 | </div> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 484 | |
Chris Lattner | f5ee170 | 2004-03-14 02:03:02 +0000 | [diff] [blame] | 485 | <!-- ======================================================================= --> |
| 486 | <div class="doc_subsection"> |
| 487 | <a name="experimental">Experimental features included with this release</a> |
| 488 | </div> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 489 | |
Chris Lattner | f5ee170 | 2004-03-14 02:03:02 +0000 | [diff] [blame] | 490 | <div class="doc_text"> |
| 491 | |
Misha Brukman | 6df9e2c | 2004-05-12 21:46:05 +0000 | [diff] [blame] | 492 | <p>The following components of this LLVM release are either untested, known to |
| 493 | be broken or unreliable, or are in early development. These components should |
| 494 | not be relied on, and bugs should not be filed against them, but they may be |
| 495 | useful to some people. In particular, if you would like to work on one of these |
Chris Lattner | 2b659ef | 2008-02-12 06:29:45 +0000 | [diff] [blame] | 496 | components, please contact us on the <a |
| 497 | href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev">LLVMdev list</a>.</p> |
Chris Lattner | f5ee170 | 2004-03-14 02:03:02 +0000 | [diff] [blame] | 498 | |
| 499 | <ul> |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 500 | <li>The Alpha, Blackfin, CellSPU, MicroBlaze, MSP430, MIPS, PTX, SystemZ |
Chris Lattner | bb11771 | 2010-10-04 01:29:06 +0000 | [diff] [blame] | 501 | and XCore backends are experimental.</li> |
Chris Lattner | 7d9b6b4 | 2010-10-02 21:59:30 +0000 | [diff] [blame] | 502 | <li><tt>llc</tt> "<tt>-filetype=obj</tt>" is experimental on all targets |
Chris Lattner | be2e1b5 | 2011-03-10 07:43:44 +0000 | [diff] [blame] | 503 | other than darwin-i386 and darwin-x86_64. FIXME: Not true on ELF anymore?</li> |
| 504 | |
Chris Lattner | f5ee170 | 2004-03-14 02:03:02 +0000 | [diff] [blame] | 505 | </ul> |
| 506 | |
| 507 | </div> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 508 | |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 509 | <!-- ======================================================================= --> |
| 510 | <div class="doc_subsection"> |
Chris Lattner | 2629922 | 2006-11-18 07:51:14 +0000 | [diff] [blame] | 511 | <a name="x86-be">Known problems with the X86 back-end</a> |
John Criswell | c0c186d | 2005-11-08 21:11:33 +0000 | [diff] [blame] | 512 | </div> |
| 513 | |
| 514 | <div class="doc_text"> |
| 515 | |
| 516 | <ul> |
Anton Korobeynikov | a6094be | 2008-06-08 10:24:13 +0000 | [diff] [blame] | 517 | <li>The X86 backend does not yet support |
| 518 | all <a href="http://llvm.org/PR879">inline assembly that uses the X86 |
| 519 | floating point stack</a>. It supports the 'f' and 't' constraints, but not |
| 520 | 'u'.</li> |
Duncan Sands | 47eff2b | 2008-06-08 19:38:43 +0000 | [diff] [blame] | 521 | <li>Win64 code generation wasn't widely tested. Everything should work, but we |
John Criswell | 524a5dd | 2009-03-02 15:28:15 +0000 | [diff] [blame] | 522 | expect small issues to happen. Also, llvm-gcc cannot build the mingw64 |
Chris Lattner | 914ce46 | 2010-04-22 06:28:20 +0000 | [diff] [blame] | 523 | runtime currently due to lack of support for the 'u' inline assembly |
| 524 | constraint and for X87 floating point inline assembly.</li> |
Dan Gohman | 8207ba9 | 2008-06-08 23:05:11 +0000 | [diff] [blame] | 525 | <li>The X86-64 backend does not yet support the LLVM IR instruction |
Chris Lattner | 914ce46 | 2010-04-22 06:28:20 +0000 | [diff] [blame] | 526 | <tt>va_arg</tt>. Currently, front-ends support variadic |
Dan Gohman | 8207ba9 | 2008-06-08 23:05:11 +0000 | [diff] [blame] | 527 | argument constructs on X86-64 by lowering them manually.</li> |
Chris Lattner | 2629922 | 2006-11-18 07:51:14 +0000 | [diff] [blame] | 528 | </ul> |
| 529 | |
| 530 | </div> |
| 531 | |
| 532 | <!-- ======================================================================= --> |
| 533 | <div class="doc_subsection"> |
| 534 | <a name="ppc-be">Known problems with the PowerPC back-end</a> |
| 535 | </div> |
| 536 | |
| 537 | <div class="doc_text"> |
| 538 | |
| 539 | <ul> |
Nicolas Geoffray | e4285dc | 2007-05-15 09:21:28 +0000 | [diff] [blame] | 540 | <li>The Linux PPC32/ABI support needs testing for the interpreter and static |
Chris Lattner | 57a460e | 2007-05-23 04:39:32 +0000 | [diff] [blame] | 541 | compilation, and lacks support for debug information.</li> |
Chris Lattner | 2629922 | 2006-11-18 07:51:14 +0000 | [diff] [blame] | 542 | </ul> |
| 543 | |
| 544 | </div> |
| 545 | |
| 546 | <!-- ======================================================================= --> |
| 547 | <div class="doc_subsection"> |
Chris Lattner | f3e5bc6 | 2007-05-14 06:56:09 +0000 | [diff] [blame] | 548 | <a name="arm-be">Known problems with the ARM back-end</a> |
| 549 | </div> |
| 550 | |
| 551 | <div class="doc_text"> |
| 552 | |
| 553 | <ul> |
Chris Lattner | 57a460e | 2007-05-23 04:39:32 +0000 | [diff] [blame] | 554 | <li>Thumb mode works only on ARMv6 or higher processors. On sub-ARMv6 |
Duncan Sands | c90d68b | 2007-09-26 15:59:54 +0000 | [diff] [blame] | 555 | processors, thumb programs can crash or produce wrong |
Chris Lattner | 57a460e | 2007-05-23 04:39:32 +0000 | [diff] [blame] | 556 | results (<a href="http://llvm.org/PR1388">PR1388</a>).</li> |
John Criswell | 524a5dd | 2009-03-02 15:28:15 +0000 | [diff] [blame] | 557 | <li>Compilation for ARM Linux OABI (old ABI) is supported but not fully tested. |
Chris Lattner | f3e5bc6 | 2007-05-14 06:56:09 +0000 | [diff] [blame] | 558 | </li> |
Chris Lattner | f3e5bc6 | 2007-05-14 06:56:09 +0000 | [diff] [blame] | 559 | </ul> |
| 560 | |
| 561 | </div> |
| 562 | |
| 563 | <!-- ======================================================================= --> |
| 564 | <div class="doc_subsection"> |
Chris Lattner | 2629922 | 2006-11-18 07:51:14 +0000 | [diff] [blame] | 565 | <a name="sparc-be">Known problems with the SPARC back-end</a> |
| 566 | </div> |
| 567 | |
| 568 | <div class="doc_text"> |
| 569 | |
| 570 | <ul> |
John Criswell | 524a5dd | 2009-03-02 15:28:15 +0000 | [diff] [blame] | 571 | <li>The SPARC backend only supports the 32-bit SPARC ABI (-m32); it does not |
Chris Lattner | 2629922 | 2006-11-18 07:51:14 +0000 | [diff] [blame] | 572 | support the 64-bit SPARC ABI (-m64).</li> |
| 573 | </ul> |
| 574 | |
| 575 | </div> |
| 576 | |
| 577 | <!-- ======================================================================= --> |
| 578 | <div class="doc_subsection"> |
Bruno Cardoso Lopes | b7e1a4f | 2008-10-25 14:56:26 +0000 | [diff] [blame] | 579 | <a name="mips-be">Known problems with the MIPS back-end</a> |
| 580 | </div> |
| 581 | |
| 582 | <div class="doc_text"> |
| 583 | |
| 584 | <ul> |
Bruno Cardoso Lopes | b7e1a4f | 2008-10-25 14:56:26 +0000 | [diff] [blame] | 585 | <li>64-bit MIPS targets are not supported yet.</li> |
| 586 | </ul> |
| 587 | |
| 588 | </div> |
| 589 | |
| 590 | <!-- ======================================================================= --> |
| 591 | <div class="doc_subsection"> |
Chris Lattner | 2629922 | 2006-11-18 07:51:14 +0000 | [diff] [blame] | 592 | <a name="alpha-be">Known problems with the Alpha back-end</a> |
| 593 | </div> |
| 594 | |
| 595 | <div class="doc_text"> |
| 596 | |
| 597 | <ul> |
| 598 | |
| 599 | <li>On 21164s, some rare FP arithmetic sequences which may trap do not have the |
| 600 | appropriate nops inserted to ensure restartability.</li> |
| 601 | |
John Criswell | c0c186d | 2005-11-08 21:11:33 +0000 | [diff] [blame] | 602 | </ul> |
| 603 | </div> |
| 604 | |
Chris Lattner | 2629922 | 2006-11-18 07:51:14 +0000 | [diff] [blame] | 605 | <!-- ======================================================================= --> |
| 606 | <div class="doc_subsection"> |
Chris Lattner | f3e5bc6 | 2007-05-14 06:56:09 +0000 | [diff] [blame] | 607 | <a name="c-be">Known problems with the C back-end</a> |
Chris Lattner | 2629922 | 2006-11-18 07:51:14 +0000 | [diff] [blame] | 608 | </div> |
| 609 | |
| 610 | <div class="doc_text"> |
| 611 | |
Chris Lattner | 3016ee9 | 2010-09-29 05:34:42 +0000 | [diff] [blame] | 612 | <p>The C backend has numerous problems and is not being actively maintained. |
| 613 | Depending on it for anything serious is not advised.</p> |
| 614 | |
Chris Lattner | 2629922 | 2006-11-18 07:51:14 +0000 | [diff] [blame] | 615 | <ul> |
Chris Lattner | 5733b27 | 2008-06-05 06:35:40 +0000 | [diff] [blame] | 616 | <li><a href="http://llvm.org/PR802">The C backend has only basic support for |
| 617 | inline assembly code</a>.</li> |
Chris Lattner | 725a0d8 | 2007-09-26 06:01:35 +0000 | [diff] [blame] | 618 | <li><a href="http://llvm.org/PR1658">The C backend violates the ABI of common |
| 619 | C++ programs</a>, preventing intermixing between C++ compiled by the CBE and |
Gabor Greif | 4906abe | 2009-03-02 12:02:51 +0000 | [diff] [blame] | 620 | C++ code compiled with <tt>llc</tt> or native compilers.</li> |
Duncan Sands | f74c0cc | 2008-02-10 13:40:55 +0000 | [diff] [blame] | 621 | <li>The C backend does not support all exception handling constructs.</li> |
Duncan Sands | 50723a9 | 2009-02-25 11:51:54 +0000 | [diff] [blame] | 622 | <li>The C backend does not support arbitrary precision integers.</li> |
Chris Lattner | 2629922 | 2006-11-18 07:51:14 +0000 | [diff] [blame] | 623 | </ul> |
| 624 | |
| 625 | </div> |
John Criswell | c0c186d | 2005-11-08 21:11:33 +0000 | [diff] [blame] | 626 | |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 627 | |
| 628 | <!-- ======================================================================= --> |
| 629 | <div class="doc_subsection"> |
Chris Lattner | 3016ee9 | 2010-09-29 05:34:42 +0000 | [diff] [blame] | 630 | <a name="llvm-gcc">Known problems with the llvm-gcc front-end</a> |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 631 | </div> |
Chris Lattner | 47588f9 | 2003-10-02 05:07:23 +0000 | [diff] [blame] | 632 | |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 633 | <div class="doc_text"> |
Chris Lattner | c5d658a | 2006-03-03 00:34:26 +0000 | [diff] [blame] | 634 | |
Chris Lattner | 3016ee9 | 2010-09-29 05:34:42 +0000 | [diff] [blame] | 635 | <p>llvm-gcc is generally very stable for the C family of languages. The only |
| 636 | major language feature of GCC not supported by llvm-gcc is the |
| 637 | <tt>__builtin_apply</tt> family of builtins. However, some extensions |
| 638 | are only supported on some targets. For example, trampolines are only |
| 639 | supported on some targets (these are used when you take the address of a |
| 640 | nested function).</p> |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 641 | |
Chris Lattner | 3016ee9 | 2010-09-29 05:34:42 +0000 | [diff] [blame] | 642 | <p>Fortran support generally works, but there are still several unresolved bugs |
| 643 | in <a href="http://llvm.org/bugs/">Bugzilla</a>. Please see the |
| 644 | tools/gfortran component for details. Note that llvm-gcc is missing major |
| 645 | Fortran performance work in the frontend and library that went into GCC after |
| 646 | 4.2. If you are interested in Fortran, we recommend that you consider using |
| 647 | <a href="#dragonegg">dragonegg</a> instead.</p> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 648 | |
Duncan Sands | 3af9633 | 2010-10-04 10:06:56 +0000 | [diff] [blame] | 649 | <p>The llvm-gcc 4.2 Ada compiler has basic functionality, but is no longer being |
| 650 | actively maintained. If you are interested in Ada, we recommend that you |
| 651 | consider using <a href="#dragonegg">dragonegg</a> instead.</p> |
Chris Lattner | 2b659ef | 2008-02-12 06:29:45 +0000 | [diff] [blame] | 652 | </div> |
| 653 | |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 654 | <!-- *********************************************************************** --> |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 655 | <div class="doc_section"> |
| 656 | <a name="additionalinfo">Additional Information</a> |
| 657 | </div> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 658 | <!-- *********************************************************************** --> |
| 659 | |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 660 | <div class="doc_text"> |
| 661 | |
Chris Lattner | 416db10 | 2005-05-16 17:13:10 +0000 | [diff] [blame] | 662 | <p>A wide variety of additional information is available on the <a |
Chris Lattner | b4b0ce7 | 2007-05-18 00:44:29 +0000 | [diff] [blame] | 663 | href="http://llvm.org">LLVM web page</a>, in particular in the <a |
| 664 | href="http://llvm.org/docs/">documentation</a> section. The web page also |
Reid Spencer | 669ed45 | 2007-07-09 08:04:31 +0000 | [diff] [blame] | 665 | contains versions of the API documentation which is up-to-date with the |
| 666 | Subversion version of the source code. |
Misha Brukman | 109d9e8 | 2005-03-30 19:14:24 +0000 | [diff] [blame] | 667 | You can access versions of these documents specific to this release by going |
| 668 | into the "<tt>llvm/doc/</tt>" directory in the LLVM tree.</p> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 669 | |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 670 | <p>If you have any questions or comments about LLVM, please feel free to contact |
Chris Lattner | c463b27 | 2005-10-29 07:07:09 +0000 | [diff] [blame] | 671 | us via the <a href="http://llvm.org/docs/#maillist"> mailing |
Chris Lattner | 5eccca4 | 2003-12-12 21:22:16 +0000 | [diff] [blame] | 672 | lists</a>.</p> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 673 | |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 674 | </div> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 675 | |
| 676 | <!-- *********************************************************************** --> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 677 | |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 678 | <hr> |
Misha Brukman | 2061e89 | 2003-11-22 01:23:39 +0000 | [diff] [blame] | 679 | <address> |
Misha Brukman | 38847d5 | 2003-12-21 22:53:21 +0000 | [diff] [blame] | 680 | <a href="http://jigsaw.w3.org/css-validator/check/referer"><img |
Misha Brukman | 4440870 | 2008-12-11 17:34:48 +0000 | [diff] [blame] | 681 | src="http://jigsaw.w3.org/css-validator/images/vcss-blue" alt="Valid CSS"></a> |
Misha Brukman | 2061e89 | 2003-11-22 01:23:39 +0000 | [diff] [blame] | 682 | <a href="http://validator.w3.org/check/referer"><img |
Misha Brukman | 4440870 | 2008-12-11 17:34:48 +0000 | [diff] [blame] | 683 | src="http://www.w3.org/Icons/valid-html401-blue" alt="Valid HTML 4.01"></a> |
Misha Brukman | 2061e89 | 2003-11-22 01:23:39 +0000 | [diff] [blame] | 684 | |
Chris Lattner | b4b0ce7 | 2007-05-18 00:44:29 +0000 | [diff] [blame] | 685 | <a href="http://llvm.org/">LLVM Compiler Infrastructure</a><br> |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 686 | Last modified: $Date$ |
Misha Brukman | 2061e89 | 2003-11-22 01:23:39 +0000 | [diff] [blame] | 687 | </address> |
Chris Lattner | 79c3fe1 | 2003-10-02 04:57:28 +0000 | [diff] [blame] | 688 | |
Misha Brukman | 500bc30 | 2003-11-22 00:38:41 +0000 | [diff] [blame] | 689 | </body> |
| 690 | </html> |