summaryrefslogtreecommitdiff
path: root/boehm-gc/include/javaxfc.h
diff options
context:
space:
mode:
Diffstat (limited to 'boehm-gc/include/javaxfc.h')
-rw-r--r--boehm-gc/include/javaxfc.h21
1 files changed, 21 insertions, 0 deletions
diff --git a/boehm-gc/include/javaxfc.h b/boehm-gc/include/javaxfc.h
new file mode 100644
index 000000000..23e01005a
--- /dev/null
+++ b/boehm-gc/include/javaxfc.h
@@ -0,0 +1,21 @@
+# ifndef GC_H
+# include "gc.h"
+# endif
+
+/*
+ * Invoke all remaining finalizers that haven't yet been run.
+ * This is needed for strict compliance with the Java standard,
+ * which can make the runtime guarantee that all finalizers are run.
+ * This is problematic for several reasons:
+ * 1) It means that finalizers, and all methods calle by them,
+ * must be prepared to deal with objects that have been finalized in
+ * spite of the fact that they are still referenced by statically
+ * allocated pointer variables.
+ * 1) It may mean that we get stuck in an infinite loop running
+ * finalizers which create new finalizable objects, though that's
+ * probably unlikely.
+ * Thus this is not recommended for general use.
+ */
+void GC_finalize_all();
+
+