gc.h

kaffe Java 解释器语言,源码,Java的子集系统,开放源代码

/*
 * gc.h
 * The garbage collector.
 *
 * Copyright (c) 1996, 1997
 *	Transvirtual Technologies, Inc.  All rights reserved.
 *
 * See the file "license.terms" for information on usage and redistribution 
 * of this file. 
 */

#ifndef __gc_h
#define __gc_h

/* 
 * We do not support incremental collection as this time.
 */
#undef	GC_INCREMENTAL

typedef struct _Collector Collector;
typedef void (*walk_func_t)(struct _Collector*, void*, uint32);
typedef void (*final_func_t)(struct _Collector*, void*);
typedef void (*destroy_func_t)(struct _Collector*, void*);

#define	GC_OBJECT_NORMAL	((final_func_t)0)
#define	GC_OBJECT_FIXED		((final_func_t)1)

/* Use the incremental garbage collector */
#ifndef KAFFEH
#include "mem/gc-incremental.h"
#endif

/*
 * Garbage collector interface.
 */
/* allocation types for different kinds of java objects */
#define	GC_ALLOC_JAVASTRING	0
#define	GC_ALLOC_NOWALK		1
#define	GC_ALLOC_NORMALOBJECT	2
#define	GC_ALLOC_PRIMARRAY	3
#define	GC_ALLOC_REFARRAY	4
#define	GC_ALLOC_FINALIZEOBJECT	5
#define	GC_ALLOC_JAVALOADER     6

/* allocation types related to the translator engines */
#define	GC_ALLOC_JITCODE	7
#define	GC_ALLOC_JITTEMP	8
#define	GC_ALLOC_JIT_SEQ	9	
#define	GC_ALLOC_JIT_CONST	10
#define	GC_ALLOC_JIT_ARGS	11
#define	GC_ALLOC_JIT_FAKE_CALL	12
#define	GC_ALLOC_JIT_SLOTS	13
#define	GC_ALLOC_JIT_CODEBLOCK	14
#define	GC_ALLOC_JIT_LABELS	15
#define	GC_ALLOC_TRAMPOLINE	16

/* allocation types used for java.lang.Class and its parts */
#define	GC_ALLOC_CLASSOBJECT	17
#define	GC_ALLOC_BYTECODE	18
#define	GC_ALLOC_EXCEPTIONTABLE	19
#define	GC_ALLOC_STATICDATA	20
#define	GC_ALLOC_CONSTANT	21
#define	GC_ALLOC_DISPATCHTABLE  22
#define	GC_ALLOC_METHOD         23
#define	GC_ALLOC_FIELD          24
#define	GC_ALLOC_INTERFACE      25
#define	GC_ALLOC_LINENRTABLE	26
#define	GC_ALLOC_DECLAREDEXC	27
#define	GC_ALLOC_CLASSMISC	28

/* miscelanious allocation types */
#define	GC_ALLOC_FIXED         	29
#define	GC_ALLOC_UTF8CONST	30
#define	GC_ALLOC_LOCK          	31
#define	GC_ALLOC_THREADCTX      32
#define	GC_ALLOC_REF            33
#define	GC_ALLOC_JAR            34
#define	GC_ALLOC_CODEANALYSE    35
#define	GC_ALLOC_CLASSPOOL	36
#define	GC_ALLOC_VERIFIER	37
#define	GC_ALLOC_NATIVELIB	38
#define	GC_ALLOC_MAX_INDEX	39

/*
 * Define a COM-like GC interface.
 */
struct GarbageCollectorInterface_Ops;

struct _Collector {
	struct GarbageCollectorInterface_Ops *ops;
};

struct GarbageCollectorInterface_Ops {

	void*   reserved1;
	void*   reserved2;
	void*   reserved3;
	void*	(*malloc)(Collector *, size_t size, int type);
	void*	(*realloc)(Collector *, void* addr, size_t size, int type);
	void	(*free)(Collector *, void* addr);

	void	(*invoke)(Collector *, int mustgc);
	void	(*invokeFinalizer)(Collector *);
	void	(*init)(Collector *);
	void	(*enable)(Collector *);

	void	(*markAddress)(Collector *, const void* addr);
	void	(*markObject)(Collector *, const void* obj);
	uint32	(*getObjectSize)(Collector *, const void* obj);
	const char* (*getObjectDescription)(Collector *, const void* obj);
	int	(*getObjectIndex)(Collector *, const void* obj);
	void*	(*getObjectBase)(Collector *, const void* obj);

