-/******************************* loader.h **************************************
+/* loader.h - class loader header
- Copyright (c) 1997 A. Krall, R. Grafl, M. Gschwind, M. Probst
+ Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
+ R. Grafl, A. Krall, C. Kruegel, C. Oates, R. Obermaisser,
+ M. Probst, S. Ring, E. Steiner, C. Thalinger, D. Thuernbeck,
+ P. Tomsich, J. Wenninger
- See file COPYRIGHT for information on usage and disclaimer of warranties
+ This file is part of CACAO.
- Contains the prototypes for the class loader.
+ This program is free software; you can redistribute it and/or
+ modify it under the terms of the GNU General Public License as
+ published by the Free Software Foundation; either version 2, or (at
+ your option) any later version.
- Author: Reinhard Grafl EMAIL: cacao@complang.tuwien.ac.at
+ This program is distributed in the hope that it will be useful, but
+ WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ General Public License for more details.
- Last Change: 1997/11/14
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
+ 02111-1307, USA.
-*******************************************************************************/
+ Contact: cacao@complang.tuwien.ac.at
+ Authors: Reinhard Grafl
+ $Id: loader.h 1296 2004-07-10 17:02:15Z stefan $
+*/
-/************************* program switches ***********************************/
-extern bool loadverbose; /* Print debug messages during loading */
-extern bool linkverbose;
-extern bool initverbose; /* Log class initialization */
-extern bool makeinitializations; /* Initialize classes automatically */
+#ifndef _LOADER_H
+#define _LOADER_H
-extern bool getloadingtime;
-extern long int loadingtime; /* CPU time for class loading */
+#include <stdio.h>
-extern list unlinkedclasses; /* List containing all unlinked classes */
-extern list linkedclasses; /* List containing all linked classes */
+#ifdef USE_ZLIB
+#include "unzip.h"
+#endif
+
+
+/* datastruture from a classfile */
+
+typedef struct classbuffer {
+ classinfo *class; /* pointer to classinfo structure */
+ u1 *data; /* pointer to byte code */
+ s4 size; /* size of the byte code */
+ u1 *pos; /* current read position */
+} classbuffer;
+
+
+/* export variables */
+
+#ifdef USE_THREADS
+extern int blockInts;
+#endif
+
+
+/* references to some system classes ******************************************/
+
+extern classinfo *class_java_lang_Object;
+extern classinfo *class_java_lang_String;
+extern classinfo *class_java_lang_Cloneable;
+extern classinfo *class_java_io_Serializable;
+extern utf *utf_fillInStackTrace_name;
+extern utf *utf_fillInStackTrace_desc;
+
+/* pseudo classes for the type checker ****************************************/
+
+/*
+ * pseudo_class_Arraystub
+ * (extends Object implements Cloneable, java.io.Serializable)
+ *
+ * If two arrays of incompatible component types are merged,
+ * the resulting reference has no accessible components.
+ * The result does, however, implement the interfaces Cloneable
+ * and java.io.Serializable. This pseudo class is used internally
+ * to represent such results. (They are *not* considered arrays!)
+ *
+ * pseudo_class_Null
+ *
+ * This pseudo class is used internally to represent the
+ * null type.
+ *
+ * pseudo_class_New
+ *
+ * This pseudo class is used internally to represent the
+ * the 'uninitialized object' type.
+ */
+
+extern classinfo *pseudo_class_Arraystub;
+extern classinfo *pseudo_class_Null;
+extern classinfo *pseudo_class_New;
+extern vftbl_t *pseudo_class_Arraystub_vftbl;
+
+extern utf *array_packagename;
/************************ prototypes ******************************************/
/* initialize laoder, load important systemclasses */
-void loader_init ();
+void loader_init();
void suck_init(char *cpath);
+void create_all_classes();
+void suck_stop(classbuffer *cb);
/* free resources */
-void loader_close ();
-
-/* load a class and all referenced classes */
-classinfo *loader_load (utf *topname);
-
-/* initializes all loaded classes */
-void loader_initclasses ();
+void loader_close();
-void loader_compute_subclasses ();
+void loader_compute_subclasses();
/* retrieve constantpool element */
-voidptr class_getconstant (classinfo *class, u4 pos, u4 ctype);
+voidptr class_getconstant(classinfo *class, u4 pos, u4 ctype);
/* determine type of a constantpool element */
-u4 class_constanttype (classinfo *class, u4 pos);
+u4 class_constanttype(classinfo *class, u4 pos);
+
+s4 class_findmethodIndex(classinfo *c, utf *name, utf *desc);
/* search class for a field */
-fieldinfo *class_findfield (classinfo *c, utf *name, utf *desc);
+fieldinfo *class_findfield(classinfo *c, utf *name, utf *desc);
+fieldinfo *class_resolvefield(classinfo *c, utf *name, utf *desc, classinfo *referer, bool except);
/* search for a method with a specified name and descriptor */
-methodinfo *class_findmethod (classinfo *c, utf *name, utf *desc);
-methodinfo *class_resolvemethod (classinfo *c, utf *name, utf *dest);
+methodinfo *class_findmethod(classinfo *c, utf *name, utf *desc);
+methodinfo *class_fetchmethod(classinfo *c, utf *name, utf *desc);
+methodinfo *class_findmethod_w(classinfo *c, utf *name, utf *desc, char*);
+methodinfo *class_resolvemethod(classinfo *c, utf *name, utf *dest);
+methodinfo *class_resolveclassmethod(classinfo *c, utf *name, utf *dest, classinfo *referer, bool except);
+methodinfo *class_resolveinterfacemethod(classinfo *c, utf *name, utf *dest, classinfo *referer, bool except);
/* search for a method with specified name and arguments (returntype ignored) */
-methodinfo *class_findmethod_approx (classinfo *c, utf *name, utf *desc);
-methodinfo *class_resolvemethod_approx (classinfo *c, utf *name, utf *dest);
+methodinfo *class_findmethod_approx(classinfo *c, utf *name, utf *desc);
+methodinfo *class_resolvemethod_approx(classinfo *c, utf *name, utf *dest);
-bool class_issubclass (classinfo *sub, classinfo *super);
+bool class_issubclass(classinfo *sub, classinfo *super);
/* call initializer of class */
-void class_init (classinfo *c);
+classinfo *class_init(classinfo *c);
+
+void class_showconstanti(classinfo *c, int ii);
/* debug purposes */
-void class_showmethods (classinfo *c);
-void class_showconstantpool (classinfo *c);
+void class_showmethods(classinfo *c);
+void class_showconstantpool(classinfo *c);
+void print_arraydescriptor(FILE *file, arraydescriptor *desc);
+
+/* return the primitive class inidicated by the given signature character */
+classinfo *class_primitive_from_sig(char sig);
-/* set buffer for reading classdata */
-void classload_buffer(u1 *buf,int len);
-/* create class representing specific arraytype */
-classinfo *create_array_class(utf *u);
+/* return the class indicated by the given descriptor */
+/* (see loader.c for documentation) */
+#define CLASSLOAD_NEW 0 /* default */
+#define CLASSLOAD_LOAD 0x0001
+#define CLASSLOAD_SKIP 0x0002
+#define CLASSLOAD_PANIC 0 /* default */
+#define CLASSLOAD_NOPANIC 0x0010
+#define CLASSLOAD_PRIMITIVE 0 /* default */
+#define CLASSLOAD_NULLPRIMITIVE 0x0020
+#define CLASSLOAD_VOID 0 /* default */
+#define CLASSLOAD_NOVOID 0x0040
+#define CLASSLOAD_NOCHECKEND 0 /* default */
+#define CLASSLOAD_CHECKEND 0x1000
-/* create the arraydescriptor for the arraytype specified by the utf-string */
-constant_arraydescriptor * buildarraydescriptor(char *utf, u4 namelen);
+classinfo *class_from_descriptor(char *utf_ptr,char *end_ptr,char **next,int mode);
+int type_from_descriptor(classinfo **cls,char *utf_ptr,char *end_ptr,char **next,int mode);
-extern void class_link (classinfo *c);
+/* (used by class_new, don't use directly) */
+void class_new_array(classinfo *c);
-void field_display (fieldinfo *f);
+classinfo *class_load(classinfo *c);
+classinfo *class_load_intern(classbuffer *cb);
+classinfo *class_link(classinfo *c);
+void class_free(classinfo *c);
+
+void field_display(fieldinfo *f);
void method_display(methodinfo *m);
+
+utf* clinit_desc();
+utf* clinit_name();
+
+
+/******************************** CLASSPATH handling *******************/
+#define CLASSPATH_MAXFILENAME 1000 /* maximum length of a filename */
+#define CLASSPATH_PATH 0
+#define CLASSPATH_ARCHIVE 1
+
+typedef union classpath_info {
+ struct {
+ int type;
+ union classpath_info *next;
+ char *filename;
+ int pathlen; } filepath;
+#ifdef USE_ZLIB
+ struct {
+ int type;
+ union classpath_info *next;
+ unzFile uf;
+ } archive;
+#endif
+} classpath_info;
+
+#endif /* _LOADER_H */
+
+
+/*
+ * These are local overrides for various environment variables in Emacs.
+ * Please do not remove this and leave it at the end of the file, where
+ * Emacs will automagically detect them.
+ * ---------------------------------------------------------------------
+ * Local variables:
+ * mode: c
+ * indent-tabs-mode: t
+ * c-basic-offset: 4
+ * tab-width: 4
+ * End:
+ */