home *** CD-ROM | disk | FTP | other *** search
/ PC World 1998 October / PCWorld_1998-10_cd.bin / software / prehled / inprise / JRUNTIME.Z / oobj.h < prev    next >
C/C++ Source or Header  |  1998-05-08  |  16KB  |  477 lines
  1. // $Header: z:/admin/jb20_jdk116x.English/javasrc/src/share/java/include/rcs/oobj.h 1.1 1998/04/17 23:02:52 bstone Exp $ 
  2. /*
  3.  * @(#)oobj.h    1.78 98/01/12
  4.  * 
  5.  * Copyright (c) 1995, 1996 Sun Microsystems, Inc. All Rights Reserved.
  6.  * 
  7.  * This software is the confidential and proprietary information of Sun
  8.  * Microsystems, Inc. ("Confidential Information").  You shall not
  9.  * disclose such Confidential Information and shall use it only in
  10.  * accordance with the terms of the license agreement you entered into
  11.  * with Sun.
  12.  * 
  13.  * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF THE
  14.  * SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  15.  * IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
  16.  * PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR ANY DAMAGES
  17.  * SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR DISTRIBUTING
  18.  * THIS SOFTWARE OR ITS DERIVATIVES.
  19.  * 
  20.  * CopyrightVersion 1.1_beta
  21.  * 
  22.  */
  23. /*
  24.  * Java object header format
  25.  */
  26.  
  27. #ifndef _OOBJ_H_
  28. #define _OOBJ_H_
  29.  
  30. #ifndef JAVA_CLASSFILE_MAGIC
  31.  
  32. #include <stddef.h>
  33.  
  34. #include "typedefs.h"
  35. #include "debug.h"
  36. #include "bool.h"
  37. #include "oobj_md.h"
  38. #include "signature.h"
  39.  
  40. #define JAVA_CLASSFILE_MAGIC              0xCafeBabe
  41.  
  42. #define JAVASRCEXT "java"
  43. #define JAVASRCEXTLEN 4
  44. #define JAVAOBJEXT "class"
  45. #define JAVAOBJEXTLEN 5
  46.  
  47. #define JAVA_VERSION     45
  48. #define JAVA_MINOR_VERSION 3
  49. #define ARRAYHEADER     long alloclen
  50.  
  51. #define HandleTo(T) typedef struct H##T { Class##T *obj; struct methodtable *methods;} H##T
  52.  
  53.  
  54. typedef long OBJECT;
  55. typedef OBJECT Classjava_lang_Object;
  56. typedef OBJECT ClassObject;
  57. HandleTo(java_lang_Object);
  58. typedef Hjava_lang_Object JHandle;
  59. typedef Hjava_lang_Object HObject;
  60.  
  61. typedef unsigned short unicode;
  62.  
  63. extern unicode    *str2unicode(char *, unicode *, long);
  64. extern char    *int642CString(int64_t number, char *buf, int buflen);
  65.  
  66. #define ALIGN(n) (((n)+3)&~3)
  67. #define UCALIGN(n) ((unsigned char *)ALIGN((int)(n)))
  68.  
  69. struct Hjava_lang_Class;    /* forward reference for some compilers */
  70. struct Classjava_lang_Class;    /* forward reference for some compilers */
  71.  
  72. typedef struct Classjava_lang_Class Classjava_lang_Class;
  73.  
  74. HandleTo(java_lang_Class);
  75. typedef struct Hjava_lang_Class ClassClass;
  76.  
  77.  
  78. struct fieldblock {
  79.     ClassClass *clazz;
  80.     char *signature;
  81.     char *name;
  82.     unsigned long ID;
  83.     unsigned short access;
  84.     union {
  85.     unsigned long offset;    /* info of data */    
  86.     OBJECT static_value;
  87.     void *static_address;
  88.     } u;
  89. };
  90.  
  91. #define fieldname(fb)    ((fb)->name)
  92. #define fieldsig(fb)     ((fb)->signature)
  93. #define fieldIsArray(fb) (fieldsig(fb)[0] == SIGNATURE_ARRAY)
  94. #define fieldIsClass(fb) (fieldsig(fb)[0] == SIGNATURE_CLASS)
  95. #define    fieldclass(fb)   ((fb)->clazz)
  96.  
  97. struct execenv;
  98.  
  99. struct methodblock {
  100.     struct fieldblock fb;
  101.     unsigned char       *code;    /* the code */
  102.     struct CatchFrame   *exception_table;
  103.     struct lineno       *line_number_table;
  104.     struct localvar     *localvar_table;
  105.  
  106.     unsigned long        code_length;
  107.     unsigned long        exception_table_length;
  108.     unsigned long        line_number_table_length;
  109.     unsigned long        localvar_table_length;
  110.  
  111.     bool_t  (*invoker)
  112.       (JHandle *o, struct methodblock *mb, int args_size, struct execenv *ee);
  113.     unsigned short       args_size;    /* total size of all arguments */
  114.     unsigned short       maxstack;    /* maximum stack usage */
  115.     unsigned short       nlocals;    /* maximum number of locals */
  116.     /* 2 spare bytes here */
  117.     void                *CompiledCode; /* it's type is machine dependent */
  118.     void                *CompiledCodeInfo; /* it's type is machine dependent */
  119.     long                 CompiledCodeFlags; /* machine dependent bits */
  120.     unsigned long        inlining;      /* possible inlining of code */
  121.     unsigned short       nexceptions;   /* number of checked exceptions */
  122.     unsigned short      *exceptions;    /* constant pool indices */
  123. #ifdef JCOV 
  124.     struct covtable      *coverage_table;
  125.     unsigned long        coverage_table_length;
  126. #endif
  127. };
  128.  
  129. struct HIOstream;
  130.  
  131. struct methodtable {
  132.     ClassClass *classdescriptor;
  133.     struct methodblock *methods[1];
  134. };
  135.  
  136. struct imethodtable { 
  137.     int icount;            /* number of interfaces to follow */
  138.     struct { 
  139.     ClassClass *classdescriptor;
  140.     unsigned long *offsets;    /* info of data */    
  141.     } itable[1];
  142. };
  143.  
  144. typedef struct {
  145.     char body[1];
  146. } ArrayOfByte;
  147. typedef ArrayOfByte ClassArrayOfByte;
  148. HandleTo(ArrayOfByte);
  149.  
  150. typedef struct {
  151.     unicode body[1];
  152. } ArrayOfChar;
  153. typedef ArrayOfChar ClassArrayOfChar;
  154. HandleTo(ArrayOfChar);
  155.  
  156. typedef struct {
  157.     signed short body[1];
  158. } ArrayOfShort;
  159. typedef ArrayOfShort ClassArrayOfShort;
  160. HandleTo(ArrayOfShort);
  161.  
  162. typedef struct {
  163.     long        body[1];
  164. } ArrayOfInt;
  165. typedef ArrayOfInt ClassArrayOfInt;
  166. HandleTo(ArrayOfInt);
  167.  
  168. typedef struct {
  169.     int64_t        body[1];
  170. } ArrayOfLong;
  171. typedef ArrayOfLong ClassArrayOfLong;
  172. HandleTo(ArrayOfLong);
  173.  
  174. typedef struct {
  175.     float       body[1];
  176. } ArrayOfFloat;
  177. typedef ArrayOfFloat ClassArrayOfFloat;
  178. HandleTo(ArrayOfFloat);
  179.  
  180. typedef struct {
  181.     double       body[1];
  182. } ArrayOfDouble;
  183. typedef ArrayOfDouble ClassArrayOfDouble;
  184. HandleTo(ArrayOfDouble);
  185.  
  186. typedef struct {
  187.     JHandle *(body[1]);
  188. } ArrayOfArray;
  189. typedef ArrayOfArray ClassArrayOfArray;
  190. HandleTo(ArrayOfArray);
  191.  
  192. typedef struct {
  193.     HObject *(body[1]);
  194. } ArrayOfObject;
  195. typedef ArrayOfObject ClassArrayOfObject;
  196. HandleTo(ArrayOfObject);
  197.  
  198. typedef struct Hjava_lang_String HString;
  199.  
  200. typedef struct {
  201.     HString  *(body[1]);
  202. } ArrayOfString;
  203. typedef ArrayOfString ClassArrayOfString;
  204. HandleTo(ArrayOfString);
  205.  
  206.  
  207. /* Note: any handles in this structure must also have explicit
  208.    code in the ScanClasses() routine of the garbage collector
  209.    to mark the handle. */
  210. struct Classjava_lang_Class {
  211.     /* Things following here are saved in the .class file */
  212.     unsigned short         major_version;
  213.     unsigned short         minor_version;
  214.     char                    *name;
  215.     char                    *super_name;
  216.     char                    *source_name;
  217.     ClassClass              *superclass;
  218.     ClassClass              *HandleToSelf;
  219.     struct Hjava_lang_ClassLoader *loader;
  220.     struct methodblock        *finalizer;
  221.  
  222.     union cp_item_type      *constantpool;
  223.     struct methodblock      *methods;
  224.     struct fieldblock       *fields;
  225.     short                   *implements;
  226.  
  227.     struct methodtable      *methodtable;
  228.     struct methodtable        *methodtable_mem;
  229.     struct fieldblock      **slottable;
  230.  
  231.     HString            *classname;
  232.  
  233.     union {
  234.     struct {
  235.         unsigned long    thishash;      /* unused */
  236.         unsigned long    totalhash;      /* unused */
  237.     } cbhash;
  238.     struct {
  239.         unsigned char    typecode;      /* VM typecode */
  240.         char        typesig;      /* signature constant */
  241.         unsigned char    slotsize;      /* (bytes) in slot */
  242.         unsigned char    elementsize;      /* (bytes) in array */
  243.         unsigned long    xxspare;
  244.     } cbtypeinfo;
  245.     } hashinfo;
  246.  
  247.     unsigned short           constantpool_count;  /* number of items in pool */
  248.     unsigned short           methods_count;       /* number of methods */
  249.     unsigned short           fields_count;        /* number of fields */
  250.     unsigned short           implements_count;    /* number of protocols */
  251.  
  252.     unsigned short           methodtable_size;    /* the size of method table */
  253.     unsigned short           slottbl_size;        /* size of slottable */
  254.     unsigned short           instance_size;       /* (bytes) of an instance */
  255.  
  256.     unsigned short access;           /* how this class can be accesses */
  257.     unsigned short flags;         /* see the CCF_* macros */
  258.     struct HArrayOfObject   *signers;
  259.     struct   imethodtable   *imethodtable;
  260.  
  261.     void                    *init_thread; /* EE of initializing thread */    
  262.  
  263.     ClassClass          *last_subclass_of;
  264. #ifdef JCOV
  265.     char                    *absolute_source_name;
  266.     int64_t                timestamp;
  267. #endif
  268. };
  269.  
  270.  
  271. extern void FreeClass(ClassClass *cb);
  272. extern void MakeClassSticky(ClassClass *cb);
  273.  
  274. #define cbAccess(cb)          ((unhand(cb))->access)
  275. #define cbClassname(cb)       ((unhand(cb))->classname)
  276. #define cbConstantPool(cb)    ((unhand(cb))->constantpool)
  277. #define cbConstantPoolCount(cb) ((unhand(cb))->constantpool_count)
  278. #define    cbFields(cb)          ((unhand(cb))->fields)
  279. #define    cbFieldsCount(cb)     ((unhand(cb))->fields_count)
  280. #define cbFinalizer(cb)       ((unhand(cb))->finalizer)
  281. #define cbFlags(cb)           ((unhand(cb))->flags)
  282. #define cbHandle(cb)          (cb)
  283. #define cbImplements(cb)      ((unhand(cb))->implements)
  284. #define cbImplementsCount(cb) ((unhand(cb))->implements_count)
  285. #define cbInstanceSize(cb)    ((unhand(cb))->instance_size)
  286. #define cbIntfMethodTable(cb) ((unhand(cb))->imethodtable)
  287. #define cbLastSubclassOf(cb)  ((unhand(cb))->last_subclass_of)
  288. #define    cbLoader(cb)          ((unhand(cb))->loader)
  289. #define cbMajorVersion(cb)    ((unhand(cb))->major_version)
  290. #define    cbMethods(cb)         ((unhand(cb))->methods)
  291. #define    cbMethodsCount(cb)    ((unhand(cb))->methods_count)
  292. #define cbMethodTable(cb)     ((unhand(cb))->methodtable)
  293. #define cbMethodTableMem(cb)  ((unhand(cb))->methodtable_mem)
  294. #define cbMethodTableSize(cb) ((unhand(cb))->methodtable_size)
  295. #define cbMinorVersion(cb)    ((unhand(cb))->minor_version)
  296. #define cbName(cb)            ((unhand(cb))->name)
  297. #define cbSigners(cb)         ((unhand(cb))->signers)
  298. #define cbSlotTable(cb)       ((unhand(cb))->slottable)
  299. #define cbSlotTableSize(cb)   ((unhand(cb))->slottbl_size)
  300. #define cbSourceName(cb)      ((unhand(cb))->source_name)
  301. #define cbSuperclass(cb)      ((unhand(cb))->superclass)
  302. #define cbSuperName(cb)       ((unhand(cb))->super_name)
  303. #define cbThisHash(cb)        ((unhand(cb))->hashinfo.cbhash.thishash)
  304. #define cbTotalHash(cb)       ((unhand(cb))->hashinfo.cbhash.totalhash)
  305. #define cbInitThread(cb)      ((unhand(cb))->init_thread)
  306.  
  307. #ifdef JCOV
  308. #define cbAbsoluteSourceName(cb) ((unhand(cb))->absolute_source_name)
  309. #define cbTimestamp(cb)       ((unhand(cb))->timestamp)
  310. #endif
  311.  
  312. #define cbIsInterface(cb)     ((cbAccess(cb) & ACC_INTERFACE) != 0)
  313.  
  314. /* These are currently only valid for primitive types */
  315. #define    cbIsPrimitive(cb)      (CCIs(cb, Primitive))
  316. #define cbTypeCode(cb)           ((unhand(cb))->hashinfo.cbtypeinfo.typecode)
  317. #define cbTypeSig(cb)           ((unhand(cb))->hashinfo.cbtypeinfo.typesig)
  318. #define cbSlotSize(cb)           ((unhand(cb))->hashinfo.cbtypeinfo.slotsize)
  319. #define cbElementSize(cb)      ((unhand(cb))->hashinfo.cbtypeinfo.elementsize)
  320.  
  321. extern char *classname2string(char *str, char *dst, int size);
  322.  
  323. #define twoword_static_address(fb) ((fb)->u.static_address)
  324. #define normal_static_address(fb)  (&(fb)->u.static_value)
  325.  
  326. /* ClassClass flags */
  327. #define CCF_IsSysLock     0x01  /* any instance treated as a "system" lock */
  328. #define CCF_IsResolved      0x02    /* has <clinit> been run? */
  329. #define CCF_IsError      0x04    /* Resolution caused an error */
  330. #define CCF_IsSoftRef      0x08    /* whether this is class Ref or subclass */
  331. #define CCF_IsInitialized 0x10    /* whether this is class has been inited */
  332. #define CCF_IsLinked      0x20    /* Has symbolic entries been linked */
  333. #define CCF_IsVerified    0x40    /* has the verifier been run */
  334. #ifdef BORLAND_JVM
  335. #define CCF_IsUserSource  0x80    /* Used in stepping to first source ACF */
  336. #endif
  337.  
  338. #define CCF_IsPrimitive   0x100    /* if pseudo-class for a primitive type */
  339. #define CCF_IsReferenced  0x200 /* Class is in use */
  340. #define CCF_IsSticky      0x400 /* Don't unload this class */
  341.  
  342. #define CCIs(cb,flag) (((unhand(cb))->flags & CCF_Is##flag) != 0)
  343. #define CCSet(cb,flag) ((unhand(cb))->flags |= CCF_Is##flag)
  344. #define CCClear(cb,flag) ((unhand(cb))->flags &= ~CCF_Is##flag)
  345.  
  346. /* map from pc to line number */
  347. struct lineno {
  348.     unsigned long pc, 
  349.     line_number;
  350. };
  351.  
  352. extern struct lineno *lntbl;
  353. extern long lntsize, lntused;
  354.  
  355. #ifdef JCOV
  356. struct covtable {
  357.     unsigned long pc, 
  358.       type,
  359.       where,
  360.       count;
  361. };
  362. #endif
  363.  
  364. /* Symbol table entry for local variables and parameters.
  365.    pc0/length defines the range that the variable is valid, slot
  366.    is the position in the local variable array in ExecEnv.
  367.    nameoff and sigoff are offsets into the string table for the
  368.    variable name and type signature.  A variable is defined with
  369.    DefineVariable, and at that time, the node for that name is
  370.    stored in the localvar entry.  When code generate is completed
  371.    for a particular scope, a second pass it made to replace the
  372.    src node entry with the correct length. */
  373.  
  374. struct localvar {
  375.     long pc0;            /* starting pc for this variable */
  376.     long length;        /* -1 initially, end pc - pc when we're done */
  377.     short nameoff;        /* offset into string table */
  378.     short sigoff;        /* offset into string table */
  379.     long slot;            /* local variable slot */
  380. };
  381.  
  382. /* Try/catch is implemented as follows.  On a per class basis,
  383.    there is a catch frame handler (below) for each catch frame
  384.    that appears in the source.  It contains the pc range of the
  385.    corresponding try body, a pc to jump to in the event that that
  386.    handler is chosen, and a catchType which must match the object
  387.    being thrown if that catch handler is to be taken.
  388.  
  389.    The list of catch frames are sorted by pc.  If one range is
  390.    inside another, then outer most range (the one that encompasses
  391.    the other) appears last in the list.  Therefore, it is possible
  392.    to search forward, and the first one that matches is the
  393.    innermost one.
  394.  
  395.    Methods with catch handlers will layout the code without the
  396.    catch frames.  After all the code is generated, the catch
  397.    clauses are generated and table entries are created.
  398.  
  399.    When the class is complete, the table entries are dumped along
  400.    with the rest of the class. */
  401.  
  402. struct CatchFrame {
  403.     long    start_pc, end_pc;    /* pc range of corresponding try block */
  404.     long    handler_pc;            /* pc of catch handler */
  405.     void*   compiled_CatchFrame; /* space to be used by machine code */
  406.     short   catchType;            /* type of catch parameter */
  407. };
  408.  
  409. #define MC_SUPER        (1<<5)
  410. #define MC_NARGSMASK    (MC_SUPER-1)
  411. #define MC_INT          (0<<6)
  412. #define MC_FLOAT        (1<<6)
  413. #define MC_VOID         (2<<6)
  414. #define MC_OTHER        (3<<6)
  415. #define MC_TYPEMASK     (3<<6)
  416.  
  417. enum {
  418.     CONSTANT_Utf8 = 1,
  419.     CONSTANT_Unicode,        /* unused */
  420.     CONSTANT_Integer,
  421.     CONSTANT_Float,
  422.     CONSTANT_Long,      
  423.     CONSTANT_Double,
  424.     CONSTANT_Class,
  425.     CONSTANT_String,
  426.     CONSTANT_Fieldref,
  427.     CONSTANT_Methodref,
  428.     CONSTANT_InterfaceMethodref,
  429.     CONSTANT_NameAndType
  430. };
  431.  
  432. union cp_item_type {
  433.     int i;
  434.     float f;
  435.     char *cp;
  436.     unsigned char *type;        /* for type table */
  437.     ClassClass *clazz;
  438.     struct methodblock *mb;
  439.     struct fieldblock *fb;
  440.     struct Hjava_lang_String *str;
  441.     void *p;                    /* for very rare occassions */
  442. };
  443.  
  444. typedef union cp_item_type cp_item_type;
  445.  
  446. #define CONSTANT_POOL_ENTRY_RESOLVED 0x80
  447. #define CONSTANT_POOL_ENTRY_TYPEMASK 0x7F
  448. #define CONSTANT_POOL_TYPE_TABLE_GET(cp,i) (((unsigned char *)(cp))[i])
  449. #define CONSTANT_POOL_TYPE_TABLE_PUT(cp,i,v) (CONSTANT_POOL_TYPE_TABLE_GET(cp,i) = (v))
  450. #define CONSTANT_POOL_TYPE_TABLE_SET_RESOLVED(cp,i) \
  451.     (CONSTANT_POOL_TYPE_TABLE_GET(cp,i) |= CONSTANT_POOL_ENTRY_RESOLVED)
  452. #define CONSTANT_POOL_TYPE_TABLE_IS_RESOLVED(cp,i) \
  453.     ((CONSTANT_POOL_TYPE_TABLE_GET(cp,i) & CONSTANT_POOL_ENTRY_RESOLVED) != 0)
  454. #define CONSTANT_POOL_TYPE_TABLE_GET_TYPE(cp,i) \
  455.         (CONSTANT_POOL_TYPE_TABLE_GET(cp,i) & CONSTANT_POOL_ENTRY_TYPEMASK)
  456.  
  457. #define CONSTANT_POOL_TYPE_TABLE_INDEX 0
  458. #define CONSTANT_POOL_UNUSED_INDEX 1
  459.  
  460. /* The following are used by the constant pool of "array" classes. */
  461.  
  462. #define CONSTANT_POOL_ARRAY_DEPTH_INDEX 1
  463. #define CONSTANT_POOL_ARRAY_TYPE_INDEX 2
  464. #define CONSTANT_POOL_ARRAY_CLASS_INDEX 3
  465. #define CONSTANT_POOL_ARRAY_LENGTH 4
  466.  
  467. /* 
  468.  * Package shorthand: this isn't obviously the correct place.
  469.  */
  470. #define JAVAPKG         "java/lang/"
  471. #define JAVAIOPKG       "java/io/"
  472. #define JAVANETPKG      "java/net/"
  473.  
  474. #endif
  475.  
  476. #endif /* !_OOBJ_H_ */
  477.