<html>
<head>
<link rel="stylesheet" href="llvm.css" type="text/css">
- <title>LLVM 1.2 Release Notes</title>
+ <title>LLVM 1.3 Release Notes</title>
</head>
<body>
-<div class="doc_title">
- LLVM 1.2 Release Notes
-</div>
+<div class="doc_title">LLVM 1.3 Release Notes</div>
<ol>
<li><a href="#intro">Introduction</a></li>
<li><a href="#whatsnew">What's New?</a></li>
+ <li><a href="GettingStarted.html">Installation Instructions</a></li>
<li><a href="#portability">Portability and Supported Platforms</a></li>
- <li><a href="#install-instructions">Installation Instructions</a></li>
<li><a href="#knownproblems">Known Problems</a>
<ul>
- <li><a href="#experimental">Experimental features included with this release</a>
+ <li><a href="#experimental">Experimental features included in this
+ release</a>
<li><a href="#core">Known problems with the LLVM Core</a>
<li><a href="#c-fe">Known problems with the C Front-end</a>
<li><a href="#c++-fe">Known problems with the C++ Front-end</a>
<li><a href="#x86-be">Known problems with the X86 Back-end</a>
- <li><a href="#sparc-be">Known problems with the Sparc Back-end</a>
+ <li><a href="#sparcv9-be">Known problems with the SparcV9 Back-end</a>
<li><a href="#c-be">Known problems with the C back-end</a>
</ul></li>
<li><a href="#additionalinfo">Additional Information</a></li>
</ol>
-<div class="doc_text">
- <p><b>Written by the <a href="http://llvm.cs.uiuc.edu">LLVM team</a></b><p>
+<div class="doc_author">
+ <p>Written by the <a href="http://llvm.cs.uiuc.edu">LLVM team</a><p>
</div>
<!-- *********************************************************************** -->
<div class="doc_text">
<p>This document contains the release notes for the LLVM compiler
-infrastructure, release 1.2. Here we describe the status of LLVM, including any
+infrastructure, release 1.3. Here we describe the status of LLVM, including any
known problems and bug fixes from the previous release. The most up-to-date
version of this document can be found on the <a
-href="http://llvm.cs.uiuc.edu/releases/1.2/">LLVM 1.2 web site</a>. If you are
+href="http://llvm.cs.uiuc.edu/releases/1.3/">LLVM 1.3 web site</a>. If you are
not reading this on the LLVM web pages, you should probably go there because
this document may be updated after the release.</p>
<div class="doc_text">
-<p>
-This is the third public release of the LLVM compiler infrastructure. This
-release incorporates several <a href="#newfeatures">new features</a> (including
-exception handling support for the native code generators, the start of a
-source-level debugger, and profile guided optimizer components), many <a
-href="#qualityofimp">speedups</a> and <a href="#codequality">code quality</a>
-improvements, documentation improvements, and a small collection of important <a
-href="bugfix">bug fixes</a>. Overall, this is our highest quality release to
-date, and we encourage you to upgrade if you are using LLVM 1.0 or 1.1.
-</p>
-
-<p>
-At this time, LLVM is known to correctly compile and run all C & C++ SPEC
-CPU2000 benchmarks, the Olden benchmarks, and the Ptrdist benchmarks. It has
-also been used to compile <b>many</b> other programs. LLVM now also works with
-a broad variety of C++ programs, though it has still received less testing than
-the C front-end.
-</p>
+<p>This is the fourth public release of the LLVM compiler infrastructure. This
+release primarily improves the <a href="#codequality">performance of the
+code</a> produced by all aspects of the LLVM compiler and adds many <a
+href="#newfeatures">new features</a>, and <a href="#bugfix">fixes a few
+bugs</a> as well.</p>
+
+<p> At this time, LLVM is known to correctly compile and run all C & C++
+SPEC CPU2000 benchmarks, the Olden benchmarks, and the Ptrdist benchmarks. It
+has also been used to compile <b>many</b> other programs. LLVM now also works
+with a broad variety of C++ programs, though it has still received less testing
+than the C front-end.</p>
+
+</div>
<!--=========================================================================-->
<div class="doc_subsubsection">
<a name="newfeatures">This release implements the following new features:</a>
</div>
+<div class="doc_text">
+
<ol>
-<li><a href="SourceLevelDebugging.html">A new LLVM source-level debugger has been started.</a></li>
-<li>LLVM 1.2 encodes bytecode files for large programs in 10-30% less space.</li>
-<li>LLVM can now feed profile information back into optimizers for Profile Guided Optimization, includes a simple basic block reordering pass, and supports edge profiling as well as function and block-level profiling.</li>
-<li>The LLVM JIT lazily initializes global variables, reducing startup time for programs with lots of globals (like C++ programs).</li>
-
-<li>The build and installation infrastructure in this release is dramatically
-improved. There is now an <a
-href="http://llvm.cs.uiuc.edu/PR105"><tt>autoconf/AutoRegen.sh</tt> script</a>
-that you can run to rebuild the <tt>configure</tt> script and its associated
-files as well as beta support for "<a
-href="http://llvm.cs.uiuc.edu/PR208">make</a> <a
-href="http://llvm.cs.uiuc.edu/PR220">install</a>" and <a
-href="http://llvm.cs.uiuc.edu/PR203">RPM package generation</a>.</li>
-
-<li>The "tblgen" tool is <a href="TableGenFundamentals.html">now documented</a>.</li>
-<li>The target-independent code generator got several improvements:
-<ul>
- <li>It can now fold spill code into instructions (on targets that support it).</li>
- <li>A generic machine code spiller/rewriter was added. It provides an API for
- global register allocators to eliminate virtual registers and add the
- appropriate spill code.</li>
- <li>The represenation of machine code basic blocks is more efficient and has
- an easier to use interface.</li>
-</ul>
-</li>
-<li><a href="http://llvm.cs.uiuc.edu/PR253">LLVM now no longer depends on the boost library</a>.</li>
-<li>The X86 backend now generates <b>substantially</b> better native code, and is faster.</li>
-<li>The C backend has been turned moved from the "llvm-dis" tool to the "llc"
-tool. You can activate it with "<tt>llc -march=c foo.bc -o foo.c</tt>".</li>
-<li>LLVM includes a new interprocedural optimization that marks global variables
-"constant" when they are provably never written to.</li>
-<li>LLVM now includes a new interprocedural optimization that converts small "by reference" arguments to "by value" arguments, which is often improve the performance of C++ programs substantially.</li>
-<li>Bugpoint can now do a better job reducing miscompilation problems by
-reducing programs down to a particular loop nest, instead of just the function
-being miscompiled.</li>
-<li>The GCSE and LICM passes can now operate on side-effect-free function calls, for example hoisting calls to "<tt>strlen</tt>" and folding "<tt>cos</tt>" common subexpressions.</li>
-<li>LLVM has early support for a new <a
-href="LangRef.html#i_select"><tt>select</tt></a> instruction, though it is
-currently only supported by the C backend.</li>
+<li>The LLVM <a href="LangRef.html#i_select"><tt>select</tt></a> instruction is
+now fully implemented and supported by all transformations, native code
+generators, and the interpreter.</li>
+<li>Bugpoint can now narrow down code-generation bugs to a loop nest, where
+before it could only narrow them down to a function being miscompiled.</li>
+<li><a href="http://llvm.cs.uiuc.edu/PR40">Bugpoint can now debug arbitrary
+modes of llc</a> and lli, by passing them command line flags (e.g.,
+<tt>-regalloc=linearscan</tt>, <tt>-enable-correct-eh-support</tt>, etc.) </li>
+<li>The Control Flow Graph in the native code generators is no longer
+constrained to be the same as the CFG for the LLVM input code.</li>
+<li>The LLVM induction variable analysis routines have been rewritten.</li>
+<li>LLVM now has new loop unrolling and loop unswitching passes.</li>
+<li>The induction variable substitution pass performs linear function test
+replacement and exit value replacement optimizations.</li>
+<li>LLVM now has first-class support for <a
+href="GarbageCollection.html">Accurate Garbage Collection</a>, enabling the use
+of aggressive copying and generational collectors.</li>
+<li>LLVM now includes an implementation of Andersen's interprocedural alias
+analysis algorithm.</li>
+<li>Bugpoint can <a href="http://llvm.cs.uiuc.edu/PR327">extract individual
+basic blocks</a> to track down reduce miscompilation testcases.</li>
+<li>LLVM and the C front-end now work under Win32 using the
+<a href="http://www.cygwin.com">Cygwin</a> runtime libraries.
+This includes the JIT compiler.</li>
+<li>The LLVM code generator is now being <a
+href="CodeGenerator.html">documented</a>.</li>
+<li>There is a new tool, llvm-bcanalyzer. This tool can compute basic
+statistics and bytecode density statistics on a module or function basis and
+also dump out bytecode in a textual format that is lower level than assembly
+(values are not resolved from slot numbers). It should only be of interest to
+(a) those who are working to improve the bytecode format and (b) those who
+really want to understand or document the details of the bytecode format.</li>
+<li>The <a href="BytecodeFormat.html">LLVM Bytecode file format</a> is now
+documented.</li>
+<li>LLVM now provides an <a
+href="LangRef.html#i_isunordered">llvm.isunordered</a> intrinsic for efficient
+implementation of unordered floating point comparisons.</li>
+<li>The llvmgcc front-end now supports the GCC builtins for ISO C99 floating
+point comparison macros (e.g., <tt>__builtin_islessequal</tt>).</li>
+<li>Now that there are more source files than can fit on a 32Kbyte command
+line (Linux's limit), there's a new utility for searching the sources. The
+llvmgrep tool in the utils directory combines an egrep and a find without
+passing filenames through the command line. This improves performance
+slightly. Simply run llvmgrep like you might egrep but leave off the file
+names.</li>
+<li>We now generate HTML documentation and man pages for the tools from a single
+source (perl-style POD files).</li>
+<li>The LLVM code generator can now dynamically load targets from shared
+objects.</li>
</ol>
+</div>
+
<!--=========================================================================-->
<div class="doc_subsubsection">
In this release, the following missing features were implemented:
</div>
-<ol>
-<li><a href="http://llvm.cs.uiuc.edu/PR16">Exception handling in the X86
-& Sparc native code generators</a> is now supported</li>
-<li>The C/C++ front-end now support the GCC <tt>__builtin_return_address</tt> and <tt>__builtin_frame_address</tt> extensions. These are also supported by the X86 backend and by the C backend.</li>
-<li><a href="http://llvm.cs.uiuc.edu/PR249">[X86] Missing cast from ULong -> Double, cast FP -> bool and support for -9223372036854775808</a></li>
-<li>The C/C++ front-end <a href="http://llvm.cs.uiuc.edu/PR273">now supports</a>
-the "<a href="http://gcc.gnu.org/onlinedocs/gcc/Labels-as-Values.html#Labels%20as%20Values">labels as values</a>" GCC extension, often used to build "threaded interpreters".</a></li>
+<div class="doc_text">
+<ol>
+<li><a href="http://llvm.cs.uiuc.edu/PR82">LLVM cannot handle structures with
+more than 256 elements</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR38">[bugpoint] External functions used in
+non-instruction entities, such as global constant initializer</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR178">Stacker does not handle targets
+with 64-bit pointers.</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR290">Bugpoint doesn't support
+uses of external fns by immediate constant exprs</a></li>
</ol>
+</div>
<!--=========================================================================-->
<div class="doc_subsubsection">
-<a name="qualityofimp">In this release, the following Quality of Implementation issues were fixed:</a>
+<a name="qualityofimp">In this release, the following Quality of Implementation
+issues were fixed:</a>
</div>
-<ol>
+<div class="doc_text">
-<li><a href="http://llvm.cs.uiuc.edu/PR135">JIT should lazily initialize global variables</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR192">[X86] X86 Backend never releases memory for machine code structures</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR196">[vmcore] OpaqueType objects memory leak</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR182">[llvmgcc] C front-end does not compile "extern inline" into linkonce</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR73">Bytecode format inconsistent</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR209">[loadvn/inline/scalarrepl] Slow optimizations with extremely large basic blocks</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR224">[asmparser] Really slow parsing of types with complex upreferences</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR205">[llvmgcc] C front-end does not emit 'zeroinitializer' when possible</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR233">[llvmgcc] Structure copies result in a LOT of code</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR239">LLVM is now much more memory efficient when handling large zero initialized arrays</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR275">[llvmgcc] Local array initializers are expanded into large amounts of code</a></li>
+<ol>
+<li><a href="http://llvm.cs.uiuc.edu/PR305">LLVM tools will happily spew
+bytecode onto your terminal</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR329">[llvmgcc] type names are not emitted
+for structure typedefs</a></li>
+<li>All documentation is now conformant to the HTML 4.01 (Strict) level.</li>
+<li>The spurious "WARNING: Found global types that are not compatible" warning
+produced when linking C++ programs has been fixed.</li>
+<li><a href="http://llvm.cs.uiuc.edu/PR391">lli Doesn't Handle Exceptions From
+Bytecode Reader</a></li>
</ol>
+</div>
+
<!--=========================================================================-->
<div class="doc_subsubsection">
In this release, the following build problems were fixed:
</div>
+<div class="doc_text">
<ol>
-<li><a href="http://llvm.cs.uiuc.edu/PR210">[build] Makefiles break if C frontend target string has unexpected value</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR214">[build] hard-wired assumption that shared-library extension is ".so"</a></li>
-<li><A href="http://llvm.cs.uiuc.edu/PR222">make tools-only doesn't make lib/Support</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR301">Minor configure bugs with
+-disable/enable-povray and -disable-spec</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR289">shell scripts output by gccld don't
+work if you change PATH</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR364">[llvmgcc] llvmgcc does not compile
+with gcc 3.4</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR373">[llvmgcc] obstack.h relies on
+obsolete casts-as-lvalues GCC extension</a></li>
</ol>
+</div>
<!--=========================================================================-->
<div class="doc_subsubsection">
-<a name="codequality">In this release, the following Code Quality issues were fixed:</a>
+<a name="codequality">This release includes the following Code Quality
+improvements:</a>
</div>
+<div class="doc_text">
<ol>
-<li><a href="http://llvm.cs.uiuc.edu/PR187">[loopsimplify] Many pointless phi nodes are created</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR237">[x86] wierd stack/frame pointer manipulation</a></li>
+<li>Fixed: <a href="http://llvm.cs.uiuc.edu/PR309">[vmcore] Code quality problem
+due to long operand of getelementptr</a></li>
-<li>The X86 backend now generate <tt>fchs</tt> to negate floating point numbers,
-compiles memcpy() into the <tt>rep movs</tt> instruction, and makes much better
-use of powerful addressing modes and instructions.</li>
-</ol>
+<li>The X86 backend now generates substantially better code for 64-bit integer
+and floating point operations.</li>
+
+<li>The -inline pass no longer inlines mutually recursive functions until it
+hits the inlining threshold.</li>
+
+<li>The -inline pass no longer misses obvious inlining opportunities just
+because the callee eventually calls into an external function.</li>
+
+<li>The -simplifycfg pass can now "if convert" simple statements into the new
+<tt>select</tt> instruction.</li>
+
+<li>The -loopsimplify pass can now break <a
+href="http://llvm.cs.uiuc.edu/PR35">natural loops with multiple backedges</a>
+into multiple nested loops. This enables a variety of subsequent
+optimizations.</li>
+
+<li>The -adce pass can now eliminate calls to functions that do not not write to
+memory.</li>
+
+<li>The link-time optimizer now runs the -prune-eh pass (to remove unused
+exception handlers).</li>
+<li>The -simplifycfg pass can now eliminate simple correlated branches (such as
+"<tt>if (A < B && A < B)</tt>", and can turn short-circuiting
+operators into the strict versions when useful (such as "<tt>if (A < B || A
+> C)</tt>" into "<tt>if (A < B | A > C)</tt>"</li>
+
+<li>LLVM now has infrastructure for (simple and sparse conditional) constant
+propagation of function calls. It currently supports a few math library
+functions like sqrt/sin/cos/etc.</li>
+
+<li>The C backend now emits <a href="http://llvm.cs.uiuc.edu/PR334">Syntactic
+loops</a> in the code to help C compilers whose optimizers do not recognize
+loops formed from gotos (like GCC).</li>
+
+<li>Fixed: <a href="http://llvm.cs.uiuc.edu/PR368">[sparcv9] null
+often spilled to constant pool</a>.</li>
+</ol>
+</div>
<!--=========================================================================-->
<div class="doc_subsubsection">
-<a name="bugfix">In this release, the following bugs in the previous release were fixed:</a>
+<a name="bugfix">In this release, the following bugs in the previous release
+were fixed:</a>
</div>
+<div class="doc_text">
+
<p>Bugs in the LLVM Core:</p>
<ol>
-<li><a href="http://llvm.cs.uiuc.edu/PR179">[licm] LICM promotes volatile memory
-locations to registers</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR191">[licm] Memory read after free causes
-infrequent crash</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR194">[indvars] Induction variable
-canonicalization always makes 32-bit indvars</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR193">[constantmerge] Merging globals can
-cause use of invalid pointers!</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR212">[bcreader] Bytecode reader misreads 'long -9223372036854775808'!</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/bugs/show_bug.cgi?id=174">Tail duplication does not update SSA form correctly.</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR218">VMCore mishandles double -0.0</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR219">[X86] X86 backend code generates -0.0 as +0.0</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR223">[loopsimplify] Loopsimplify incorrectly updates dominator information</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR225">[pruneeh] -pruneeh pass removes invoke instructions it shouldn't</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR228">[sparc] Boolean constants are emitted as true and false</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR234">[interpreter] va_list values silently corrupted by function calls</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR235">Tablegen aborts on errors</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR236">[inliner] Error inlining intrinsic calls into invoke instructions</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR245">Linking weak and strong global variables is dependent on link order</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR258">Variables used to define non-printable FP constants are externally visible</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR259">CBE gives linkonce functions wrong linkage semantics</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR274">[JIT] Programs cannot resolve the fstat function</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR284">[indvars] Induction variable analysis violates LLVM invariants</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR296">[execution engines] Unhandled cast constant expression</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR299">[Sparc] Code generator asserts on alloca of zero size type</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR306">[loopsimplify] Loop simplify
+incorrectly updates dominator information</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR310">[tailduplicate] DemoteRegToStack
+breaks SSA form</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR313">[X86] JIT miscompiles unsigned short
+to floating point cast</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR315">[jit] abort, don't warn, when
+missing external functions encountered</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR330">[vmcore] Linker causes erroneous
+asssertion</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR332">[adce] Crash handling unreachable
+code that unwinds</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR333">[sparcv9] LLC can't emit 2 functions
+of the same name, both having constant pools</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR337">[livevar] Live variables missed
+physical register use of aliased definition</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR340">Verifier misses malformed switch
+instruction</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR365">[asmwriter] Asm writer aborts if
+an instruction is not embedded into a function</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR369">[X86] stackifier crash on floating
+point setcc X, X</a></li>
</ol>
-
-
<p>Bugs in the C/C++ front-end:</p>
<ol>
-<li><a href="http://llvm.cs.uiuc.edu/PR186">Need weak linkage on memory
-management functions in libc runtime to allow them to be overriden</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR202">[llvm-gcc] asserts when an extern inline function is redefined</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR204">[llvmg++] Dynamically initialized constants cannot be marked 'constant'</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR216">[llvmgcc] floating-point unary minus is incorrect for +0.0</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR221">[llvm-gcc] miscompilation of 'X = Y = Z' with aggregate values</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR272">[llvmgcc] Invalid code created for complex division operation</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR268">[llvmgcc] Incorrect code generation for pointer subtraction</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR261">[llvmg++] Crash assigning pointers-to-members with casted types</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR291">[llvm-g++] Cleanups and gotos don't mix properly</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR297">[llvmgcc] Crash on auto register variable with specific register specified</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR298">[llvmgcc] Variable length array
+indexing miscompiled</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR326">[llvmgcc] Crash on use of undeclared
+enum type</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR355">[llvmgcc] Errors handling function
+prototypes that take opaque structs by-value</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR374">[llvmgcc] Crash compiling variable
+length array of structures</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR377">[llvmgcc] miscompilation of staticly
+initialized unsigned bitfields</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR396">[llvm-gcc] Crash casting function to void</a></li>
</ol>
-
</div>
<!-- *********************************************************************** -->
<div class="doc_text">
-<p>LLVM has been extensively tested on Intel and AMD machines running Red
-Hat Linux and FreeBSD. It has also been tested on Sun UltraSPARC workstations running Solaris 8.
-Additionally,
-LLVM works on Mac OS X 10.3 and above, but only with the C backend or
-interpreter (no native backend for the PowerPC is available yet).
-The core LLVM infrastructure uses "autoconf" for portability, so hopefully we
-work on more platforms than that. However, it is likely that we
-missed something and that minor porting is required to get LLVM to work on
-new platforms. We welcome portability patches and error messages.</p>
+<p>LLVM is known to work in the following platforms:</p>
+
+<ul>
+<li>Intel and AMD machines running Red Hat Linux and FreeBSD (and probably
+ other unix-like systems).</li>
+<li>Sun UltraSPARC workstations running Solaris 8.</li>
+<li>PowerPC-based Mac OS X boxes, running 10.3 and above (C backend and
+ interpreter only, no native codegen is available yet).</li>
+<li>Intel and AMD machines running on Win32 with the Cygwin libraries.</li>
+</ul>
+
+
+<p>The core LLVM infrastructure uses
+<a href="http://www.gnu.org/software/autoconf/">GNU autoconf</a> to adapt itself
+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>
+
+<p>Note that the LLVM build system does not currently support directories with
+spaces on them when running on Win32/cygwin. We strongly recommend running
+LLVM and the C frontend out of a top-level directory without spaces (e.g.,
+<tt>/cygdrive/c/llvm</tt>). Also, make sure to install <b>all</b> of the
+cygwin packages. By default, many important tools are not installed that
+are needed by the LLVM build process or test suite (e.g., /bin/time).</p>
+
+</div>
+
+<!--=========================================================================-->
+<div class="doc_subsection">
+In this release, the following portability problems were fixed:
+</div>
+
+<div class="doc_text">
+
+<ol>
+<li><a href="http://llvm.cs.uiuc.edu/PR304">warnings compiling Stacker compiler
+on Mac OS X</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR308">Archive file reader doesn't
+understand abbreviated names in headers</a></li>
+</ol>
</div>
<div class="doc_text">
-<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
-components, please contact us on the llvmdev list.
-</p>
+<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
+components, please contact us on the llvmdev list.</p>
<ul>
<li>The following passes are incomplete or buggy: <tt>-pgmdep, -memdep,
- -ipmodref, -sortstructs, -swapstructs, -cee</tt></li>
+ -ipmodref, -cee</tt></li>
<li>The <tt>-pre</tt> pass is incomplete (there are cases it doesn't handle that
it should) and not thoroughly tested.</li>
<li>Linking in static archive files (.a files) is very slow (there is no symbol
table in the archive).</li>
-<li><a href="http://llvm.cs.uiuc.edu/PR82">LLVM cannot handle structures with
-more than 256 elements</a>.</li>
-
-<li>The gccld program <a href="http://llvm.cs.uiuc.edu/PR139">does not link objects/archives in the order specified on the command line.</a></li>
+<li>The gccld program <a href="http://llvm.cs.uiuc.edu/PR139">does not link
+objects/archives in the order specified on the command line.</a></li>
<li><a href="http://llvm.cs.uiuc.edu/PR240">The lower-invoke pass does not mark
values live across a setjmp as volatile</a>. This missing feature only affects
}
</pre></li>
-<li>
-Initialization of global union variables can only be done
-<a href="http://llvm.cs.uiuc.edu/bugs/show_bug.cgi?id=162">with the largest
-union member</a>.
-</li>
+<li>Initialization of global union variables can only be done <a
+href="http://llvm.cs.uiuc.edu/bugs/show_bug.cgi?id=162">with the largest union
+member</a>.</li>
-<li><a href="http://llvm.cs.uiuc.edu/PR244">[llvm-gcc] Error when an implicitly external function is re-declared as static</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR244">[llvm-gcc] Error when an implicitly
+external function is re-declared as static</a></li>
</ul>
</div>
We support all builtins which have a C language equivalent (e.g.,
<tt>__builtin_cos</tt>), <tt>__builtin_alloca</tt>,
<tt>__builtin_types_compatible_p</tt>, <tt>__builtin_choose_expr</tt>,
- <tt>__builtin_constant_p</tt>, and <tt>__builtin_expect</tt> (ignored).</li>
-
+ <tt>__builtin_constant_p</tt>, and <tt>__builtin_expect</tt>
+ (currently ignored). We also support builtins for ISO C99 floating
+ point comparison macros (e.g., <tt>__builtin_islessequal</tt>).</li>
</ol>
<p>The following extensions <b>are</b> known to be supported:</p>
<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>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Statement-Exprs.html#Statement%20Exprs">Statement Exprs</a>: Putting statements and declarations inside expressions.</li>
<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>
- <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Lvalues.html#Lvalues">Lvalues</a>: Using <code>?:</code>, "<code>,</code>" and casts in lvalues.</li>
+ <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>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Conditionals.html#Conditionals">Conditionals</a>: Omitting the middle operand of a <code>?:</code> expression.</li>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Long-Long.html#Long%20Long">Long Long</a>: Double-word integers.</li>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Complex.html#Complex">Complex</a>: Data types for complex numbers.</li>
<div class="doc_text">
<ul>
-<li>None so far.
+ <li>Optimized (Release) versions of LLVM built with GCC 3.3.2 or 3.3.3 will
+ produce an llc tool that always enters an infinite loop due to what
+ appears to be an optimization bug (-O2 and -O3) in those versions of GCC.
+ This problem does not happen in GCC 3.3.1 nor GCC 3.4.0 nor does it happen if
+ you build a Debug version of LLVM. You are cautioned not to use GCC 3.3.2 or
+ GCC 3.3.3 to build Optimized versions of LLVM. It is unclear whether this problem
+ affects other backends but it is unlikely.</li>
</ul>
</div>
<!-- ======================================================================= -->
<div class="doc_subsection">
- <a name="sparc-be">Known problems with the Sparc back-end</a>
+ <a name="sparcv9-be">Known problems with the SparcV9 back-end</a>
</div>
<div class="doc_text">
<ul>
-<li>None so far.
+<li><a href="http://llvm.cs.uiuc.edu/PR60">[sparcv9] SparcV9 backend miscompiles
+several programs in the LLVM test suite</a></li>
</ul>
</div>