boehm-gc/include/javaxfc.h

   1 # ifndef GC_H
   2 #   include "gc.h"
   3 # endif
   4
   5 /*
   6  * Invoke all remaining finalizers that haven't yet been run.
   7  * This is needed for strict compliance with the Java standard,
   8  * which can make the runtime guarantee that all finalizers are run.
   9  * This is problematic for several reasons:
  10  * 1) It means that finalizers, and all methods calle by them,
  11  *    must be prepared to deal with objects that have been finalized in
  12  *    spite of the fact that they are still referenced by statically
  13  *    allocated pointer variables.
  14  * 1) It may mean that we get stuck in an infinite loop running
  15  *    finalizers which create new finalizable objects, though that's
  16  *    probably unlikely.
  17  * Thus this is not recommended for general use.
  18  */
  19 void GC_finalize_all();
  20
  21 /*
  22  * A version of GC_register_finalizer that allows the object to be
  23  * finalized before the objects it references.  This is again error
  24  * prone, in that it makes it easy to accidentally reference finalized
  25  * objects.  Again, recommended only for JVM implementors.
  26  */
  27 void GC_register_finalizer_no_order(GC_PTR obj,
  28                                GC_finalization_proc fn, GC_PTR cd,
  29                                GC_finalization_proc *ofn, GC_PTR * ocd);
  30
  31 void GC_debug_register_finalizer_no_order(GC_PTR obj,
  32                                GC_finalization_proc fn, GC_PTR cd,
  33                                GC_finalization_proc *ofn, GC_PTR * ocd);
  34
  35 #ifdef GC_DEBUG
  36 #   define GC_REGISTER_FINALIZER(p, f, d, of, od) \
  37         GC_debug_register_finalizer_no_order(p, f, d, of, od)
  38 #else
  39 #   define GC_REGISTER_FINALIZER(p, f, d, of, od) \
  40         GC_register_finalizer_no_order(p, f, d, of, od)
  41 #endif