Return to javaxfc.h CVS log

Up to [local] / OpenXM_contrib / gc / include

Annotation of OpenXM_contrib/gc/include/javaxfc.h, Revision 1.1.1.1

1.1       maekawa     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