- <!--=====================================================================-->
- <h3><a name="requirements"><b>Requirements</b></a></h3>
- <!--=====================================================================-->
-
- Before you begin to use the LLVM system, review the requirements given
- below. This may save you some trouble by knowing ahead of time what
- hardware and software you will need.
-
- <!--=====================================================================-->
- <h4><a name="hardware"><b>Hardware</b></a></h4>
- <!--=====================================================================-->
- LLVM is known to work on the following platforms:
- <ul>
- <li> Linux on x86 (Pentium and above)
- <ul>
- <li> Approximately 760 MB of Free Disk Space
- <ul>
- <li>Source code: 30 MB
- <li>Object code: 670 MB
- <li>GCC front end: 60 MB
- </ul>
- </ul>
-
- <p>
-
- <li> Solaris on SparcV9 (Ultrasparc)
- <ul>
- <li> Approximately 1.24 GB of Free Disk Space
- <ul>
- <li>Source code: 30 MB
- <li>Object code: 1000 MB
- <li>GCC front end: 210 MB
- </ul>
- </ul>
- </ul>
-
- LLVM <i>may</i> compile on other platforms. The LLVM utilities should work
- on other platforms, so it should be possible to generate and produce LLVM
- bytecode on unsupported platforms (although bytecode generated on one
- platform may not work on another platform). However, the code generators
- and Just-In-Time (JIT) compilers only generate SparcV9 or x86 machine code.
- </p>
-
- <!--=====================================================================-->
- <h4><a name="software"><b>Software</b></a></h4>
- <!--=====================================================================-->
- <p>
-
- Unpacking the distribution requires the following tools:
- <dl compact>
- <dt>
- <A href="http://www.gnu.org/software/gzip/gzip.html">GNU Zip (gzip)</A>
- <dt><A href="http://www.gnu.org/software/tar/tar.html">GNU Tar</A>
- <dd>
- These tools are needed to uncompress and unarchive the software.
- Regular Solaris <tt>tar</tt> may work for unpacking the TAR archive but
- is untested.
- </dl>
-
- Compiling LLVM requires that you have several different software packages
- installed:
-
- <dl compact>
- <dt> <A href="http://gcc.gnu.org">GCC</A>
- <dd>
- The GNU Compiler Collection must be installed with C and C++ language
- support. GCC 3.2.x works, and GCC 3.x is generally supported.
-
- <p>
- Note that we currently do not support any other C++ compiler.
- </p>
-
- <dt> <A href="http://savannah.gnu.org/projects/make">GNU Make</A>
- <dd>
- The LLVM build system relies upon GNU Make extensions. Therefore, you
- will need GNU Make (sometimes known as gmake) to build LLVM.
- <p>
-
- <dt> <A href="http://www.gnu.org/software/flex">Flex</A>
- and
- <A href="http://www.gnu.org/software/bison/bison.html">Bison</A>
- <dd>
- The LLVM source code is built using flex and bison. You will not be
- able to configure and compile LLVM without them.
- <p>
-
- <dt> <A href="http://savannah.gnu.org/projects/m4">GNU M4</A>
- <dd>
- If you are installing Bison on your machine for the first time, you
- will need GNU M4 (version 1.4 or higher).
- </dl>
-
- <p>
- There are some additional tools that you may want to have when working with
- LLVM:
- </p>
-
- <ul>
- <li><A href="http://www.gnu.org/software/autoconf">GNU Autoconf</A>
- <li><A href="http://savannah.gnu.org/projects/m4">GNU M4</A>
- <p>
- If you want to make changes to the configure scripts, you will need
- GNU autoconf (2.53 or higher), and consequently, GNU M4 (version 1.4
- or higher).
- </p>
-
- <li><A href="http://www.codesourcery.com/qm/qmtest">QMTest</A>
- <li><A href="http://www.python.org">Python</A>
- <p>
- In order to run the tests in the LLVM test suite, you will need QMTest and
- a version of the Python interpreter that works with QMTest.
- </ul>
-
-
- <p>The remainder of this guide is meant to get you up and running with
- LLVM and to give you some basic information about the LLVM environment.
- The <a href"#quickstart">next section</a> gives a short summary for those
- who are already familiar with the system and want to get started as quickly
- as possible. A <a href="#starting">complete guide to installation</a> is
- provided in the subsequent section.
-
- <p>The later sections of this guide describe the <a
- href="#layout">general layout</a> of the the LLVM source-tree, a <a
- href="#tutorial">simple example</a> using the LLVM tool chain, and <a
- href="#links">links</a> to find more information about LLVM or to get
- help via e-mail.
-