git.h (view raw)
1#ifndef GIT_H
2#define GIT_H
3
4
5/*
6 * from git:git-compat-util.h
7 */
8
9
10#ifndef FLEX_ARRAY
11#if defined(__GNUC__) && (__GNUC__ < 3)
12#define FLEX_ARRAY 0
13#else
14#define FLEX_ARRAY /* empty */
15#endif
16#endif
17
18
19#include <unistd.h>
20#include <stdio.h>
21#include <sys/stat.h>
22#include <fcntl.h>
23#include <stddef.h>
24#include <stdlib.h>
25#include <stdarg.h>
26#include <string.h>
27#include <errno.h>
28#include <limits.h>
29#include <sys/param.h>
30#include <netinet/in.h>
31#include <sys/types.h>
32#include <dirent.h>
33#include <time.h>
34
35
36/* On most systems <limits.h> would have given us this, but
37 * not on some systems (e.g. GNU/Hurd).
38 */
39#ifndef PATH_MAX
40#define PATH_MAX 4096
41#endif
42
43#ifdef __GNUC__
44#define NORETURN __attribute__((__noreturn__))
45#else
46#define NORETURN
47#ifndef __attribute__
48#define __attribute__(x)
49#endif
50#endif
51
52
53extern void die(const char *err, ...) NORETURN __attribute__((format (printf, 1, 2)));
54
55
56static inline char* xstrdup(const char *str)
57{
58 char *ret = strdup(str);
59 if (!ret)
60 die("Out of memory, strdup failed");
61 return ret;
62}
63
64static inline void *xmalloc(size_t size)
65{
66 void *ret = malloc(size);
67 if (!ret && !size)
68 ret = malloc(1);
69 if (!ret)
70 die("Out of memory, malloc failed");
71#ifdef XMALLOC_POISON
72 memset(ret, 0xA5, size);
73#endif
74 return ret;
75}
76
77static inline void *xrealloc(void *ptr, size_t size)
78{
79 void *ret = realloc(ptr, size);
80 if (!ret && !size)
81 ret = realloc(ptr, 1);
82 if (!ret)
83 die("Out of memory, realloc failed");
84 return ret;
85}
86
87static inline void *xcalloc(size_t nmemb, size_t size)
88{
89 void *ret = calloc(nmemb, size);
90 if (!ret && (!nmemb || !size))
91 ret = calloc(1, 1);
92 if (!ret)
93 die("Out of memory, calloc failed");
94 return ret;
95}
96
97static inline ssize_t xread(int fd, void *buf, size_t len)
98{
99 ssize_t nr;
100 while (1) {
101 nr = read(fd, buf, len);
102 if ((nr < 0) && (errno == EAGAIN || errno == EINTR))
103 continue;
104 return nr;
105 }
106}
107
108static inline ssize_t xwrite(int fd, const void *buf, size_t len)
109{
110 ssize_t nr;
111 while (1) {
112 nr = write(fd, buf, len);
113 if ((nr < 0) && (errno == EAGAIN || errno == EINTR))
114 continue;
115 return nr;
116 }
117}
118
119
120
121
122/*
123 * from git:cache.h
124 */
125
126
127/* Convert to/from hex/sha1 representation */
128#define MINIMUM_ABBREV 4
129#define DEFAULT_ABBREV 7
130
131extern int sha1_object_info(const unsigned char *, char *, unsigned long *);
132
133extern void * read_sha1_file(const unsigned char *sha1, char *type, unsigned long *size);
134
135extern int get_sha1(const char *str, unsigned char *sha1);
136extern int get_sha1_hex(const char *hex, unsigned char *sha1);
137extern char *sha1_to_hex(const unsigned char *sha1); /* static buffer result! */
138
139
140
141/*
142 * from git:object.h
143 */
144
145struct object_list {
146 struct object *item;
147 struct object_list *next;
148};
149
150struct object_refs {
151 unsigned count;
152 struct object *base;
153 struct object *ref[FLEX_ARRAY]; /* more */
154};
155
156struct object_array {
157 unsigned int nr;
158 unsigned int alloc;
159 struct object_array_entry {
160 struct object *item;
161 const char *name;
162 } *objects;
163};
164
165#define TYPE_BITS 3
166#define FLAG_BITS 27
167
168/*
169 * The object type is stored in 3 bits.
170 */
171struct object {
172 unsigned parsed : 1;
173 unsigned used : 1;
174 unsigned type : TYPE_BITS;
175 unsigned flags : FLAG_BITS;
176 unsigned char sha1[20];
177};
178
179
180/*
181 * from git:tree.h
182 */
183
184struct tree {
185 struct object object;
186 void *buffer;
187 unsigned long size;
188};
189
190
191struct tree *lookup_tree(const unsigned char *sha1);
192int parse_tree_buffer(struct tree *item, void *buffer, unsigned long size);
193int parse_tree(struct tree *tree);
194struct tree *parse_tree_indirect(const unsigned char *sha1);
195
196typedef int (*read_tree_fn_t)(const unsigned char *, const char *, int, const char *, unsigned int, int);
197
198extern int read_tree_recursive(struct tree *tree,
199 const char *base, int baselen,
200 int stage, const char **match,
201 read_tree_fn_t fn);
202
203extern int read_tree(struct tree *tree, int stage, const char **paths);
204
205
206/* from git:commit.h */
207
208struct commit_list {
209 struct commit *item;
210 struct commit_list *next;
211};
212
213struct commit {
214 struct object object;
215 void *util;
216 unsigned long date;
217 struct commit_list *parents;
218 struct tree *tree;
219 char *buffer;
220};
221
222
223struct commit *lookup_commit(const unsigned char *sha1);
224struct commit *lookup_commit_reference(const unsigned char *sha1);
225struct commit *lookup_commit_reference_gently(const unsigned char *sha1,
226 int quiet);
227
228int parse_commit_buffer(struct commit *item, void *buffer, unsigned long size);
229int parse_commit(struct commit *item);
230
231struct commit_list * commit_list_insert(struct commit *item, struct commit_list **list_p);
232struct commit_list * insert_by_date(struct commit *item, struct commit_list **list);
233
234void free_commit_list(struct commit_list *list);
235
236void sort_by_date(struct commit_list **list);
237
238/* Commit formats */
239enum cmit_fmt {
240 CMIT_FMT_RAW,
241 CMIT_FMT_MEDIUM,
242 CMIT_FMT_DEFAULT = CMIT_FMT_MEDIUM,
243 CMIT_FMT_SHORT,
244 CMIT_FMT_FULL,
245 CMIT_FMT_FULLER,
246 CMIT_FMT_ONELINE,
247 CMIT_FMT_EMAIL,
248
249 CMIT_FMT_UNSPECIFIED,
250};
251
252extern unsigned long pretty_print_commit(enum cmit_fmt fmt, const struct commit *, unsigned long len, char *buf, unsigned long space, int abbrev, const char *subject, const char *after_subject, int relative_date);
253
254
255typedef void (*topo_sort_set_fn_t)(struct commit*, void *data);
256typedef void* (*topo_sort_get_fn_t)(struct commit*);
257
258
259
260
261/*
262 * from git:diff.h
263 */
264
265
266struct rev_info;
267struct diff_options;
268struct diff_queue_struct;
269
270typedef void (*change_fn_t)(struct diff_options *options,
271 unsigned old_mode, unsigned new_mode,
272 const unsigned char *old_sha1,
273 const unsigned char *new_sha1,
274 const char *base, const char *path);
275
276typedef void (*add_remove_fn_t)(struct diff_options *options,
277 int addremove, unsigned mode,
278 const unsigned char *sha1,
279 const char *base, const char *path);
280
281typedef void (*diff_format_fn_t)(struct diff_queue_struct *q,
282 struct diff_options *options, void *data);
283
284#define DIFF_FORMAT_RAW 0x0001
285#define DIFF_FORMAT_DIFFSTAT 0x0002
286#define DIFF_FORMAT_NUMSTAT 0x0004
287#define DIFF_FORMAT_SUMMARY 0x0008
288#define DIFF_FORMAT_PATCH 0x0010
289
290/* These override all above */
291#define DIFF_FORMAT_NAME 0x0100
292#define DIFF_FORMAT_NAME_STATUS 0x0200
293#define DIFF_FORMAT_CHECKDIFF 0x0400
294
295/* Same as output_format = 0 but we know that -s flag was given
296 * and we should not give default value to output_format.
297 */
298#define DIFF_FORMAT_NO_OUTPUT 0x0800
299
300#define DIFF_FORMAT_CALLBACK 0x1000
301
302struct diff_options {
303 const char *filter;
304 const char *orderfile;
305 const char *pickaxe;
306 const char *single_follow;
307 unsigned recursive:1,
308 tree_in_recursive:1,
309 binary:1,
310 text:1,
311 full_index:1,
312 silent_on_remove:1,
313 find_copies_harder:1,
314 color_diff:1,
315 color_diff_words:1;
316 int context;
317 int break_opt;
318 int detect_rename;
319 int line_termination;
320 int output_format;
321 int pickaxe_opts;
322 int rename_score;
323 int reverse_diff;
324 int rename_limit;
325 int setup;
326 int abbrev;
327 const char *msg_sep;
328 const char *stat_sep;
329 long xdl_opts;
330
331 int stat_width;
332 int stat_name_width;
333
334 int nr_paths;
335 const char **paths;
336 int *pathlens;
337 change_fn_t change;
338 add_remove_fn_t add_remove;
339 diff_format_fn_t format_callback;
340 void *format_callback_data;
341};
342
343enum color_diff {
344 DIFF_RESET = 0,
345 DIFF_PLAIN = 1,
346 DIFF_METAINFO = 2,
347 DIFF_FRAGINFO = 3,
348 DIFF_FILE_OLD = 4,
349 DIFF_FILE_NEW = 5,
350 DIFF_COMMIT = 6,
351 DIFF_WHITESPACE = 7,
352};
353
354
355
356
357/*
358 * from git:refs.g
359 */
360
361typedef int each_ref_fn(const char *refname, const unsigned char *sha1, int flags, void *cb_data);
362extern int head_ref(each_ref_fn, void *);
363extern int for_each_ref(each_ref_fn, void *);
364extern int for_each_tag_ref(each_ref_fn, void *);
365extern int for_each_branch_ref(each_ref_fn, void *);
366extern int for_each_remote_ref(each_ref_fn, void *);
367
368
369
370/*
371 * from git:revision.h
372 */
373
374struct rev_info;
375struct log_info;
376
377typedef void (prune_fn_t)(struct rev_info *revs, struct commit *commit);
378
379struct rev_info {
380 /* Starting list */
381 struct commit_list *commits;
382 struct object_array pending;
383
384 /* Basic information */
385 const char *prefix;
386 void *prune_data;
387 prune_fn_t *prune_fn;
388
389 /* Traversal flags */
390 unsigned int dense:1,
391 no_merges:1,
392 no_walk:1,
393 remove_empty_trees:1,
394 simplify_history:1,
395 lifo:1,
396 topo_order:1,
397 tag_objects:1,
398 tree_objects:1,
399 blob_objects:1,
400 edge_hint:1,
401 limited:1,
402 unpacked:1, /* see also ignore_packed below */
403 boundary:1,
404 parents:1;
405
406 /* Diff flags */
407 unsigned int diff:1,
408 full_diff:1,
409 show_root_diff:1,
410 no_commit_id:1,
411 verbose_header:1,
412 ignore_merges:1,
413 combine_merges:1,
414 dense_combined_merges:1,
415 always_show_header:1;
416
417 /* Format info */
418 unsigned int shown_one:1,
419 abbrev_commit:1,
420 relative_date:1;
421
422 const char **ignore_packed; /* pretend objects in these are unpacked */
423 int num_ignore_packed;
424
425 unsigned int abbrev;
426 enum cmit_fmt commit_format;
427 struct log_info *loginfo;
428 int nr, total;
429 const char *mime_boundary;
430 const char *message_id;
431 const char *ref_message_id;
432 const char *add_signoff;
433 const char *extra_headers;
434
435 /* Filter by commit log message */
436 struct grep_opt *grep_filter;
437
438 /* special limits */
439 int max_count;
440 unsigned long max_age;
441 unsigned long min_age;
442
443 /* diff info for patches and for paths limiting */
444 struct diff_options diffopt;
445 struct diff_options pruning;
446
447 topo_sort_set_fn_t topo_setter;
448 topo_sort_get_fn_t topo_getter;
449};
450
451
452extern void init_revisions(struct rev_info *revs, const char *prefix);
453extern int setup_revisions(int argc, const char **argv, struct rev_info *revs, const char *def);
454extern int handle_revision_arg(const char *arg, struct rev_info *revs,int flags,int cant_be_filename);
455
456extern void prepare_revision_walk(struct rev_info *revs);
457extern struct commit *get_revision(struct rev_info *revs);
458
459
460
461
462#endif /* GIT_H */