35cd9bafc6125e0194689fe3429d2deb3b6fb6c9
[cacao.git] / loader.h
1 /* loader.c - class loader header
2
3    Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
4    R. Grafl, A. Krall, C. Kruegel, C. Oates, R. Obermaisser,
5    M. Probst, S. Ring, E. Steiner, C. Thalinger, D. Thuernbeck,
6    P. Tomsich, J. Wenninger
7
8    This file is part of CACAO.
9
10    This program is free software; you can redistribute it and/or
11    modify it under the terms of the GNU General Public License as
12    published by the Free Software Foundation; either version 2, or (at
13    your option) any later version.
14
15    This program is distributed in the hope that it will be useful, but
16    WITHOUT ANY WARRANTY; without even the implied warranty of
17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
18    General Public License for more details.
19
20    You should have received a copy of the GNU General Public License
21    along with this program; if not, write to the Free Software
22    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
23    02111-1307, USA.
24
25    Contact: cacao@complang.tuwien.ac.at
26
27    Authors: Reinhard Grafl
28
29    $Id: loader.h 669 2003-11-23 14:04:20Z edwin $
30 */
31
32
33 #ifndef _LOADER_H
34 #define _LOADER_H
35
36 /************************* program switches ***********************************/
37
38 extern bool loadverbose;         /* Print debug messages during loading */
39 extern bool linkverbose;
40 extern bool initverbose;         /* Log class initialization */ 
41 extern bool makeinitializations; /* Initialize classes automatically */
42
43 extern bool getloadingtime;
44 extern long int loadingtime;     /* CPU time for class loading */
45
46 extern list unlinkedclasses;     /* List containing all unlinked classes */
47 extern list linkedclasses;       /* List containing all linked classes */
48
49
50 /************************ prototypes ******************************************/
51
52 /* initialize laoder, load important systemclasses */
53 void loader_init();
54
55 void suck_init(char *cpath);
56
57 /* free resources */
58 void loader_close();
59
60 /* load a class and all referenced classes */
61 classinfo *loader_load(utf *topname);
62
63 /* initializes all loaded classes */
64 void loader_initclasses();
65
66 void loader_compute_subclasses();
67
68 /* retrieve constantpool element */
69 voidptr class_getconstant(classinfo *class, u4 pos, u4 ctype);
70
71 /* determine type of a constantpool element */
72 u4 class_constanttype(classinfo *class, u4 pos);
73
74 /* search class for a field */
75 fieldinfo *class_findfield(classinfo *c, utf *name, utf *desc);
76
77 /* search for a method with a specified name and descriptor */
78 methodinfo *class_findmethod(classinfo *c, utf *name, utf *desc);
79 methodinfo *class_resolvemethod(classinfo *c, utf *name, utf *dest);
80
81 /* search for a method with specified name and arguments (returntype ignored) */
82 methodinfo *class_findmethod_approx(classinfo *c, utf *name, utf *desc);
83 methodinfo *class_resolvemethod_approx(classinfo *c, utf *name, utf *dest);
84
85 bool class_issubclass(classinfo *sub, classinfo *super);
86
87 /* call initializer of class */
88 void class_init(classinfo *c);
89
90 void class_showconstanti(classinfo *c, int ii);
91
92 /* debug purposes */
93 void class_showmethods (classinfo *c);
94 void class_showconstantpool (classinfo *c);
95 void print_arraydescriptor(FILE *file,arraydescriptor *desc);
96
97 classinfo *loader_load(utf *topname);
98
99 /* set buffer for reading classdata */
100 void classload_buffer(u1 *buf,int len);
101
102 /* return the primitive class inidicated by the given signature character */
103 classinfo *class_primitive_from_sig(char sig);
104
105 /* return the class indicated by the given descriptor */
106 #define CLASSLOAD_SKIP  0
107 #define CLASSLOAD_NEW   1
108 #define CLASSLOAD_LOAD  2
109 classinfo *class_from_descriptor(char *utf_ptr,char *end_ptr,char **next,int mode);
110
111 /* (used by class_new, don't use directly) */
112 void class_new_array(classinfo *c);
113
114 void class_link(classinfo *c);
115
116 void field_display(fieldinfo *f);
117
118 void method_display(methodinfo *m);
119
120 utf* clinit_desc();
121 utf* clinit_name();
122
123 #endif /* _LOADER_H */
124
125
126 /*
127  * These are local overrides for various environment variables in Emacs.
128  * Please do not remove this and leave it at the end of the file, where
129  * Emacs will automagically detect them.
130  * ---------------------------------------------------------------------
131  * Local variables:
132  * mode: c
133  * indent-tabs-mode: t
134  * c-basic-offset: 4
135  * tab-width: 4
136  * End:
137  */