mono/linux-packaging-mono
0
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Imported Upstream version 5.2.0.175

Browse Source 
Former-commit-id: bb0468d0f257ff100aa895eb5fe583fb5dfbf900
This commit is contained in:
Xamarin Public Jenkins (auto-signing)
2017-06-07 13:16:24 +00:00
parent 4bdbaf4a88
commit 966bba02bb
8776 changed files with 346420 additions and 149650 deletions
Download Patch File Download Diff File Expand all files Collapse all files

340
docs/deploy/mono-api-assembly.html
View File

File diff suppressed because it is too large Load Diff

491
docs/deploy/mono-api-class.html
View File

File diff suppressed because it is too large Load Diff

15
docs/deploy/mono-api-counters.html
View File

@@ -243,11 +243,8 @@ mono_counters_dump (int section_mask, FILE *outfile)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>section_mask</i><td> The sections to dump counters for</td></td></tr><tr><td><i>outfile</i><td> a FILE to dump the results to</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Displays the counts of all the enabled counters registered.
To filter by variance, you can OR one or more variance with the specific section you want.
Use MONO_COUNTER_SECTION_MASK to dump all categories of a specific variance.</div>
<table class="mapi-parameters"><tbody><tr><td><i>section_mask</i></td><td> The sections to dump counters for</td></tr><tr><td><i>outfile</i></td><td> a FILE to dump the results to</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> Displays the counts of all the enabled counters registered. To filter by variance, you can OR one or more variance with the specific section you want. Use <code>MONO_COUNTER_SECTION_MASK</code> to dump all categories of a specific variance.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -267,11 +264,7 @@ mono_counters_enable (int section_mask)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>section_mask</i><td> a mask listing the sections that will be displayed</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
This is used to track which counters will be displayed.</div>
<table class="mapi-parameters"><tbody><tr><td><i>sectionmask</i></td><td> a mask listing the sections that will be displayed</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> This is used to track which counters will be displayed.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div>
</div></body>
</html>

100
docs/deploy/mono-api-debug.html
View File

