- add an extra filed for the bit offset\n- renamed access functions\n- renamed entity...
[libfirm] / ir / tr / entity_t.h
index 334ecea..43e7fd4 100644 (file)
@@ -3,10 +3,10 @@
  * File name:   ir/tr/entity_t.h
  * Purpose:     Representation of all program known entities -- private header.
  * Author:      Martin Trapp, Christian Schaefer
- * Modified by: Goetz Lindenmaier
+ * Modified by: Goetz Lindenmaier, Michael Beck
  * Created:
  * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2003 Universität Karlsruhe
+ * Copyright:   (c) 1998-2006 Universität Karlsruhe
  * Licence:     This file protected by GPL -  GNU GENERAL PUBLIC LICENSE.
  */
 
 
 /** A path in a compound graph. */
 struct compound_graph_path {
-  firm_kind kind;       /**< dynamic type tag for compound graph path. */
-  ir_type *tp;          /**< The type this path belongs to. */
-  int len;              /**< length of the path */
-  struct tuple {
-    int    index;       /**< Array index.  To compute position of array elements */
-    entity *node;       /**< entity */
-  } list[1];            /**< List of entity/index tuple of length len to express the
-                             access path. */
+       firm_kind kind;       /**< The dynamic type tag for compound graph path. */
+       ir_type *tp;          /**< The type this path belongs to. */
+       int len;              /**< The length of the path. */
+       struct tuple {
+               int       index;    /**< Array index.  To compute position of array elements */
+               ir_entity *node;    /**< The accessed entity. */
+       } list[1];            /**< List of entity/index tuple of length len to express the
+       access path. */
 };
 
-/** attributes for atomic entities */
+/** The attributes for atomic entities. */
 typedef struct atomic_ent_attr {
   ir_node *value;            /**< value if entity is not of variability uninitialized.
                                Only for atomic entities. */
 } atomic_ent_attr;
 
-/** attributes for compound entities */
+/** The attributes for compound entities. */
 typedef struct compound_ent_attr {
-  ir_node **values;     /**< constant values of compound entities. Only available if
-                             variability not uninitialized.  Must be set for variability constant. */
-  compound_graph_path **val_paths; /**< paths corresponding to constant values. Only available if
-                                        variability not uninitialized.  Must be set for variability constant. */
+       ir_node **values;     /**< constant values of compound entities. Only available if
+                                  variability not uninitialized.  Must be set for variability constant. */
+       compound_graph_path **val_paths;
+                            /**< paths corresponding to constant values. Only available if
+                                 variability not uninitialized.  Must be set for variability constant. */
 } compound_ent_attr;
 
-/** a reserved value for "not yet set" */
+/** A reserved value for "not yet set". */
 #define VTABLE_NUM_NOT_SET ((unsigned)(-1))
 
-/** attributes for methods */
+/** The attributes for methods. */
 typedef struct method_ent_attr {
-  ir_graph *irg;                 /**< The corresponding irg if known.
-                                      The ir_graph constructor automatically sets this field. */
-  unsigned irg_add_properties;   /**< Additional graph properties can be
-                                      stored in a entity if no irg is available. */
-
-  unsigned vtable_number;        /**< For a dynamically called method, the number assigned
-                                      in the virtual function table. */
-
-  ptr_access_kind *param_access; /**< the parameter access */
-  float *param_weight;           /**< The weight of method's parameters. Parameters
-                                      with a high weight are good for procedure cloning. */
-  ir_img_section section;        /**< The code section where this method should be placed */
+       ir_graph *irg;                 /**< The corresponding irg if known.
+                                           The ir_graph constructor automatically sets this field. */
+       unsigned irg_add_properties;   /**< Additional graph properties can be
+                                           stored in a entity if no irg is available. */
+
+       unsigned vtable_number;        /**< For a dynamically called method, the number assigned
+                                           in the virtual function table. */
+
+       ptr_access_kind *param_access; /**< the parameter access */
+       float *param_weight;           /**< The weight of method's parameters. Parameters
+                                           with a high weight are good for procedure cloning. */
+       ir_img_section section;        /**< The code section where this method should be placed */
 } method_ent_attr;
 
 
