X-Git-Url: http://wien.tomnetworks.com/gitweb/?a=blobdiff_plain;f=man%2Fmono-config.5;h=a8e31f3ed3356515a970d082eb42bb5537a13e2f;hb=897ecfd59c21eed6d0a7929721ea88442316f1fa;hp=44fc04b619d92c61b63c06ff2e6d372f6f3fd825;hpb=ef475921e85694e66bc7d9bf4cdc78a132b81162;p=mono.git
diff --git a/man/mono-config.5 b/man/mono-config.5
index 44fc04b619d..a8e31f3ed33 100644
--- a/man/mono-config.5
+++ b/man/mono-config.5
@@ -5,7 +5,7 @@
.\" Miguel de Icaza (miguel@gnu.org)
.\" Paolo Molaro (lupus@ximian.com)
.\"
-.TH Mono "Mono 1.0"
+.TH Mono "mono-config"
.SH NAME
mono-config \- Mono runtime file format configuration
.SH DESCRIPTION
@@ -38,7 +38,9 @@ The
element takes two attributes:
.TP
.I dll
-This should be the same string used in the DllImport attribute
+This should be the same string used in the DllImport attribute, optionally
+prefixed with "i:" to indicate that the string must be matched in a
+case-insensitive way
.TP
.I target
This should be the name of the library where the function can be found:
@@ -58,20 +60,58 @@ element takes 3 attributes:
This is the target library, where the function can be found.
.TP
.I name
-This is the name of the fuction as it appears in the metadata: it is the name
+This is the name of the function as it appears in the metadata: it is the name
of the P/Invoke method.
.TP
.I target
This is the name of the function to lookup instead of the name specified in the
P/Invoke method.
+.SH Mapping based on operating system and cpu
+Both the
+.B dllmap
+and the
+.B dllentry
+elements allow the following two attributes which make it easy to use a single
+configuration file and support multiple operating systems and architectures with
+different mapping requirements:
+.TP
+.I os
+This is the name of the operating system for which the mapping should be applied.
+Allowed values are: linux, osx, solaris, freebsd, openbsd, netbsd, windows, aix, hpux.
+.TP
+.I cpu
+This is the name of the architecture for which the mapping should be applied.
+Allowed values are: x86, x86-64, sparc, ppc, s390, s390x, arm, mips,
+alpha, hppa, ia64.
+.TP
+.I wordsize
+This is the size of registers on the target architecture, it can be
+either 32 or 64.
+.PP
+The attribute value for both attributes can be a comma-separated list of the allowed
+values. Additionally, the first character may be a
+.I '!'
+to reverse the meaning. An attribute value of "!windows,osx", for example, would mean
+that the entry is considered on all operating systems, except on Windows and OS X.
+No spaces are allowed in any part of the value.
+.PP
+Note that later entries will override the entries defined earlier in the file.
.SH EXAMPLES
The following example maps references to the `cygwin1.dll' shared
library to the `libc.so.6' file.
.nf
-
+
.fi
+The library name in the DllImport attribute is allowed to be in any
+case variant, like the following examples:
+.nf
+.nf
+ [DllImport ("cygwin1.dll")]
+ [DllImport ("Cygwin1.dll")]
+ [DllImport ("cygwiN1.Dll")]
+.fi
.PP
This one maps the following C# method:
.nf
@@ -81,11 +121,15 @@ This one maps the following C# method:
to
.B differentfunction
in
-.B libdifferent.so.
+.B libdifferent.so
+, but to the same function in the library
+.B libanother.so
+when running under the Solaris and FreeBSD operating systems.
.nf
+
.fi