[gc] Make mono_gc_init_finalizer_thread a public API

It was already used by Xamarin.iOS but wasn't in a public header and required
compiling with --disable-visibility-hidden in order to dlsym the symbol.

If --with-lazy-gc-thread-creation is used, embedders must call this function to
create the finalizer therad.  Otherwise the function does nothing and the
runtime will create the finalizer thread automatically.

diff --git a/src/mono/mono/metadata/gc.c b/src/mono/mono/metadata/gc.c
index d9fe1af..f81963b 100644 (file)
--- a/src/mono/mono/metadata/gc.c
+++ b/src/mono/mono/metadata/gc.c
@@ -999,17 +999,32 @@ finalizer_thread (gpointer unused)
        return 0;
 }
 
-#ifndef LAZY_GC_THREAD_CREATION
-static
-#endif
-void
-mono_gc_init_finalizer_thread (void)
+static void
+init_finalizer_thread (void)
 {
        ERROR_DECL (error);
        gc_thread = mono_thread_create_internal (mono_domain_get (), (gpointer)finalizer_thread, NULL, MONO_THREAD_CREATE_FLAGS_NONE, error);
        mono_error_assert_ok (error);
 }
 
+/**
+ * mono_gc_init_finalizer_thread:
+ *
+ * If the runtime is compiled with --with-lazy-gc-thread-creation, this
+ * function must be called by embedders to create the finalizer. Otherwise, the
+ * function does nothing and the runtime creates the finalizer thread
+ * automatically.
+ */
+void
+mono_gc_init_finalizer_thread (void)
+{
+#ifndef LAZY_GC_THREAD_CREATION
+       /* do nothing */
+#else
+       init_finalizer_thread ();
+#endif
+}
+
 static void
 reference_queue_mutex_init (void)
 {
@@ -1048,7 +1063,7 @@ mono_gc_init (void)
 
 #ifndef LAZY_GC_THREAD_CREATION
        if (!mono_runtime_get_no_exec ())
-               mono_gc_init_finalizer_thread ();
+               init_finalizer_thread ();
 #endif
 }
 

diff --git a/src/mono/mono/metadata/mono-gc.h b/src/mono/mono/metadata/mono-gc.h
index 86111ac..72c768e 100644 (file)
--- a/src/mono/mono/metadata/mono-gc.h
+++ b/src/mono/mono/metadata/mono-gc.h
@@ -123,6 +123,9 @@ MONO_API int    mono_gc_invoke_finalizers (void);
 /* heap walking is only valid in the pre-stop-world event callback */
 MONO_API int    mono_gc_walk_heap        (int flags, MonoGCReferences callback, void *data);
 
+MONO_API MONO_RT_EXTERNAL_ONLY void
+mono_gc_init_finalizer_thread (void);
+
 MONO_END_DECLS
 
 #endif /* __METADATA_MONO_GC_H__ */