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.16</b><br>
  21               <a href="archive/mono-0.16">Release notes</a><br>
  22               Oct 1st, 2002.
  23             </td>
  24             <td>
  25               <table cellspacing="1" 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.16.tar.gz">Mono Class Libraries and C# Compiler.</a>
  33                       <li><a href="archive/mono-0.16.tar.gz">Mono Runtime</a>
  34                       <li><a href="archive/gc6.1.tar.gz">Boehm GC 6.1</a>
  35                     </ul>
  36                   </td>
  37                 </tr>
  38                 <tr bgcolor="#BBBBBB">
  39                   <td>
  40                      <b>Source RPMs</b>
  41                   </td>
  42                   <td>
  43                     <ul>
  44                         <li><a href="archive/libgc-6.1-1.src.rpm">libgc-6.1-1.src.rpm</a>
  45                         <li><a href="archive/mono-0.16-1.src.rpm">mono-0.16-1.src.rpm</a>
  46                     </ul>
  47                   </td>
  48                 </tr>
  49                 <tr>
  50                  <td></td>
  51                 </tr>
  52                 <tr>
  53                   <td bgcolor="#999999">
  54                     <b>Red Hat 7.3/x86</b>
  55                     <ul>
  56                         <li><a href="archive/redhat-73-i386/libgc-6.1-1.i386.rpm">libgc-6.1-1.i386.rpm</a>
  57                         <li><a href="archive/redhat-73-i386/libgc-devel-6.1-1.i386.rpm">libgc-devel-6.1-1.i386.rpm</a>
  58                         <li><a href="archive/redhat-73-i386/mono-0.16-1.i386.rpm">mono-0.16-1.i386.rpm</a>
  59                         <li><a href="archive/redhat-73-i386/mono-devel-0.16-1.i386.rpm">mono-devel-0.16-1.i386.rpm</a>
  60                     </ul>
  61                   </td>
  62                   <td bgcolor="#999999">
  63                     <b>Red Hat 7.1/x86</b>
  64                     <ul>
  65                         <li><a href="archive/redhat-71-i386/libgc-6.1-1.i386.rpm">libgc-6.1-1.i386.rpm</a>
  66                         <li><a href="archive/redhat-71-i386/libgc-devel-6.1-1.i386.rpm">libgc-devel-6.1-1.i386.rpm</a>
  67                         <li><a href="archive/redhat-71-i386/mono-0.16-1.i386.rpm">mono-0.16-1.i386.rpm</a>
  68                         <li><a href="archive/redhat-71-i386/mono-devel-0.16-1.i386.rpm">mono-devel-0.16-1.i386.rpm</a>
  69                     </ul>
  70                   </td>
  71                 </tr>
  72                 <tr>
  73                   <td bgcolor="#999999">
  74                     <b>Mandrake 8.2/x86</b>
  75                     <ul>
  76                         <li><a href="archive/mandrake-82-i386/libgc-6.1-1.i586.rpm">libgc-6.1-1.i586.rpm</a>
  77                         <li><a href="archive/mandrake-82-i386/libgc-devel-6.1-1.i586.rpm">libgc-devel-6.1-1.i586.rpm</a>
  78                         <li><a href="archive/mandrake-82-i386/mono-0.16-1.i586.rpm">mono-0.16-1.i586.rpm</a>
  79                         <li><a href="archive/mandrake-82-i386/mono-devel-0.16-1.i586.rpm">mono-devel-0.16-1.i586.rpm</a>
  80                     </ul>
  81                   </td>
  82                   <td bgcolor="#999999">
  83                     <b>SuSE 8.0/x86</b>
  84                     <ul>
  85                         <li><a href="archive/suse-80-i386/libgc-6.1-1.i386.rpm">libgc-6.1-1.i386.rpm</a>
  86                         <li><a href="archive/suse-80-i386/libgc-devel-6.1-1.i386.rpm">libgc-devel-6.1-1.i386.rpm</a>
  87                         <li><a href="archive/suse-80-i386/mono-0.16-1.i386.rpm">mono-0.16-1.i386.rpm</a>
  88                         <li><a href="archive/suse-80-i386/mono-devel-0.16-1.i386.rpm">mono-devel-0.16-1.i386.rpm</a>
  89                     </ul>
  90                   </td>
  91                 </tr>
  92               </table>
  93             </td>
  94           </tr>
  95           <tr>
  96             <tr bgcolor="#CCCCC">
  97             <td>
  98               <b>Regression Tests</b><br>
  99             </td>
 100             <td>
 101                 You can get binaries for the Mono Regression Test
 102                 Suite <a href="archive/mono-tests.tar.gz">here</a>
 103             </td>
 104           </tr>
 105           </tr>
 106           </tbody>
 107         </table>
 108 <br>
 109 * Older Releases:
 110
 111         We provide binaries for older releases until we have packages for the new release.
 112
 113
 114         <table>
 115           <tbody>
 116           <tr bgcolor="#DDDDDD">
 117             <td>
 118               <b>Release 0.15</b><br>
 119               <a href="archive/mono-0.15">Release notes</a><br>
 120               Aug 23rd, 2002.
 121             </td>
 122             <td>
 123               <table cellspacing="1" cellpadding="3">
 124                 <tr bgcolor="#BBBBBB">
 125                   <td>
 126                     <b>Source Code</b>
 127                   </td>
 128                   <td>
 129                     <ul>
 130                       <li><a href="archive/mcs-0.15.tar.gz">Mono Class Libraries and C# Compiler.</a>
 131                       <li><a href="archive/mono-0.15.tar.gz">Mono Runtime</a>
 132                       <li><a href="archive/gc6.1alpha5.tar.gz">Boehm GC 6.1alpha5</a>
 133                     </ul>
 134                   </td>
 135                 </tr>
 136                 <tr bgcolor="#BBBBBB">
 137                   <td>
 138                      <b>Source RPMs</b>
 139                   </td>
 140                   <td>
 141                     <ul>
 142                         <li><a href="archive/libgc-6.1alpha5-1.src.rpm">libgc-6.1alpha5-1.src.rpm</a>
 143                         <li><a href="archive/mono-0.15-1.src.rpm">mono-0.15-1.src.rpm</a>
 144                     </ul>
 145                   </td>
 146                 </tr>
 147                 <tr>
 148                  <td></td>
 149                 </tr>
 150                 \r
 151                 <tr bgcolor="#999999">\r
 152                   <td>\r
 153                     <b>Windows (win95 friendly)</b>\r
 154                     <ul>\r
 155                       <li><a href="archive/mono-w32-Aug_28_2002.zip">Mono-w32</a>\r
 156                     </ul>\r
 157                   </td>\r
 158                   <td bgcolor="#999999">\r
 159                     <b>Windows Setup Wizard (NT/2000/XP)</b>\r
 160                     <ul>\r
 161                       <li><a href="http://www.sport-huettn.de/mono/mono-0.15-stable.exe">Mono-Setup</a>\r
 162                     </ul>\r
 163                   </td>\r
 164                 </tr>\r
 165                 <tr bgcolor="#999999">\r
 166                   <td bgcolor="#999999">\r
 167                     <b>Red Hat null-8.0/x86</b>\r
 168                     <ul>\r
 169                         <li><a href="archive/redhat-null-i386/libgc-6.1alpha5-1.i386.rpm">libgc-6.1alpha5-1.i386.rpm</a>\r
 170                         <li><a href="archive/redhat-null-i386/libgc-devel-6.1alpha5-1.i386.rpm">libgc-devel-6.1alpha5-1.i386.rpm</a>\r
 171                         <li><a href="archive/redhat-null-i386/mono-0.15-1.i386.rpm">mono-0.15-1.i386.rpm</a>\r
 172                         <li><a href="archive/redhat-null-i386/mono-devel-0.15-1.i386.rpm">mono-devel-0.15-1.i386.rpm</a>\r
 173                     </ul>\r
 174                   </td>\r
 175                   <td bgcolor="#999999">\r
 176                         &nbsp;              \r
 177 \r
 178                   </td>\r
 179                 </tr>\r
 180 \r
 181               </table>
 182             </td>
 183           </tr>
 184           </tbody>
 185         </table>
 186
 187 ** Binaries for other platforms.
 188
 189         Already daily volunteer's made binaries:
 190
 191         <ul>
 192                 * <a href="http://www.debianplanet.org/mono/">DebianPlanet</a>
 193                 * <a href="http://www.superin.formativ.net/mono/mono.htm">Windows</a> (works without cygwin!)
 194         </ul>
 195
 196 * Snapshots
 197
 198 <a name="snapshots">
 199
 200         <a href="http://www.go-mono.com/snapshots">Nightly snapshots</a> of
 201         the CVS repository are made every day at 10pm EST (Boston
 202         Time).  These are not guaranteed to build, they are just a
 203         snapshot of the tree.
 204
 205         The <a href="anoncvs.html">anoncvs</a> mirrors provided by
 206         Hispalinux are updated every six hours.
 207
 208 * Compiling with scripts
 209
 210         There are scripts to help build mono for both Unix and Windows.  Get
 211         <a href="mono-build.sh">mono-build.sh</a> for Unix, or <a
 212         href="mono-build-w32.sh">mono-build-w32.sh</a> for Windows.
 213         These scripts automate the installation of GLIB and pkgconfig
 214         (building from source on Unix, and using binary packages
 215         provided by the GIMP for Windows project on Windows.)  To use
 216         the script, follow these simple steps:
 217
 218         <ul>
 219                 * Save the script for your platform somewhere (e.g. /usr/local/bin)
 220                 * Make the script executable (i.e chmod 755 /usr/local/bin/mono-build.sh)
 221                 * Create a directory to hold the mono source, and the compiled binaries (e.g. mkdir ~/mono)
 222                 * Change to the new directory (i.e. cd ~/mono)
 223                 * run the script (i.e. /usr/local/bin/mono-build.sh)
 224         </ul>
 225
 226         The script requires wget on either platform, and building the
 227         software requires make, gcc, automake, autoconf, and libtool.
 228         You should install these packages from your distribution or
 229         with the cygwin installer. You should also take care of setting
 230         the right environment variables as the PKG_CONFIG_FLAGS, etc.
 231
 232         The script will download required packages from
 233         www.go-mono.com and do a cvs checkout of mono in the current
 234         directory.  <b>IMPORTANT!:</b> The cvs server chosen defaults to
 235         anonymous cvs;
 236         set your CVSROOT environment variable before running the script to
 237         select a particular cvs server.
 238
 239 <a name="install">
 240 ** Building the software manually
 241
 242         You will need to obtain the Mono dependencies first: <a
 243         href="http://www.gtk.org">glib 2.x</a> and
 244         <a href="http://www.freedesktop.org/software/pkgconfig">pkg-config</a>.
 245
 246 *** Building on Linux
 247
 248         <ul>
 249                 Unpack the Mono runtime distribution:
 250                 <pre>
 251                 tar xzvf mono-X.XX.tar.gz
 252                 cd mono-X.XX
 253
 254                 </pre>
 255                 <p>
 256
 257                 Then configure, compile and install:
 258
 259                 <pre>
 260
 261                 ./configure --prefix=/usr/local
 262                 make
 263                 make install</pre>
 264
 265                 This will give you a runtime, C# compiler and runtime
 266                 libraries.
 267
 268                 If you want to recompile the runtime and the compiler,
 269                 follow these steps, first unpack the MCS package:
 270
 271                 <pre>
 272                 tar xzvf mcs-X.XX.tar.gz
 273
 274                 cd mcs-X.XX
 275                 </pre>
 276
 277                 Then use the following command to compile and install:
 278
 279                 <pre>
 280
 281                 make -f makefile.gnu install prefix=/usr/local
 282                 </pre>
 283
 284                 You can change /usr/local to something else if you want.
 285         </ul>
 286
 287 *** On Windows, to install and work on the compiler and the class libraries:
 288
 289 **** Install Cygwin and the GNU build tools, Microsoft's .NET Framework SDK and the precompiled GLIB 2.0 and pkg-config libraries.
 290
 291         <ul>
 292
 293                 * Install <a href="http://www.cygwin.com">Cygwin</a>.
 294
 295                 * Install <a href="http://msdn.microsoft.com/downloads">
 296                   Microsoft .NET Framework SDK</a>.
 297
 298                 * Change to the /usr/local directory
 299                   of your Cygwin installation.<br>
 300                   Unzip the precompiled packages listed above.
 301
 302         </ul>
 303         <ul>
 304
 305                 * If you downloaded the Mono
 306                 <a href="http://www.go-mono.com/snapshots">nightly snapshot
 307                 </a>, untar the snapshot.
 308
 309                 * Change directories to "mcs".
 310
 311                 * Compile:
 312
 313                 <pre>
 314                 make
 315                 </pre>
 316         </ul>
 317
 318 *** On Windows, to compile the mono runtime:
 319
 320         <ul>
 321
 322                 * If you downloaded the Mono
 323                   <a href="http://www.go-mono.com/snapshots">nightly snapshot
 324                   </a>, untar the snapshot.
 325
 326                 * Change directories to "mono".
 327
 328                 * Configure, compile and install:
 329                 <pre>
 330                 ./configure --prefix=c:/mono
 331                 make
 332                 make install
 333                 </pre>
 334
 335         </ul>
 336
 337 * Software resources and notes
 338
 339                 The required and additional software can be downloaded here:
 340
 341                 * Microsoft's .NET Framework SDK from
 342                   <a href="http://msdn.microsoft.com/downloads">
 343                   msdn.microsoft.com/downloads</a>.
 344
 345                 * Cygwin and the GNU Make tools from
 346                   <a href="http://www.cygwin.com">www.cygwin.com</a>.
 347                   Some people observed problems with autoconf 2.52. Installing
 348                   autoconf 2.13 helped in those cases.
 349
 350                 * Precompiled GLIB 2.0 and pkg-config packages (and
 351                   their dependencies) by the <a href="http://www.gimp.org/~tml/gimp/win32//index.html">GIMP for Windows</a> project from
 352                   <a href="http://www.go-mono.com/archive/pkgconfig-0.11-20020310.zip">http://www.go-mono.com/archive/pkgconfig-0.11-20020310.zip</a><br>
 353                   <a href="http://www.go-mono.com/archive/glib-2.0.4-20020703.zip">http://www.go-mono.com/archive/glib-2.0.4-20020703.zip</a> <br>
 354                   <a href="http://www.go-mono.com/archive/glib-dev-2.0.4-20020703.zip">http://www.go-mono.com/archive/glib-dev-2.0.4-20020703.zip</a> <br>
 355                   <a href="http://www.go-mono.com/archive/libiconv-1.7.zip">http://www.go-mono.com/archive/libiconv-1.7.zip</a> <br>
 356                   <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>
 357                   <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>
 358
 359
 360                 * Download the Mono source code from the
 361                   <a href="#feb-11">packaged versions</a> or
 362                   the <a href="http://www.go-mono.com/snapshots">
 363                   nightly snapshots</a> or the <a href="anoncvs.html">
 364                   Anonymous CVS</a>.  The nightly snapshots are done every
 365                   night at 10pm EST (Boston Time). The nightly snapshots are
 366                   not guaranteed to build, but most of the time they should.
 367
 368
 369         </ul>
 370
 371
 372 *** Notes on compiling GLIB 2.0 and pkg-config from source:
 373
 374
 375         <ul>
 376
 377                 * Some people observed problems with autoconf 2.52. Installing
 378                   autoconf 2.13 helped in those cases (don't forget to do a
 379                   `make maintainer-clean' after the update).
 380
 381                 * Download, compile and install <a href="http://www.freedesktop.org/software/pkgconfig">pkg-config</a> from source.
 382                   (I had to change line 674 of
 383                   <nobr><tt>pkg-config-0.8.0/glib-1.2.8/gstrfuncs.c</tt></nobr> from
 384                   <nobr><tt>extern char *strsignal (int sig);</tt></nobr> to
 385                   <nobr><tt>extern const char *strsignal (int sig);</tt></nobr>.
 386
 387 <pre>
 388 tar xzvf pkg-config-0.8.0.tar.gz
 389 cd pkg-config-0.8.0
 390 ./configure --prefix=/usr
 391 make
 392 make install
 393 </pre>
 394
 395                 * Download, compile and install <a href="ftp://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.7.tar.gz">libiconv</a> from source.<br>
 396                   If you dont have MS Visual C/C++ 4.0 or 5.0 or 6.0 you can also try
 397                   the binary package available at <a
 398                   href="http://www.gimp.org/win32/libiconv-dev-20001007.zip">
 399                   http://www.gimp.org/win32/libiconv-dev-20001007.zip</a>.
 400
 401
 402                 * Download, compile and install the
 403                   <a href="ftp://ftp.gtk.org/pub/gtk/v2.0/glib-2.0.6.tar.gz">
 404                   glib 2.0</a> from source.
 405
 406         </ul>
 407