1 // boehm.cc - interface between libjava and Boehm GC.
3 /* Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003 Free Software Foundation
5 This file is part of libgcj.
7 This software is copyrighted work licensed under the terms of the
8 Libgcj License. Please consult the file "LIBGCJ_LICENSE" for
15 #include <gc_config.h>
17 // Set GC_DEBUG before including gc.h!
18 #ifdef LIBGCJ_GC_DEBUG
24 #include <javaxfc.h> // GC_finalize_all declaration.
26 #ifdef THREAD_LOCAL_ALLOC
27 # define GC_REDIRECT_TO_LOCAL
28 # include <gc_local_alloc.h>
38 #include <java/lang/Class.h>
39 #include <java/lang/reflect/Modifier.h>
40 #include <java-interp.h>
42 #define MAYBE_MARK(Obj, Top, Limit, Source, Exit) \
43 Top=GC_MARK_AND_PUSH((GC_PTR)Obj, Top, Limit, (GC_PTR *)Source)
45 // `kind' index used when allocating Java arrays.
46 static int array_kind_x
;
48 // Freelist used for Java arrays.
49 static void * *array_free_list
;
53 // This is called by the GC during the mark phase. It marks a Java
54 // object. We use `void *' arguments and return, and not what the
55 // Boehm GC wants, to avoid pollution in our headers.
57 _Jv_MarkObj (void *addr
, void *msp
, void *msl
, void * env
)
59 struct GC_ms_entry
*mark_stack_ptr
= (struct GC_ms_entry
*)msp
;
60 struct GC_ms_entry
*mark_stack_limit
= (struct GC_ms_entry
*)msl
;
62 if (env
== (void *)1) /* Object allocated with debug allocator. */
63 addr
= (GC_PTR
)GC_USR_PTR_FROM_BASE(addr
);
64 jobject obj
= (jobject
) addr
;
66 _Jv_VTable
*dt
= *(_Jv_VTable
**) addr
;
67 // The object might not yet have its vtable set, or it might
68 // really be an object on the freelist. In either case, the vtable slot
69 // will either be 0, or it will point to a cleared object.
70 // This assumes Java objects have size at least 3 words,
71 // including the header. But this should remain true, since this
72 // should only be used with debugging allocation or with large objects.
73 if (__builtin_expect (! dt
|| !(dt
-> get_finalizer()), false))
74 return mark_stack_ptr
;
75 jclass klass
= dt
->clas
;
78 # ifndef JV_HASH_SYNCHRONIZATION
79 // Every object has a sync_info pointer.
80 p
= (GC_PTR
) obj
->sync_info
;
81 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, obj
, o1label
);
83 // Mark the object's class.
85 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, obj
, o2label
);
87 if (__builtin_expect (klass
== &java::lang::Class::class$
, false))
89 // Currently we allocate some of the memory referenced from class objects
90 // as pointerfree memory, and then mark it more intelligently here.
91 // We ensure that the ClassClass mark descriptor forces invocation of
93 // Correctness of this is subtle, but it looks OK to me for now. For the incremental
94 // collector, we need to make sure that the class object is written whenever
95 // any of the subobjects are altered and may need rescanning. This may be tricky
96 // during construction, and this may not be the right way to do this with
97 // incremental collection.
98 // If we overflow the mark stack, we will rescan the class object, so we should
99 // be OK. The same applies if we redo the mark phase because win32 unmapped part
100 // of our root set. - HB
101 jclass c
= (jclass
) addr
;
103 p
= (GC_PTR
) c
->name
;
104 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, c3label
);
105 p
= (GC_PTR
) c
->superclass
;
106 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, c4label
);
107 for (int i
= 0; i
< c
->constants
.size
; ++i
)
109 /* FIXME: We could make this more precise by using the tags -KKT */
110 p
= (GC_PTR
) c
->constants
.data
[i
].p
;
111 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, c5label
);
115 if (_Jv_IsInterpretedClass (c
))
117 p
= (GC_PTR
) c
->constants
.tags
;
118 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, c5alabel
);
119 p
= (GC_PTR
) c
->constants
.data
;
120 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, c5blabel
);
121 p
= (GC_PTR
) c
->vtable
;
122 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, c5clabel
);
126 // If the class is an array, then the methods field holds a
127 // pointer to the element class. If the class is primitive,
128 // then the methods field holds a pointer to the array class.
129 p
= (GC_PTR
) c
->methods
;
130 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, c6label
);
132 // The vtable might have been set, but the rest of the class
133 // could still be uninitialized. If this is the case, then
134 // c.isArray will SEGV. We check for this, and if it is the
135 // case we just return.
136 if (__builtin_expect (c
->name
== NULL
, false))
137 return mark_stack_ptr
;
139 if (! c
->isArray() && ! c
->isPrimitive())
141 // Scan each method in the cases where `methods' really
142 // points to a methods structure.
143 for (int i
= 0; i
< c
->method_count
; ++i
)
145 p
= (GC_PTR
) c
->methods
[i
].name
;
146 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
,
148 p
= (GC_PTR
) c
->methods
[i
].signature
;
149 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
,
154 // Mark all the fields.
155 p
= (GC_PTR
) c
->fields
;
156 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, c8label
);
157 for (int i
= 0; i
< c
->field_count
; ++i
)
159 _Jv_Field
* field
= &c
->fields
[i
];
161 #ifndef COMPACT_FIELDS
162 p
= (GC_PTR
) field
->name
;
163 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, c8alabel
);
165 p
= (GC_PTR
) field
->type
;
166 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, c8blabel
);
168 // For the interpreter, we also need to mark the memory
169 // containing static members
170 if ((field
->flags
& java::lang::reflect::Modifier::STATIC
))
172 p
= (GC_PTR
) field
->u
.addr
;
173 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, c8clabel
);
175 // also, if the static member is a reference,
176 // mark also the value pointed to. We check for isResolved
177 // since marking can happen before memory is allocated for
179 if (JvFieldIsRef (field
) && field
->isResolved())
181 jobject val
= *(jobject
*) field
->u
.addr
;
183 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
,
189 p
= (GC_PTR
) c
->vtable
;
190 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, c9label
);
191 p
= (GC_PTR
) c
->interfaces
;
192 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, cAlabel
);
193 for (int i
= 0; i
< c
->interface_count
; ++i
)
195 p
= (GC_PTR
) c
->interfaces
[i
];
196 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, cClabel
);
198 p
= (GC_PTR
) c
->loader
;
199 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, cBlabel
);
200 p
= (GC_PTR
) c
->arrayclass
;
201 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, cDlabel
);
202 p
= (GC_PTR
) c
->protectionDomain
;
203 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, cPlabel
);
204 p
= (GC_PTR
) c
->hack_signers
;
205 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, cSlabel
);
206 p
= (GC_PTR
) c
->aux_info
;
207 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
, cTlabel
);
210 if (_Jv_IsInterpretedClass (c
))
212 _Jv_InterpClass
* ic
= (_Jv_InterpClass
*) c
->aux_info
;
214 p
= (GC_PTR
) ic
->interpreted_methods
;
215 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, ic
, cElabel
);
217 for (int i
= 0; i
< c
->method_count
; i
++)
219 p
= (GC_PTR
) ic
->interpreted_methods
[i
];
220 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, ic
, \
223 // Mark the direct-threaded code.
224 if ((c
->methods
[i
].accflags
225 & java::lang::reflect::Modifier::NATIVE
) == 0)
228 = (_Jv_InterpMethod
*) ic
->interpreted_methods
[i
];
231 p
= (GC_PTR
) im
->prepared
;
232 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, ic
, \
237 // The interpreter installs a heap-allocated trampoline
238 // here, so we'll mark it.
239 p
= (GC_PTR
) c
->methods
[i
].ncode
;
240 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, c
,
244 p
= (GC_PTR
) ic
->field_initializers
;
245 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, ic
, cGlabel
);
253 // NOTE: each class only holds information about the class
254 // itself. So we must do the marking for the entire inheritance
255 // tree in order to mark all fields. FIXME: what about
256 // interfaces? We skip Object here, because Object only has a
257 // sync_info, and we handled that earlier.
258 // Note: occasionally `klass' can be null. For instance, this
259 // can happen if a GC occurs between the point where an object
260 // is allocated and where the vtbl slot is set.
261 while (klass
&& klass
!= &java::lang::Object::class$
)
263 jfieldID field
= JvGetFirstInstanceField (klass
);
264 jint max
= JvNumInstanceFields (klass
);
266 for (int i
= 0; i
< max
; ++i
)
268 if (JvFieldIsRef (field
))
270 jobject val
= JvGetObjectField (obj
, field
);
272 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
,
275 field
= field
->getNextField ();
277 klass
= klass
->getSuperclass();
281 return mark_stack_ptr
;
284 // This is called by the GC during the mark phase. It marks a Java
285 // array (of objects). We use `void *' arguments and return, and not
286 // what the Boehm GC wants, to avoid pollution in our headers.
288 _Jv_MarkArray (void *addr
, void *msp
, void *msl
, void * env
)
290 struct GC_ms_entry
*mark_stack_ptr
= (struct GC_ms_entry
*)msp
;
291 struct GC_ms_entry
*mark_stack_limit
= (struct GC_ms_entry
*)msl
;
293 if (env
== (void *)1) /* Object allocated with debug allocator. */
294 addr
= (void *)GC_USR_PTR_FROM_BASE(addr
);
295 jobjectArray array
= (jobjectArray
) addr
;
297 _Jv_VTable
*dt
= *(_Jv_VTable
**) addr
;
298 // Assumes size >= 3 words. That's currently true since arrays have
299 // a vtable, sync pointer, and size. If the sync pointer goes away,
300 // we may need to round up the size.
301 if (__builtin_expect (! dt
|| !(dt
-> get_finalizer()), false))
302 return mark_stack_ptr
;
303 jclass klass
= dt
->clas
;
306 # ifndef JV_HASH_SYNCHRONIZATION
307 // Every object has a sync_info pointer.
308 p
= (GC_PTR
) array
->sync_info
;
309 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, array
, e1label
);
311 // Mark the object's class.
313 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, &(dt
-> clas
), o2label
);
315 for (int i
= 0; i
< JvGetArrayLength (array
); ++i
)
317 jobject obj
= elements (array
)[i
];
319 MAYBE_MARK (p
, mark_stack_ptr
, mark_stack_limit
, array
, e2label
);
322 return mark_stack_ptr
;
325 // Generate a GC marking descriptor for a class.
327 // We assume that the gcj mark proc has index 0. This is a dubious assumption,
328 // since another one could be registered first. But the compiler also
329 // knows this, so in that case everything else will break, too.
330 #define GCJ_DEFAULT_DESCR GC_MAKE_PROC(GC_GCJ_RESERVED_MARK_PROC_INDEX,0)
333 _Jv_BuildGCDescr(jclass self
)
336 jint bits_per_word
= CHAR_BIT
* sizeof (void *);
338 // Note: for now we only consider a bitmap mark descriptor. We
339 // could also handle the case where the first N fields of a type are
340 // references. However, this is not very likely to be used by many
341 // classes, and it is easier to compute things this way.
343 // The vtable pointer.
344 desc
|= 1ULL << (bits_per_word
- 1);
345 #ifndef JV_HASH_SYNCHRONIZATION
346 // The sync_info field.
347 desc
|= 1ULL << (bits_per_word
- 2);
350 for (jclass klass
= self
; klass
!= NULL
; klass
= klass
->getSuperclass())
352 jfieldID field
= JvGetFirstInstanceField(klass
);
353 int count
= JvNumInstanceFields(klass
);
355 for (int i
= 0; i
< count
; ++i
)
359 unsigned int off
= field
->getOffset();
360 // If we run into a weird situation, we bail.
361 if (off
% sizeof (void *) != 0)
362 return (void *) (GCJ_DEFAULT_DESCR
);
363 off
/= sizeof (void *);
364 // If we find a field outside the range of our bitmap,
365 // fall back to procedure marker. The bottom 2 bits are
367 if (off
>= (unsigned)bits_per_word
- 2)
368 return (void *) (GCJ_DEFAULT_DESCR
);
369 desc
|= 1ULL << (bits_per_word
- off
- 1);
372 field
= field
->getNextField();
376 // For bitmap mark type, bottom bits are 01.
378 // Bogus warning avoidance (on many platforms).
379 return (void *) (unsigned long) desc
;
382 // Allocate some space that is known to be pointer-free.
384 _Jv_AllocBytes (jsize size
)
386 void *r
= GC_MALLOC_ATOMIC (size
);
387 // We have to explicitly zero memory here, as the GC doesn't
388 // guarantee that PTRFREE allocations are zeroed. Note that we
389 // don't have to do this for other allocation types because we set
390 // the `ok_init' flag in the type descriptor.
395 #ifdef LIBGCJ_GC_DEBUG
398 _Jv_AllocObj (jsize size
, jclass klass
)
400 return GC_GCJ_MALLOC (size
, klass
->vtable
);
404 _Jv_AllocPtrFreeObj (jsize size
, jclass klass
)
406 #ifdef JV_HASH_SYNCHRONIZATION
407 void * obj
= GC_MALLOC_ATOMIC(size
);
408 *((_Jv_VTable
**) obj
) = klass
->vtable
;
410 void * obj
= GC_GCJ_MALLOC(size
, klass
->vtable
);
415 #endif /* LIBGCJ_GC_DEBUG */
416 // In the non-debug case, the above two functions are defined
417 // as inline functions in boehm-gc.h. In the debug case we
418 // really want to take advantage of the definitions in gc_gcj.h.
420 // Allocate space for a new Java array.
421 // Used only for arrays of objects.
423 _Jv_AllocArray (jsize size
, jclass klass
)
427 #ifdef LIBGCJ_GC_DEBUG
428 // There isn't much to lose by scanning this conservatively.
429 // If we didn't, the mark proc would have to understand that
430 // it needed to skip the header.
431 obj
= GC_MALLOC(size
);
433 const jsize min_heap_addr
= 16*1024;
434 // A heuristic. If size is less than this value, the size
435 // stored in the array can't possibly be misinterpreted as
436 // a pointer. Thus we lose nothing by scanning the object
437 // completely conservatively, since no misidentification can
440 if (size
< min_heap_addr
)
441 obj
= GC_MALLOC(size
);
443 obj
= GC_generic_malloc (size
, array_kind_x
);
445 *((_Jv_VTable
**) obj
) = klass
->vtable
;
449 /* Allocate space for a new non-Java object, which does not have the usual
450 Java object header but may contain pointers to other GC'ed objects. */
452 _Jv_AllocRawObj (jsize size
)
454 return (void *) GC_MALLOC (size
);
458 call_finalizer (GC_PTR obj
, GC_PTR client_data
)
460 _Jv_FinalizerFunc
*fn
= (_Jv_FinalizerFunc
*) client_data
;
461 jobject jobj
= (jobject
) obj
;
467 _Jv_RegisterFinalizer (void *object
, _Jv_FinalizerFunc
*meth
)
469 GC_REGISTER_FINALIZER_NO_ORDER (object
, call_finalizer
, (GC_PTR
) meth
,
474 _Jv_RunFinalizers (void)
476 GC_invoke_finalizers ();
480 _Jv_RunAllFinalizers (void)
492 _Jv_GCTotalMemory (void)
494 return GC_get_heap_size ();
498 _Jv_GCFreeMemory (void)
500 return GC_get_free_bytes ();
504 _Jv_GCSetInitialHeapSize (size_t size
)
506 size_t current
= GC_get_heap_size ();
508 GC_expand_hp (size
- current
);
512 _Jv_GCSetMaximumHeapSize (size_t size
)
514 GC_set_max_heap_size ((GC_word
) size
);
517 // From boehm's misc.c
518 extern "C" void GC_enable();
519 extern "C" void GC_disable();
533 static void * handle_out_of_memory(size_t)
539 gcj_describe_type_fn(void *obj
, char *out_buf
)
541 _Jv_VTable
*dt
= *(_Jv_VTable
**) obj
;
543 if (! dt
/* Shouldn't happen */)
545 strcpy(out_buf
, "GCJ (bad)");
548 jclass klass
= dt
->clas
;
549 if (!klass
/* shouldn't happen */)
551 strcpy(out_buf
, "GCJ (bad)");
554 jstring name
= klass
-> getName();
555 size_t len
= name
-> length();
556 if (len
>= GC_TYPE_DESCR_LEN
) len
= GC_TYPE_DESCR_LEN
- 1;
557 JvGetStringUTFRegion (name
, 0, len
, out_buf
);
566 // Ignore pointers that do not point to the start of an object.
567 GC_all_interior_pointers
= 0;
569 // Configure the collector to use the bitmap marking descriptors that we
570 // stash in the class vtable.
571 // We always use mark proc descriptor 0, since the compiler knows
573 GC_init_gcj_malloc (0, (void *) _Jv_MarkObj
);
575 // Cause an out of memory error to be thrown from the allocators,
576 // instead of returning 0. This is cheaper than checking on allocation.
577 GC_oom_fn
= handle_out_of_memory
;
579 GC_java_finalization
= 1;
581 // We use a different mark procedure for object arrays. This code
582 // configures a different object `kind' for object array allocation and
584 array_free_list
= GC_new_free_list();
585 proc
= GC_new_proc((GC_mark_proc
)_Jv_MarkArray
);
586 array_kind_x
= GC_new_kind(array_free_list
, GC_MAKE_PROC (proc
, 0), 0, 1);
588 /* Arrange to have the GC print Java class names in backtraces, etc. */
589 GC_register_describe_type_fn(GC_gcj_kind
, gcj_describe_type_fn
);
590 GC_register_describe_type_fn(GC_gcj_debug_kind
, gcj_describe_type_fn
);
593 #ifdef JV_HASH_SYNCHRONIZATION
594 // Allocate an object with a fake vtable pointer, which causes only
595 // the first field (beyond the fake vtable pointer) to be traced.
596 // Eventually this should probably be generalized.
598 static _Jv_VTable trace_one_vtable
= {
600 (void *)(2 * sizeof(void *)),
601 // descriptor; scan 2 words incl. vtable ptr.
602 // Least significant bits must be zero to
603 // identify this as a length descriptor
608 _Jv_AllocTraceOne (jsize size
/* includes vtable slot */)
610 return GC_GCJ_MALLOC (size
, &trace_one_vtable
);
613 // Ditto for two words.
614 // the first field (beyond the fake vtable pointer) to be traced.
615 // Eventually this should probably be generalized.
617 static _Jv_VTable trace_two_vtable
=
620 (void *)(3 * sizeof(void *)),
621 // descriptor; scan 3 words incl. vtable ptr.
626 _Jv_AllocTraceTwo (jsize size
/* includes vtable slot */)
628 return GC_GCJ_MALLOC (size
, &trace_two_vtable
);
631 #endif /* JV_HASH_SYNCHRONIZATION */
634 _Jv_GCInitializeFinalizers (void (*notifier
) (void))
636 GC_finalize_on_demand
= 1;
637 GC_finalizer_notifier
= notifier
;
641 _Jv_GCRegisterDisappearingLink (jobject
*objp
)
643 GC_general_register_disappearing_link ((GC_PTR
*) objp
, (GC_PTR
) *objp
);
647 _Jv_GCCanReclaimSoftReference (jobject
)
649 // For now, always reclaim soft references. FIXME.