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