-/** the type of an entity */
-struct entity {
-  firm_kind kind;       /**< The dynamic type tag for entity. */
-  ident *name;          /**< The name of this entity. */
-  ident *ld_name;       /**< Unique name of this entity, i.e., the mangled
-                             name.  If the field is read before written a default
-                             mangling is applies.  The name of the owner is prepended
-                             to the name of the entity, separated by a underscore.
-                             E.g.,  for a class `A' with field `a' this
-                             is the ident for `A_a'. */
-  ir_type *type;        /**< The type of this entity, e.g., a method type, a
-                             basic type of the language or a class itself. */
-  ir_type *owner;              /**< The compound type (e.g. class type) this entity belongs to. */
-  ent_allocation allocation;   /**< Distinguishes static and dynamically allocated
-                                    entities and some further cases. */
-  visibility visibility;       /**< Specifies visibility to external program
-                                    fragments. */
-  ent_variability variability; /**< Specifies variability of entities content. */
-  ent_volatility volatility;   /**< Specifies volatility of entities content. */
-  ent_stickyness stickyness;   /**< Specifies whether this entity is sticky.  */
-  int  offset;                 /**< Offset in bits for this entity.  Fixed when layout
-                                    of owner is determined. */
-  peculiarity peculiarity;     /**< The peculiarity of this entity. */
-  unsigned long visit;         /**< visited counter for walks of the type information. */
-  struct dbg_info *dbi;        /**< A pointer to information for debug support. */
-  void *link;                  /**< To store some intermediate information. */
-
-  /* ------------- fields for entities owned by a class type ---------------*/
-
-  entity **overwrites;     /**< A list of entities this entity overwrites. */
-  entity **overwrittenby;  /**< A list of entities that overwrite this entity.  */
-
-  /* ------------- fields for atomic entities  --------------- */
-  ir_node *value;          /**< value if entity is not of variability uninitialized.
-                                Only for atomic entities. */
-  union {
-    /* ------------- fields for compound entities -------------- */
-    compound_ent_attr cmpd_attr;
-    /* ------------- fields for method entities ---------------- */
-    method_ent_attr   mtd_attr;
-  } attr; /**< type specific attributes */
-
-  /* ------------- fields for analyses ---------------*/
+/** The type of an entity. */
+struct ir_entity {
+       firm_kind kind;       /**< The dynamic type tag for entity. */
+       ident *name;          /**< The name of this entity. */
+       ident *ld_name;       /**< Unique name of this entity, i.e., the mangled
+                                  name.  If the field is read before written a default
+                                  mangling is applies.  The name of the owner is prepended
+                                  to the name of the entity, separated by a underscore.
+                                  E.g.,  for a class `A' with field `a' this
+                                  is the ident for `A_a'. */
+       ir_type *type;        /**< The type of this entity, e.g., a method type, a
+                                  basic type of the language or a class itself. */
+       ir_type *owner;       /**< The compound type (e.g. class type) this entity belongs to. */
+       ir_allocation allocation:3;    /**< Distinguishes static and dynamically allocated
+                                           entities and some further cases. */
+       ir_visibility visibility:3;    /**< Specifies visibility to external program
+                                           fragments. */
+       ir_variability variability:3;  /**< Specifies variability of entities content. */
+       ir_volatility volatility:2;    /**< Specifies volatility of entities content. */
+       ir_stickyness stickyness:2;    /**< Specifies whether this entity is sticky.  */
+       ir_peculiarity peculiarity:3;  /**< The peculiarity of this entity. */
+       unsigned final:1;              /**< If set, this entity cannot be overridden. */
+       unsigned compiler_gen:1;       /**< If set, this entity was compiler generated. */
+       int offset;                    /**< Offset in bytes for this entity.  Fixed when layout
+                                           of owner is determined. */
+       unsigned char offset_bit_remainder;
+                                      /**< If the entity is a bit field, this is the offset of
+                                           the start of the bit field within the byte specified
+                                           by offset. */
+       unsigned long visit;           /**< visited counter for walks of the type information. */
+       struct dbg_info *dbi;          /**< A pointer to information for debug support. */
+       void *link;                    /**< To store some intermediate information. */
+       ir_type *repr_class;           /**< If this entity represents a class info, the associated class. */
+
+       /* ------------- fields for entities owned by a class type ---------------*/
+
+       ir_entity **overwrites;     /**< A list of entities this entity overwrites. */
+       ir_entity **overwrittenby;  /**< A list of entities that overwrite this entity.  */
+
+       /* ------------- fields for atomic entities  --------------- */
+       ir_node *value;          /**< value if entity is not of variability uninitialized.
+                                     Only for atomic entities. */
+       union {
+               /* ------------- fields for compound entities -------------- */
+               compound_ent_attr cmpd_attr;
+               /* ------------- fields for method entities ---------------- */
+               method_ent_attr   mtd_attr;
+       } attr; /**< type specific attributes */
+
+       /* ------------- fields for analyses ---------------*/
 
 #ifdef DEBUG_libfirm
-  long nr;             /**< A unique node number for each node to make output
-                            readable. */
+       long nr;             /**< A unique node number for each node to make output readable. */
 # endif /* DEBUG_libfirm */
 };
 
-/** Initialize entity module. */
+/** Initialize the entity module. */
 void firm_init_entity(void);
 
 
 /* ----------------------- inline functions ------------------------ */
 static INLINE int
 _is_entity(const void *thing) {
-  return get_kind(thing) == k_entity;
+       return get_kind(thing) == k_entity;
 }
 
 static INLINE const char *
-_get_entity_name(const entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  return get_id_str(get_entity_ident(ent));
+_get_entity_name(const ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return get_id_str(get_entity_ident(ent));
 }
 
 static INLINE ident *
-_get_entity_ident(const entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  return ent->name;
+_get_entity_ident(const ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return ent->name;
 }
 
 static INLINE void
-_set_entity_ident(entity *ent, ident *id) {
-  assert(ent && ent->kind == k_entity);
-  ent->name = id;
+_set_entity_ident(ir_entity *ent, ident *id) {
+       assert(ent && ent->kind == k_entity);
+       ent->name = id;
 }
 
 static INLINE ir_type *
-_get_entity_owner(entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  return ent->owner = skip_tid(ent->owner);
+_get_entity_owner(ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return ent->owner = skip_tid(ent->owner);
 }
 
 static INLINE ident *
-_get_entity_ld_ident(entity *ent)
+_get_entity_ld_ident(ir_entity *ent)
 {
-  assert(ent && ent->kind == k_entity);
-  if (ent->ld_name == NULL)
-    ent->ld_name = mangle_entity(ent);
-  return ent->ld_name;
+       assert(ent && ent->kind == k_entity);
+       if (ent->ld_name == NULL)
+               ent->ld_name = mangle_entity(ent);
+       return ent->ld_name;
 }
 
 static INLINE void
-_set_entity_ld_ident(entity *ent, ident *ld_ident) {
-  assert(ent && ent->kind == k_entity);
-  ent->ld_name = ld_ident;
+_set_entity_ld_ident(ir_entity *ent, ident *ld_ident) {
+       assert(ent && ent->kind == k_entity);
+       ent->ld_name = ld_ident;
 }
 
 static INLINE const char *
-_get_entity_ld_name(entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  return get_id_str(get_entity_ld_ident(ent));
+_get_entity_ld_name(ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return get_id_str(get_entity_ld_ident(ent));
 }
 
 static INLINE ir_type *
-_get_entity_type(entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  return ent->type = skip_tid(ent->type);
+_get_entity_type(ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return ent->type = skip_tid(ent->type);
 }
 
 static INLINE void
-_set_entity_type(entity *ent, ir_type *type) {
-  assert(ent && ent->kind == k_entity);
-  ent->type = type;
+_set_entity_type(ir_entity *ent, ir_type *type) {
+       assert(ent && ent->kind == k_entity);
+       ent->type = type;
 }
 
-static INLINE ent_allocation
-_get_entity_allocation(const entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  return ent->allocation;
+static INLINE ir_allocation
+_get_entity_allocation(const ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return ent->allocation;
 }
 
 static INLINE void
-_set_entity_allocation(entity *ent, ent_allocation al) {
-  assert(ent && ent->kind == k_entity);
-  ent->allocation = al;
+_set_entity_allocation(ir_entity *ent, ir_allocation al) {
+       assert(ent && ent->kind == k_entity);
+       ent->allocation = al;
 }
 
-static INLINE visibility
-_get_entity_visibility(const entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  return ent->visibility;
+static INLINE ir_visibility
+_get_entity_visibility(const ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return ent->visibility;
 }
 
-static INLINE ent_variability
-_get_entity_variability(const entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  return ent->variability;
+static INLINE ir_variability
+_get_entity_variability(const ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return ent->variability;
 }
 
-static INLINE ent_volatility
-_get_entity_volatility(const entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  return ent->volatility;
+static INLINE ir_volatility
+_get_entity_volatility(const ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return ent->volatility;
 }
 
 static INLINE void
-_set_entity_volatility(entity *ent, ent_volatility vol) {
-  assert(ent && ent->kind == k_entity);
-  ent->volatility = vol;
+_set_entity_volatility(ir_entity *ent, ir_volatility vol) {
+       assert(ent && ent->kind == k_entity);
+       ent->volatility = vol;
 }
 
-static INLINE peculiarity
-_get_entity_peculiarity(const entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  return ent->peculiarity;
+static INLINE ir_peculiarity
+_get_entity_peculiarity(const ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return ent->peculiarity;
 }
 
 /**
@@ -260,100 +267,116 @@ _get_entity_peculiarity(const entity *ent) {
  *       I removed the assertion.  GL, 28.2.05
  */
 static INLINE void
-_set_entity_peculiarity(entity *ent, peculiarity pec) {
-  assert(ent && ent->kind == k_entity);
-  /* @@@ why peculiarity only for methods? */
-  //assert(is_Method_type(ent->type));
+_set_entity_peculiarity(ir_entity *ent, ir_peculiarity pec) {
+       assert(ent && ent->kind == k_entity);
+       /* @@@ why peculiarity only for methods? */
+       //assert(is_Method_type(ent->type));
 
-  ent->peculiarity = pec;
+       ent->peculiarity = pec;
 }
 
-static INLINE ent_stickyness
-_get_entity_stickyness(const entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  return ent->stickyness;
+static INLINE ir_stickyness
+_get_entity_stickyness(const ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return ent->stickyness;
 }
 
 static INLINE void
-_set_entity_stickyness(entity *ent, ent_stickyness stickyness)
-{
-  assert(ent && ent->kind == k_entity);
-  ent->stickyness = stickyness;
+_set_entity_stickyness(ir_entity *ent, ir_stickyness stickyness) {
+       assert(ent && ent->kind == k_entity);
+       ent->stickyness = stickyness;
 }
 
 static INLINE int
-_get_entity_offset_bits(const entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  return ent->offset;
+_get_entity_final(const ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return (int)ent->final;
 }
 
-static INLINE int
-_get_entity_offset_bytes(const entity *ent) {
-  int bits = _get_entity_offset_bits(ent);
+static INLINE void
+_set_entity_final(ir_entity *ent, int final) {
+       assert(ent && ent->kind == k_entity);
+       ent->final = final ? 1 : 0;
+}
 
-  if (bits & 7) return -1;
-  return bits >> 3;
+static INLINE int
+_get_entity_offset(const ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return ent->offset;
 }
 
 static INLINE void
-_set_entity_offset_bits(entity *ent, int offset) {
-  assert(ent && ent->kind == k_entity);
-  ent->offset = offset;
+_set_entity_offset(ir_entity *ent, int offset) {
+       assert(ent && ent->kind == k_entity);
+       ent->offset = offset;
+}
+
+static INLINE unsigned char
+_get_entity_offset_bits_remainder(const ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return ent->offset_bit_remainder;
 }
 
 static INLINE void
-_set_entity_offset_bytes(entity *ent, int offset) {
-  _set_entity_offset_bits(ent, offset * 8);
+_set_entity_offset_bits_remainder(ir_entity *ent, unsigned char offset) {
+       assert(ent && ent->kind == k_entity);
+       ent->offset_bit_remainder = offset;
 }
 
 static INLINE void *
-_get_entity_link(const entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  return ent->link;
+_get_entity_link(const ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return ent->link;
 }
 
 static INLINE void
-_set_entity_link(entity *ent, void *l) {
-  assert(ent && ent->kind == k_entity);
-  ent->link = l;
+_set_entity_link(ir_entity *ent, void *l) {
+       assert(ent && ent->kind == k_entity);
+       ent->link = l;
 }
 
 static INLINE ir_graph *
-_get_entity_irg(const entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  assert(ent == unknown_entity || is_Method_type(ent->type));
-  if (!get_visit_pseudo_irgs() && ent->attr.mtd_attr.irg
-      && is_pseudo_ir_graph(ent->attr.mtd_attr.irg))
-    return NULL;
-  return ent->attr.mtd_attr.irg;
+_get_entity_irg(const ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       assert(ent == unknown_entity || is_Method_type(ent->type));
+       if (!get_visit_pseudo_irgs() && ent->attr.mtd_attr.irg
+               && is_pseudo_ir_graph(ent->attr.mtd_attr.irg))
+               return NULL;
+       return ent->attr.mtd_attr.irg;
 }
 
 static INLINE unsigned long
-_get_entity_visited(entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  return ent->visit;
+_get_entity_visited(ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return ent->visit;
 }
 
 static INLINE void
-_set_entity_visited(entity *ent, unsigned long num) {
-  assert(ent && ent->kind == k_entity);
-  ent->visit = num;
+_set_entity_visited(ir_entity *ent, unsigned long num) {
+       assert(ent && ent->kind == k_entity);
+       ent->visit = num;
 }
 
 static INLINE void
-_mark_entity_visited(entity *ent) {
-  assert(ent && ent->kind == k_entity);
-  ent->visit = firm_type_visited;
+_mark_entity_visited(ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       ent->visit = firm_type_visited;
 }
 
 static INLINE int
-_entity_visited(entity *ent) {
-  return _get_entity_visited(ent) >= firm_type_visited;
+_entity_visited(ir_entity *ent) {
+       return _get_entity_visited(ent) >= firm_type_visited;
 }
 
 static INLINE int
-_entity_not_visited(entity *ent) {
-  return _get_entity_visited(ent) < firm_type_visited;
+_entity_not_visited(ir_entity *ent) {
+       return _get_entity_visited(ent) < firm_type_visited;
+}
+
+static INLINE ir_type *
+_get_entity_repr_class(const ir_entity *ent) {
+       assert(ent && ent->kind == k_entity);
+       return ent->repr_class;
 }
 
 #define is_entity(thing)                         _is_entity(thing)
@@ -376,10 +399,12 @@ _entity_not_visited(entity *ent) {
 #define set_entity_peculiarity(ent, pec)         _set_entity_peculiarity(ent, pec)
 #define get_entity_stickyness(ent)               _get_entity_stickyness(ent)
 #define set_entity_stickyness(ent, stickyness)   _set_entity_stickyness(ent, stickyness)
-#define get_entity_offset_bits(ent)              _get_entity_offset_bits(ent)
-#define get_entity_offset_bytes(ent)             _get_entity_offset_bytes(ent)
-#define set_entity_offset_bits(ent, offset)      _set_entity_offset_bits(ent, offset)
-#define set_entity_offset_bytes(ent, offset)     _set_entity_offset_bytes(ent, offset)
+#define get_entity_final(ent)                    _get_entity_final(ent)
+#define set_entity_final(ent, final)             _set_entity_final(ent, final)
+#define get_entity_offset(ent)                   _get_entity_offset(ent)
+#define set_entity_offset(ent, offset)           _set_entity_offset(ent, offset)
+#define get_entity_offset_bits_remainder(ent)    _get_entity_offset_bits_remainder(ent)
+#define set_entity_offset_bits_remainder(ent, o) _set_entity_offset_bits_remainder(ent, o)
 #define get_entity_link(ent)                     _get_entity_link(ent)
 #define set_entity_link(ent, l)                  _set_entity_link(ent, l)
 #define get_entity_irg(ent)                      _get_entity_irg(ent)
@@ -388,5 +413,7 @@ _entity_not_visited(entity *ent) {
 #define mark_entity_visited(ent)                 _mark_entity_visited(ent)
 #define entity_visited(ent)                      _entity_visited(ent)
 #define entity_not_visited(ent)                  _entity_not_visited(ent)
+#define get_entity_repr_class(ent)               _get_entity_repr_class(ent)
+
 
 #endif /* _FIRM_TR_ENTITY_T_H_ */