NAME

       mono-config - Mono runtime file format configuration

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.

       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.

       This file controls the behavior of the runtime.

       The file contains an XML-like file with various sections, all of them contained  inside  a
       section (It actually uses GMarkup to parse the file).

       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.

<dllmap> directive

       You use the dllmap directive to map  shared  libraries  referenced  by  P/Invoke  in  your
       assemblies to a different shared library.

       This is typically used to map Windows libraries to Unix library names.  The dllmap element
       takes two attributes:

       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

       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.

<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 dllmap element with only the dll
       attribute specified.

       The dllentry element takes 3 attributes:

       dll    This is the target library, where the function can be found.

       name   This  is  the name of the function as it appears in the metadata: it is the name of
              the P/Invoke method.

       target This is the name of the function to lookup instead of the  name  specified  in  the
              P/Invoke method.

Mapping based on operating system and cpu

       Both the dllmap and the 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:

       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.

       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.

       wordsize
              This  is  the  size of registers on the target architecture, it can be either 32 or
              64.

       The attribute value for both attributes can be  a  comma-separated  list  of  the  allowed
       values.  Additionally,  the  first  character  may  be  a  '!'  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.

       Note that later entries will override the entries defined earlier in the file.

EXAMPLES

       The following  example  maps  references  to  the  `cygwin1.dll'  shared  library  to  the
       `libc.so.6' file.
       <configuration>
            <dllmap dll="i:cygwin1.dll" target="libc.so.6"/>
       </configuration>
       The library name in the DllImport attribute is allowed to be in any case variant, like the
       following examples:
            [DllImport ("cygwin1.dll")]
            [DllImport ("Cygwin1.dll")]
            [DllImport ("cygwiN1.Dll")]

       This one maps the following C# method:
            [DllImport ("libc")]
            static extern void somefunction ();
       to differentfunction in libdifferent.so  ,  but  to  the  same  function  in  the  library
       libanother.so when running under the Solaris and FreeBSD operating systems.
       <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>

SEE ALSO

       mono(1),monodis(1),mint(1)

                                                                                   Mono(Mono 1.0)