8 1. Compilation and Installation
9 ===============================
14 To build Mono, you will need the following components:
18 Available from: http://www.freedesktop.org/Software/pkgconfig
22 Available from: http://www.gtk.org/
24 Optional dependencies:
28 http://oss.software.ibm.com/icu/index.html
30 You will need this one to get complete support for the international
31 features of the .NET Framework.
33 * Cairo and libgdiplus
35 If you want to get support for System.Drawing, you will need to get
36 both Libgdiplus and Cairo.
38 b. Building the Software
39 ------------------------
41 If you obtained this package as an officially released tarball,
42 this is very simple, use configure and make:
44 ./configure --prefix=/usr/local
48 Mono supports a JIT engine on x86, SPARC and PowerPC systems.
49 The various commands that ship with Mono default to the JIT engine
50 on x86 and SPARC, to turn it on for PPC systems, use the --with-jit=yes
51 command line option to configure.
53 MacOS X Users: you will need to download the latest Boehm GC
54 Alpha release for garbage collection to work properly.
56 If you obtained this as a snapshot, you will need an existing
57 Mono installation. To upgrade your installation, unpack both
60 tar xzf mcs-XXXX.tar.gz
61 tar xzf mono-XXXX.tar.gz
65 ./autogen.sh --prefix=/usr/local
71 If you are upgrading from CVS you will need an existing Mono installation.
72 First verify that you have a working installation:
74 echo 'class X { static void Main () { System.Console.Write("OK");}}' > x.cs
84 If you get the output `OK' and no errors, you are ready to start your CVS upgrade.
86 First, make sure that you have up-to-date mcs and mono sources:
90 Then, go into the mono directory, and configure:
93 ./autogen.sh --prefix=/usr/local
95 Then compile using the special target `bootstrap':
99 You can now install it:
103 This step will compile and install at the same time.
105 Failure to follow these steps will result in a broken installation.
111 Once you have installed the software, you can run a few programs:
127 See the man pages for mono(1), mint(1), monodis(1) and mcs(2)
134 Contains the web site contents.
137 Technical documents about the Mono runtime.
140 Configuration files installed as part of the Mono runtime.
143 The core of the Mono Runtime.
146 The object system and metadata reader.
149 The Just in Time Compiler.
152 CIL executable Disassembler
155 Common code for the JIT and the interpreter.
158 The I/O layer and system abstraction for
159 emulating the .NET IO model.
162 Common Intermediate Representation, XML
163 definition of the CIL bytecodes.
166 Interpreter for CLI executables.
169 Architecture specific portions.
173 Manual pages for the various Mono commands and programs.
177 Scripts used to invoke Mono and the corresponding program.
181 A directory holding a pre-compiled version of the Mono