.\"
.\" mono manual page.
.\" (C) 2003 Ximian, Inc.
+.\" (C) 2004-2005 Novell, Inc.
.\" Author:
.\" Miguel de Icaza (miguel@gnu.org)
.\"
.fi
.TP
.I "--security"
-Activate the security manager (experimental in 1.1). This allows the
-support for declarative security attributes (e.g. execution of, CAS or
-non-CAS, security demands). The security manager is OFF by default
-(experimental). Note that this options is currently not compatible with
-AOT. The security manager will be disabled if AOT (--aot) is specified.
+Activate the security manager (experimental feature in 1.1). This allows
+mono to support declarative security attributes (e.g. execution of, CAS
+or non-CAS, security demands). The security manager is OFF by default
+(experimental).
.TP
.I "-V", "--version"
Prints JIT version information.
You can control this with the MONO_XMLSERIALIZER_THS environment
variable.
.PP
-The possible values are `no' to disable the use of a C# customized
+The possible values are
+.B `no'
+to disable the use of a C# customized
serializer, or an integer that is the minimum number of uses before
the runtime will produce a custom serializer (0 will produce a
custom serializer on the first access, 50 will produce a serializer on
.TP
.I "MONO_DEBUG"
If set, enables some features of the runtime useful for debugging.
-It makes the runtime display the stack traces for all the threads
-running and exit when mono is interrupted (Ctrl-C) and print some
-additional messages on error conditions. It may not exit cleanly. Use at
-your own risk.
+This variable should contain a comma separated list of debugging options.
+Currently, the following options are supported:
+.RS
+.ne 8
+.TP
+.I "keep-delegates"
+This option will leak delegate trampolines that are no longer
+referenced as to present the user with more information about a
+delegate missuse. Basically a delegate instance might be created,
+passed to unmanaged code, and no references kept in managed code,
+which will garbage collect the code. With this option it is possible
+to track down the source of the problems.
+.TP
+.I "abort-on-sigsegv"
+This option will make the runtime abort when it receives a SIGSEGV signal
+while executing unmanaged (native) code. This is useful for debugging
+problems when interfacing with native code.
+.ne
+.RE
.TP
.I "MONO_DISABLE_AIO"
If set, tells mono NOT to attempt using native asynchronous I/O services. In
-that case, the threadpool is used for asynchronous I/O on files and sockets.
-.TP
-.I "MONO_DISABLE_SHM"
-If this variable is set, it disables the shared memory part of the
-Windows I/O Emulation layer, and handles (files, events, mutexes,
-pipes) will not be shared across processes. Process creation is also
-disabled. This option is only available on Unix.
+that case, a default select/poll implementation is used. Currently only epoll()
+is supported.
.TP
.I "MONO_EGD_SOCKET"
For platforms that do not otherwise have a way of obtaining random bytes
Experimental RTC support in the statistical profiler: if the user has
the permission, more accurate statistics are gathered. The MONO_RTC
value must be restricted to what the linux rtc allows: power of two
-from 64 to 8192 Hz.
+from 64 to 8192 Hz. To enable higher frequencies like 4096 Hz, run as root:
+.nf
+ echo 4096 > /proc/sys/dev/rtc/max-user-freq
+.fi
.Sp
For example:
.nf
MONO_RTC=4096 mono --profiler=default:stat program.exe
.fi
+.TP
+.I "MONO_NO_TLS"
+Disable inlining of thread local accesses. Try setting this if you get a segfault
+early on in the execution of mono.
.TP
.I "MONO_SHARED_DIR"
If set its the directory where the ".wapi" handle state is stored.
will store the ".wapi" directory in the users's home directory.
.TP
.I "MONO_THREADS_PER_CPU"
-Sets the maximum number of threads in the threadpool per CPU. The default is
-50 for non-windows systems and 25 for windows.
+The maximum number of threads in the general threadpool will be
+20 + (MONO_THREADS_PER_CPU * number of CPUs). The default value for this
+variable is 5.
.TP
.I "MONO_TRACE"
+Used for runtime tracing of method calls. The format of the comma separated
+trace options is:
+.nf
+
+ [-]M:method name
+ [-]N:namespace
+ [-]T:class name
+ [-]all
+ [-]program
+ disabled Trace output off upon start.
+
+.fi
+You can toggle trace output on/off sending a SIGUSR2 signal to the program.
+.TP
+.I "MONO_TRACE_LISTENER"
If set, enables the System.Diagnostics.DefaultTraceListener, which will
print the output of the System.Diagnostics Trace and Debug classes.
It can be set to a filename, and to Console.Out or Console.Error to display
-output to standard output or standard error, respectively.
+output to standard output or standard error, respectively. If it's set to
+Console.Out or Console.Error you can append an optional prefix that will
+be used when writing messages like this: Console.Error:MyProgramName.
See the System.Diagnostics.DefaultTraceListener documentation for more
information.
.TP
Mono runtime configuration file. See the mono-config(5) manual page
for more information.
.PP
-~/.config/.mono/certs
+~/.config/.mono/certs, /usr/share/.mono/certs
+.PP
+Contains Mono certificate stores for users / machine. See the certmgr(1)
+manual page for more information on managing certificate stores.
+.PP
+~/.config/.mono/keypairs, /usr/share/.mono/keypairs
+.PP
+Contains Mono cryptographic keypairs for users / machine. They can be
+accessed by using a CspParameters object with DSACryptoServiceProvider
+and RSACryptoServiceProvider classes.
.PP
-Contains Mono certificate stores. See the certmgr(1) manual page for
-more information.
+~/.config/.isolatedstorage, ~/.local/share/.isolatedstorage, /usr/share/.isolatedstorage
+.PP
+Contains Mono isolated storage for non-roaming users, roaming users and
+local machine. Isolated storage can be accessed using the classes from
+the System.IO.IsolatedStorage namespace.
.SH MAILING LISTS
-Visit http://mail.ximian.com/mailman/mono-list for details.
+Visit http://lists.ximian.com/mailman/listinfo/mono-list for details.
.SH WEB SITE
Visit: http://www.mono-project.com for details
.SH SEE ALSO
.BR mcs(1), mint(1), monodis(1), mono-config(5), certmgr(1).
.PP
For ASP.NET-related documentation, see the xsp(1) manual page
-
-