docs/ReleaseNotes.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
   2                       "http://www.w3.org/TR/html4/strict.dtd">
   3 <html>
   4 <head>
   5   <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
   6   <link rel="stylesheet" href="llvm.css" type="text/css">
   7   <title>LLVM 1.7cvs Release Notes</title>
   8 </head>
   9 <body>
  10
  11 <div class="doc_title">LLVM 1.7 Release Notes</div>
  12
  13 <ol>
  14   <li><a href="#intro">Introduction</a></li>
  15   <li><a href="#whatsnew">What's New?</a></li>
  16   <li><a href="GettingStarted.html">Installation Instructions</a></li>
  17   <li><a href="#portability">Portability and Supported Platforms</a></li>
  18   <li><a href="#knownproblems">Known Problems</a>
  19   <li><a href="#additionalinfo">Additional Information</a></li>
  20 </ol>
  21
  22 <div class="doc_author">
  23   <p>Written by the <a href="http://llvm.org">LLVM Team</a><p>
  24 </div>
  25
  26 <!-- *********************************************************************** -->
  27 <div class="doc_section">
  28   <a name="intro">Introduction</a>
  29 </div>
  30 <!-- *********************************************************************** -->
  31
  32 <div class="doc_text">
  33
  34 <p>This document contains the release notes for the LLVM compiler
  35 infrastructure, release 1.7.  Here we describe the status of LLVM, including any
  36 known problems and major improvements from the previous release.  The most
  37 up-to-date version of this document can be found on the <a
  38 href="http://llvm.org/releases/">LLVM releases web site</a>.  If you are
  39 not reading this on the LLVM web pages, you should probably go there because
  40 this document may be updated after the release.</p>
  41
  42 <p>For more information about LLVM, including information about the latest
  43 release, please check out the <a href="http://llvm.org/">main LLVM
  44 web site</a>.  If you have questions or comments, the <a
  45 href="http://mail.cs.uiuc.edu/mailman/listinfo/llvmdev">LLVM developer's mailing
  46 list</a> is a good place to send them.</p>
  47
  48 <p>Note that if you are reading this file from CVS or the main LLVM web page,
  49 this document applies to the <i>next</i> release, not the current one.  To see
  50 the release notes for the current or previous releases, see the <a
  51 href="http://llvm.org/releases/">releases page</a>.</p>
  52
  53 </div>
  54
  55 <!-- *********************************************************************** -->
  56 <div class="doc_section">
  57   <a name="whatsnew">What's New?</a>
  58 </div>
  59 <!-- *********************************************************************** -->
  60
  61 <div class="doc_text">
  62
  63 <p>This is the seventh public release of the LLVM Compiler Infrastructure. This
  64 release incorporates a large number of enhancements and additions (primarily in
  65 the code generator), which combine to improve the quality of the code generated
  66 by LLVM by up to 30% in some cases.  This release is also the first release to
  67 have first-class support for Mac OS X: all of the major bugs have been shaken
  68 out and it is now as well supported as Linux on X86.</p>
  69
  70 </div>
  71
  72 <!--=========================================================================-->
  73 <div class="doc_subsection">
  74 <a name="newfeatures">New Features in LLVM 1.7cvs</a>
  75 </div>
  76
  77
  78 <!-- *********************************************************************** -->
  79 <div class="doc_section">
  80   <a name="portability">Portability and Supported Platforms</a>
  81 </div>
  82 <!-- *********************************************************************** -->
  83
  84 <div class="doc_text">
  85
  86 <p>LLVM is known to work on the following platforms:</p>
  87
  88 <ul>
  89   <li>Intel and AMD machines running Red Hat Linux, Fedora Core and FreeBSD
  90       (and probably other unix-like systems).</li>
  91 <li>Sun UltraSPARC workstations running Solaris 8.</li>
  92 <li>Intel and AMD machines running on Win32 with the Cygwin libraries (limited
  93     support is available for native builds with Visual C++).</li>
  94 <li>PowerPC and X86-based Mac OS X systems, running 10.2 and above.</li>
  95 <li>Alpha-based machines running Debian GNU/Linux.</li>
  96 <li>Itanium-based machines running Linux and HP-UX.</li>
  97 </ul>
  98
  99 <p>The core LLVM infrastructure uses
 100 <a href="http://www.gnu.org/software/autoconf/">GNU autoconf</a> to adapt itself
 101 to the machine and operating system on which it is built.  However, minor
 102 porting may be required to get LLVM to work on new platforms.  We welcome your
 103 portability patches and reports of successful builds or error messages.</p>
 104
 105 </div>
 106
 107 <!-- *********************************************************************** -->
 108 <div class="doc_section">
 109   <a name="knownproblems">Known Problems</a>
 110 </div>
 111 <!-- *********************************************************************** -->
 112
 113 <div class="doc_text">
 114
 115 <p>This section contains all known problems with the LLVM system, listed by
 116 component.  As new problems are discovered, they will be added to these
 117 sections.  If you run into a problem, please check the <a
 118 href="http://llvm.org/bugs/">LLVM bug database</a> and submit a bug if
 119 there isn't already one.</p>
 120
 121 </div>
 122
 123 <!-- ======================================================================= -->
 124 <div class="doc_subsection">
 125   <a name="experimental">Experimental features included with this release</a>
 126 </div>
 127
 128 <div class="doc_text">
 129
 130 <p>The following components of this LLVM release are either untested, known to
 131 be broken or unreliable, or are in early development.  These components should
 132 not be relied on, and bugs should not be filed against them, but they may be
 133 useful to some people.  In particular, if you would like to work on one of these
 134 components, please contact us on the llvmdev list.</p>
 135
 136 <ul>
 137 <li>The following passes are incomplete or buggy, and may be removed in future
 138     releases: <tt>-cee</tt></li>
 139 <li>The <tt>llvm-db</tt> tool is in a very early stage of development, but can
 140     be used to step through programs and inspect the stack.</li>
 141 <li>The SparcV8 and IA64 code generators are experimental.</li>
 142 <li>The Alpha JIT is experimental.</li>
 143 </ul>
 144
 145 </div>
 146
 147 <!-- ======================================================================= -->
 148 <div class="doc_subsection">
 149   <a name="build">Known problems with the Build System</a>
 150 </div>
 151
 152 <div class="doc_text">
 153
 154 <ul>
 155   <li>The <a href="http://llvm.org/PR656">configure script sometimes fails on Solaris/Sparc</a>. A work around is documented in <a href="http://llvm.org/PR656">PR656.</a></li>
 156 </ul>
 157 </div>
 158
 159
 160 <!-- ======================================================================= -->
 161 <div class="doc_subsection">
 162   <a name="core">Known problems with the LLVM Core</a>
 163 </div>
 164
 165 <div class="doc_text">
 166
 167 <ul>
 168   <li>In the JIT, <tt>dlsym()</tt> on a symbol compiled by the JIT will not
 169   work.</li>
 170 </ul>
 171 </div>
 172
 173 <!-- ======================================================================= -->
 174 <div class="doc_subsection">
 175   <a name="c-fe">Known problems with the C front-end</a>
 176 </div>
 177
 178 <!-- _______________________________________________________________________ -->
 179 <div class="doc_subsubsection">Bugs</div>
 180
 181 <div class="doc_text">
 182 <ul>
 183 <li>C99 Variable sized arrays do not release stack memory when they go out of
 184     scope.  Thus, the following program may run out of stack space:
 185 <pre>
 186     for (i = 0; i != 1000000; ++i) {
 187       int X[n];
 188       foo(X);
 189     }
 190 </pre></li>
 191
 192 <li>Initialization of global union variables can only be done <a
 193 href="http://llvm.org/PR162">with the largest union member</a>.</li>
 194
 195 </ul>
 196 </div>
 197
 198 <!-- _______________________________________________________________________ -->
 199 <div class="doc_subsubsection">
 200   Notes
 201 </div>
 202
 203 <div class="doc_text">
 204
 205 <ul>
 206
 207 <li>Inline assembly is not yet supported.</li>
 208
 209 <li>"long double" is transformed by the front-end into "double".  There is no
 210 support for floating point data types of any size other than 32 and 64
 211 bits.</li>
 212
 213 <li>The following Unix system functionality has not been tested and may not
 214 work:
 215   <ol>
 216   <li><tt>sigsetjmp</tt>, <tt>siglongjmp</tt> - These are not turned into the
 217       appropriate <tt>invoke</tt>/<tt>unwind</tt> instructions.  Note that
 218       <tt>setjmp</tt> and <tt>longjmp</tt> <em>are</em> compiled correctly.
 219   <li><tt>getcontext</tt>, <tt>setcontext</tt>, <tt>makecontext</tt>
 220       - These functions have not been tested.
 221   </ol></li>
 222
 223 <li>Although many GCC extensions are supported, some are not.  In particular,
 224     the following extensions are known to <b>not be</b> supported:
 225   <ol>
 226   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Local-Labels.html#Local%20Labels">Local Labels</a>: Labels local to a block.</li>
 227   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Nested-Functions.html#Nested%20Functions">Nested Functions</a>: As in Algol and Pascal, lexical scoping of functions.</li>
 228   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Constructing-Calls.html#Constructing%20Calls">Constructing Calls</a>: Dispatching a call to another function.</li>
 229   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Extended-Asm.html#Extended%20Asm">Extended Asm</a>: Assembler instructions with C expressions as operands.</li>
 230   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Constraints.html#Constraints">Constraints</a>: Constraints for asm operands.</li>
 231   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Asm-Labels.html#Asm%20Labels">Asm Labels</a>: Specifying the assembler name to use for a C symbol.</li>
 232   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Explicit-Reg-Vars.html#Explicit%20Reg%20Vars">Explicit Reg Vars</a>: Defining variables residing in specified registers.</li>
 233   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Vector-Extensions.html#Vector%20Extensions">Vector Extensions</a>: Using vector instructions through built-in functions.</li>
 234   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Target-Builtins.html#Target%20Builtins">Target Builtins</a>:   Built-in functions specific to particular targets.</li>
 235   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Thread_002dLocal.html">Thread-Local</a>: Per-thread variables.</li>
 236   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Pragmas.html#Pragmas">Pragmas</a>: Pragmas accepted by GCC.</li>
 237   </ol>
 238
 239   <p>The following GCC extensions are <b>partially</b> supported.  An ignored
 240   attribute means that the LLVM compiler ignores the presence of the attribute,
 241   but the code should still work.  An unsupported attribute is one which is
 242   ignored by the LLVM compiler and will cause a different interpretation of
 243   the program.</p>
 244
 245   <ol>
 246   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Variable-Length.html#Variable%20Length">Variable Length</a>:
 247       Arrays whose length is computed at run time.<br>
 248       Supported, but allocated stack space is not freed until the function returns (noted above).</li>
 249
 250   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Function-Attributes.html#Function%20Attributes">Function Attributes</a>:
 251
 252       Declaring that functions have no side effects or that they can never
 253       return.<br>
 254
 255       <b>Supported:</b> <tt>format</tt>, <tt>format_arg</tt>, <tt>non_null</tt>,
 256       <tt>noreturn</tt>, <tt>constructor</tt>, <tt>destructor</tt>,
 257       <tt>unused</tt>, <tt>used</tt>,
 258       <tt>deprecated</tt>, <tt>warn_unused_result</tt>, <tt>weak</tt><br>
 259
 260       <b>Ignored:</b> <tt>noinline</tt>,
 261       <tt>always_inline</tt>, <tt>pure</tt>, <tt>const</tt>, <tt>nothrow</tt>,
 262       <tt>malloc</tt>, <tt>no_instrument_function</tt>, <tt>cdecl</tt><br>
 263
 264       <b>Unsupported:</b> <tt>section</tt>, <tt>alias</tt>,
 265       <tt>visibility</tt>, <tt>regparm</tt>, <tt>stdcall</tt>,
 266       <tt>fastcall</tt>, all other target specific attributes</li>
 267
 268   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Variable-Attributes.html#Variable%20Attributes">Variable Attributes</a>:
 269       Specifying attributes of variables.<br>
 270       <b>Supported:</b> <tt>cleanup</tt>, <tt>common</tt>, <tt>nocommon</tt>,
 271                         <tt>deprecated</tt>, <tt>transparent_union</tt>,
 272                         <tt>unused</tt>, <tt>used</tt>, <tt>weak</tt><br>
 273
 274       <b>Unsupported:</b> <tt>aligned</tt>, <tt>mode</tt>, <tt>packed</tt>,
 275                         <tt>section</tt>, <tt>shared</tt>, <tt>tls_model</tt>,
 276                         <tt>vector_size</tt>, <tt>dllimport</tt>,
 277                         <tt>dllexport</tt>, all target specific attributes.</li>
 278
 279   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Type-Attributes.html#Type%20Attributes">Type Attributes</a>:   Specifying attributes of types.<br>
 280       <b>Supported:</b> <tt>transparent_union</tt>, <tt>unused</tt>,
 281                         <tt>deprecated</tt>, <tt>may_alias</tt><br>
 282
 283       <b>Unsupported:</b> <tt>aligned</tt>, <tt>packed</tt>,
 284                         all target specific attributes.</li>
 285
 286   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Other-Builtins.html#Other%20Builtins">Other Builtins</a>:
 287       Other built-in functions.<br>
 288       We support all builtins which have a C language equivalent (e.g.,
 289          <tt>__builtin_cos</tt>),  <tt>__builtin_alloca</tt>,
 290          <tt>__builtin_types_compatible_p</tt>, <tt>__builtin_choose_expr</tt>,
 291          <tt>__builtin_constant_p</tt>, and <tt>__builtin_expect</tt>
 292          (currently ignored).  We also support builtins for ISO C99 floating
 293          point comparison macros (e.g., <tt>__builtin_islessequal</tt>),
 294          <tt>__builtin_prefetch</tt>, <tt>__builtin_popcount[ll]</tt>,
 295          <tt>__builtin_clz[ll]</tt>, and <tt>__builtin_ctz[ll]</tt>.</li>
 296   </ol>
 297
 298   <p>The following extensions <b>are</b> known to be supported:</p>
 299
 300   <ol>
 301   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Labels-as-Values.html#Labels%20as%20Values">Labels as Values</a>: Getting pointers to labels and computed gotos.</li>
 302   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Statement-Exprs.html#Statement%20Exprs">Statement Exprs</a>:   Putting statements and declarations inside expressions.</li>
 303   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Typeof.html#Typeof">Typeof</a>: <code>typeof</code>: referring to the type of an expression.</li>
 304   <li><a href="http://gcc.gnu.org/onlinedocs/gcc-3.4.0/gcc/Lvalues.html#Lvalues">Lvalues</a>: Using <code>?:</code>, "<code>,</code>" and casts in lvalues.</li>
 305   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Conditionals.html#Conditionals">Conditionals</a>: Omitting the middle operand of a <code>?:</code> expression.</li>
 306   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Long-Long.html#Long%20Long">Long Long</a>: Double-word integers.</li>
 307   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Complex.html#Complex">Complex</a>:   Data types for complex numbers.</li>
 308   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Hex-Floats.html#Hex%20Floats">Hex Floats</a>:Hexadecimal floating-point constants.</li>
 309   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Zero-Length.html#Zero%20Length">Zero Length</a>: Zero-length arrays.</li>
 310   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Empty-Structures.html#Empty%20Structures">Empty Structures</a>: Structures with no members.</li>
 311   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Variadic-Macros.html#Variadic%20Macros">Variadic Macros</a>: Macros with a variable number of arguments.</li>
 312   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Escaped-Newlines.html#Escaped%20Newlines">Escaped Newlines</a>:  Slightly looser rules for escaped newlines.</li>
 313   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Subscripting.html#Subscripting">Subscripting</a>: Any array can be subscripted, even if not an lvalue.</li>
 314   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Pointer-Arith.html#Pointer%20Arith">Pointer Arith</a>: Arithmetic on <code>void</code>-pointers and function pointers.</li>
 315   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Initializers.html#Initializers">Initializers</a>: Non-constant initializers.</li>
 316   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Compound-Literals.html#Compound%20Literals">Compound Literals</a>: Compound literals give structures, unions,
 317 or arrays as values.</li>
 318   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Designated-Inits.html#Designated%20Inits">Designated Inits</a>: Labeling elements of initializers.</li>
 319   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Cast-to-Union.html#Cast%20to%20Union">Cast to Union</a>: Casting to union type from any member of the union.</li>
 320   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Case-Ranges.html#Case%20Ranges">Case Ranges</a>: `case 1 ... 9' and such.</li>
 321   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Mixed-Declarations.html#Mixed%20Declarations">Mixed Declarations</a>: Mixing declarations and code.</li>
 322   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Function-Prototypes.html#Function%20Prototypes">Function Prototypes</a>: Prototype declarations and old-style definitions.</li>
 323   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/C_002b_002b-Comments.html#C_002b_002b-Comments">C++ Comments</a>: C++ comments are recognized.</li>
 324   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Dollar-Signs.html#Dollar%20Signs">Dollar Signs</a>: Dollar sign is allowed in identifiers.</li>
 325   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Character-Escapes.html#Character%20Escapes">Character Escapes</a>: <code>\e</code> stands for the character &lt;ESC&gt;.</li>
 326   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Alignment.html#Alignment">Alignment</a>: Inquiring about the alignment of a type or variable.</li>
 327   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Inline.html#Inline">Inline</a>: Defining inline functions (as fast as macros).</li>
 328   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Alternate-Keywords.html#Alternate%20Keywords">Alternate Keywords</a>:<code>__const__</code>, <code>__asm__</code>, etc., for header files.</li>
 329   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Incomplete-Enums.html#Incomplete%20Enums">Incomplete Enums</a>:  <code>enum foo;</code>, with details to follow.</li>
 330   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Function-Names.html#Function%20Names">Function Names</a>: Printable strings which are the name of the current function.</li>
 331   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Return-Address.html#Return%20Address">Return Address</a>: Getting the return or frame address of a function.</li>
 332   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Unnamed-Fields.html#Unnamed%20Fields">Unnamed Fields</a>: Unnamed struct/union fields within structs/unions.</li>
 333   <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Attribute-Syntax.html#Attribute%20Syntax">Attribute Syntax</a>: Formal syntax for attributes.</li>
 334   </ol></li>
 335
 336 </ul>
 337
 338 <p>If you run into GCC extensions which have not been included in any of these
 339 lists, please let us know (also including whether or not they work).</p>
 340
 341 </div>
 342
 343 <!-- ======================================================================= -->
 344 <div class="doc_subsection">
 345   <a name="c++-fe">Known problems with the C++ front-end</a>
 346 </div>
 347
 348 <div class="doc_text">
 349
 350 <p>For this release, the C++ front-end is considered to be fully
 351 tested and works for a number of non-trivial programs, including LLVM
 352 itself.</p>
 353
 354 </div>
 355
 356 <!-- _______________________________________________________________________ -->
 357 <div class="doc_subsubsection">Bugs</div>
 358
 359 <div class="doc_text">
 360
 361 <ul>
 362 <li>The C++ front-end inherits all problems afflicting the <a href="#c-fe">C
 363     front-end</a>.</li>
 364
 365 </ul>
 366
 367 </div>
 368
 369 <!-- _______________________________________________________________________ -->
 370 <div class="doc_subsubsection">
 371   Notes
 372 </div>
 373
 374 <div class="doc_text">
 375
 376 <ul>
 377
 378 <li>The C++ front-end is based on a pre-release of the GCC 3.4 C++ parser.  This
 379 parser is significantly more standards compliant (and picky) than prior GCC
 380 versions.  For more information, see the C++ section of the <a
 381 href="http://gcc.gnu.org/gcc-3.4/changes.html">GCC 3.4 release notes</a>.</li>
 382
 383 <li>Destructors for local objects are not always run when a <tt>longjmp</tt> is
 384     performed. In particular, destructors for objects in the <tt>longjmp</tt>ing
 385     function and in the <tt>setjmp</tt> receiver function may not be run.
 386     Objects in intervening stack frames will be destroyed, however (which is
 387     better than most compilers).</li>
 388
 389 <li>The LLVM C++ front-end follows the <a
 390     href="http://www.codesourcery.com/cxx-abi">Itanium C++ ABI</a>.
 391     This document, which is not Itanium specific, specifies a standard for name
 392     mangling, class layout, v-table layout, RTTI formats, and other C++
 393     representation issues.  Because we use this API, code generated by the LLVM
 394     compilers should be binary compatible with machine code generated by other
 395     Itanium ABI C++ compilers (such as G++, the Intel and HP compilers, etc).
 396     <i>However</i>, the exception handling mechanism used by LLVM is very
 397     different from the model used in the Itanium ABI, so <b>exceptions will not
 398     interact correctly</b>. </li>
 399
 400 </ul>
 401
 402 </div>
 403
 404 <!-- ======================================================================= -->
 405 <div class="doc_subsection">
 406   <a name="c-be">Known problems with the C back-end</a>
 407 </div>
 408
 409 <div class="doc_text">
 410
 411 <ul>
 412
 413 <li>The C back-end produces code that violates the ANSI C Type-Based Alias
 414 Analysis rules.  As such, special options may be necessary to compile the code
 415 (for example, GCC requires the <tt>-fno-strict-aliasing</tt> option).  This
 416 problem probably cannot be fixed.</li>
 417
 418 <li><a href="http://llvm.org/PR56">Zero arg vararg functions are not
 419 supported</a>.  This should not affect LLVM produced by the C or C++
 420 frontends.</li>
 421
 422 </ul>
 423
 424 </div>
 425
 426 <!-- ======================================================================= -->
 427 <div class="doc_subsection">
 428   <a name="x86-be">Known problems with the X86 back-end</a>
 429 </div>
 430
 431 <div class="doc_text">
 432
 433 <ul>
 434 <li><a href="http://llvm.org/PR566">Memory Mapped I/O Intrinsics do not fence
 435 memory</a></li>
 436 </ul>
 437
 438 </div>
 439
 440 <!-- ======================================================================= -->
 441 <div class="doc_subsection">
 442   <a name="ppc-be">Known problems with the PowerPC back-end</a>
 443 </div>
 444
 445 <div class="doc_text">
 446
 447 <ul>
 448 <li>None yet</li>
 449 </ul>
 450
 451 </div>
 452
 453 <!-- ======================================================================= -->
 454 <div class="doc_subsection">
 455   <a name="sparcv9-be">Known problems with the SparcV9 back-end</a>
 456 </div>
 457
 458 <div class="doc_text">
 459
 460 <ul>
 461 <li><a href="http://llvm.org/PR60">[sparcv9] SparcV9 backend miscompiles
 462 several programs in the LLVM test suite</a></li>
 463 </ul>
 464
 465 </div>
 466
 467 <!-- ======================================================================= -->
 468 <div class="doc_subsection">
 469   <a name="alpha-be">Known problems with the Alpha back-end</a>
 470 </div>
 471
 472 <div class="doc_text">
 473
 474 <ul>
 475
 476 <li>On 21164s, some rare FP arithmetic sequences which may trap do not have the
 477 appropriate nops inserted to ensure restartability.</li>
 478
 479 </ul>
 480
 481 </div>
 482
 483 <!-- ======================================================================= -->
 484 <div class="doc_subsection">
 485   <a name="ia64-be">Known problems with the IA64 back-end</a>
 486 </div>
 487
 488 <div class="doc_text">
 489
 490 <ul>
 491
 492 <li>C++ programs are likely to fail on IA64, as calls to <tt>setjmp</tt> are
 493 made where the argument is not 16-byte aligned, as required on IA64. (Strictly
 494 speaking this is not a bug in the IA64 back-end; it will also be encountered
 495 when building C++ programs using the C back-end.)</li>
 496
 497 <li>The C++ front-end does not use <a href="http://llvm.org/PR406">IA64
 498 ABI compliant layout of v-tables</a>.  In particular, it just stores function
 499 pointers instead of function descriptors in the vtable.  This bug prevents
 500 mixing C++ code compiled with LLVM with C++ objects compiled by other C++
 501 compilers.</li>
 502
 503 <li>There are a few ABI violations which will lead to problems when mixing LLVM
 504 output with code built with other compilers, particularly for floating-point
 505 programs.</li>
 506
 507 <li>Defining vararg functions is not supported (but calling them is ok).</li>
 508
 509 </ul>
 510
 511 </div>
 512
 513 <!-- ======================================================================= -->
 514 <div class="doc_subsection">
 515   <a name="sparcv8">Known problems with the SPARC-V8 back-end</a>
 516 </div>
 517
 518 <div class="doc_text">
 519
 520 <ul>
 521 <li>Many features are still missing (e.g. support for 64-bit integer
 522 arithmetic).  This back-end is in pre-beta state.</li>
 523 </ul>
 524 </div>
 525
 526 <!-- *********************************************************************** -->
 527 <div class="doc_section">
 528   <a name="additionalinfo">Additional Information</a>
 529 </div>
 530 <!-- *********************************************************************** -->
 531
 532 <div class="doc_text">
 533
 534 <p>A wide variety of additional information is available on the <a
 535 href="http://llvm.org">LLVM web page</a>, including <a
 536 href="http://llvm.org/docs/">documentation</a> and <a
 537 href="http://llvm.org/pubs/">publications describing algorithms and
 538 components implemented in LLVM</a>.  The web page also contains versions of the
 539 API documentation which is up-to-date with the CVS version of the source code.
 540 You can access versions of these documents specific to this release by going
 541 into the "<tt>llvm/doc/</tt>" directory in the LLVM tree.</p>
 542
 543 <p>If you have any questions or comments about LLVM, please feel free to contact
 544 us via the <a href="http://llvm.org/docs/#maillist"> mailing
 545 lists</a>.</p>
 546
 547 </div>
 548
 549 <!-- *********************************************************************** -->
 550
 551 <hr>
 552 <address>
 553   <a href="http://jigsaw.w3.org/css-validator/check/referer"><img
 554   src="http://jigsaw.w3.org/css-validator/images/vcss" alt="Valid CSS!"></a>
 555   <a href="http://validator.w3.org/check/referer"><img
 556   src="http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01!" /></a>
 557
 558   <a href="http://llvm.org/">The LLVM Compiler Infrastructure</a><br>
 559   Last modified: $Date$
 560 </address>
 561
 562 </body>
 563 </html>