@@ -234,7 +234,11 @@
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_debug_open_mono_symbols</div>
<div class="mapi-prototype">MonoSymbolFile*
mono_debug_open_mono_symbols (MonoDebugHandle *handle, const uint8_t *raw_contents,
int size, gboolean in_the_debugger)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -249,8 +253,13 @@
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_debug_symfile_free_location</div>
<div class="mapi-prototype">void
mono_debug_symfile_free_location (MonoDebugSourceLocation *location)
</div>
<p />
<div class="mapi-section">Description</div>
<div> <p /> Free a <code>MonoDebugSourceLocation</code> returned by <code>mono_debug_symfile_lookup_location</code></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -264,7 +273,10 @@
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_debug_symfile_is_loaded</div>
<div class="mapi-prototype">mono_bool
mono_debug_symfile_is_loaded (MonoSymbolFile *symfile)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -279,8 +291,13 @@
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_debug_symfile_lookup_locals</div>
<div class="mapi-prototype">MonoDebugLocalsInfo*
mono_debug_symfile_lookup_locals (MonoDebugMethodInfo *minfo)
</div>
<p />
<div class="mapi-section">Description</div>
<div> <p /> Return information about the local variables of <i>minfo</i> from the symbol file. Return <code>NULL</code> if no information can be found. The result should be freed using <code>mono_debug_symfile_free_locals</code>.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -300,13 +317,8 @@ mono_debug_symfile_lookup_location (MonoDebugMethodInfo *minfo, uint32_t offset)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>minfo</i><td> A `MonoDebugMethodInfo' which can be retrieved by</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> mono_debug_lookup_method().
<i>offset</i>: IL offset within the corresponding method's CIL code.
<p />
This function is similar to mono_debug_lookup_location(), but we
already looked up the method and also already did the
`native address -&gt; IL offset' mapping.</div>
<table class="mapi-parameters"><tbody><tr><td><i>minfo</i></td><td> A <code>MonoDebugMethodInfo</code> which can be retrieved by <code>mono_debug_lookup_method</code>.</td></tr><tr><td><i>offset</i></td><td> IL offset within the corresponding method's CIL code.</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> This function is similar to <code>mono_debug_lookup_location</code>, but we already looked up the method and also already did the native address -&gt; IL offset mapping.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -320,7 +332,10 @@ mono_debug_symfile_lookup_location (MonoDebugMethodInfo *minfo, uint32_t offset)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_debug_symfile_lookup_method</div>
<div class="mapi-prototype">MonoDebugMethodInfo*
mono_debug_symfile_lookup_method (MonoDebugHandle *handle, MonoMethod *method)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -338,7 +353,10 @@ mono_debug_symfile_lookup_location (MonoDebugMethodInfo *minfo, uint32_t offset)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_debug_add_delegate_trampoline</div>
<div class="mapi-prototype">void
mono_debug_add_delegate_trampoline (gpointer code, int size)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -353,7 +371,10 @@ mono_debug_symfile_lookup_location (MonoDebugMethodInfo *minfo, uint32_t offset)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_debug_close_image</div>
<div class="mapi-prototype">void
mono_debug_close_image (MonoImage *image)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -368,7 +389,10 @@ mono_debug_symfile_lookup_location (MonoDebugMethodInfo *minfo, uint32_t offset)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_debug_domain_create</div>
<div class="mapi-prototype">void
mono_debug_domain_create (MonoDomain *domain)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -404,8 +428,7 @@ mono_debug_enabled (void)
</div>
<p />
<div class="mapi-section">Description</div>
<div> <p />
Returns true is debug information is enabled. This doesn't relate if a debugger is present or not.</div>
<div> <p /> Returns true is debug information is enabled. This doesn't relate if a debugger is present or not.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -440,9 +463,8 @@ mono_debug_free_source_location (MonoDebugSourceLocation *location)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>location</i><td> A `MonoDebugSourceLocation'.</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Frees the <i>location</i>.</div>
<table class="mapi-parameters"><tbody><tr><td><i>location</i></td><td> A <code>MonoDebugSourceLocation</code></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> Frees the <i>location</i>.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -477,10 +499,7 @@ mono_debug_lookup_method (MonoMethod *method)
</div>
<p />
<div class="mapi-section">Description</div>
<div> <p />
Lookup symbol file information for the method <i>method</i>. The returned
`MonoDebugMethodInfo' is a private structure, but it can be passed to
mono_debug_symfile_lookup_location().</div>
<div> <p /> Lookup symbol file information for the method <i>method</i>. The returned <code>MonoDebugMethodInfo</code> is a private structure, but it can be passed to <code>mono_debug_symfile_lookup_location</code>.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -515,14 +534,8 @@ mono_debug_lookup_source_location (MonoMethod *method, guint32 address, MonoDoma
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>address</i><td> Native offset within the <i>method</i>'s machine code.</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Lookup the source code corresponding to the machine instruction located at
native offset <i>address</i> within <i>method</i>.
<p />
The returned `MonoDebugSourceLocation' contains both file / line number
information and the corresponding IL offset. It must be freed by
mono_debug_free_source_location().</div>
<table class="mapi-parameters"><tbody><tr><td><i>address</i></td><td> Native offset within the <i>method</i>'s machine code.</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> Lookup the source code corresponding to the machine instruction located at native offset <i>address</i> within <i>method</i>. The returned <code>MonoDebugSourceLocation</code> contains both file / line number information and the corresponding IL offset. It must be freed by <code>mono_debug_free_source_location</code>.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -557,10 +570,8 @@ mono_debug_print_stack_frame (MonoMethod *method, guint32 native_offset, MonoDom
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>native_offset</i><td> Native offset within the <i>method</i>'s machine code.</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Conventient wrapper around mono_debug_lookup_source_location() which can be
used if you only want to use the location to print a stack frame.</div>
<table class="mapi-parameters"><tbody><tr><td><i>native_offset</i></td><td> Native offset within the <i>method</i>'s machine code.</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> Conventient wrapper around <code>mono_debug_lookup_source_location</code> which can be used if you only want to use the location to print a stack frame.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -595,9 +606,7 @@ mono_debug_il_offset_from_address (MonoMethod *method, MonoDomain *domain, guint
</div>
<p />
<div class="mapi-section">Description</div>
<div> <p />
Compute the IL offset corresponding to NATIVE_OFFSET inside the native
code of METHOD in DOMAIN.</div>
<div> <p /> Compute the IL offset corresponding to <i>native_offset</i> inside the native code of <i>method</i> in <i>domain</i>.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -611,7 +620,10 @@ mono_debug_il_offset_from_address (MonoMethod *method, MonoDomain *domain, guint
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_debug_add_method</div>
<div class="mapi-prototype">MonoDebugMethodAddress*
mono_debug_add_method (MonoMethod *method, MonoDebugMethodJitInfo *jit, MonoDomain *domain)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -626,10 +638,10 @@ mono_debug_il_offset_from_address (MonoMethod *method, MonoDomain *domain, guint
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_debug_close_mono_symbol_file</div>
<div class="mapi-prototype">void
mono_debug_close_mono_symbol_file (MonoSymbolFile *symfile)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
</div>
</div></body>
</html>

231
docs/deploy/mono-api-domains.html
View File

@@ -202,43 +202,6 @@ typedef struct _MonoDomain MonoDomain;
/* Represents System.Runtime.Remoting.Contexts.Context */
typedef struct _MonoAppContext MonoAppContext
MonoAssembly* <a href="#api:mono_domain_assembly_open">mono_domain_assembly_open</a> (MonoDomain *domain,
const char *name);
MonoDomain* <a href="#api:mono_domain_create">mono_domain_create</a> (void);
MonoDomain* <a href="#api:mono_domain_create_appdomain">mono_domain_create_appdomain</a> (char *friendly_name,
char *configuration_file);
gboolean <a href="#api:mono_domain_finalize">mono_domain_finalize</a> (MonoDomain *domain,
guint32 timeout) ;
void <a href="#api:mono_domain_foreach">mono_domain_foreach</a> (MonoDomainFunc func,
gpointer user_data);
void <a href="#api:mono_domain_free">mono_domain_free</a> (MonoDomain *domain,
gboolean force);
<a href="#api:mono_domain_from_appdomain">mono_domain_from_appdomain</a>
MonoDomain* <a href="#api:mono_domain_get_by_id">mono_domain_get_by_id</a> (gint32 domainid) ;
<a href="#api:mono_domain_get_friendly_name">mono_domain_get_friendly_name</a>
<a href="#api:mono_domain_get_id">mono_domain_get_id</a>
MonoDomain* <a href="#api:mono_domain_get">mono_domain_get</a> ();
gboolean <a href="#api:mono_domain_has_type_resolve">mono_domain_has_type_resolve</a> (MonoDomain *domain);
<a href="#api:mono_domain_is_unloading">mono_domain_is_unloading</a>
gboolean <a href="#api:mono_domain_owns_vtable_slot">mono_domain_owns_vtable_slot</a> (MonoDomain *domain,
gpointer vtable_slot);
void <a href="#api:mono_domain_set_config">mono_domain_set_config</a> (MonoDomain *domain,
const char *base_dir,
const char *config_file_name);
void <a href="#api:mono_domain_set_internal">mono_domain_set_internal</a> (MonoDomain *domain);
gboolean <a href="#api:mono_domain_set">mono_domain_set</a> (MonoDomain *domain,
gboolean force);
MonoReflectionAssembly* <a href="#api:mono_domain_try_type_resolve">mono_domain_try_type_resolve</a> (MonoDomain *domain,
char *name,
MonoObject *tb);
<a href="#api:mono_domain_try_unload">mono_domain_try_unload</a>
<a href="#api:mono_domain_unload">mono_domain_unload</a>
void <a href="#api:mono_context_init">mono_context_init</a> (MonoDomain *domain);
MonoAppContext* <a href="#api:mono_context_get">mono_context_get</a> (void);
gint32 <a href="#api:mono_context_get_domain_id">mono_context_get_domain_id</a> (MonoAppContext *context);
gint32 <a href="#api:mono_context_get_id">mono_context_get_id</a> (MonoAppContext *context);
<a href="#api:mono_context_set">mono_context_set</a>
<a href="#api:mono_context_get_desc">mono_context_get_desc</a>
</div>
@@ -271,10 +234,7 @@ mono_domain_assembly_open (MonoDomain *domain, const char *name)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i><td> the application domain</td></td></tr><tr><td><i>name</i><td> file name of the assembly</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
fixme: maybe we should integrate this with mono_assembly_open ??</div>
</div><!--mapi-description -->
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> the application domain</td></tr><tr><td><i>name</i></td><td> file name of the assembly</td></tr></tbody></table> </div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -293,26 +253,11 @@ mono_domain_create (void)
</div>
<p />
<div class="mapi-section">Return value</div>
<div> New initialized MonoDomain, with no configuration or assemblies
<div> New initialized <code>MonoDomain</code>, with no configuration or assemblies
loaded into it.</div>
<div class="mapi-section">Description</div>
<div> <p />
Creates a new application domain, the unmanaged representation
of the actual domain. Usually you will want to create the
<p />
Application domains provide an isolation facilty for assemblies. You
can load assemblies and execute code in them that will not be visible
to other application domains. This is a runtime-based virtualization
technology.
<p />
It is possible to unload domains, which unloads the assemblies and
data that was allocated in that domain.
<p />
When a domain is created a mempool is allocated for domain-specific
structures, along a dedicated code manager to hold code that is
associated with the domain.
<p /></div>
<div> <p /> Creates a new application domain, the unmanaged representation of the actual domain. <p /> Application domains provide an isolation facilty for assemblies. You can load assemblies and execute code in them that will not be visible to other application domains. This is a runtime-based virtualization technology. <p /> It is possible to unload domains, which unloads the assemblies and data that was allocated in that domain. <p /> When a domain is created a mempool is allocated for domain-specific structures, along a dedicated code manager to hold code that is associated with the domain. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -332,9 +277,9 @@ mono_domain_create_appdomain (char *friendly_name, char *configuration_file)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>friendly_name</i><td> The friendly name of the appdomain to create</td></td></tr><tr><td><i>configuration_file</i><td> The configuration file to initialize the appdomain with</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Returns a MonoDomain initialized with the appdomain</div>
<table class="mapi-parameters"><tbody><tr><td><i>friendly_name</i></td><td> The friendly name of the appdomain to create</td></tr><tr><td><i>configuration_file</i></td><td> The configuration file to initialize the appdomain with</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> a <code>MonoDomain</code> initialized with the appdomain
</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -348,21 +293,17 @@ mono_domain_create_appdomain (char *friendly_name, char *configuration_file)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">
gboolean
<div class="mapi-prototype">gboolean
mono_domain_finalize (MonoDomain *domain, guint32 timeout)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i><td> the domain to finalize</td></td></tr><tr><td><i>timeout</i><td> msects to wait for the finalization to complete, -1 to wait indefinitely</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> <code>TRUE</code> if succeeded, <code>FALSE</code> if there was a timeout
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> the domain to finalize</td></tr><tr><td><i>timeout</i></td><td> msecs to wait for the finalization to complete, <code>-1</code> to wait indefinitely</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> <code>TRUE</code> if succeeded, <code>FALSE</code> if there was a timeout
</div>
<div class="mapi-section">Description</div>
<div> <p />
Request finalization of all finalizable objects inside <i>domain</i>. Wait
<i>timeout</i> msecs for the finalization to complete.
<p /></div>
<div> <p /> Request finalization of all finalizable objects inside <i>domain</i>. Wait <i>timeout</i> msecs for the finalization to complete. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -382,12 +323,8 @@ mono_domain_foreach (MonoDomainFunc func, gpointer user_data)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>func</i><td> function to invoke with the domain data</td></td></tr><tr><td><i>user_data</i><td> user-defined pointer that is passed to the supplied <i>func</i> fo reach domain</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Use this method to safely iterate over all the loaded application
domains in the current runtime. The provided <i>func</i> is invoked with a
pointer to the MonoDomain and is given the value of the <i>user_data</i>
parameter which can be used to pass state to your called routine.</div>
<table class="mapi-parameters"><tbody><tr><td><i>func</i></td><td> function to invoke with the domain data</td></tr><tr><td><i>user_data</i></td><td> user-defined pointer that is passed to the supplied <i>func</i> fo reach domain</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> Use this method to safely iterate over all the loaded application domains in the current runtime. The provided <i>func</i> is invoked with a pointer to the <code>MonoDomain</code> and is given the value of the <i>user_data</i> parameter which can be used to pass state to your called routine.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -407,11 +344,8 @@ mono_domain_free (MonoDomain *domain, gboolean force)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i><td> the domain to release</td></td></tr><tr><td><i>force</i><td> if true, it allows the root domain to be released (used at shutdown only).</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
This releases the resources associated with the specific domain.
This is a low-level function that is invoked by the AppDomain infrastructure
when necessary.</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> the domain to release</td></tr><tr><td><i>force</i></td><td> if <code>TRUE</code>, it allows the root domain to be released (used at shutdown only).</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> This releases the resources associated with the specific domain. This is a low-level function that is invoked by the AppDomain infrastructure when necessary.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -425,7 +359,10 @@ mono_domain_free (MonoDomain *domain, gboolean force)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_domain_from_appdomain</div>
<div class="mapi-prototype">MonoDomain*
mono_domain_from_appdomain (MonoAppDomain *appdomain_raw)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -446,11 +383,9 @@ mono_domain_get_by_id (gint32 domainid)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domainid</i><td> the ID</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the domain for a specific domain id.
<table class="mapi-parameters"><tbody><tr><td><i>domainid</i></td><td> the ID</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the domain for a specific domain id.
</div>
<div class="mapi-section">Description</div>
<div> <p /> </div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -464,8 +399,16 @@ mono_domain_get_by_id (gint32 domainid)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_domain_get_friendly_name</div>
<div class="mapi-prototype">const char *
mono_domain_get_friendly_name (MonoDomain *domain)
</div>
<p />
<div class="mapi-section">Return value</div>
<div> The friendly name of <i>domain</i>. Can be <code>NULL</code> if not yet set.
</div>
<div class="mapi-section">Description</div>
<div> <p /> The returned string's lifetime is the same as <i>domain</i>'s. Consider copying it if you need to store it somewhere. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -479,8 +422,16 @@ mono_domain_get_by_id (gint32 domainid)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_domain_get_id</div>
<div class="mapi-prototype">gint32
mono_domain_get_id (MonoDomain *domain)
</div>
<p />
<div class="mapi-section">Return value</div>
<div> The unique ID for <i>domain</i>.
</div>
<div class="mapi-section">Description</div>
<div> <p /> A domain ID is guaranteed to be unique for as long as the domain using it is alive. It may be reused later once the domain has been unloaded. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -500,14 +451,10 @@ mono_domain_get ()
</div>
<p />
<div class="mapi-section">Return value</div>
<div> the current domain
<div> the current domain
</div>
<div class="mapi-section">Description</div>
<div> <p />
This method returns the value of the current MonoDomain that this thread
and code are running under. To obtain the root domain use
mono_get_root_domain() API.
<p /></div>
<div> <p /> This method returns the value of the current <code>MonoDomain</code> that this thread and code are running under. To obtain the root domain use <code>mono_get_root_domain</code> API. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -527,12 +474,11 @@ mono_domain_has_type_resolve (MonoDomain *domain)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i><td> application domains being looked up</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> <code>TRUE</code> if the AppDomain.TypeResolve field has been
set.</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> application domain being looked up</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> <code>TRUE</code> if the <code>AppDomain.TypeResolve</code> field has been set.
</div>
<div class="mapi-section">Description</div>
<div> <p /> </div>
<div> <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -546,7 +492,10 @@ mono_domain_has_type_resolve (MonoDomain *domain)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_domain_is_unloading</div>
<div class="mapi-prototype">gboolean
mono_domain_is_unloading (MonoDomain *domain)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -566,9 +515,9 @@ mono_domain_owns_vtable_slot (MonoDomain *domain, gpointer vtable_slot)
</div>
<p />
<div class="mapi-section">Description</div>
<div> <p />
Returns whenever VTABLE_SLOT is inside a vtable which belongs to DOMAIN.</div>
<div class="mapi-section">Return value</div>
<div> Whether <i>vtable_slot</i> is inside a vtable which belongs to <i>domain</i>.
</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -588,13 +537,8 @@ mono_domain_set_config (MonoDomain *domain, const char *base_dir, const char *co
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i><td> MonoDomain initialized with the appdomain we want to change</td></td></tr><tr><td><i>base_dir</i><td> new base directory for the appdomain</td></td></tr><tr><td><i>config_file_name</i><td> path to the new configuration for the app domain</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Used to set the system configuration for an appdomain
<p />
Without using this, embedded builds will get 'System.Configuration.ConfigurationErrorsException:
Error Initializing the configuration system. ---&gt; System.ArgumentException:
The 'ExeConfigFilename' argument cannot be null.' for some managed calls.</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> <code>MonoDomain</code> initialized with the appdomain we want to change</td></tr><tr><td><i>base_dir</i></td><td> new base directory for the appdomain</td></tr><tr><td><i>config_file_name</i></td><td> path to the new configuration for the app domain</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> Used to set the system configuration for an appdomain <p /> Without using this, embedded builds will get 'System.Configuration.ConfigurationErrorsException: Error Initializing the configuration system. ---&gt; System.ArgumentException: The 'ExeConfigFilename' argument cannot be null.' for some managed calls.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -614,9 +558,8 @@ mono_domain_set_internal (MonoDomain *domain)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i><td> the new domain</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Sets the current domain to <i>domain</i>.</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> the new domain</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> Sets the current domain to <i>domain</i>.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -636,16 +579,11 @@ mono_domain_set (MonoDomain *domain, gboolean force)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i><td> domain</td></td></tr><tr><td><i>force</i><td> force setting.</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div>
<code>TRUE</code> on success;
<code>FALSE</code> if the domain is unloaded</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> domain</td></tr><tr><td><i>force</i></td><td> force setting.</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> <code>TRUE</code> on success; <code>FALSE</code> if the domain is unloaded
</div>
<div class="mapi-section">Description</div>
<div> <p />
Set the current appdomain to <i>domain</i>. If <i>force</i> is set, set it even
if it is being unloaded.
<p /></div>
<div> <p /> Set the current appdomain to <i>domain</i>. If <i>force</i> is set, set it even if it is being unloaded. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -665,16 +603,11 @@ mono_domain_try_type_resolve (MonoDomain *domain, char *name, MonoObject *tb)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i><td> application domainwhere the name where the type is going to be resolved</td></td></tr><tr><td><i>name</i><td> the name of the type to resolve or <code>NULL</code>.</td></td></tr><tr><td><i>tb</i><td> A System.Reflection.Emit.TypeBuilder, used if name is <code>NULL</code>.</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> A MonoReflectionAssembly or <code>NULL</code> if not found
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> application domainwhere the name where the type is going to be resolved</td></tr><tr><td><i>name</i></td><td> the name of the type to resolve or <code>NULL</code>.</td></tr><tr><td><i>tb</i></td><td> A <code>System.Reflection.Emit.TypeBuilder</code>, used if name is <code>NULL</code>.</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> A <code>MonoReflectionAssembly</code> or <code>NULL</code> if not found
</div>
<div class="mapi-section">Description</div>
<div> <p />
This routine invokes the internal System.AppDomain.DoTypeResolve and returns
the assembly that matches name.
<p />
If <i>name</i> is null, the value of ((TypeBuilder)tb).FullName is used instead
<p /></div>
<div> <p /> This routine invokes the internal <code>System.AppDomain.DoTypeResolve</code> and returns the assembly that matches name. <p /> If <i>name</i> is null, the value of <code>((TypeBuilder)tb).FullName</code> is used instead <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -703,8 +636,14 @@ mono_domain_try_type_resolve (MonoDomain *domain, char *name, MonoObject *tb)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_domain_unload</div>
<div class="mapi-prototype">void
mono_domain_try_unload (MonoDomain *domain, MonoObject **exc)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> The domain to unload</td></tr><tr><td><i>exc</i></td><td> Exception information</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> Unloads an appdomain. Follows the process outlined in: http://blogs.gotdotnet.com/cbrumme <p /> If doing things the 'right' way is too hard or complex, we do it the 'simple' way, which means do everything needed to avoid crashes and memory leaks, but not much else. <p /> It is required to pass a valid reference to the exc argument, upon return from this function *exc will be set to the exception thrown, if any. <p /> If this method is not called from an icall (embedded scenario for instance), it must not be called with any managed frames on the stack, since the unload process could end up trying to abort the current thread.</div>
</div><!--mapi-description -->
</div><!--height container -->
@@ -727,9 +666,8 @@ mono_context_init (MonoDomain *domain)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i><td> The domain where the System.Runtime.Remoting.Context.Context is initialized</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Initializes the <i>domain</i>'s default System.Runtime.Remoting's Context.</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> The domain where the <code>System.Runtime.Remoting.Context.Context</code> is initialized</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> Initializes the <i>domain</i>'s default <code>System.Runtime.Remoting</code> 's Context.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -749,10 +687,10 @@ mono_context_get (void)
</div>
<p />
<div class="mapi-section">Return value</div>
<div> the current Mono Application Context.
<div> the current Mono Application Context.
</div>
<div class="mapi-section">Description</div>
<div> <p /> </div>
<div> <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -772,11 +710,9 @@ mono_context_get_domain_id (MonoAppContext *context)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>context</i><td> the context to operate on.</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> The ID of the domain that <i>context</i> was created in.
<table class="mapi-parameters"><tbody><tr><td><i>context</i></td><td> the context to operate on.</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> The ID of the domain that <i>context</i> was created in.
</div>
<div class="mapi-section">Description</div>
<div> <p /> </div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -796,14 +732,11 @@ mono_context_get_id (MonoAppContext *context)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>context</i><td> the context to operate on.</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> The unique ID for <i>context</i>.
<table class="mapi-parameters"><tbody><tr><td><i>context</i></td><td> the context to operate on.</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> The unique ID for <i>context</i>.
</div>
<div class="mapi-section">Description</div>
<div> <p />
Context IDs are guaranteed to be unique for the duration of a Mono
process; they are never reused.
<p /></div>
<div> <p /> Context IDs are guaranteed to be unique for the duration of a Mono process; they are never reused. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -817,10 +750,10 @@ mono_context_get_id (MonoAppContext *context)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_context_set</div>
<div class="mapi-prototype">void
mono_context_set (MonoAppContext * new_context)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
</div>
</div></body>
</html>

143
docs/deploy/mono-api-dynamic-codegen.html
View File

@@ -276,7 +276,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_new</div>
<div class="mapi-prototype">MonoMethodBuilder*
mono_mb_new (MonoClass *klass, const char *name, MonoWrapperType type)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -326,7 +329,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_add_to_local</div>
<div class="mapi-prototype">void
mono_mb_emit_add_to_local (MonoMethodBuilder *mb, guint16 local, gint32 incr)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -341,7 +347,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_branch</div>
<div class="mapi-prototype">guint32
mono_mb_emit_branch (MonoMethodBuilder *mb, guint8 op)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -356,7 +365,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_byte</div>
<div class="mapi-prototype">void
mono_mb_emit_byte (MonoMethodBuilder *mb, guint8 op)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -371,7 +383,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_exception</div>
<div class="mapi-prototype">void
mono_mb_emit_exception (MonoMethodBuilder *mb, const char *exc_name, const char *msg)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -386,7 +401,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_i2</div>
<div class="mapi-prototype">void
mono_mb_emit_i2 (MonoMethodBuilder *mb, gint16 data)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -401,7 +419,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_i4</div>
<div class="mapi-prototype">void
mono_mb_emit_i4 (MonoMethodBuilder *mb, gint32 data)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -416,7 +437,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_icon</div>
<div class="mapi-prototype">void
mono_mb_emit_icon (MonoMethodBuilder *mb, gint32 value)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -431,7 +455,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_ldarg_addr</div>
<div class="mapi-prototype">void
mono_mb_emit_ldarg_addr (MonoMethodBuilder *mb, guint argnum)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -446,7 +473,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_ldarg</div>
<div class="mapi-prototype">void
mono_mb_emit_ldarg (MonoMethodBuilder *mb, guint argnum)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -461,7 +491,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_ldflda</div>
<div class="mapi-prototype">void
mono_mb_emit_ldflda (MonoMethodBuilder *mb, gint32 offset)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -476,7 +509,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_ldloc_addr</div>
<div class="mapi-prototype">void
mono_mb_emit_ldloc_addr (MonoMethodBuilder *mb, guint locnum)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -491,7 +527,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_ldloc</div>
<div class="mapi-prototype">void
mono_mb_emit_ldloc (MonoMethodBuilder *mb, guint num)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -506,7 +545,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_ldstr</div>
<div class="mapi-prototype">void
mono_mb_emit_ldstr (MonoMethodBuilder *mb, char *str)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -521,7 +563,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_managed_call</div>
<div class="mapi-prototype">void
mono_mb_emit_managed_call (MonoMethodBuilder *mb, MonoMethod *method, MonoMethodSignature *opt_sig)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -536,7 +581,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_native_call</div>
<div class="mapi-prototype">void
mono_mb_emit_native_call (MonoMethodBuilder *mb, MonoMethodSignature *sig, gpointer func)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -551,7 +599,10 @@ MonoMethod *adder ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_emit_stloc</div>
<div class="mapi-prototype">void
mono_mb_emit_stloc (MonoMethodBuilder *mb, guint num)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -574,12 +625,10 @@ mono_mb_create_method (MonoMethodBuilder *mb, MonoMethodSignature *signature, in
</div>
<p />
<div class="mapi-section">Return value</div>
<div> the newly created method.
<p /></div>
<div> the newly created method.
</div>
<div class="mapi-section">Description</div>
<div> <p />
Create a MonoMethod from this method builder.</div>
<div> Create a <code>MonoMethod</code> from this method builder.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -593,7 +642,10 @@ mono_mb_create_method (MonoMethodBuilder *mb, MonoMethodSignature *signature, in
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_add_data</div>
<div class="mapi-prototype">guint32
mono_mb_add_data (MonoMethodBuilder *mb, gpointer data)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -608,7 +660,10 @@ mono_mb_create_method (MonoMethodBuilder *mb, MonoMethodSignature *signature, in
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_add_local</div>
<div class="mapi-prototype">int
mono_mb_add_local (MonoMethodBuilder *mb, MonoType *type)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -623,7 +678,10 @@ mono_mb_create_method (MonoMethodBuilder *mb, MonoMethodSignature *signature, in
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_free</div>
<div class="mapi-prototype">void
mono_mb_free (MonoMethodBuilder *mb)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -640,7 +698,10 @@ mono_mb_create_method (MonoMethodBuilder *mb, MonoMethodSignature *signature, in
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_patch_addr</div>
<div class="mapi-prototype">void
mono_mb_patch_addr (MonoMethodBuilder *mb, int pos, int value)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -655,7 +716,10 @@ mono_mb_create_method (MonoMethodBuilder *mb, MonoMethodSignature *signature, in
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_mb_patch_addr_s</div>
<div class="mapi-prototype">void
mono_mb_patch_addr_s (MonoMethodBuilder *mb, int pos, gint8 value)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -672,8 +736,17 @@ mono_mb_create_method (MonoMethodBuilder *mb, MonoMethodSignature *signature, in
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_metadata_signature_alloc</div>
<div class="mapi-prototype">MonoMethodSignature*
mono_metadata_signature_alloc (MonoImage *m, guint32 nparams)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>image</i></td><td> metadata context</td></tr><tr><td><i>nparams</i></td><td> number of parameters in the signature</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the new <code>MonoMethodSignature</code> structure.
</div>
<div class="mapi-section">Description</div>
<div> <p /> Allocate a <code>MonoMethodSignature</code> structure with the specified number of params. The return type and the params types need to be filled later. This is a Mono runtime internal function. <p /> LOCKING: Assumes the loader lock is held. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -687,10 +760,16 @@ mono_mb_create_method (MonoMethodBuilder *mb, MonoMethodSignature *signature, in
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_metadata_signature_dup</div>
<div class="mapi-prototype">MonoMethodSignature*
mono_metadata_signature_dup (MonoMethodSignature *sig)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>sig</i></td><td> method signature</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the new <code>MonoMethodSignature</code> structure.
</div>
<div class="mapi-section">Description</div>
<div> <p /> Duplicate an existing <code>MonoMethodSignature</code> so it can be modified. This is a Mono runtime internal function. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div>
</div></body>
</html>

248
docs/deploy/mono-api-embedding.html
View File

@@ -258,7 +258,10 @@ getMessage ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_jit_init</div>
<div class="mapi-prototype">MonoDomain*
mono_jit_init (const char *file)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -273,8 +276,13 @@ getMessage ()
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_jit_parse_options</div>
<div class="mapi-prototype">void
mono_jit_parse_options (int argc, char * argv[])
</div>
<p />
<div class="mapi-section">Description</div>
<div> <p /> Process the command line options in <i>argv</i> as done by the runtime executable. This should be called before <code>mono_jit_init</code>.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -294,9 +302,8 @@ mono_jit_exec (MonoDomain *domain, MonoAssembly *assembly, int argc, char *argv[
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>assembly</i><td> reference to an assembly</td></td></tr><tr><td><i>argc</i><td> argument count</td></td></tr><tr><td><i>argv</i><td> argument vector</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Start execution of a program.</div>
<table class="mapi-parameters"><tbody><tr><td><i>assembly</i></td><td> reference to an assembly</td></tr><tr><td><i>argc</i></td><td> argument count</td></tr><tr><td><i>argv</i></td><td> argument vector</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> Start execution of a program.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -316,27 +323,8 @@ mono_set_dirs (const char *assembly_dir, const char *config_dir)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>assembly_dir</i><td> the base directory for assemblies</td></td></tr><tr><td><i>config_dir</i><td> the base directory for configuration files</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
This routine is used internally and by developers embedding
the runtime into their own applications.
<p />
There are a number of cases to consider: Mono as a system-installed
package that is available on the location preconfigured or Mono in
a relocated location.
<p />
If you are using a system-installed Mono, you can pass <code>NULL</code>
to both parameters. If you are not, you should compute both
directory values and call this routine.
<p />
The values for a given PREFIX are:
<p />
assembly_dir: PREFIX/lib
config_dir: PREFIX/etc
<p />
Notice that embedders that use Mono in a relocated way must
compute the location at runtime, as they will be in control
of where Mono is installed.</div>
<table class="mapi-parameters"><tbody><tr><td><i>assembly_dir</i></td><td> the base directory for assemblies</td></tr><tr><td><i>config_dir</i></td><td> the base directory for configuration files</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> This routine is used internally and by developers embedding the runtime into their own applications. <p /> There are a number of cases to consider: Mono as a system-installed package that is available on the location preconfigured or Mono in a relocated location. <p /> If you are using a system-installed Mono, you can pass <code>NULL</code> to both parameters. If you are not, you should compute both directory values and call this routine. <p /> The values for a given PREFIX are: <p /> assembly_dir: PREFIX/lib config_dir: PREFIX/etc <p /> Notice that embedders that use Mono in a relocated way must compute the location at runtime, as they will be in control of where Mono is installed.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -350,7 +338,10 @@ mono_set_dirs (const char *assembly_dir, const char *config_dir)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_parse_default_optimizations</div>
<div class="mapi-prototype">int
mono_parse_default_optimizations (const char* p)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -371,10 +362,8 @@ mono_runtime_set_main_args (int argc, char* argv[])
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>argc</i><td> number of arguments from the command line</td></td></tr><tr><td><i>argv</i><td> array of strings from the command line</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Set the command line arguments from an embedding application that doesn't otherwise call
mono_runtime_run_main ().</div>
<table class="mapi-parameters"><tbody><tr><td><i>argc</i></td><td> number of arguments from the command line</td></tr><tr><td><i>argv</i></td><td> array of strings from the command line</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> Set the command line arguments from an embedding application that doesn't otherwise call <code>mono_runtime_run_main</code>.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -388,7 +377,10 @@ mono_runtime_set_main_args (int argc, char* argv[])
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_jit_cleanup</div>
<div class="mapi-prototype">void
mono_jit_cleanup (MonoDomain *domain)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -409,14 +401,11 @@ mono_jit_set_trace_options (const char* options)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>options</i><td> string representing the trace options</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> #<code>TRUE</code> if the options where parsed and set correctly, #<code>FALSE</code> otherwise.
<table class="mapi-parameters"><tbody><tr><td><i>options</i></td><td> string representing the trace options</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> <code>TRUE</code> if the options were parsed and set correctly, <code>FALSE</code> otherwise.
</div>
<div class="mapi-section">Description</div>
<div> <p />
Set the options of the tracing engine. This function can be called before initializing
the mono runtime. See the --trace mono(1) manpage for the options format.
<p /></div>
<div> Set the options of the tracing engine. This function can be called before initializing the mono runtime. See the --trace mono(1) manpage for the options format. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
@@ -455,38 +444,8 @@ mono_add_internal_call (const char *name, gconstpointer method)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>name</i><td> method specification to surface to the managed world</td></td></tr><tr><td><i>method</i><td> pointer to a C method to invoke when the method is called</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
This method surfaces the C function pointed by <i>method</i> as a method
that has been surfaced in managed code with the method specified in
<i>name</i> as an internal call.
<p />
Internal calls are surfaced to all app domains loaded and they are
accessibly by a type with the specified name.
<p />
You must provide a fully qualified type name, that is namespaces
and type name, followed by a colon and the method name, with an
optional signature to bind.
<p />
For example, the following are all valid declarations:
<p />
&quot;MyApp.Services.ScriptService:Accelerate&quot;
&quot;MyApp.Services.ScriptService:Slowdown(int,bool)&quot;
<p />
You use method parameters in cases where there might be more than
one surface method to managed code. That way you can register different
internal calls for different method overloads.
<p />
The internal calls are invoked with no marshalling. This means that .NET
types like System.String are exposed as `MonoString *` parameters. This is
different than the way that strings are surfaced in P/Invoke.
<p />
For more information on how the parameters are marshalled, see the
<a href="http://www.mono-project.com/docs/advanced/embedding/">Mono Embedding</a>
page.
<p />
See the <a href="mono-api-methods.html&lt;code&gt;method&lt;/code&gt;-desc">Method Description</a>
reference for more information on the format of method descriptions.</div>
<table class="mapi-parameters"><tbody><tr><td><i>name</i></td><td> method specification to surface to the managed world</td></tr><tr><td><i>method</i></td><td> pointer to a C method to invoke when the method is called</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> This method surfaces the C function pointed by <i>method</i> as a method that has been surfaced in managed code with the method specified in <i>name</i> as an internal call. <p /> Internal calls are surfaced to all app domains loaded and they are accessibly by a type with the specified name. <p /> You must provide a fully qualified type name, that is namespaces and type name, followed by a colon and the method name, with an optional signature to bind. <p /> For example, the following are all valid declarations: <p /> <code>MyApp.Services.ScriptService:Accelerate</code> <p /> <code>MyApp.Services.ScriptService:Slowdown(int,bool)</code> <p /> You use method parameters in cases where there might be more than one surface method to managed code. That way you can register different internal calls for different method overloads. <p /> The internal calls are invoked with no marshalling. This means that .NET types like <code>System.String</code> are exposed as <code>MonoString*</code> parameters. This is different than the way that strings are surfaced in P/Invoke. <p /> For more information on how the parameters are marshalled, see the <a href="http://www.mono-project.com/docs/advanced/embedding/">Mono Embedding</a> page. <p /> See the <a href="mono-api-methods.html&lt;code&gt;method&lt;/code&gt;-desc">Method Description</a> reference for more information on the format of method descriptions.</div>
</div><!--mapi-description -->
</div><!--height container -->
@@ -566,7 +525,10 @@ mono_add_internal_call (const char *name, gconstpointer method)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_config_cleanup</div>
<div class="mapi-prototype">void
mono_config_cleanup (void)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -581,7 +543,10 @@ mono_add_internal_call (const char *name, gconstpointer method)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_config_is_server_mode</div>
<div class="mapi-prototype">mono_bool
mono_config_is_server_mode (void)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -601,10 +566,8 @@ mono_config_parse (const char *filename)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>filename</i><td> the filename to load the configuration variables from.</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Pass a <code>NULL</code> filename to parse the default config files
(or the file in the MONO_CONFIG env var).</div>
<table class="mapi-parameters"><tbody><tr><td><i>filename</i></td><td> the filename to load the configuration variables from.</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> Pass a <code>NULL</code> filename to parse the default config files (or the file in the <code>MONO_CONFIG</code> env var).</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -624,9 +587,8 @@ mono_config_parse_memory (const char *buffer)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>buffer</i><td> a pointer to an string XML representation of the configuration</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Parses the configuration from a buffer</div>
<table class="mapi-parameters"><tbody><tr><td><i>buffer</i></td><td> a pointer to an string XML representation of the configuration</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> Parses the configuration from a buffer</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -640,7 +602,10 @@ mono_config_parse_memory (const char *buffer)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_config_set_server_mode</div>
<div class="mapi-prototype">void
mono_config_set_server_mode (mono_bool server_mode)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -655,7 +620,10 @@ mono_config_parse_memory (const char *buffer)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_config_string_for_assembly_file</div>
<div class="mapi-prototype">const char *
mono_config_string_for_assembly_file (const char *filename)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -670,7 +638,10 @@ mono_config_parse_memory (const char *buffer)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_get_config_dir</div>
<div class="mapi-prototype">const char*
mono_get_config_dir (void)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -685,7 +656,10 @@ mono_config_parse_memory (const char *buffer)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_get_machine_config</div>
<div class="mapi-prototype">const char *
mono_get_machine_config (void)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -700,7 +674,10 @@ mono_config_parse_memory (const char *buffer)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_register_machine_config</div>
<div class="mapi-prototype">void
mono_register_machine_config (const char *config_xml)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -715,8 +692,13 @@ mono_config_parse_memory (const char *buffer)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_set_config_dir</div>
<div class="mapi-prototype">void
mono_set_config_dir (const char *dir)
</div>
<p />
<div class="mapi-section">Description</div>
<div> Invoked during startup</div>
</div><!--mapi-description -->
</div><!--height container -->
@@ -745,17 +727,8 @@ mono_runtime_exec_managed_code (MonoDomain *domain,
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i><td> Application domain</td></td></tr><tr><td><i>main_func</i><td> function to invoke from the execution thread</td></td></tr><tr><td><i>main_args</i><td> parameter to the main_func</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Launch a new thread to execute a function
<p />
main_func is called back from the thread with main_args as the
parameter. The callback function is expected to start Main()
eventually. This function then waits for all managed threads to
finish.
It is not necesseray anymore to execute managed code in a subthread,
so this function should not be used anymore by default: just
execute the code and then call mono_thread_manage ().</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> Application domain</td></tr><tr><td><i>main_func</i></td><td> function to invoke from the execution thread</td></tr><tr><td><i>main_args</i></td><td> parameter to the main_func</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> Launch a new thread to execute a function <p /> <i>main_func</i> is called back from the thread with main_args as the parameter. The callback function is expected to start <code>Main</code> eventually. This function then waits for all managed threads to finish. It is not necessary anymore to execute managed code in a subthread, so this function should not be used anymore by default: just execute the code and then call mono_thread_manage().</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -790,16 +763,10 @@ mono_init (const char *domain_name)
</div>
<p />
<div class="mapi-section">Return value</div>
<div> the initial domain.
<div> the initial domain.
</div>
<div class="mapi-section">Description</div>
<div> <p />
Creates the initial application domain and initializes the mono_defaults
structure.
<p />
This function is guaranteed to not run any IL code.
The runtime is initialized using the default runtime version.
<p /></div>
<div> <p /> Creates the initial application domain and initializes the mono_defaults structure. <p /> This function is guaranteed to not run any IL code. The runtime is initialized using the default runtime version. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -819,20 +786,11 @@ mono_init_from_assembly (const char *domain_name, const char *filename)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain_name</i><td> name to give to the initial domain</td></td></tr><tr><td><i>filename</i><td> filename to load on startup</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the initial domain.
<table class="mapi-parameters"><tbody><tr><td><i>domain_name</i></td><td> name to give to the initial domain</td></tr><tr><td><i>filename</i></td><td> filename to load on startup</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the initial domain.
</div>
<div class="mapi-section">Description</div>
<div> <p />
Used by the runtime, users should use mono_jit_init instead.
<p />
Creates the initial application domain and initializes the mono_defaults
structure.
This function is guaranteed to not run any IL code.
The runtime is initialized using the runtime version required by the
provided executable. The version is determined by looking at the exe
configuration file and the version PE field)
<p /></div>
<div> <p /> Used by the runtime, users should use mono_jit_init instead. <p /> Creates the initial application domain and initializes the mono_defaults structure. This function is guaranteed to not run any IL code. The runtime is initialized using the runtime version required by the provided executable. The version is determined by looking at the exe configuration file and the version PE field) <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -852,18 +810,10 @@ mono_init_version (const char *domain_name, const char *version)
</div>
<p />
<div class="mapi-section">Return value</div>
<div> the initial domain.
<div> the initial domain.
</div>
<div class="mapi-section">Description</div>
<div> <p />
Used by the runtime, users should use mono_jit_init instead.
<p />
Creates the initial application domain and initializes the mono_defaults
structure.
<p />
This function is guaranteed to not run any IL code.
The runtime is initialized using the provided rutime version.
<p /></div>
<div> <p /> Used by the runtime, users should use <code>mono_jit_init</code> instead. <p /> Creates the initial application domain and initializes the <code>mono_defaults</code> structure. <p /> This function is guaranteed to not run any IL code. The runtime is initialized using the provided rutime version. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -883,9 +833,8 @@ mono_jit_exec (MonoDomain *domain, MonoAssembly *assembly, int argc, char *argv[
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>assembly</i><td> reference to an assembly</td></td></tr><tr><td><i>argc</i><td> argument count</td></td></tr><tr><td><i>argv</i><td> argument vector</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Start execution of a program.</div>
<table class="mapi-parameters"><tbody><tr><td><i>assembly</i></td><td> reference to an assembly</td></tr><tr><td><i>argc</i></td><td> argument count</td></tr><tr><td><i>argv</i></td><td> argument vector</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> Start execution of a program.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -899,7 +848,10 @@ mono_jit_exec (MonoDomain *domain, MonoAssembly *assembly, int argc, char *argv[
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_jit_set_aot_mode</div>
<div class="mapi-prototype">void
mono_jit_set_aot_mode (MonoAotMode mode)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -920,18 +872,8 @@ mono_set_break_policy (MonoBreakPolicyFunc policy_callback)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>policy_callback</i><td> the new callback function</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Allow embedders to decide wherther to actually obey breakpoint instructions
(both break IL instructions and Debugger.Break () method calls), for example
to not allow an app to be aborted by a perfectly valid IL opcode when executing
untrusted or semi-trusted code.
<p />
<i>policy_callback</i> will be called every time a break point instruction needs to
be inserted with the method argument being the method that calls Debugger.Break()
or has the IL break instruction. The callback should return <code>MONO_BREAK_POLICY_NEVER</code>
if it wants the breakpoint to not be effective in the given method.
<code>MONO_BREAK_POLICY_ALWAYS</code> is the default.</div>
<table class="mapi-parameters"><tbody><tr><td><i>policy_callback</i></td><td> the new callback function</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> Allow embedders to decide wherther to actually obey breakpoint instructions (both break IL instructions and <code>Debugger.Break</code> method calls), for example to not allow an app to be aborted by a perfectly valid IL opcode when executing untrusted or semi-trusted code. <p /> <i>policy_callback</i> will be called every time a break point instruction needs to be inserted with the method argument being the method that calls <code>Debugger.Break</code> or has the IL <code>break</code> instruction. The callback should return <code>MONO_BREAK_POLICY_NEVER</code> if it wants the breakpoint to not be effective in the given method. <code>MONO_BREAK_POLICY_ALWAYS</code> is the default.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -950,11 +892,11 @@ mono_get_runtime_build_info (void)
</div>
<p />
<div class="mapi-section">Return value</div>
<div> the runtime version + build date in string format.
</div>
<div class="mapi-section">Description</div>
<div> <p />
Return the runtime version + build date in string format.
The returned string is owned by the caller. The returned string
format is &quot;VERSION (FULL_VERSION BUILD_DATE)&quot; and build date is optional.</div>
<div> The returned string is owned by the caller. The returned string format is <code>VERSION (FULL_VERSION BUILD_DATE)</code> and build date is optional.</div>
</div><!--mapi-description -->
</div><!--height container -->
@@ -977,18 +919,6 @@ mono_set_signal_chaining (gboolean chain_signals)
</div>
<p />
<div class="mapi-section">Description</div>
<div> <p />
Enable/disable signal chaining. This should be called before mono_jit_init ().
If signal chaining is enabled, the runtime saves the original signal handlers before
installing its own handlers, and calls the original ones in the following cases:
- a SIGSEGV/SIGABRT signal received while executing native (i.e. not JITted) code.
- SIGPROF
- SIGFPE
- SIGQUIT
- SIGUSR2
Signal chaining only works on POSIX platforms.</div>
<div> <p /> Enable/disable signal chaining. This should be called before <code>mono_jit_init</code>. If signal chaining is enabled, the runtime saves the original signal handlers before installing its own handlers, and calls the original ones in the following cases: - a <code>SIGSEGV</code> / <code>SIGABRT</code> signal received while executing native (i.e. not JITted) code. - <code>SIGPROF</code> - <code>SIGFPE</code> - <code>SIGQUIT</code> - <code>SIGUSR2</code> Signal chaining only works on POSIX platforms.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div>
</div></body>
</html>

256
docs/deploy/mono-api-exc.html
View File

File diff suppressed because it is too large Load Diff

158
docs/deploy/mono-api-gc.html
View File

@@ -211,15 +211,8 @@ mono_gc_collect (int generation)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>generation</i><td> GC generation identifier</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Perform a garbage collection for the given generation, higher numbers
mean usually older objects. Collecting a high-numbered generation
implies collecting also the lower-numbered generations.
The maximum value for <i>generation</i> can be retrieved with a call to
mono_gc_max_generation(), so this function is usually called as:
<p />
mono_gc_collect (mono_gc_max_generation ());</div>
<table class="mapi-parameters"><tbody><tr><td><i>generation</i></td><td> GC generation identifier</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> Perform a garbage collection for the given generation, higher numbers mean usually older objects. Collecting a high-numbered generation implies collecting also the lower-numbered generations. The maximum value for <i>generation</i> can be retrieved with a call to <code>mono_gc_max_generation</code>, so this function is usually called as: <p /> <code>mono_gc_collect (mono_gc_max_generation ());</code></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -239,14 +232,11 @@ mono_gc_collection_count (int generation)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>generation</i><td> a GC generation number</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the number of garbage collections
<table class="mapi-parameters"><tbody><tr><td><i>generation</i></td><td> a GC generation number</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the number of garbage collections
</div>
<div class="mapi-section">Description</div>
<div> <p />
Get how many times a garbage collection has been performed
for the given <i>generation</i> number.
<p /></div>
<div> <p /> Get how many times a garbage collection has been performed for the given <i>generation</i> number. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -266,14 +256,10 @@ mono_gc_max_generation (void)
</div>
<p />
<div class="mapi-section">Return value</div>
<div> the maximum generation number.
<div> the maximum generation number.
</div>
<div class="mapi-section">Description</div>
<div> <p />
Get the maximum generation number used by the current garbage
collector. The value will be 0 for the Boehm collector, 1 or more
for the generational collectors.
<p /></div>
<div> <p /> Get the maximum generation number used by the current garbage collector. The value will be 0 for the Boehm collector, 1 or more for the generational collectors. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -293,14 +279,11 @@ mono_gc_get_generation (MonoObject *object)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>object</i><td> a managed object</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> a garbage collector generation number
<table class="mapi-parameters"><tbody><tr><td><i>object</i></td><td> a managed object</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> a garbage collector generation number
</div>
<div class="mapi-section">Description</div>
<div> <p />
Get the garbage collector's generation that <i>object</i> belongs to.
Use this has a hint only.
<p /></div>
<div> <p /> Get the garbage collector's generation that <i>object</i> belongs to. Use this has a hint only. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -320,12 +303,10 @@ mono_gc_get_heap_size (void)
</div>
<p />
<div class="mapi-section">Return value</div>
<div> the size of the heap in bytes
<div> the size of the heap in bytes
</div>
<div class="mapi-section">Description</div>
<div> <p />
Get the amount of memory used by the garbage collector.
<p /></div>
<div> <p /> Get the amount of memory used by the garbage collector. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -345,12 +326,10 @@ mono_gc_get_used_size (void)
</div>
<p />
<div class="mapi-section">Return value</div>
<div> the amount of memory used in bytes
<div> the amount of memory used in bytes
</div>
<div class="mapi-section">Description</div>
<div> <p />
Get the approximate amount of memory used by managed objects.
<p /></div>
<div> <p /> Get the approximate amount of memory used by managed objects. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -370,22 +349,11 @@ mono_gc_walk_heap (int flags, MonoGCReferences callback, void *data)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>flags</i><td> flags for future use</td></td></tr><tr><td><i>callback</i><td> a function pointer called for each object in the heap</td></td></tr><tr><td><i>data</i><td> a user data pointer that is passed to callback</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> a non-zero value if the GC doesn't support heap walking
<table class="mapi-parameters"><tbody><tr><td><i>flags</i></td><td> flags for future use</td></tr><tr><td><i>callback</i></td><td> a function pointer called for each object in the heap</td></tr><tr><td><i>data</i></td><td> a user data pointer that is passed to callback</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> a non-zero value if the GC doesn't support heap walking
</div>
<div class="mapi-section">Description</div>
<div> <p />
This function can be used to iterate over all the live objects in the heap:
for each object, <i>callback</i> is invoked, providing info about the object's
location in memory, its class, its size and the objects it references.
For each referenced object it's offset from the object address is
reported in the offsets array.
The object references may be buffered, so the callback may be invoked
multiple times for the same object: in all but the first call, the size
argument will be zero.
Note that this function can be only called in the <code>MONO_GC_EVENT_PRE_START_WORLD</code>
profiler event handler.
<p /></div>
<div> This function can be used to iterate over all the live objects in the heap; for each object, <i>callback</i> is invoked, providing info about the object's location in memory, its class, its size and the objects it references. For each referenced object its offset from the object address is reported in the offsets array. The object references may be buffered, so the callback may be invoked multiple times for the same object: in all but the first call, the size argument will be zero. Note that this function can be only called in the <code>MONO_GC_EVENT_PRE_START_WORLD</code> profiler event handler.</div>
</div><!--mapi-description -->
</div><!--height container -->
@@ -407,16 +375,12 @@ mono_gc_reference_queue_add (MonoReferenceQueue *queue, MonoObject *obj, void *u
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>queue</i></td><td> the queue to add the reference to.</td></tr><tr><td><i>obj</i></td><td> the object to be watched for collection</td></tr><tr><td><i>user_data</i></td><td> parameter to be passed to the queue callback</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> <code>FALSE</code> if the queue is scheduled to be freed.
</div>
<div class="mapi-section">Description</div>
<div> <i>queue</i> the queue to add the reference to.
<i>obj</i> the object to be watched for collection
<i>user_data</i> parameter to be passed to the queue callback
<p />
Queue an object to be watched for collection, when the <i>obj</i> is
collected, the callback that was registered for the <i>queue</i> will
be invoked with <i>user_data</i> as argument.
<p />
<i>returns</i> false if the queue is scheduled to be freed.</div>
<div> <p /> Queue an object to be watched for collection, when the <i>obj</i> is collected, the callback that was registered for the <i>queue</i> will be invoked with <i>user_data</i> as argument. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -435,14 +399,9 @@ mono_gc_reference_queue_free (MonoReferenceQueue *queue)
</div>
<p />
<div class="mapi-section">Description</div>
<div> <i>queue</i> the queue that should be freed.
<p />
This operation signals that <i>queue</i> should be freed. This operation is deferred
as it happens on the finalizer thread.
<p />
After this call, no further objects can be queued. It's the responsibility of the
caller to make sure that no further attempt to access queue will be made.</div>
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>queue</i></td><td> the queue that should be freed.</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> This operation signals that <i>queue</i> should be freed. This operation is deferred as it happens on the finalizer thread. <p /> After this call, no further objects can be queued. It's the responsibility of the caller to make sure that no further attempt to access queue will be made.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -461,21 +420,12 @@ mono_gc_reference_queue_new (mono_reference_queue_callback callback)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>callback</i></td><td> callback used when processing collected entries.</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the new queue.
</div>
<div class="mapi-section">Description</div>
<div> <i>callback</i> callback used when processing collected entries.
<p />
Create a new reference queue used to process collected objects.
A reference queue let you add a pair of (managed object, user data)
using the mono_gc_reference_queue_add method.
<p />
Once the managed object is collected <i>callback</i> will be called
in the finalizer thread with 'user data' as argument.
<p />
The callback is called from the finalizer thread without any locks held.
When a AppDomain is unloaded, all callbacks for objects belonging to it
will be invoked.
<p />
<i>returns</i> the new queue.</div>
<div> <p /> Create a new reference queue used to process collected objects. A reference queue let you add a pair of (managed object, user data) using the <code>mono_gc_reference_queue_add</code> method. <p /> Once the managed object is collected <i>callback</i> will be called in the finalizer thread with 'user data' as argument. <p /> The callback is called from the finalizer thread without any locks held. When an AppDomain is unloaded, all callbacks for objects belonging to it will be invoked. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
@@ -573,7 +523,10 @@ typedef struct {
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_gc_register_bridge_callbacks</div>
<div class="mapi-prototype">void
mono_gc_register_bridge_callbacks (MonoGCBridgeCallbacks *callbacks)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -588,7 +541,10 @@ typedef struct {
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_gc_wait_for_bridge_processing</div>
<div class="mapi-prototype">void
mono_gc_wait_for_bridge_processing (void)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -606,7 +562,10 @@ typedef struct {
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_gc_wbarrier_arrayref_copy</div>
<div class="mapi-prototype">void
mono_gc_wbarrier_arrayref_copy (gpointer dest_ptr, gpointer src_ptr, int count)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -621,7 +580,10 @@ typedef struct {
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_gc_wbarrier_generic_nostore</div>
<div class="mapi-prototype">void
mono_gc_wbarrier_generic_nostore (gpointer ptr)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -636,7 +598,10 @@ typedef struct {
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_gc_wbarrier_generic_store</div>
<div class="mapi-prototype">void
mono_gc_wbarrier_generic_store (gpointer ptr, GCObject* value)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -651,8 +616,13 @@ typedef struct {
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_gc_wbarrier_generic_store_atomic</div>
<div class="mapi-prototype">void
mono_gc_wbarrier_generic_store_atomic (gpointer ptr, GCObject *value)
</div>
<p />
<div class="mapi-section">Description</div>
<div> Same as <code>mono_gc_wbarrier_generic_store</code> but performs the store as an atomic operation with release semantics.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -672,8 +642,7 @@ mono_gc_wbarrier_object_copy (MonoObject* obj, MonoObject *src)
</div>
<p />
<div class="mapi-section">Description</div>
<div> <p />
Write barrier to call when obj is the result of a clone or copy of an object.</div>
<div> <p /> Write barrier to call when <i>obj</i> is the result of a clone or copy of an object.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -687,7 +656,10 @@ mono_gc_wbarrier_object_copy (MonoObject* obj, MonoObject *src)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_gc_wbarrier_set_arrayref</div>
<div class="mapi-prototype">void
mono_gc_wbarrier_set_arrayref (MonoArray *arr, gpointer slot_ptr, MonoObject* value)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -702,10 +674,10 @@ mono_gc_wbarrier_object_copy (MonoObject* obj, MonoObject *src)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_gc_wbarrier_set_field</div>
<div class="mapi-prototype">void
mono_gc_wbarrier_set_field (MonoObject *obj, gpointer field_ptr, MonoObject* value)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
</div>
</div></body>
</html>

57
docs/deploy/mono-api-gchandle.html
View File

@@ -192,12 +192,6 @@
<h3>Synopsys</h3>
<div class="mapi-header">
guint32 <a href="#api:mono_gchandle_new">mono_gchandle_new</a> (GCObject *obj,
gboolean pinned);
guint32 <a href="#api:mono_gchandle_new_weakref">mono_gchandle_new_weakref</a> (GCObject *obj,
gboolean track_resurrection);
GCObject* <a href="#api:mono_gchandle_get_target">mono_gchandle_get_target</a> (guint32 gchandle);
void <a href="#api:mono_gchandle_free">mono_gchandle_free</a> (guint32 gchandle);
</div>
@@ -297,21 +291,11 @@ mono_gchandle_new (GCObject *obj, gboolean pinned)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>obj</i><td> managed object to get a handle for</td></td></tr><tr><td><i>pinned</i><td> whether the object should be pinned</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> a handle that can be used to access the object from
unmanaged code.</div>
<table class="mapi-parameters"><tbody><tr><td><i>obj</i></td><td> managed object to get a handle for</td></tr><tr><td><i>pinned</i></td><td> whether the object should be pinned</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> a handle that can be used to access the object from unmanaged code.
</div>
<div class="mapi-section">Description</div>
<div> <p />
This returns a handle that wraps the object, this is used to keep a
reference to a managed object from the unmanaged world and preventing the
object from being disposed.
<p />
If <i>pinned</i> is false the address of the object can not be obtained, if it is
true the address of the object can be obtained. This will also pin the
object so it will not be possible by a moving garbage collector to move the
object.
<p /></div>
<div> This returns a handle that wraps the object, this is used to keep a reference to a managed object from the unmanaged world and preventing the object from being disposed. <p /> If <i>pinned</i> is false the address of the object can not be obtained, if it is true the address of the object can be obtained. This will also pin the object so it will not be possible by a moving garbage collector to move the object. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -331,25 +315,12 @@ mono_gchandle_new_weakref (GCObject *obj, gboolean track_resurrection)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>obj</i><td> managed object to get a handle for</td></td></tr><tr><td><i>track_resurrection</i><td> Determines how long to track the object, if this is set to <code>TRUE</code>, the object is tracked after finalization, if <code>FALSE</code>, the object is only tracked up until the point of finalization.</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> a handle that can be used to access the object from
<table class="mapi-parameters"><tbody><tr><td><i>obj</i></td><td> managed object to get a handle for</td></tr><tr><td><i>track_resurrection</i></td><td> Determines how long to track the object, if this is set to <code>TRUE</code>, the object is tracked after finalization, if <code>FALSE</code>, the object is only tracked up until the point of finalization.</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> a handle that can be used to access the object from
unmanaged code.</div>
<div class="mapi-section">Description</div>
<div> <p />
This returns a weak handle that wraps the object, this is used to
keep a reference to a managed object from the unmanaged world.
Unlike the mono_gchandle_new the object can be reclaimed by the
garbage collector. In this case the value of the GCHandle will be
set to zero.
<p />
If <i>track_resurrection</i> is <code>TRUE</code> the object will be tracked through
finalization and if the object is resurrected during the execution
of the finalizer, then the returned weakref will continue to hold
a reference to the object. If <i>track_resurrection</i> is <code>FALSE</code>, then
the weak reference's target will become <code>NULL</code> as soon as the object
is passed on to the finalizer.
<p /></div>
<div> <p /> This returns a weak handle that wraps the object, this is used to keep a reference to a managed object from the unmanaged world. Unlike the <code>mono_gchandle_new</code> the object can be reclaimed by the garbage collector. In this case the value of the GCHandle will be set to zero. <p /> If <i>track_resurrection</i> is <code>TRUE</code> the object will be tracked through finalization and if the object is resurrected during the execution of the finalizer, then the returned weakref will continue to hold a reference to the object. If <i>track_resurrection</i> is <code>FALSE</code>, then the weak reference's target will become <code>NULL</code> as soon as the object is passed on to the finalizer. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -369,15 +340,11 @@ mono_gchandle_get_target (guint32 gchandle)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>gchandle</i><td> a GCHandle's handle.</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
The handle was previously created by calling <code>mono_gchandle_new</code> or
<code>mono_gchandle_new_weakref</code>.
<p />
Returns a pointer to the <code>MonoObject*</code> represented by the handle or
<table class="mapi-parameters"><tbody><tr><td><i>gchandle</i></td><td> a GCHandle's handle.</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> a pointer to the <code>MonoObject*</code> represented by the handle or
<code>NULL</code> for a collected object if using a weakref handle.</div>
<div class="mapi-section">Description</div>
<div> <p /> The handle was previously created by calling <code>mono_gchandle_new</code> or <code>mono_gchandle_new_weakref</code>. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div>
</div></body>
</html>

329
docs/deploy/mono-api-image.html
View File

File diff suppressed because it is too large Load Diff

480
docs/deploy/mono-api-internal.html
View File

File diff suppressed because it is too large Load Diff

130
docs/deploy/mono-api-jit.html
View File

@@ -196,22 +196,6 @@
<div class="mapi-header">
typedef struct _MonoJitInfo MonoJitInfo;
MonoJitInfo* <a href="#api:mono_jit_info_table_find">mono_jit_info_table_find</a> (MonoDomain *domain,
char *addr);
int <a href="#api:mono_jit_info_get_code_size">mono_jit_info_get_code_size</a> (MonoJitInfo* ji);
gpointer <a href="#api:mono_jit_info_get_code_start">mono_jit_info_get_code_start</a> (MonoJitInfo* ji);
MonoMethod* <a href="#api:mono_jit_info_get_method">mono_jit_info_get_method</a> (MonoJitInfo* ji);
G_GNUC_UNUSED char * <a href="#api:mono_pmip">mono_pmip</a> (void *ip);
void <a href="#api:mono_print_method_from_ip">mono_print_method_from_ip</a> (void *ip);
<a href="#api:mono_print_thread_dump">mono_print_thread_dump</a>
void <a href="#api:mono_threads_request_thread_dump">mono_threads_request_thread_dump</a> (void);
void <a href="#api:mono_assemblies_init">mono_assemblies_init</a> (void);
void <a href="#api:mono_assemblies_cleanup">mono_assemblies_cleanup</a> (void);
<a href="#api:mono_environment_exitcode_get">mono_environment_exitcode_get</a>
<a href="#api:mono_environment_exitcode_set">mono_environment_exitcode_set</a>
<a href="#api:mono_install_runtime_cleanup">mono_install_runtime_cleanup</a>
void <a href="#api:mono_runtime_set_shutting_down">mono_runtime_set_shutting_down</a> (void);
<a href="#api:mono_security_set_core_clr_platform_callback">mono_security_set_core_clr_platform_callback</a>
</div>
@@ -236,19 +220,12 @@ mono_jit_info_table_find (MonoDomain *domain, char *addr)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i><td> Domain that you want to look up</td></td></tr><tr><td><i>addr</i><td> Points to an address with JITed code.</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> <code>NULL</code> if the address does not belong to JITed code (it might be native
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> Domain that you want to look up</td></tr><tr><td><i>addr</i></td><td> Points to an address with JITed code.</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> <code>NULL</code> if the address does not belong to JITed code (it might be native
code or a trampoline) or a valid pointer to a <code>MonoJitInfo*</code>.</div>
code or a trampoline) or a valid pointer to a <code>MonoJitInfo*</code> .</div>
<div class="mapi-section">Description</div>
<div> <p />
Use this function to obtain a <code>MonoJitInfo*</code> object that can be used to get
some statistics. You should provide both the <i>domain</i> on which you will be
performing the probe, and an address. Since application domains can share code
the same address can be in use by multiple domains at once.
<p />
This does not return any results for trampolines.
<p /></div>
<div> <p /> Use this function to obtain a <code>MonoJitInfo*</code> object that can be used to get some statistics. You should provide both the <i>domain</i> on which you will be performing the probe, and an address. Since application domains can share code the same address can be in use by multiple domains at once. <p /> This does not return any results for trampolines. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -268,15 +245,11 @@ mono_jit_info_get_code_size (MonoJitInfo* ji)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>ji</i><td> the JIT information handle</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> Starting address with the native code.
<table class="mapi-parameters"><tbody><tr><td><i>ji</i></td><td> the JIT information handle</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> Starting address with the native code.
</div>
<div class="mapi-section">Description</div>
<div> <p />
Use this function to get the code size for the method described by
the <i>ji</i> object. You can use this plus the <code>mono_jit_info_get_code_start</code>
to determine the start and end of the native code.
<p /></div>
<div> <p /> Use this function to get the code size for the method described by the <i>ji</i> object. You can use this plus the <code>mono_jit_info_get_code_start</code> to determine the start and end of the native code. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -296,15 +269,11 @@ mono_jit_info_get_code_start (MonoJitInfo* ji)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>ji</i><td> the JIT information handle</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> Starting address with the native code.
<table class="mapi-parameters"><tbody><tr><td><i>ji</i></td><td> the JIT information handle</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> Starting address with the native code.
</div>
<div class="mapi-section">Description</div>
<div> <p />
Use this function to get the starting address for the method described by
the <i>ji</i> object. You can use this plus the <code>mono_jit_info_get_code_size</code>
to determine the start and end of the native code.
<p /></div>
<div> <p /> Use this function to get the starting address for the method described by the <i>ji</i> object. You can use this plus the <code>mono_jit_info_get_code_size</code> to determine the start and end of the native code. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -324,15 +293,12 @@ mono_jit_info_get_method (MonoJitInfo* ji)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>ji</i><td> the JIT information handle</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> The MonoMethod that represents the code tracked
<table class="mapi-parameters"><tbody><tr><td><i>ji</i></td><td> the JIT information handle</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> The <code>MonoMethod</code> that represents the code tracked
by <i>ji</i>.</div>
<div class="mapi-section">Description</div>
<div> <p />
Use this function to get the `MonoMethod *` that backs
the <i>ji</i> object.
<p /></div>
<div> <p /> Use this function to get the <code>MonoMethod*</code> that backs the <i>ji</i> object. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
@@ -358,17 +324,11 @@ mono_pmip (void *ip)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>ip</i><td> an instruction pointer address</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the name of the method at address <i>ip</i>.
<table class="mapi-parameters"><tbody><tr><td><i>ip</i></td><td> an instruction pointer address</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the name of the method at address <i>ip</i>.
</div>
<div class="mapi-section">Description</div>
<div> <p />
This method is used from a debugger to get the name of the
method at address <i>ip</i>. This routine is typically invoked from
a debugger like this:
<p />
(gdb) print mono_pmip ($pc)
<p /></div>
<div> <p /> This method is used from a debugger to get the name of the method at address <i>ip</i>. This routine is typically invoked from a debugger like this: <p /> (gdb) print mono_pmip ($pc) <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -382,24 +342,14 @@ mono_pmip (void *ip)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">#ifdef __GNUC__
/* Prevent the linker from optimizing this away in embedding setups to help debugging */
__attribute__ ((__used__))
#endif
void
<div class="mapi-prototype">MONO_ATTR_USED void
mono_print_method_from_ip (void *ip)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>ip</i><td> an instruction pointer address</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
This method is used from a debugger to get the name of the
method at address <i>ip</i>.
<p />
This prints the name of the method at address <i>ip</i> in the standard
output. Unlike mono_pmip which returns a string, this routine
prints the value on the standard output.</div>
<table class="mapi-parameters"><tbody><tr><td><i>ip</i></td><td> an instruction pointer address</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> This method is used from a debugger to get the name of the method at address <i>ip</i>. <p /> This prints the name of the method at address <i>ip</i> in the standard output. Unlike <code>mono_pmip</code> which returns a string, this routine prints the value on the standard output.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -413,8 +363,13 @@ mono_print_method_from_ip (void *ip)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_print_thread_dump</div>
<div class="mapi-prototype">void
mono_print_thread_dump (void *sigctx)
</div>
<p />
<div class="mapi-section">Description</div>
<div> <p /> Print information about the current thread to stdout. <i>sigctx</i> can be <code>NULL</code>, allowing this to be called from gdb.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -434,8 +389,7 @@ mono_threads_request_thread_dump (void)
</div>
<p />
<div class="mapi-section">Description</div>
<div> <p />
Ask all threads except the current to print their stacktrace to stdout.</div>
<div> <p /> Ask all threads except the current to print their stacktrace to stdout.</div>
</div><!--mapi-description -->
</div><!--height container -->
@@ -458,8 +412,7 @@ mono_assemblies_init (void)
</div>
<p />
<div class="mapi-section">Description</div>
<div> <p />
Initialize global variables used by this module.</div>
<div> <p /> Initialize global variables used by this module.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -479,8 +432,7 @@ mono_assemblies_cleanup (void)
</div>
<p />
<div class="mapi-section">Description</div>
<div> <p />
Free all resources used by this module.</div>
<div> <p /> Free all resources used by this module.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -494,7 +446,10 @@ mono_assemblies_cleanup (void)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_environment_exitcode_get</div>
<div class="mapi-prototype">gint32
mono_environment_exitcode_get (void)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -509,7 +464,10 @@ mono_assemblies_cleanup (void)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_environment_exitcode_set</div>
<div class="mapi-prototype">void
mono_environment_exitcode_set (gint32 value)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -524,7 +482,10 @@ mono_assemblies_cleanup (void)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_install_runtime_cleanup</div>
<div class="mapi-prototype">void
mono_install_runtime_cleanup (MonoDomainFunc func)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -532,7 +493,7 @@ mono_assemblies_cleanup (void)
<a name="api:mono_runtime_set_shutting_down"></a>
<div class="mapi">
<div class="mapi-entry "><code>mono_runtime_set_shutting_down</code></div>
<div class="mapi-entry mapi-strike"><code>mono_runtime_set_shutting_down</code></div><br /><div class='mapi-deprecated'><b>Deprecated:</b> This function can break the shutdown sequence.</div>
<div class="mapi-height-container">
<div class="mapi-ptr-container"></div>
<div class="mapi-description">
@@ -545,13 +506,6 @@ mono_runtime_set_shutting_down (void)
</div>
<p />
<div class="mapi-section">Description</div>
<div> <p />
Invoked by System.Environment.Exit to flag that the runtime
is shutting down.
<p />
Deprecated. This function can break the shutdown sequence.</div>
<div> <p /> Invoked by <code>System.Environment.Exit</code> to flag that the runtime is shutting down.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div>
</div></body>
</html>

584
docs/deploy/mono-api-jitinternal.html
View File

File diff suppressed because it is too large Load Diff

515
docs/deploy/mono-api-metadata.html
View File

File diff suppressed because it is too large Load Diff

404
docs/deploy/mono-api-methods.html
View File

File diff suppressed because one or more lines are too long

573
docs/deploy/mono-api-object.html
View File

File diff suppressed because it is too large Load Diff

96
docs/deploy/mono-api-profiler.html
View File

@@ -251,13 +251,8 @@ mono_profiler_install (MonoProfiler *prof, MonoProfileFunc callback)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>prof</i><td> a MonoProfiler structure pointer, or a pointer to a derived structure.</td></td></tr><tr><td><i>callback</i><td> the function to invoke at shutdown</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Use mono_profiler_install to activate profiling in the Mono runtime.
Typically developers of new profilers will create a new structure whose
first field is a MonoProfiler and put any extra information that they need
to access from the various profiling callbacks there.
<p /></div>
<table class="mapi-parameters"><tbody><tr><td><i>prof</i></td><td> a <code>MonoProfiler</code> structure pointer, or a pointer to a derived structure.</td></tr><tr><td><i>callback</i></td><td> the function to invoke at shutdown</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> Use <code>mono_profiler_install</code> to activate profiling in the Mono runtime. Typically developers of new profilers will create a new structure whose first field is a <code>MonoProfiler</code> and put any extra information that they need to access from the various profiling callbacks there.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -271,7 +266,10 @@ mono_profiler_install (MonoProfiler *prof, MonoProfileFunc callback)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_profiler_install_allocation</div>
<div class="mapi-prototype">void
mono_profiler_install_allocation (MonoProfileAllocFunc callback)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -286,7 +284,12 @@ mono_profiler_install (MonoProfiler *prof, MonoProfileFunc callback)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_profiler_install_appdomain</div>
<div class="mapi-prototype">void
mono_profiler_install_appdomain (MonoProfileAppDomainFunc start_load, MonoProfileAppDomainResult end_load,
MonoProfileAppDomainFunc start_unload, MonoProfileAppDomainFunc end_unload)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -301,7 +304,11 @@ mono_profiler_install (MonoProfiler *prof, MonoProfileFunc callback)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_profiler_install_assembly</div>
<div class="mapi-prototype">void
mono_profiler_install_assembly (MonoProfileAssemblyFunc start_load, MonoProfileAssemblyResult end_load,
MonoProfileAssemblyFunc start_unload, MonoProfileAssemblyFunc end_unload)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -316,7 +323,11 @@ mono_profiler_install (MonoProfiler *prof, MonoProfileFunc callback)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_profiler_install_class</div>
<div class="mapi-prototype">void
mono_profiler_install_class (MonoProfileClassFunc start_load, MonoProfileClassResult end_load,
MonoProfileClassFunc start_unload, MonoProfileClassFunc end_unload)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -331,7 +342,10 @@ mono_profiler_install (MonoProfiler *prof, MonoProfileFunc callback)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_profiler_install_coverage_filter</div>
<div class="mapi-prototype">void
mono_profiler_install_coverage_filter (MonoProfileCoverageFilterFunc callback)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -352,11 +366,8 @@ mono_profiler_install_enter_leave (MonoProfileMethodFunc enter, MonoProfileMetho
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>enter</i><td> the routine to be called on each method entry</td></td></tr><tr><td><i>fleave</i><td> the routine to be called each time a method returns</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Use this routine to install routines that will be called everytime
a method enters and leaves. The routines will receive as an argument
the MonoMethod representing the method that is entering or leaving.</div>
<table class="mapi-parameters"><tbody><tr><td><i>enter</i></td><td> the routine to be called on each method entry</td></tr><tr><td><i>fleave</i></td><td> the routine to be called each time a method returns</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> Use this routine to install routines that will be called everytime a method enters and leaves. The routines will receive as an argument the <code>MonoMethod</code> representing the method that is entering or leaving.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -376,10 +387,8 @@ mono_profiler_install_jit_compile (MonoProfileMethodFunc start, MonoProfileMetho
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>start</i><td> the routine to be called when the JIT process starts.</td></td></tr><tr><td><i>end</i><td> the routine to be called when the JIT process ends.</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Use this routine to install routines that will be called when JIT
compilation of a method starts and completes.</div>
<table class="mapi-parameters"><tbody><tr><td><i>start</i></td><td> the routine to be called when the JIT process starts.</td></tr><tr><td><i>end</i></td><td> the routine to be called when the JIT process ends.</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> Use this routine to install routines that will be called when JIT compilation of a method starts and completes.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -393,7 +402,11 @@ mono_profiler_install_jit_compile (MonoProfileMethodFunc start, MonoProfileMetho
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_profiler_install_module</div>
<div class="mapi-prototype">void
mono_profiler_install_module (MonoProfileModuleFunc start_load, MonoProfileModuleResult end_load,
MonoProfileModuleFunc start_unload, MonoProfileModuleFunc end_unload)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -408,7 +421,10 @@ mono_profiler_install_jit_compile (MonoProfileMethodFunc start, MonoProfileMetho
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_profiler_install_thread</div>
<div class="mapi-prototype">void
mono_profiler_install_thread (MonoProfileThreadFunc start, MonoProfileThreadFunc end)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -423,7 +439,10 @@ mono_profiler_install_jit_compile (MonoProfileMethodFunc start, MonoProfileMetho
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_profiler_install_transition</div>
<div class="mapi-prototype">void
mono_profiler_install_transition (MonoProfileMethodResult callback)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -438,7 +457,10 @@ mono_profiler_install_jit_compile (MonoProfileMethodFunc start, MonoProfileMetho
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_profiler_install_gc</div>
<div class="mapi-prototype">void
mono_profiler_install_gc (MonoProfileGCFunc callback, MonoProfileGCResizeFunc heap_resize_callback)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -453,7 +475,10 @@ mono_profiler_install_jit_compile (MonoProfileMethodFunc start, MonoProfileMetho
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_profiler_install_statistical</div>
<div class="mapi-prototype">void
mono_profiler_install_statistical (MonoProfileStatFunc callback)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -474,17 +499,8 @@ mono_profiler_set_events (MonoProfileFlags events)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>events</i><td> an ORed set of values made up of MONO_PROFILER_ flags</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
The events descriped in the <i>events</i> argument is a set of flags
that represent which profiling events must be triggered. For
example if you have registered a set of methods for tracking
JIT compilation start and end with mono_profiler_install_jit_compile,
you will want to pass the MONO_PROFILE_JIT_COMPILATION flag to
this routine.
<p />
You can call mono_profile_set_events more than once and you can
do this at runtime to modify which methods are invoked.</div>
<table class="mapi-parameters"><tbody><tr><td><i>events</i></td><td> an ORed set of values made up of <code>MONO_PROFILER_</code> flags</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> The events described in the <i>events</i> argument is a set of flags that represent which profiling events must be triggered. For example if you have registered a set of methods for tracking JIT compilation start and end with <code>mono_profiler_install_jit_compile</code>, you will want to pass the <code>MONO_PROFILE_JIT_COMPILATION</code> flag to this routine. <p /> You can call <code>mono_profile_set_events</code> more than once and you can do this at runtime to modify which methods are invoked.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -504,8 +520,7 @@ mono_profiler_get_events (void)
</div>
<p />
<div class="mapi-section">Description</div>
<div> <p />
Returns a list of active events that will be intercepted. </div>
<div> <p /> Returns a list of active events that will be intercepted. </div>
</div><!--mapi-description -->
</div><!--height container -->
@@ -514,6 +529,3 @@ mono_profiler_get_events (void)
<p />To support profiling modules that need to do code coverage
analysis, the following routines is provided:
</div>
</div></body>
</html>

226
docs/deploy/mono-api-reflection.html
View File

@@ -198,7 +198,10 @@
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_custom_attrs_get_attr</div>
<div class="mapi-prototype">MonoObject*
mono_custom_attrs_get_attr (MonoCustomAttrInfo *ainfo, MonoClass *attr_klass)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -219,9 +222,9 @@ mono_reflection_assembly_get_assembly (MonoReflectionAssembly *refassembly)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>refassembly</i><td> the System.Reflection.Assembly object</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Returns the MonoAssembly* associated with the C# System.Reflection.Assembly object <i>refassembly</i>.</div>
<table class="mapi-parameters"><tbody><tr><td><i>refassembly</i></td><td> the <code>System.Reflection.Assembly</code> object</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the <code>MonoAssembly*</code> associated with the C# <code>System.Reflection.Assembly</code> object <i>refassembly</i>.
</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -235,7 +238,10 @@ mono_reflection_assembly_get_assembly (MonoReflectionAssembly *refassembly)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_reflection_free_type_info</div>
<div class="mapi-prototype">void
mono_reflection_free_type_info (MonoTypeNameParse *info)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -256,13 +262,11 @@ mono_reflection_get_custom_attrs_blob (MonoReflectionAssembly *assembly, MonoObj
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>ctor</i><td> custom attribute constructor</td></td></tr><tr><td><i>ctorArgs</i><td> arguments o the constructor</td></td></tr><tr><td><i>properties</i><td></td></td></tr><tr><td><i>propValues</i><td></td></td></tr><tr><td><i>fields</i><td></td></td></tr><tr><td><i>fieldValues</i><td></td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> a Byte array representing the blob of data.
<table class="mapi-parameters"><tbody><tr><td><i>ctor</i></td><td> custom attribute constructor</td></tr><tr><td><i>ctorArgs</i></td><td> arguments o the constructor</td></tr><tr><td><i>properties</i></td><td></td></tr><tr><td><i>propValues</i></td><td></td></tr><tr><td><i>fields</i></td><td></td></tr><tr><td><i>fieldValues</i></td><td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> a <code>Byte</code> array representing the blob of data.
</div>
<div class="mapi-section">Description</div>
<div> <p />
Creates the blob of data that needs to be saved in the metadata and that represents
the custom attributed described by <i>ctor</i>, <i>ctorArgs</i> etc.</div>
<div> Creates the blob of data that needs to be saved in the metadata and that represents the custom attributed described by <i>ctor</i>, <i>ctorArgs</i> etc.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -276,8 +280,18 @@ mono_reflection_get_custom_attrs_blob (MonoReflectionAssembly *assembly, MonoObj
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_reflection_get_custom_attrs_by_type</div>
<div class="mapi-prototype">MonoArray*
mono_reflection_get_custom_attrs_by_type (MonoObject *obj, MonoClass *attr_klass, MonoError *error)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>obj</i></td><td> a reflection object handle</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> an array with all the custom attributes defined of the
reflection handle <i>obj</i>. If <i>attr_klass</i> is non-<code>NULL</code>, only custom attributes
of that type are returned. The objects are fully build. Return <code>NULL</code> if a loading error
occurs.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -291,8 +305,17 @@ mono_reflection_get_custom_attrs_blob (MonoReflectionAssembly *assembly, MonoObj
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_reflection_get_custom_attrs_data</div>
<div class="mapi-prototype">MonoArray*
mono_reflection_get_custom_attrs_data (MonoObject *obj)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>obj</i></td><td> a reflection obj handle</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> an array of <code>System.Reflection.CustomAttributeData</code>,
which include information about attributes reflected on
types loaded using the Reflection Only methods</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -306,8 +329,17 @@ mono_reflection_get_custom_attrs_blob (MonoReflectionAssembly *assembly, MonoObj
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_reflection_get_custom_attrs</div>
<div class="mapi-prototype">MonoArray*
mono_reflection_get_custom_attrs (MonoObject *obj)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>obj</i></td><td> a reflection object handle</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> an array with all the custom attributes defined of the
reflection handle <i>obj</i>. The objects are fully build. Return <code>NULL</code> if a loading error
occurs.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -321,8 +353,15 @@ mono_reflection_get_custom_attrs_blob (MonoReflectionAssembly *assembly, MonoObj
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_reflection_get_token</div>
<div class="mapi-prototype">guint32
mono_reflection_get_token (MonoObject *obj_raw)
</div>
<p />
<div class="mapi-section">Return value</div>
<div> the metadata token of <i>obj</i> which should be an object
representing a metadata element.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -336,8 +375,13 @@ mono_reflection_get_custom_attrs_blob (MonoReflectionAssembly *assembly, MonoObj
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_reflection_get_type</div>
<div class="mapi-prototype">MonoType*
mono_reflection_get_type (MonoImage* image, MonoTypeNameParse *info, gboolean ignorecase, gboolean *type_resolve)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>image</i></td><td> a metadata context</td></tr><tr><td><i>info</i></td><td> type description structure</td></tr><tr><td><i>ignorecase</i></td><td> flag for case-insensitive string compares</td></tr><tr><td><i>type_resolve</i></td><td> whenever type resolve was already tried</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> Build a MonoType from the type description in <i>info</i>. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -351,7 +395,10 @@ mono_reflection_get_custom_attrs_blob (MonoReflectionAssembly *assembly, MonoObj
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_reflection_parse_type</div>
<div class="mapi-prototype">int
mono_reflection_parse_type (char *name, MonoTypeNameParse *info)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -372,9 +419,9 @@ mono_reflection_type_get_type (MonoReflectionType *reftype)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>reftype</i><td> the System.Type object</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Returns the MonoType* associated with the C# System.Type object <i>reftype</i>.</div>
<table class="mapi-parameters"><tbody><tr><td><i>reftype</i></td><td> the <code>System.Type</code> object</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the <code>MonoType*</code> associated with the C# <code>System.Type</code> object <i>reftype</i>.
</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -388,8 +435,14 @@ mono_reflection_type_get_type (MonoReflectionType *reftype)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_reflection_type_from_name</div>
<div class="mapi-prototype">MonoType*
mono_reflection_type_from_name (char *name, MonoImage *image)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>name</i></td><td> type name.</td></tr><tr><td><i>image</i></td><td> a metadata context (can be <code>NULL</code>).</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p /> Retrieves a <code>MonoType</code> from its <i>name</i>. If the name is not fully qualified, it defaults to get the type from <i>image</i> or, if <i>image</i> is <code>NULL</code> or loading from it fails, uses corlib. <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -403,8 +456,20 @@ mono_reflection_type_get_type (MonoReflectionType *reftype)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_reflection_get_custom_attrs_info</div>
<div class="mapi-prototype">MonoCustomAttrInfo*
mono_reflection_get_custom_attrs_info (MonoObject *obj)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>obj</i></td><td> a reflection object handle</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the custom attribute info for attributes defined for the
reflection handle <i>obj</i>. The objects.
<p />
FIXME this function leaks like a sieve for SRE objects.</div>
<div class="mapi-section">Description</div>
<div> <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
@@ -421,7 +486,10 @@ mono_reflection_type_get_type (MonoReflectionType *reftype)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_custom_attrs_construct</div>
<div class="mapi-prototype">MonoArray*
mono_custom_attrs_construct (MonoCustomAttrInfo *cinfo)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -436,7 +504,10 @@ mono_reflection_type_get_type (MonoReflectionType *reftype)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_custom_attrs_free</div>
<div class="mapi-prototype">void
mono_custom_attrs_free (MonoCustomAttrInfo *ainfo)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -451,7 +522,10 @@ mono_reflection_type_get_type (MonoReflectionType *reftype)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_custom_attrs_from_assembly</div>
<div class="mapi-prototype">MonoCustomAttrInfo*
mono_custom_attrs_from_assembly (MonoAssembly *assembly)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -466,7 +540,10 @@ mono_reflection_type_get_type (MonoReflectionType *reftype)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_custom_attrs_from_class</div>
<div class="mapi-prototype">MonoCustomAttrInfo*
mono_custom_attrs_from_class (MonoClass *klass)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -481,7 +558,10 @@ mono_reflection_type_get_type (MonoReflectionType *reftype)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_custom_attrs_from_event</div>
<div class="mapi-prototype">MonoCustomAttrInfo*
mono_custom_attrs_from_event (MonoClass *klass, MonoEvent *event)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -496,7 +576,10 @@ mono_reflection_type_get_type (MonoReflectionType *reftype)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_custom_attrs_from_field</div>
<div class="mapi-prototype">MonoCustomAttrInfo*
mono_custom_attrs_from_field (MonoClass *klass, MonoClassField *field)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -517,10 +600,10 @@ mono_custom_attrs_from_index (MonoImage *image, guint32 idx)
</div>
<p />
<div class="mapi-section">Return value</div>
<div> <code>NULL</code> if no attributes are found or if a loading error occurs.
<div> <code>NULL</code> if no attributes are found or if a loading error occurs.
</div>
<div class="mapi-section">Description</div>
<div> <p /> </div>
<div> <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -534,7 +617,10 @@ mono_custom_attrs_from_index (MonoImage *image, guint32 idx)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_custom_attrs_from_method</div>
<div class="mapi-prototype">MonoCustomAttrInfo*
mono_custom_attrs_from_method (MonoMethod *method)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -555,13 +641,11 @@ mono_custom_attrs_from_param (MonoMethod *method, guint32 param)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>method</i><td> handle to the method that we want to retrieve custom parameter information from</td></td></tr><tr><td><i>param</i><td> parameter number, where zero represent the return value, and one is the first parameter in the method</td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the custom attribute object for the specified parameter, or <code>NULL</code> if there are none.
<table class="mapi-parameters"><tbody><tr><td><i>method</i></td><td> handle to the method that we want to retrieve custom parameter information from</td></tr><tr><td><i>param</i></td><td> parameter number, where zero represent the return value, and one is the first parameter in the method</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the custom attribute object for the specified parameter, or <code>NULL</code> if there are none.
</div>
<div class="mapi-section">Description</div>
<div> <p />
The result must be released with mono_custom_attrs_free().
<p /></div>
<div> <p /> The result must be released with mono_custom_attrs_free(). <p /></div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -575,7 +659,10 @@ mono_custom_attrs_from_param (MonoMethod *method, guint32 param)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_custom_attrs_from_property</div>
<div class="mapi-prototype">MonoCustomAttrInfo*
mono_custom_attrs_from_property (MonoClass *klass, MonoProperty *property)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -590,7 +677,10 @@ mono_custom_attrs_from_param (MonoMethod *method, guint32 param)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_custom_attrs_has_attr</div>
<div class="mapi-prototype">gboolean
mono_custom_attrs_has_attr (MonoCustomAttrInfo *ainfo, MonoClass *attr_klass)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -607,7 +697,10 @@ mono_custom_attrs_from_param (MonoMethod *method, guint32 param)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_module_file_get_object</div>
<div class="mapi-prototype">MonoReflectionModule*
mono_module_file_get_object (MonoDomain *domain, MonoImage *image, int table_index)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -622,7 +715,10 @@ mono_custom_attrs_from_param (MonoMethod *method, guint32 param)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_module_get_object</div>
<div class="mapi-prototype">MonoReflectionModule*
mono_module_get_object (MonoDomain *domain, MonoImage *image)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -637,8 +733,15 @@ mono_custom_attrs_from_param (MonoMethod *method, guint32 param)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_method_body_get_object</div>
<div class="mapi-prototype">MonoReflectionMethodBody*
mono_method_body_get_object (MonoDomain *domain, MonoMethod *method)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> an app domain</td></tr><tr><td><i>method</i></td><td> a method</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> A <code>System.Reflection.MethodBody</code> object representing the method <i>method</i>.
</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -652,8 +755,16 @@ mono_custom_attrs_from_param (MonoMethod *method, guint32 param)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_event_get_object</div>
<div class="mapi-prototype">MonoReflectionEvent*
mono_event_get_object (MonoDomain *domain, MonoClass *klass, MonoEvent *event)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> an app domain</td></tr><tr><td><i>klass</i></td><td> a type</td></tr><tr><td><i>event</i></td><td> a event</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> A <code>System.Reflection.MonoEvent</code> object representing the event <i>event</i>
in class <i>klass</i>.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -667,8 +778,15 @@ mono_custom_attrs_from_param (MonoMethod *method, guint32 param)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_assembly_get_object</div>
<div class="mapi-prototype">MonoReflectionAssembly*
mono_assembly_get_object (MonoDomain *domain, MonoAssembly *assembly)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> an app domain</td></tr><tr><td><i>assembly</i></td><td> an assembly</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> a <code>System.Reflection.Assembly</code> object representing the <code>MonoAssembly</code> <i>assembly</i>.
</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -682,7 +800,10 @@ mono_custom_attrs_from_param (MonoMethod *method, guint32 param)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_param_get_objects</div>
<div class="mapi-prototype">MonoArray*
mono_param_get_objects (MonoDomain *domain, MonoMethod *method)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -697,8 +818,16 @@ mono_custom_attrs_from_param (MonoMethod *method, guint32 param)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_field_get_object</div>
<div class="mapi-prototype">MonoReflectionField*
mono_field_get_object (MonoDomain *domain, MonoClass *klass, MonoClassField *field)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> an app domain</td></tr><tr><td><i>klass</i></td><td> a type</td></tr><tr><td><i>field</i></td><td> a field</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> A <code>System.Reflection.MonoField</code> object representing the field <i>field</i>
in class <i>klass</i>.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -718,12 +847,9 @@ mono_property_get_object_checked (MonoDomain *domain, MonoClass *klass, MonoProp
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i><td> an app domain</td></td></tr><tr><td><i>klass</i><td> a type</td></td></tr><tr><td><i>property</i><td> a property</td></td></tr><tr><td><i>error</i><td> set on error</td></td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> <p />
Return an System.Reflection.MonoProperty object representing the property <i>property</i>
<table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> an app domain</td></tr><tr><td><i>klass</i></td><td> a type</td></tr><tr><td><i>property</i></td><td> a property</td></tr><tr><td><i>error</i></td><td> set on error</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> a <code>System.Reflection.MonoProperty</code> object representing the property <i>property</i>
in class <i>klass</i>. On error returns <code>NULL</code> and sets <i>error</i>.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div>
</div></body>
</html>

80
docs/deploy/mono-api-security.html
View File

@@ -200,8 +200,17 @@
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_declsec_flags_from_assembly</div>
<div class="mapi-prototype">guint32
mono_declsec_flags_from_assembly (MonoAssembly *assembly)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>assembly</i></td><td> The assembly for which we want the declarative security flags.</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the declarative security flags for the assembly.
</div>
<div class="mapi-section">Description</div>
<div> Get the security actions (in the form of flags) associated with the specified assembly.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -215,8 +224,17 @@
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_declsec_flags_from_class</div>
<div class="mapi-prototype">guint32
mono_declsec_flags_from_class (MonoClass *klass)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>klass</i></td><td> The class for which we want the declarative security flags.</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the declarative security flags for the class.
</div>
<div class="mapi-section">Description</div>
<div> Get the security actions (in the form of flags) associated with the specified class. We cache the flags inside the <code>MonoClass</code> structure as this will get called very often (at least for each method).</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -230,8 +248,17 @@
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_declsec_flags_from_method</div>
<div class="mapi-prototype">guint32
mono_declsec_flags_from_method (MonoMethod *method)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>method</i></td><td> The method for which we want the declarative security flags.</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> the declarative security flags for the method (only).
</div>
<div class="mapi-section">Description</div>
<div> Get the security actions (in the form of flags) associated with the specified method. To keep <code>MonoMethod</code> size down we do not cache the declarative security flags (except for the stack modifiers which are kept in the MonoJitInfo structure)</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -245,7 +272,10 @@
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_declsec_get_assembly_action</div>
<div class="mapi-prototype">MonoBoolean
mono_declsec_get_assembly_action (MonoAssembly *assembly, guint32 action, MonoDeclSecurityEntry *entry)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -260,7 +290,10 @@
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_declsec_get_class_action</div>
<div class="mapi-prototype">MonoBoolean
mono_declsec_get_class_action (MonoClass *klass, guint32 action, MonoDeclSecurityEntry *entry)
</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -275,8 +308,13 @@
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_declsec_get_demands</div>
<div class="mapi-prototype">MonoBoolean
mono_declsec_get_demands (MonoMethod *method, MonoDeclSecurityActions* demands)
</div>
<p />
<div class="mapi-section">Description</div>
<div> Collect all actions (that requires to generate code in mini) assigned for the specified method. Don't use the content of actions if the function return <code>FALSE</code>.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -290,8 +328,17 @@
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_declsec_get_inheritdemands_class</div>
<div class="mapi-prototype">MonoBoolean
mono_declsec_get_inheritdemands_class (MonoClass *klass, MonoDeclSecurityActions* demands)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>klass</i></td><td> The inherited class - this is the class that provides the security check (attributes)</td></tr><tr><td><i>demands</i></td><td></td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> <code>TRUE</code> if inheritance demands (any kind) are present, <code>FALSE</code> otherwise.
</div>
<div class="mapi-section">Description</div>
<div> Collect all Inherit actions - <code>InheritanceDemand</code>, <code>NonCasInheritanceDemand</code> and <code>InheritanceDemandChoice</code> (2.0). Don't use the content of actions if the function return <code>FALSE</code>.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -305,8 +352,14 @@
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_declsec_get_inheritdemands_method</div>
<div class="mapi-prototype">MonoBoolean
mono_declsec_get_inheritdemands_method (MonoMethod *method, MonoDeclSecurityActions* demands)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>actions</i></td><td> <code>InheritanceDemand</code>, <code>NonCasInheritanceDemand</code> and <code>InheritanceDemandChoice</code> (2.0).</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> Don't use the content of actions if the function return <code>FALSE</code>.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -320,10 +373,13 @@
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_declsec_get_linkdemands</div>
<div class="mapi-prototype">MonoBoolean
mono_declsec_get_linkdemands (MonoMethod *method, MonoDeclSecurityActions* klass, MonoDeclSecurityActions *cmethod)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>actions</i></td><td> <code>LinkDemand</code>, <code>NonCasLinkDemand</code> and <code>LinkDemandChoice</code> (2.0).</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div> Don't use the content of actions if the function return <code>FALSE</code>.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div>
</div></body>
</html>

Some files were not shown because too many files have changed in this diff Show More