object.hon commit diff-format.txt: Combined diff format documentation supplement (0074aba)
   1#ifndef OBJECT_H
   2#define OBJECT_H
   3
   4struct object_list {
   5        struct object *item;
   6        struct object_list *next;
   7};
   8
   9struct object_refs {
  10        unsigned count;
  11        struct object *base;
  12        struct object *ref[FLEX_ARRAY]; /* more */
  13};
  14
  15struct object_array {
  16        unsigned int nr;
  17        unsigned int alloc;
  18        struct object_array_entry {
  19                struct object *item;
  20                const char *name;
  21        } *objects;
  22};
  23
  24#define TYPE_BITS   3
  25#define FLAG_BITS  27
  26
  27/*
  28 * The object type is stored in 3 bits.
  29 */
  30struct object {
  31        unsigned parsed : 1;
  32        unsigned used : 1;
  33        unsigned type : TYPE_BITS;
  34        unsigned flags : FLAG_BITS;
  35        unsigned char sha1[20];
  36};
  37
  38extern int track_object_refs;
  39extern const char *type_names[9];
  40
  41extern unsigned int get_max_object_index(void);
  42extern struct object *get_indexed_object(unsigned int);
  43
  44static inline const char *typename(unsigned int type)
  45{
  46        return type_names[type > OBJ_BAD ? OBJ_BAD : type];
  47}
  48
  49extern struct object_refs *lookup_object_refs(struct object *);
  50
  51/** Internal only **/
  52struct object *lookup_object(const unsigned char *sha1);
  53
  54/** Returns the object, having looked it up as being the given type. **/
  55struct object *lookup_object_type(const unsigned char *sha1, const char *type);
  56
  57void created_object(const unsigned char *sha1, struct object *obj);
  58
  59/** Returns the object, having parsed it to find out what it is. **/
  60struct object *parse_object(const unsigned char *sha1);
  61
  62/** Returns the object, with potentially excess memory allocated. **/
  63struct object *lookup_unknown_object(const unsigned  char *sha1);
  64
  65struct object_refs *alloc_object_refs(unsigned count);
  66void set_object_refs(struct object *obj, struct object_refs *refs);
  67
  68void mark_reachable(struct object *obj, unsigned int mask);
  69
  70struct object_list *object_list_insert(struct object *item, 
  71                                       struct object_list **list_p);
  72
  73void object_list_append(struct object *item,
  74                        struct object_list **list_p);
  75
  76unsigned object_list_length(struct object_list *list);
  77
  78int object_list_contains(struct object_list *list, struct object *obj);
  79
  80/* Object array handling .. */
  81void add_object_array(struct object *obj, const char *name, struct object_array *array);
  82
  83#endif /* OBJECT_H */