Imported Upstream version 6.0.0.172

Former-commit-id: f3cc9b82f3e5bd8f0fd3ebc098f789556b44e9cd
This commit is contained in:
Xamarin Public Jenkins (auto-signing)
2019-04-12 14:10:50 +00:00
parent 8016999e4d
commit 64ac736ec5
32155 changed files with 3981439 additions and 75368 deletions

View File

@@ -1007,7 +1007,7 @@ mono_class_inflate_generic_type (MonoType *type, MonoGenericContext *context)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">gboolean
<div class="mapi-prototype">mono_bool
mono_class_init (MonoClass *klass)
</div>
@@ -1020,8 +1020,8 @@ mono_class_init (MonoClass *klass)
<div class="mapi-section">Description</div>
<div>
<p />
Compute the <code>instance_size</code>, <code>class_size</code> and other infos that cannot be
computed at <code>mono_class_get</code> time. Also compute vtable_size if possible.
Compute the <code>instance_size</code>, <code>class_size</code> and other infos that cannot be
computed at <code>mono_class_get</code> time. Also compute vtable_size if possible.
Initializes the following fields in <i>klass</i>:
- all the fields initialized by <code>mono_class_init_sizes</code>
- has_cctor

View File

@@ -796,8 +796,8 @@ mono_set_config_dir (const char *dir)
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">void
mono_runtime_exec_managed_code (MonoDomain *domain,
MonoMainThreadFunc main_func,
gpointer main_args)
MonoMainThreadFunc mfunc,
gpointer margs)
</div>
<p />

View File

@@ -231,7 +231,7 @@
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">void
mono_raise_exception (MonoException *ex)
mono_raise_exception (MonoException *ex)
</div>
<p />
@@ -254,21 +254,20 @@ mono_raise_exception (MonoException *ex)
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">void
mono_unhandled_exception_checked (MonoObjectHandle exc, MonoError *error)
mono_unhandled_exception (MonoObject *exc)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>exc</i></td><td> exception thrown</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div>
<p />
This is a VM internal routine.
<p />
We call this function when we detect an unhandled exception
in the default domain.
<p />
It invokes the * UnhandledException event in AppDomain or prints
a warning to the console </div>
It invokes the <code>UnhandledException</code> event in <code>AppDomain</code> or prints
a warning to the console</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -283,7 +282,7 @@ mono_unhandled_exception_checked (MonoObjectHandle exc, MonoError *error)
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">void
mono_print_unhandled_exception (MonoObject *exc)
mono_print_unhandled_exception_internal (MonoObject *exc)
</div>
<p />

View File

