doc/download

   1 * Software Availability
   2
   3         The Virtual Execution System is available in package `mono'.
   4         Currently this contains a metadata library and the
   5         disassembler.  Please refer to our <a
   6         href="runtime.html">Runtime</a> description for more details
   7         on this part of the project.
   8
   9         Some useful links: <a
  10         href="http://www.go-mono.org/mono-beginning.html">Resources/Beginning
  11         section</a>, the <a
  12         href="http://www.go-mono.org/faq.html">FAQ</a> and the <a
  13         href="http://geneura.ugr.es/~jaime/deploy/mono-common-problems.html">
  14         Mono Common Problems</a>.
  15
  16         <table>
  17           <tbody>
  18           <tr bgcolor="#DDDDDD">
  19             <td>
  20               <b>Release 0.15</b><br>
  21               <a href="archive/mono-0.15">Release notes</a><br>
  22               Aug 23rd, 2002.
  23             </td>
  24             <td>
  25               <table cellspacing="0" cellpadding="3">
  26                 <tr bgcolor="#BBBBBB">
  27                   <td>
  28                     <b>Source Code</b>
  29                   </td>
  30                   <td>
  31                     <ul>
  32                       <li><a href="archive/mcs-0.15.tar.gz">Mono Class Libraries and C# Compiler.</a>
  33                       <li><a href="archive/mono-0.15.tar.gz">Mono Runtime</a>
  34                       <li><a href="archive/gc6.1alpha5.tar.gz">Boehm GC 6.1alpha5</a>
  35                     </ul>
  36                   </td>
  37                 </tr>
  38                 <tr>
  39                  <td></td>
  40                 </tr>
  41                 <tr bgcolor="#999999">
  42                   <td>
  43                     <b>Red Hat 7.3</b>
  44                   </td>
  45                   <td>
  46                     Source RPMS:
  47                     <ul>
  48                         <li><a href="archive/libgc-6.1alpha5-1.src.rpm">libgc-6.1alpha5-1.src.rpm</a>
  49                         <li><a href="archive/mono-0.15-1.src.rpm">mono-0.15-1.src.rpm</a>
  50                     </ul>
  51                     X86 RPMS:
  52                     <ul>
  53                         <li><a href="archive/libgc-6.1alpha5-1.i386.rpm">libgc-6.1alpha5-1.i386.rpm</a>
  54                         <li><a href="archive/libgc-devel-6.1alpha5-1.i386.rpm">libgc-devel-6.1alpha5-1.i386.rpm</a>
  55                         <li><a href="archive/mono-0.15-1.i386.rpm">mono-0.15-1.i386.rpm</a>
  56                         <li><a href="archive/mono-devel-0.15-1.i386.rpm">mono-devel-0.15-1.i386.rpm</a>
  57                     </ul>
  58                   </td>
  59                 </tr>
  60               </table>
  61             </td>
  62           </tr>
  63           <tr>
  64             <tr bgcolor="#CCCCC">
  65             <td>
  66               <b>Regression Tests</b><br>
  67             </td>
  68             <td>
  69                 You can get binaries for the Mono Regression Test
  70                 Suite <a href="archive/mono-tests.tar.gz">here</a>
  71             </td>
  72           </tr>
  73           </tbody>
  74         </table>
  75
  76 ** Binaries for other platforms.
  77
  78         Already daily volunteer's made binaries:
  79
  80         <ul>
  81                 * <a href="http://www.debianplanet.org/mono/">DebianPlanet</a>
  82                 * <a href="http://www.superin.formativ.net/mono/mono.htm">Windows</a> (works without cygwin!)
  83         </ul>
  84
  85 * Snapshots
  86
  87 <a name="snapshots">
  88
  89         <a href="http://www.go-mono.com/snapshots">Nightly snapshots</a> of
  90         the CVS repository are made every day at 10pm EST (Boston
  91         Time).  These are not guaranteed to build, they are just a
  92         snapshot of the tree.
  93
  94         The <a href="anoncvs.html">anoncvs</a> mirrors provided by
  95         Hispalinux are updated every six hours.
  96
  97 * Compiling with scripts
  98
  99         There are scripts to help build mono for both Unix and Windows.  Get
 100         <a href="mono-build.sh">mono-build.sh</a> for Unix, or <a
 101         href="mono-build-w32.sh">mono-build-w32.sh</a> for Windows.
 102         These scripts automate the installation of GLIB and pkgconfig
 103         (building from source on Unix, and using binary packages
 104         provided by the GIMP for Windows project on Windows.)  To use
 105         the script, follow these simple steps:
 106
 107         <ul>
 108                 * Save the script for your platform somewhere (e.g. /usr/local/bin)
 109                 * Make the script executable (i.e chmod 755 /usr/local/bin/mono-build.sh)
 110                 * Create a directory to hold the mono source, and the compiled binaries (e.g. mkdir ~/mono)
 111                 * Change to the new directory (i.e. cd ~/mono)
 112                 * run the script (i.e. /usr/local/bin/mono-build.sh)
 113         </ul>
 114
 115         The script requires wget on either platform, and building the
 116         software requires make, gcc, automake, autoconf, and libtool.
 117         You should install these packages from your distribution or
 118         with the cygwin installer. You should also take care of setting
 119         the right environment variables as the PKG_CONFIG_FLAGS, etc.
 120
 121         The script will download required packages from
 122         www.go-mono.com and do a cvs checkout of mono in the current
 123         directory.  <b>IMPORTANT!:</b> The cvs server chosen defaults to
 124         anonymous cvs;
 125         set your CVSROOT environment variable before running the script to
 126         select a particular cvs server.
 127
 128 <a name="install">
 129 ** Building the software manually
 130
 131         You will need to obtain the Mono dependencies first: <a
 132         href="http://www.gtk.org">glib 2.x</a> and
 133         <a href="http://www.freedesktop.org/software/pkgconfig">pkg-config</a>.
 134
 135 *** Building on Linux
 136
 137         <ul>
 138                 Unpack the Mono runtime distribution:
 139                 <pre>
 140                 tar xzvf mono-X.XX.tar.gz
 141                 cd mono-X.XX
 142
 143                 </pre>
 144                 <p>
 145
 146                 Then configure, compile and install:
 147
 148                 <pre>
 149
 150                 ./configure --prefix=/usr/local
 151                 make
 152                 make install</pre>
 153
 154                 This will give you a runtime, C# compiler and runtime
 155                 libraries.
 156
 157                 If you want to recompile the runtime and the compiler,
 158                 follow these steps, first unpack the MCS package:
 159
 160                 <pre>
 161                 tar xzvf mcs-X.XX.tar.gz
 162
 163                 cd mcs-X.XX
 164                 </pre>
 165
 166                 Then use the following command to compile and install:
 167
 168                 <pre>
 169
 170                 make -f makefile.gnu install prefix=/usr/local
 171                 </pre>
 172
 173                 You can change /usr/local to something else if you want.
 174         </ul>
 175
 176 *** On Windows, to install and work on the compiler and the class libraries:
 177
 178 **** Install Cygwin and the GNU build tools, Microsoft's .NET Framework SDK and the precompiled GLIB 2.0 and pkg-config libraries.
 179
 180         <ul>
 181
 182                 * Install <a href="http://www.cygwin.com">Cygwin</a>.
 183
 184                 * Install <a href="http://msdn.microsoft.com/downloads">
 185                   Microsoft .NET Framework SDK</a>.
 186
 187                 * Change to the /usr/local directory
 188                   of your Cygwin installation.<br>
 189                   Unzip the precompiled packages listed above.
 190
 191         </ul>
 192         <ul>
 193
 194                 * If you downloaded the Mono
 195                 <a href="http://www.go-mono.com/snapshots">nightly snapshot
 196                 </a>, untar the snapshot.
 197
 198                 * Change directories to "mcs".
 199
 200                 * Compile:
 201
 202                 <pre>
 203                 make
 204                 </pre>
 205         </ul>
 206
 207 *** On Windows, to compile the mono runtime:
 208
 209         <ul>
 210
 211                 * If you downloaded the Mono
 212                   <a href="http://www.go-mono.com/snapshots">nightly snapshot
 213                   </a>, untar the snapshot.
 214
 215                 * Change directories to "mono".
 216
 217                 * Configure, compile and install:
 218                 <pre>
 219                 ./configure --prefix=c:/mono
 220                 make
 221                 make install
 222                 </pre>
 223
 224         </ul>
 225
 226 * Software resources and notes
 227
 228                 The required and additional software can be downloaded here:
 229
 230                 * Microsoft's .NET Framework SDK from
 231                   <a href="http://msdn.microsoft.com/downloads">
 232                   msdn.microsoft.com/downloads</a>.
 233
 234                 * Cygwin and the GNU Make tools from
 235                   <a href="http://www.cygwin.com">www.cygwin.com</a>.
 236                   Some people observed problems with autoconf 2.52. Installing
 237                   autoconf 2.13 helped in those cases.
 238
 239                 * Precompiled GLIB 2.0 and pkg-config packages (and
 240                   their dependencies) by the <a href="http://www.gimp.org/~tml/gimp/win32//index.html">GIMP for Windows</a> project from
 241                   <a href="http://www.go-mono.com/archive/pkgconfig-0.80-tml-20020101.zip">http://www.go-mono.com/archive/pkgconfig-0.80-tml-20020101.zip</a><br>
 242                   <a href="http://www.go-mono.com/archive/glib-1.3.12-20020101.zip">http://www.go-mono.com/archive/glib-1.3.12-20020101.zip</a> <br>
 243                   <a href="http://www.go-mono.com/archive/glib-dev-1.3.12-20020101.zip">http://www.go-mono.com/archive/glib-dev-1.3.12-20020101.zip</a> <br>
 244                   <a href="http://www.go-mono.com/archive/libiconv-1.7.zip">http://www.go-mono.com/archive/libiconv-1.7.zip</a> <br>
 245                   <a href="http://www.go-mono.com/archive/libiconv-dev-1.7.zip">http://www.go-mono.com/archive/libiconv-dev-1.7-20020101.zip</a> <br>
 246                   <a href="http://www.go-mono.com/archive/libintl-0.10.40-20020101.zip">http://www.go-mono.com/archive/libintl-0.10.40-20020101.zip</a><br>
 247
 248
 249                 * Download the Mono source code from the
 250                   <a href="#feb-11">packaged versions</a> or
 251                   the <a href="http://www.go-mono.com/snapshots">
 252                   nightly snapshots</a> or the <a href="anoncvs.html">
 253                   Anonymous CVS</a>.  The nightly snapshots are done every
 254                   night at 10pm EST (Boston Time). The nightly snapshots are
 255                   not guaranteed to build, but most of the time they should.
 256
 257
 258         </ul>
 259
 260
 261 *** Notes on compiling GLIB 2.0 and pkg-config from source:
 262
 263
 264         <ul>
 265
 266                 * Some people observed problems with autoconf 2.52. Installing
 267                   autoconf 2.13 helped in those cases (don't forget to do a
 268                   `make maintainer-clean' after the update).
 269
 270                 * Download, compile and install <a href="http://www.freedesktop.org/software/pkgconfig">pkg-config</a> from source.
 271                   (I had to change line 674 of
 272                   <nobr><tt>pkg-config-0.8.0/glib-1.2.8/gstrfuncs.c</tt></nobr> from
 273                   <nobr><tt>extern char *strsignal (int sig);</tt></nobr> to
 274                   <nobr><tt>extern const char *strsignal (int sig);</tt></nobr>.
 275
 276 <pre>
 277 tar xzvf pkg-config-0.8.0.tar.gz
 278 cd pkg-config-0.8.0
 279 ./configure --prefix=/usr
 280 make
 281 make install
 282 </pre>
 283
 284                 * Download, compile and install <a href="ftp://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.7.tar.gz">libiconv</a> from source.<br>
 285                   If you dont have MS Visual C/C++ 4.0 or 5.0 or 6.0 you can also try
 286                   the binary package available at <a
 287                   href="http://www.gimp.org/win32/libiconv-dev-20001007.zip">
 288                   http://www.gimp.org/win32/libiconv-dev-20001007.zip</a>.
 289
 290
 291                 * Download, compile and install the
 292                   <a href="ftp://ftp.gtk.org/pub/gtk/v2.0/glib-2.0.6.tar.gz">
 293                   glib 2.0</a> from source.
 294
 295         </ul>
 296