2002-03-24 Martin Baulig <martin@gnome.org>
[mono.git] / man / mono.1
1 .\" 
2 .\" mint manual page.
3 .\" (C) Ximian, Inc. 
4 .\" Author:
5 .\"   Miguel de Icaza (miguel@gnu.org)
6 .\"
7 .TH Mono "Mono 1.0"
8 .SH NAME
9 mono \- Mono ECMA-CLI Just in Time compiler.
10 .SH SYNOPSIS
11 .PP
12 .B mono
13 [\-\-help] [\-d] [\-\-debug-asm] [\-\-debug-forest] [\-\-trace-calls]
14 [\-\-stabs] [\-\-compile cname] [\-\-ncompile num] [\-\-debug]
15 program.exe [arguments...]
16 .SH DESCRIPTION
17 The \fImono\fP program is a Just in Time compiler for ECMA CLI byte
18 codes.  It translates dynamically a CIL stream into native code. 
19 .I program.exe
20 and optionally passes
21 the
22 .I arguments
23 to it. 
24 .SH OPTIONS
25 The following options are supported:
26 .TP
27 .I "--help", "-h"
28 Displays usage instructions.
29 .I "--share-code"
30 This mode makes the LoaderOptimization for Application Domains default
31 to sharing code.  This results in slower code, but enables code
32 sharing across application domains.  The default is to maximize for
33 speed, but disallow JITed code sharing across domains.  See
34 System.LoaderOptimization for more information
35 .SH DEBUGGING OPTIONS
36 The following options are used to debug, or perfomance test the JIT
37 compiler:
38 .TP
39 .I "--trace-calls"
40 Shows method names as they are invoked.
41 .TP
42 .I "--dump-asm"
43 Displays the generated code as methods are invoked.
44 .TP
45 .I "--dump-forest"
46 Displays the basic blocks and the forest of trees that is 
47 created from a stream of CIL opcodes.
48 .TP
49 .I "--stabs"
50 Writes out stabs debug information
51 .TP
52 .I "--dwarf"
53 Writes out dwarf debug information
54 .TP
55 .I "--dwarf-plus"
56 Uses an extended debugging information file which has been generated
57 by MCS.  This extended debugging information will allow you to debug
58 C# source code rather than IL code.  To use it, just run the JIT in
59 your debugger and call "mono_debug_make_symbols" each time the program
60 stops.
61 .TP
62 .I "--debug method"
63 Debugs the method whose name is `method'
64 .TP
65 .I "--compile"
66 Compiles the method on the given class (namespace.name:methodname).
67 .TP
68 .I "--ncompile"
69 Compiles the method a number of times.  If no argument is specified,
70 the method will be compiled a thousand times.
71 .SH FILES
72 Assemblies are lodaed from the installation lib directory.  If you set
73 `prefix' to /usr, the assemblies will be located in /usr/lib.
74 .SH MAILING LISTS
75 Visit http://mail.ximian.com/mailman/mono-list for details.
76 .SH WEB SITE
77 Visit: http://www.go-mono.com for details
78 .SH SEE ALSO
79 .BR mint(1), monodis(1)