@@ -632,10 +632,7 @@ mono_gc_wait_for_bridge_processing (void)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">void
mono_gc_wbarrier_arrayref_copy (gpointer dest_ptr, gpointer src_ptr, int count)
</div>
<div class="mapi-prototype">mono_gc_wbarrier_arrayref_copy</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -650,10 +647,7 @@ mono_gc_wbarrier_arrayref_copy (gpointer dest_ptr, gpointer src_ptr, int count)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">void
mono_gc_wbarrier_generic_nostore (gpointer ptr)
</div>
<div class="mapi-prototype">mono_gc_wbarrier_generic_nostore</div>
<p />
</div><!--mapi-description -->
</div><!--height container -->
@@ -669,7 +663,7 @@ mono_gc_wbarrier_generic_nostore (gpointer ptr)
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">void
mono_gc_wbarrier_generic_store (gpointer ptr, GCObject* value)
mono_gc_wbarrier_generic_store (void* ptr, MonoObject* value)
</div>
<p />
@@ -686,15 +680,8 @@ mono_gc_wbarrier_generic_store (gpointer ptr, GCObject* value)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">void
mono_gc_wbarrier_generic_store_atomic (gpointer ptr, GCObject *value)
</div>
<div class="mapi-prototype">mono_gc_wbarrier_generic_store_atomic</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 -->
@@ -731,7 +718,7 @@ mono_gc_wbarrier_object_copy (MonoObject* obj, MonoObject *src)
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">void
mono_gc_wbarrier_set_arrayref (MonoArray *arr, gpointer slot_ptr, MonoObject* value)
mono_gc_wbarrier_set_arrayref (MonoArray *arr, void* slot_ptr, MonoObject* value)
</div>
<p />
@@ -749,7 +736,7 @@ mono_gc_wbarrier_set_arrayref (MonoArray *arr, gpointer slot_ptr, MonoObject* va
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">void
mono_gc_wbarrier_set_field (MonoObject *obj, gpointer field_ptr, MonoObject* value)
mono_gc_wbarrier_set_field (MonoObject *obj, void* field_ptr, MonoObject* value)
</div>
<p />

View File

@@ -296,16 +296,18 @@ mono_gchandle_free (o_handle);
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">guint32
mono_gchandle_new (MonoObject *obj, gboolean pinned)
mono_gchandle_new_internal (MonoObject *obj, gboolean pinned)
</div>
<p />
<div class="mapi-section">Parameters</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> 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.
@@ -328,8 +330,8 @@ mono_gchandle_new (MonoObject *obj, gboolean pinned)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">guint32
mono_gchandle_new_weakref (GCObject *obj, gboolean track_resurrection)
<div class="mapi-prototype">uint32_t
mono_gchandle_new_weakref (MonoObject *obj, mono_bool track_resurrection)
</div>
<p />
@@ -343,7 +345,7 @@ mono_gchandle_new_weakref (GCObject *obj, gboolean track_resurrection)
<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
Unlike the <code>mono_gchandle_new_internal</code> the object can be reclaimed by the
garbage collector. In this case the value of the GCHandle will be
set to zero.
<p />
@@ -368,20 +370,20 @@ mono_gchandle_new_weakref (GCObject *obj, gboolean track_resurrection)
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">MonoObject*
mono_gchandle_get_target (guint32 gchandle)
mono_gchandle_get_target_internal (guint32 gchandle)
</div>
<p />
<div class="mapi-section">Parameters</div>
<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
<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>.
The handle was previously created by calling <code>mono_gchandle_new_internal</code> or
<code>mono_gchandle_new_weakref</code>.
<p /></div>
</div><!--mapi-description -->
</div><!--height container -->

View File

@@ -340,14 +340,14 @@ mono_marshal_alloc (gsize size, MonoError *error)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">static gpointer
mono_marshal_asany_handle (MonoObjectHandle o, MonoMarshalNative string_encoding, int param_attrs, MonoError *error)
<div class="mapi-prototype">gpointer
mono_marshal_asany_impl (MonoObjectHandle o, MonoMarshalNative string_encoding, int param_attrs, MonoError *error)
</div>
<p />
<div class="mapi-section">Description</div>
<div>
This is a JIT icall, it sets the pending exception and returns <code>NULL</code> on error.</div>
This is a JIT icall, it sets the pending exception (in wrapper) and returns <code>NULL</code> on error.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -380,13 +380,13 @@ mono_marshal_free_array (gpointer *ptr, int size)
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">void
mono_marshal_free_asany (MonoObject *o, gpointer ptr, MonoMarshalNative string_encoding, int param_attrs)
mono_marshal_free_asany_impl (MonoObjectHandle o, gpointer ptr, MonoMarshalNative string_encoding, int param_attrs, MonoError *error)
</div>
<p />
<div class="mapi-section">Description</div>
<div>
This is a JIT icall, it sets the pending exception</div>
This is a JIT icall, it sets the pending exception (in wrapper)</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->

View File

@@ -886,7 +886,7 @@ mono_runtime_invoke (MonoMethod *method, void *obj, void **params, MonoObject **
<p />
The params array contains the arguments to the method with the
same convention: <code>MonoObject*</code> pointers for object instances and
pointers to the value type otherwise.
pointers to the value type otherwise.
<p />
From unmanaged code you'll usually use the
<code>mono_runtime_invoke</code> variant.

View File

@@ -493,12 +493,12 @@ mono_object_get_domain (MonoObject *obj)
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">MonoMethod*
mono_object_get_virtual_method (MonoObject *obj_raw, MonoMethod *method)
mono_object_get_virtual_method (MonoObject *obj, MonoMethod *method)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>obj</i></td><td> object to operate on.</td></tr><tr><td><i>method</i></td><td> method </td></tr></tbody></table> <div class="mapi-section">Description</div>
<table class="mapi-parameters"><tbody><tr><td><i>obj</i></td><td> object to operate on.</td></tr><tr><td><i>method</i></td><td> method</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div>
Retrieves the <code>MonoMethod</code> that would be called on <i>obj</i> if <i>obj</i> is passed as
the instance of a callvirt of <i>method</i>.</div>
@@ -539,7 +539,7 @@ mono_object_isinst (MonoObject *obj_raw, MonoClass *klass)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>obj</i></td><td> an object</td></tr><tr><td><i>klass</i></td><td> a pointer to a class </td></tr></tbody></table> <div class="mapi-section">Return value</div>
<table class="mapi-parameters"><tbody><tr><td><i>obj</i></td><td> an object</td></tr><tr><td><i>klass</i></td><td> a pointer to a class</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> <i>obj</i> if <i>obj</i> is derived from <i>klass</i> or <code>NULL</code> otherwise.
</div>
</div><!--mapi-description -->
@@ -555,7 +555,7 @@ mono_object_isinst (MonoObject *obj_raw, MonoClass *klass)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">gpointer
<div class="mapi-prototype">void*
mono_object_unbox (MonoObject *obj)
</div>
@@ -586,7 +586,7 @@ mono_object_castclass_mbyref (MonoObject *obj_raw, MonoClass *klass)
</div>
<p />
<div class="mapi-section">Parameters</div>
<table class="mapi-parameters"><tbody><tr><td><i>obj</i></td><td> an object</td></tr><tr><td><i>klass</i></td><td> a pointer to a class </td></tr></tbody></table> <div class="mapi-section">Return value</div>
<table class="mapi-parameters"><tbody><tr><td><i>obj</i></td><td> an object</td></tr><tr><td><i>klass</i></td><td> a pointer to a class</td></tr></tbody></table> <div class="mapi-section">Return value</div>
<div> <i>obj</i> if <i>obj</i> is derived from <i>klass</i>, returns <code>NULL</code> otherwise.
</div>
</div><!--mapi-description -->
@@ -602,8 +602,8 @@ mono_object_castclass_mbyref (MonoObject *obj_raw, MonoClass *klass)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">guint
mono_object_get_size (MonoObject* o)
<div class="mapi-prototype">unsigned
mono_object_get_size (MonoObject *o)
</div>
<p />
@@ -711,7 +711,7 @@ mono_value_copy (gpointer dest, gpointer src, MonoClass *klass)
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">void
mono_value_copy_array (MonoArray *dest, int dest_idx, gpointer src, int count)
mono_value_copy_array (MonoArray *dest, int dest_idx, void* src, int count)
</div>
<p />
@@ -893,7 +893,7 @@ mono_array_clone (MonoArray *array)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">Type mono_array_get (MonoArray *array, Type element_type, uintptr_t index)
<div class="mapi-prototype">Type mono_array_get_internal (MonoArray *array, Type element_type, uintptr_t index)
</div>
<p />
@@ -1218,7 +1218,7 @@ mono_field_get_value (MonoObject *obj, MonoClassField *field, void *value)
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">MonoObject*
mono_field_get_value_object (MonoDomain *domain, MonoClassField *field, MonoObject *obj)
</div>
<p />
<div class="mapi-section">Parameters</div>
@@ -1495,7 +1495,7 @@ mono_property_get_value (MonoProperty *prop, void *obj, void **params, MonoObjec
<div class="mapi-section">Description</div>
<div>
Invokes the property's <code>get</code> method with the given arguments on the
object instance <i>obj</i> (or <code>NULL</code> for static properties).
object instance <i>obj</i> (or <code>NULL</code> for static properties).
<p />
You can pass <code>NULL</code> as the <i>exc</i> argument if you don't want to
catch exceptions, otherwise, <code>*exc</code> will be set to the exception
@@ -1524,7 +1524,7 @@ mono_property_set_value (MonoProperty *prop, void *obj, void **params, MonoObjec
<table class="mapi-parameters"><tbody><tr><td><i>prop</i></td><td> MonoProperty to set</td></tr><tr><td><i>obj</i></td><td> instance object on which to act</td></tr><tr><td><i>params</i></td><td> parameters to pass to the propery</td></tr><tr><td><i>exc</i></td><td> optional exception</td></tr></tbody></table> <div class="mapi-section">Description</div>
<div>
Invokes the property's set method with the given arguments on the
object instance obj (or <code>NULL</code> for static properties).
object instance obj (or <code>NULL</code> for static properties).
<p />
You can pass <code>NULL</code> as the exc argument if you don't want to
catch exceptions, otherwise, <code>*exc</code> will be set to the exception

View File

@@ -721,13 +721,6 @@ mono_profiler_enable_call_context_introspection (void)
functions (they will simply return <code><code>NULL</code>)</code>. Returns <code><code>TRUE</code></code> if call context
introspection was enabled, or <code><code>FALSE</code></code> if the function was called too late for
this to be possible.
<p />
Please note: Mono's LLVM backend does not support this feature. This means
that methods with call context instrumentation will be handled by Mono's
JIT even in LLVM mode. There is also a special case when Mono is compiling
in LLVM-only mode: Since LLVM does not provide a way to implement call
contexts, a <code><code>NULL</code></code> context will always be passed to enter/leave events even
though this method returns <code><code>TRUE</code></code>.
<p />
This function is <strong>not</strong> async safe.
<p />

View File

@@ -408,7 +408,7 @@ mono_string_from_utf32 (/*const*/ mono_unichar4 *data)
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_unichar2*
mono_string_to_utf16 (MonoString *s)
mono_string_to_utf16 (MonoString *string_obj)
</div>
<p />
@@ -425,7 +425,7 @@ mono_string_to_utf16 (MonoString *s)
<a name="api:mono_string_to_utf8"></a>
<div class="mapi">
<div class="mapi-entry mapi-strike"><code>mono_string_to_utf8</code></div><br /><div class='mapi-deprecated'><b>Deprecated:</b> Use <code>mono_string_to_utf8_checked</code> to avoid having an exception arbitrarily raised.</div>
<div class="mapi-entry mapi-strike"><code>mono_string_to_utf8</code></div><br /><div class='mapi-deprecated'><b>Deprecated:</b> Use <code>mono_string_to_utf8_checked_internal</code> to avoid having an exception arbitrarily raised.</div>
<div class="mapi-height-container">
<div class="mapi-ptr-container"></div>
<div class="mapi-description">
@@ -456,7 +456,7 @@ mono_string_to_utf8 (MonoString *s)
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">char*
mono_string_to_utf8_checked (MonoString *s, MonoError *error)
mono_string_to_utf8_checked (MonoString *string_obj, MonoError *error)
</div>
<p />
@@ -480,7 +480,7 @@ mono_string_to_utf8_checked (MonoString *s, MonoError *error)
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">mono_unichar4*
mono_string_to_utf32 (MonoString *s)
mono_string_to_utf32 (MonoString *string_obj)
</div>
<p />
@@ -559,7 +559,7 @@ mono_string_hash (MonoString *s)
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">MonoString*
mono_string_intern (MonoString *str)
mono_string_intern (MonoString *str_raw)
</div>
<p />
@@ -569,7 +569,7 @@ mono_string_intern (MonoString *str)
</div>
<div class="mapi-section">Description</div>
<div>
Interns the string passed. </div>
Interns the string passed.</div>
</div><!--mapi-description -->
</div><!--height container -->
</div> <!-- class=mapi -->
@@ -584,7 +584,7 @@ mono_string_intern (MonoString *str)
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">MonoString*
mono_string_is_interned (MonoString *o)
mono_string_is_interned (MonoString *str_raw)
</div>
<p />
@@ -627,7 +627,7 @@ mono_string_new_wrapper (const char *text)
<div class="mapi-ptr"></div>
<div class="mapi-declaration mapi-section">Syntax</div>
<div class="mapi-prototype">gunichar2*
<div class="mapi-prototype">mono_unichar2*
mono_string_chars (MonoString *s)
</div>

View File

@@ -325,7 +325,7 @@ mono_type_get_class (MonoType *type)
<div class="mapi-section">Description</div>
<div>
It is only valid to call this function if <i>type</i> is a <code>MONO_TYPE_CLASS</code> or a
<code>MONO_TYPE_VALUETYPE</code> . For more general functionality, use <code>mono_class_from_mono_type</code>,
<code>MONO_TYPE_VALUETYPE</code> . For more general functionality, use <code>mono_class_from_mono_type_internal</code>,
instead.</div>
</div><!--mapi-description -->
</div><!--height container -->