	void	(*walkMemory)(Collector *, void *addr);
	void	(*walkConservative)(Collector *, 
			const void* addr, uint32 length);

	void	(*registerFixedTypeByIndex)(Collector *, 
			int index, const char *description);

	void 	(*registerGcTypeByIndex)(Collector *, 
			int index,
			walk_func_t walk, final_func_t final, 
			destroy_func_t destroy, const char
					 *description);
	struct Hjava_lang_Throwable *(*throwOOM)(Collector *);

	void 	(*enableGC)(Collector *);
	void 	(*disableGC)(Collector *);
};

Collector* createGC(void (*_walkRootSet)(Collector*));

/*
 * Convenience macros
 */
#define GC_malloc(G, size, type)	\
    ((G)->ops->malloc)((Collector*)(G), (size), (type))
#define GC_realloc(G, addr, size, type)	\
    ((G)->ops->realloc)((Collector*)(G), (addr), (size), (type))
#define GC_free(G, addr)		\
    ((G)->ops->free)((Collector*)(G), (addr))
#define GC_invoke(G, mustgc)		\
    ((G)->ops->invoke)((Collector*)(G), (mustgc))
#define GC_invokeFinalizer(G)		\
    ((G)->ops->invokeFinalizer)((Collector*)(G))
#define GC_init(G)		\
    ((G)->ops->init)((Collector*)(G))
#define GC_enable(G)		\
    ((G)->ops->enable)((Collector*)(G))
#define GC_throwOOM(G)		\
    ((G)->ops->throwOOM)((Collector*)(G))
#define GC_markAddress(G, addr)		\
    ((G)->ops->markAddress)((Collector*)(G), (addr))

#if !defined(KAFFEH)
static inline void GC_markObject(void *g, void *addr)
{
	if (addr)
		((Collector*) g)->ops->markObject((Collector*) g, addr);
}
#endif

#define GC_getObjectSize(G, obj)	\
    ((G)->ops->getObjectSize)((Collector*)(G), (obj))
#define GC_getObjectDescription(G, obj)	\
    ((G)->ops->getObjectDescription)((Collector*)(G), (obj))
#define GC_getObjectIndex(G, obj)	\
    ((G)->ops->getObjectIndex)((Collector*)(G), (obj))
#define GC_getObjectBase(G, obj)	\
    ((G)->ops->getObjectBase)((Collector*)(G), (obj))
#define GC_walkMemory(G, addr)	\
    ((G)->ops->walkMemory)((Collector*)(G), (addr))
#define GC_walkConservative(G, addr, len)		\
    ((G)->ops->walkConservative)((Collector*)(G), (addr), (len))
#define GC_registerFixedTypeByIndex(G, idx, desc)	\
    ((G)->ops->registerFixedTypeByIndex)((Collector*)(G),   \
				(idx), (desc))
#define GC_registerGcTypeByIndex(G, idx, walk, final, destroy, desc)	\
    ((G)->ops->registerGcTypeByIndex)((Collector*)(G), 	     \
				(idx), (walk), (final), (destroy), (desc))
#define GC_enableGC(G)		\
    ((G)->ops->enableGC)((Collector*)(G));
#define GC_disableGC(G)		\
    ((G)->ops->disableGC)((Collector*)(G));

/*
 * Compatibility macros to access GC functions
 */
extern Collector* main_collector;

#define	gc_malloc(A,B)	    GC_malloc(main_collector,A,B)
#define	gc_calloc(A,B,C)    GC_malloc(main_collector,(A)*(B),C)
#define	gc_realloc(A,B,C)   GC_realloc(main_collector,(A),(B),C)
#define	gc_free(A)	    GC_free(main_collector,(A))

#define	invokeGC()	    GC_invoke(main_collector,1)
#define	adviseGC()	    GC_invoke(main_collector,0)
#define	invokeFinalizer()   GC_invokeFinalizer(main_collector)

#define gc_throwOOM()	    GC_throwOOM(main_collector)

#define gc_enableGC()	    GC_enableGC(main_collector)
#define gc_disableGC()	    GC_disableGC(main_collector)

#include "gcRefs.h"
extern char* describeObject(const void* mem);
#endif