Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: d0baa99bcb
Fetching contributors…

Cannot retrieve contributors at this time

file 138 lines (137 sloc) 4.457 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138
.\"
.\" mono-config configuration page.
.\" (C) Ximian, Inc.
.\" Author:
.\" Miguel de Icaza (miguel@gnu.org)
.\" Paolo Molaro (lupus@ximian.com)
.\"
.TH Mono "Mono 1.0"
.SH NAME
mono-config \- Mono runtime file format configuration
.SH DESCRIPTION
The Mono runtime will load configuration data from the
installation prefix /etc/mono/config file, the ~/.mono/config or from
the file pointed by the MONO_CONFIG environment variable.
.PP
For each assembly loaded a config file with the name:
/path/to/the/assembly.exe.config is loaded as well as the
~/.mono/assemblies/ASSEMBLY/ASSEMBLY.EXT.config file.
.PP
This file controls the behavior of the runtime.
.PP
The file contains an XML-like file with various sections, all of them
contained inside a
.B<configuration>
section (It actually uses GMarkup
to parse the file).
.PP
This page describes the Unix-specific and Mono-specific extensions to
the configuration file; For complete details, see the
http://www.mono-project.com/Config web page.
.SH <dllmap> directive
You use the dllmap directive to map shared libraries referenced by
P/Invoke in your assemblies to a different shared library.
.PP
This is typically used to map Windows libraries to Unix library names.
The
.B dllmap
element takes two attributes:
.TP
.I dll
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:
this name should be suitable for use with the platform native shared library
loading routines (dlopen etc.), so you may want to check the manpages for that, too.
.SH <dllentry> directive
This directive can be used to map a specific dll/function pair to a different
library and also a different function name. It should appear inside a
.B dllmap
element with only the dll attribute specified.
.PP
The
.B dllentry
element takes 3 attributes:
.TP
.I dll
This is the target library, where the function can be found.
.TP
.I 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
<configuration>
<dllmap dll="i:cygwin1.dll" target="libc.so.6"/>
</configuration>
.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
[DllImport ("libc")]
static extern void somefunction ();
.fi
to
.B differentfunction
in
.B libdifferent.so
, but to the same function in the library
.B libanother.so
when running under the Solaris and FreeBSD operating systems.
.nf
<configuration>
<dllmap dll="libc">
<dllentry dll="libdifferent.so" name="somefunction" target="differentfunction" />
<dllentry os="solaris,freebsd" dll="libanother.so" name="somefunction" target="differentfunction" />
</dllmap>
</configuration>
.fi

.SH SEE ALSO
.BR mono(1), monodis(1), mint(1)
Something went wrong with that request. Please try again.