]>
Commit | Line | Data |
---|---|---|
6eb8ae00 DB |
1 | #ifndef OBJECT_H |
2 | #define OBJECT_H | |
3 | ||
99bf115c SB |
4 | struct parsed_object_pool { |
5 | struct object **obj_hash; | |
6 | int nr_objs, obj_hash_size; | |
7 | }; | |
8 | ||
9 | struct parsed_object_pool *parsed_object_pool_new(void); | |
10 | void parsed_object_pool_clear(struct parsed_object_pool *o); | |
11 | ||
6eb8ae00 DB |
12 | struct object_list { |
13 | struct object *item; | |
14 | struct object_list *next; | |
15 | }; | |
16 | ||
1f1e895f LT |
17 | struct object_array { |
18 | unsigned int nr; | |
19 | unsigned int alloc; | |
20 | struct object_array_entry { | |
21 | struct object *item; | |
31faeb20 MH |
22 | /* |
23 | * name or NULL. If non-NULL, the memory pointed to | |
24 | * is owned by this object *except* if it points at | |
25 | * object_array_slopbuf, which is a static copy of the | |
26 | * empty string. | |
27 | */ | |
28 | char *name; | |
9e0c3c4f | 29 | char *path; |
e5709a4a | 30 | unsigned mode; |
1f1e895f LT |
31 | } *objects; |
32 | }; | |
33 | ||
3cd47459 TF |
34 | #define OBJECT_ARRAY_INIT { 0, 0, NULL } |
35 | ||
885a86ab | 36 | #define TYPE_BITS 3 |
208acbfb NTND |
37 | /* |
38 | * object flag allocation: | |
3d1cf1e8 NTND |
39 | * revision.h: 0---------10 26 |
40 | * fetch-pack.c: 0----5 | |
41 | * walker.c: 0-2 | |
42 | * upload-pack.c: 4 11----------------19 | |
43 | * builtin/blame.c: 12-13 | |
44 | * bisect.c: 16 | |
45 | * bundle.c: 16 | |
46 | * http-push.c: 16-----19 | |
47 | * commit.c: 16-----19 | |
48 | * sha1_name.c: 20 | |
49 | * list-objects-filter.c: 21 | |
50 | * builtin/fsck.c: 0--3 | |
51 | * builtin/index-pack.c: 2021 | |
52 | * builtin/pack-objects.c: 20 | |
53 | * builtin/reflog.c: 10--12 | |
54 | * builtin/unpack-objects.c: 2021 | |
208acbfb | 55 | */ |
885a86ab LT |
56 | #define FLAG_BITS 27 |
57 | ||
1974632c LT |
58 | /* |
59 | * The object type is stored in 3 bits. | |
60 | */ | |
6eb8ae00 DB |
61 | struct object { |
62 | unsigned parsed : 1; | |
885a86ab LT |
63 | unsigned type : TYPE_BITS; |
64 | unsigned flags : FLAG_BITS; | |
f2fd0760 | 65 | struct object_id oid; |
6eb8ae00 DB |
66 | }; |
67 | ||
debca9d2 | 68 | extern const char *type_name(unsigned int type); |
fe8e3b71 JS |
69 | extern int type_from_string_gently(const char *str, ssize_t, int gentle); |
70 | #define type_from_string(str) type_from_string_gently(str, -1, 0) | |
885a86ab | 71 | |
33bef7ea MH |
72 | /* |
73 | * Return the current number of buckets in the object hashmap. | |
74 | */ | |
fc046a75 | 75 | extern unsigned int get_max_object_index(void); |
33bef7ea MH |
76 | |
77 | /* | |
78 | * Return the object from the specified bucket in the object hashmap. | |
79 | */ | |
fc046a75 | 80 | extern struct object *get_indexed_object(unsigned int); |
3e4339e6 | 81 | |
628b06d7 JH |
82 | /* |
83 | * This can be used to see if we have heard of the object before, but | |
84 | * it can return "yes we have, and here is a half-initialised object" | |
85 | * for an object that we haven't loaded/parsed yet. | |
86 | * | |
87 | * When parsing a commit to create an in-core commit object, its | |
88 | * parents list holds commit objects that represent its parents, but | |
89 | * they are expected to be lazily initialized and do not know what | |
90 | * their trees or parents are yet. When this function returns such a | |
91 | * half-initialised objects, the caller is expected to initialize them | |
92 | * by calling parse_object() on them. | |
93 | */ | |
5d6ccf5c | 94 | struct object *lookup_object(const unsigned char *sha1); |
6eb8ae00 | 95 | |
341e45e4 | 96 | extern void *create_object(struct repository *r, const unsigned char *sha1, void *obj); |
6eb8ae00 | 97 | |
8ff226a9 JK |
98 | void *object_as_type(struct object *obj, enum object_type type, int quiet); |
99 | ||
75a95490 JK |
100 | /* |
101 | * Returns the object, having parsed it to find out what it is. | |
102 | * | |
103 | * Returns NULL if the object is missing or corrupt. | |
104 | */ | |
c251c83d | 105 | struct object *parse_object(const struct object_id *oid); |
e9eefa67 | 106 | |
75a95490 JK |
107 | /* |
108 | * Like parse_object, but will die() instead of returning NULL. If the | |
109 | * "name" parameter is not NULL, it is included in the error message | |
c251c83d | 110 | * (otherwise, the hex object ID is given). |
75a95490 | 111 | */ |
c251c83d | 112 | struct object *parse_object_or_die(const struct object_id *oid, const char *name); |
75a95490 | 113 | |
9f613ddd JH |
114 | /* Given the result of read_sha1_file(), returns the object after |
115 | * parsing it. eaten_p indicates if the object has a borrowed copy | |
116 | * of buffer and the caller should not free() it. | |
117 | */ | |
c251c83d | 118 | struct object *parse_object_buffer(const struct object_id *oid, enum object_type type, unsigned long size, void *buffer, int *eaten_p); |
9f613ddd | 119 | |
66e481b0 DB |
120 | /** Returns the object, with potentially excess memory allocated. **/ |
121 | struct object *lookup_unknown_object(const unsigned char *sha1); | |
122 | ||
a6080a0a | 123 | struct object_list *object_list_insert(struct object *item, |
66e481b0 DB |
124 | struct object_list **list_p); |
125 | ||
66e481b0 DB |
126 | int object_list_contains(struct object_list *list, struct object *obj); |
127 | ||
1f1e895f LT |
128 | /* Object array handling .. */ |
129 | void add_object_array(struct object *obj, const char *name, struct object_array *array); | |
9e0c3c4f | 130 | void add_object_array_with_path(struct object *obj, const char *name, struct object_array *array, unsigned mode, const char *path); |
aeb4a51e | 131 | |
71992039 MÅ |
132 | /* |
133 | * Returns NULL if the array is empty. Otherwise, returns the last object | |
134 | * after removing its entry from the array. Other resources associated | |
135 | * with that object are left in an unspecified state and should not be | |
136 | * examined. | |
137 | */ | |
138 | struct object *object_array_pop(struct object_array *array); | |
139 | ||
aeb4a51e MH |
140 | typedef int (*object_array_each_func_t)(struct object_array_entry *, void *); |
141 | ||
142 | /* | |
143 | * Apply want to each entry in array, retaining only the entries for | |
144 | * which the function returns true. Preserve the order of the entries | |
145 | * that are retained. | |
146 | */ | |
147 | void object_array_filter(struct object_array *array, | |
148 | object_array_each_func_t want, void *cb_data); | |
149 | ||
1506510c MH |
150 | /* |
151 | * Remove from array all but the first entry with a given name. | |
152 | * Warning: this function uses an O(N^2) algorithm. | |
153 | */ | |
154 | void object_array_remove_duplicates(struct object_array *array); | |
1f1e895f | 155 | |
46be8231 JK |
156 | /* |
157 | * Remove any objects from the array, freeing all used memory; afterwards | |
158 | * the array is ready to store more objects with add_object_array(). | |
159 | */ | |
160 | void object_array_clear(struct object_array *array); | |
161 | ||
bcc0a3ea HV |
162 | void clear_object_flags(unsigned flags); |
163 | ||
4ad315fc RS |
164 | /* |
165 | * Clear the specified object flags from all in-core commit objects. | |
166 | */ | |
167 | extern void clear_commit_marks_all(unsigned int flags); | |
168 | ||
6eb8ae00 | 169 | #endif /* OBJECT_H */ |