Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
Mono(mono-config)					     Mono(mono-config)

       mono-config - Mono runtime file format configuration

       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/as-
       sembly.exe.config is loaded as well  as	the  ~/.mono/assemblies/ASSEM-
       BLY/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

       This  page  describes the Unix-specific and Mono-specific extensions to
       the   configuration   file;     For   complete	details,    see	   the 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  at-
       tributes	which make it easy to use a single configuration file and sup-
       port multiple operating systems and architectures with  different  map-
       ping 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.

	      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 exam-
       ple,  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

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

       The following example maps references to	the `cygwin1.dll'  shared  li-
       brary to	the `'	file.
	    <dllmap dll="i:cygwin1.dll"	target=""/>
       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 , but to	the same  function  in
       the  library  when running under the Solaris and FreeBSD
       operating systems.
	    <dllmap dll="libc">
		 <dllentry dll="" name="somefunction" target="differentfunction"	/>
		 <dllentry os="solaris,freebsd"	dll="" name="somefunction"	target="differentfunction" />



NAME | DESCRIPTION | Mapping based on operating system and cpu | EXAMPLES | SEE ALSO

Want to link to this manual page? Use this URL:

home | help