2 Installation
You will need OCaml release 3.08 or higher to build CIL. CIL has been tested
on Linux and on Windows (where it can behave at either Microsoft Visual C or
gcc).
If you want to use CIL on Windows then you must get a complete installation
of cygwin and the source-code OCaml distribution and compile it yourself
using the cygwin tools (as opposed to getting the Win32 native-code version of
OCaml). If you have not done this before then take a look
here. (Don't need to worry about cvs and
ssh unless you will need to use the master CVS repository for CIL.)
-
Download the CIL distribution (latest version is
distrib/cil-1.3.5.tar.gz). See the Section 20 for recent changes to the CIL distribution.
- Unzip and untar the source distribution. This will create a directory
called cil whose structure is explained below.
tar xvfz cil-1.3.5.tar.gz
- Enter the cil directory and run the configure script and then
GNU make to build the distribution. If you are on Windows, at least the
configure step must be run from within bash.
cd cil
./configure
make
make quicktest
- You should now find cilly.asm.exe in a
subdirectory of obj. The name of the subdirectory is either x86_WIN32
if you are using cygwin on Windows or x86_LINUX if you are using
Linux (although you should be using instead the Perl wrapper bin/cilly).
Note that we do not have an install make target and you should use Cil
from the development directory.
- If you decide to use CIL, please
send us a note. This will help recharge
our batteries after more than a year of development. And of course, do send us
your bug reports as well.
The configure script tries to find appropriate defaults for your system.
You can control its actions by passing the following arguments:
-
CC=foo Specifies the path for the gcc executable. By default
whichever version is in the PATH is used. If CC specifies the Microsoft
cl compiler, then that compiler will be set as the default one. Otherwise,
the gcc compiler will be the default.
CIL requires an underlying C compiler and preprocessor. CIL depends on the
underlying compiler and machine for the sizes and alignment of types.The
installation procedure for CIL queries the underlying compiler for
architecture and compiler dependent configuration parameters, such as the size
of a pointer or the particular alignment rules for structure fields. (This
means, of course, that you should re-run ./configure when you move CIL to
another machine.)
We have tested CIL on the following compilers:
-
On Windows, cl compiler version 12.00.8168 (MSVC 6),
13.00.9466 (MSVC .Net), and 13.10.3077 (MSVC .Net 2003). Run cl
with no arguments to get the compiler version.
- On Windows, using cygwin and gcc version 2.95.3, 3.0,
3.2, 3.3, and 3.4.
- On Linux, using gcc version 2.95.3, 3.0, 3.2, 3.3, and 4.0.
Others have successfully used CIL with Mac OS X (on both PowerPC and
x86), Solaris, and *BSD. If you make any changes to the build
system in order to run CIL on your platform, please send us a patch.