]> gitweb.ps.run Git - ps-cgit/blob - git.h
Update README with install/config information
[ps-cgit] / git.h
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 #include <regex.h>
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
53 extern void die(const char *err, ...) NORETURN __attribute__((format (printf, 1, 2)));
54
55
56 static 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
64 static 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
77 static 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
87 static 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
97 static 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
108 static 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 enum object_type {
128         OBJ_NONE = 0,
129         OBJ_COMMIT = 1,
130         OBJ_TREE = 2,
131         OBJ_BLOB = 3,
132         OBJ_TAG = 4,
133         /* 5 for future expansion */
134         OBJ_OFS_DELTA = 6,
135         OBJ_REF_DELTA = 7,
136         OBJ_BAD,
137 };
138
139
140 /* Convert to/from hex/sha1 representation */
141 #define MINIMUM_ABBREV 4
142 #define DEFAULT_ABBREV 7
143
144 extern const unsigned char null_sha1[20];
145
146 extern int sha1_object_info(const unsigned char *, char *, unsigned long *);
147
148 extern void * read_sha1_file(const unsigned char *sha1, char *type, unsigned long *size);
149
150 extern int get_sha1(const char *str, unsigned char *sha1);
151 extern int get_sha1_hex(const char *hex, unsigned char *sha1);
152 extern char *sha1_to_hex(const unsigned char *sha1);    /* static buffer result! */
153
154 static inline int is_null_sha1(const unsigned char *sha1)
155 {
156         return !memcmp(sha1, null_sha1, 20);
157 }
158 static inline int hashcmp(const unsigned char *sha1, const unsigned char *sha2)
159 {
160         return memcmp(sha1, sha2, 20);
161 }
162 static inline void hashcpy(unsigned char *sha_dst, const unsigned char *sha_src)
163 {
164         memcpy(sha_dst, sha_src, 20);
165 }
166 static inline void hashclr(unsigned char *hash)
167 {
168         memset(hash, 0, 20);
169 }
170
171
172 /*
173  * from git:grep.h
174  */
175
176 enum grep_pat_token {
177         GREP_PATTERN,
178         GREP_PATTERN_HEAD,
179         GREP_PATTERN_BODY,
180         GREP_AND,
181         GREP_OPEN_PAREN,
182         GREP_CLOSE_PAREN,
183         GREP_NOT,
184         GREP_OR,
185 };
186
187 enum grep_context {
188         GREP_CONTEXT_HEAD,
189         GREP_CONTEXT_BODY,
190 };
191
192 struct grep_pat {
193         struct grep_pat *next;
194         const char *origin;
195         int no;
196         enum grep_pat_token token;
197         const char *pattern;
198         regex_t regexp;
199 };
200
201 enum grep_expr_node {
202         GREP_NODE_ATOM,
203         GREP_NODE_NOT,
204         GREP_NODE_AND,
205         GREP_NODE_OR,
206 };
207
208 struct grep_opt {
209         struct grep_pat *pattern_list;
210         struct grep_pat **pattern_tail;
211         struct grep_expr *pattern_expression;
212         int prefix_length;
213         regex_t regexp;
214         unsigned linenum:1;
215         unsigned invert:1;
216         unsigned status_only:1;
217         unsigned name_only:1;
218         unsigned unmatch_name_only:1;
219         unsigned count:1;
220         unsigned word_regexp:1;
221         unsigned fixed:1;
222         unsigned all_match:1;
223 #define GREP_BINARY_DEFAULT     0
224 #define GREP_BINARY_NOMATCH     1
225 #define GREP_BINARY_TEXT        2
226         unsigned binary:2;
227         unsigned extended:1;
228         unsigned relative:1;
229         unsigned pathname:1;
230         int regflags;
231         unsigned pre_context;
232         unsigned post_context;
233 };
234
235
236 extern void compile_grep_patterns(struct grep_opt *opt);
237 extern void free_grep_patterns(struct grep_opt *opt);
238
239
240 /*
241  * from git:object.h 
242  */
243
244 extern const char *type_names[9];
245
246 struct object_list {
247         struct object *item;
248         struct object_list *next;
249 };
250
251 struct object_refs {
252         unsigned count;
253         struct object *base;
254         struct object *ref[FLEX_ARRAY]; /* more */
255 };
256
257 struct object_array {
258         unsigned int nr;
259         unsigned int alloc;
260         struct object_array_entry {
261                 struct object *item;
262                 const char *name;
263         } *objects;
264 };
265
266 #define TYPE_BITS   3
267 #define FLAG_BITS  27
268
269 /*
270  * The object type is stored in 3 bits.
271  */
272 struct object {
273         unsigned parsed : 1;
274         unsigned used : 1;
275         unsigned type : TYPE_BITS;
276         unsigned flags : FLAG_BITS;
277         unsigned char sha1[20];
278 };
279
280
281 /*
282  * from git:tree.h
283  */
284
285 struct tree {
286         struct object object;
287         void *buffer;
288         unsigned long size;
289 };
290
291
292 struct tree *lookup_tree(const unsigned char *sha1);
293 int parse_tree_buffer(struct tree *item, void *buffer, unsigned long size);
294 int parse_tree(struct tree *tree);
295 struct tree *parse_tree_indirect(const unsigned char *sha1);
296
297 typedef int (*read_tree_fn_t)(const unsigned char *, const char *, int, const char *, unsigned int, int);
298
299 extern int read_tree_recursive(struct tree *tree,
300                                const char *base, int baselen,
301                                int stage, const char **match,
302                                read_tree_fn_t fn);
303
304 extern int read_tree(struct tree *tree, int stage, const char **paths);
305
306
307 /* from git:commit.h */
308
309 struct commit_list {
310         struct commit *item;
311         struct commit_list *next;
312 };
313
314 struct commit {
315         struct object object;
316         void *util;
317         unsigned long date;
318         struct commit_list *parents;
319         struct tree *tree;
320         char *buffer;
321 };
322
323
324 struct commit *lookup_commit(const unsigned char *sha1);
325 struct commit *lookup_commit_reference(const unsigned char *sha1);
326 struct commit *lookup_commit_reference_gently(const unsigned char *sha1,
327                                               int quiet);
328
329 int parse_commit_buffer(struct commit *item, void *buffer, unsigned long size);
330 int parse_commit(struct commit *item);
331
332 struct commit_list * commit_list_insert(struct commit *item, struct commit_list **list_p);
333 struct commit_list * insert_by_date(struct commit *item, struct commit_list **list);
334
335 void free_commit_list(struct commit_list *list);
336
337 void sort_by_date(struct commit_list **list);
338
339 /* Commit formats */
340 enum cmit_fmt {
341         CMIT_FMT_RAW,
342         CMIT_FMT_MEDIUM,
343         CMIT_FMT_DEFAULT = CMIT_FMT_MEDIUM,
344         CMIT_FMT_SHORT,
345         CMIT_FMT_FULL,
346         CMIT_FMT_FULLER,
347         CMIT_FMT_ONELINE,
348         CMIT_FMT_EMAIL,
349
350         CMIT_FMT_UNSPECIFIED,
351 };
352
353 extern 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);
354
355
356 typedef void (*topo_sort_set_fn_t)(struct commit*, void *data);
357 typedef void* (*topo_sort_get_fn_t)(struct commit*);
358
359
360
361 /*
362  * from git:tag.h
363  */
364
365 extern const char *tag_type;
366
367 struct tag {
368         struct object object;
369         struct object *tagged;
370         char *tag;
371         char *signature; /* not actually implemented */
372 };
373
374 extern struct tag *lookup_tag(const unsigned char *sha1);
375 extern int parse_tag_buffer(struct tag *item, void *data, unsigned long size);
376 extern int parse_tag(struct tag *item);
377 extern struct object *deref_tag(struct object *, const char *, int);
378
379
380 /*
381  * from git:diffcore.h
382  */
383
384 struct diff_filespec {
385         unsigned char sha1[20];
386         char *path;
387         void *data;
388         void *cnt_data;
389         unsigned long size;
390         int xfrm_flags;          /* for use by the xfrm */
391         unsigned short mode;     /* file mode */
392         unsigned sha1_valid : 1; /* if true, use sha1 and trust mode;
393                                   * if false, use the name and read from
394                                   * the filesystem.
395                                   */
396 #define DIFF_FILE_VALID(spec) (((spec)->mode) != 0)
397         unsigned should_free : 1; /* data should be free()'ed */
398         unsigned should_munmap : 1; /* data should be munmap()'ed */
399 };
400
401 struct diff_filepair {
402         struct diff_filespec *one;
403         struct diff_filespec *two;
404         unsigned short int score;
405         char status; /* M C R N D U (see Documentation/diff-format.txt) */
406         unsigned source_stays : 1; /* all of R/C are copies */
407         unsigned broken_pair : 1;
408         unsigned renamed_pair : 1;
409 };
410
411 #define DIFF_PAIR_UNMERGED(p) \
412         (!DIFF_FILE_VALID((p)->one) && !DIFF_FILE_VALID((p)->two))
413
414 #define DIFF_PAIR_RENAME(p) ((p)->renamed_pair)
415
416 #define DIFF_PAIR_BROKEN(p) \
417         ( (!DIFF_FILE_VALID((p)->one) != !DIFF_FILE_VALID((p)->two)) && \
418           ((p)->broken_pair != 0) )
419
420 #define DIFF_PAIR_TYPE_CHANGED(p) \
421         ((S_IFMT & (p)->one->mode) != (S_IFMT & (p)->two->mode))
422
423 #define DIFF_PAIR_MODE_CHANGED(p) ((p)->one->mode != (p)->two->mode)
424
425 extern void diff_free_filepair(struct diff_filepair *);
426
427 extern int diff_unmodified_pair(struct diff_filepair *);
428
429 struct diff_queue_struct {
430         struct diff_filepair **queue;
431         int alloc;
432         int nr;
433 };
434
435
436 /*
437  *  from git:diff.h
438  */
439
440
441 struct rev_info;
442 struct diff_options;
443 struct diff_queue_struct;
444
445 typedef void (*change_fn_t)(struct diff_options *options,
446                  unsigned old_mode, unsigned new_mode,
447                  const unsigned char *old_sha1,
448                  const unsigned char *new_sha1,
449                  const char *base, const char *path);
450
451 typedef void (*add_remove_fn_t)(struct diff_options *options,
452                     int addremove, unsigned mode,
453                     const unsigned char *sha1,
454                     const char *base, const char *path);
455
456 typedef void (*diff_format_fn_t)(struct diff_queue_struct *q,
457                 struct diff_options *options, void *data);
458
459 #define DIFF_FORMAT_RAW         0x0001
460 #define DIFF_FORMAT_DIFFSTAT    0x0002
461 #define DIFF_FORMAT_NUMSTAT     0x0004
462 #define DIFF_FORMAT_SUMMARY     0x0008
463 #define DIFF_FORMAT_PATCH       0x0010
464
465 /* These override all above */
466 #define DIFF_FORMAT_NAME        0x0100
467 #define DIFF_FORMAT_NAME_STATUS 0x0200
468 #define DIFF_FORMAT_CHECKDIFF   0x0400
469
470 /* Same as output_format = 0 but we know that -s flag was given
471  * and we should not give default value to output_format.
472  */
473 #define DIFF_FORMAT_NO_OUTPUT   0x0800
474
475 #define DIFF_FORMAT_CALLBACK    0x1000
476
477 struct diff_options {
478         const char *filter;
479         const char *orderfile;
480         const char *pickaxe;
481         const char *single_follow;
482         unsigned recursive:1,
483                  tree_in_recursive:1,
484                  binary:1,
485                  text:1,
486                  full_index:1,
487                  silent_on_remove:1,
488                  find_copies_harder:1,
489                  color_diff:1,
490                  color_diff_words:1;
491         int context;
492         int break_opt;
493         int detect_rename;
494         int line_termination;
495         int output_format;
496         int pickaxe_opts;
497         int rename_score;
498         int reverse_diff;
499         int rename_limit;
500         int setup;
501         int abbrev;
502         const char *msg_sep;
503         const char *stat_sep;
504         long xdl_opts;
505
506         int stat_width;
507         int stat_name_width;
508
509         int nr_paths;
510         const char **paths;
511         int *pathlens;
512         change_fn_t change;
513         add_remove_fn_t add_remove;
514         diff_format_fn_t format_callback;
515         void *format_callback_data;
516 };
517
518 enum color_diff {
519         DIFF_RESET = 0,
520         DIFF_PLAIN = 1,
521         DIFF_METAINFO = 2,
522         DIFF_FRAGINFO = 3,
523         DIFF_FILE_OLD = 4,
524         DIFF_FILE_NEW = 5,
525         DIFF_COMMIT = 6,
526         DIFF_WHITESPACE = 7,
527 };
528
529
530 extern int diff_tree_sha1(const unsigned char *old, const unsigned char *new,
531                           const char *base, struct diff_options *opt);
532
533 extern int diff_root_tree_sha1(const unsigned char *new, const char *base,
534                                struct diff_options *opt);
535
536 extern int git_diff_ui_config(const char *var, const char *value);
537 extern void diff_setup(struct diff_options *);
538 extern int diff_opt_parse(struct diff_options *, const char **, int);
539 extern int diff_setup_done(struct diff_options *);
540
541
542 extern void diffcore_std(struct diff_options *);
543 extern void diff_flush(struct diff_options*);
544
545
546 /* diff-raw status letters */
547 #define DIFF_STATUS_ADDED               'A'
548 #define DIFF_STATUS_COPIED              'C'
549 #define DIFF_STATUS_DELETED             'D'
550 #define DIFF_STATUS_MODIFIED            'M'
551 #define DIFF_STATUS_RENAMED             'R'
552 #define DIFF_STATUS_TYPE_CHANGED        'T'
553 #define DIFF_STATUS_UNKNOWN             'X'
554 #define DIFF_STATUS_UNMERGED            'U'
555
556
557
558 /*
559  * from git:refs.g
560  */
561
562 typedef int each_ref_fn(const char *refname, const unsigned char *sha1, int flags, void *cb_data);
563 extern int head_ref(each_ref_fn, void *);
564 extern int for_each_ref(each_ref_fn, void *);
565 extern int for_each_tag_ref(each_ref_fn, void *);
566 extern int for_each_branch_ref(each_ref_fn, void *);
567 extern int for_each_remote_ref(each_ref_fn, void *);
568
569
570
571 /*
572  * from git:revision.h
573  */
574
575 struct rev_info;
576 struct log_info;
577
578 typedef void (prune_fn_t)(struct rev_info *revs, struct commit *commit);
579
580 struct rev_info {
581         /* Starting list */
582         struct commit_list *commits;
583         struct object_array pending;
584
585         /* Basic information */
586         const char *prefix;
587         void *prune_data;
588         prune_fn_t *prune_fn;
589
590         /* Traversal flags */
591         unsigned int    dense:1,
592                         no_merges:1,
593                         no_walk:1,
594                         remove_empty_trees:1,
595                         simplify_history:1,
596                         lifo:1,
597                         topo_order:1,
598                         tag_objects:1,
599                         tree_objects:1,
600                         blob_objects:1,
601                         edge_hint:1,
602                         limited:1,
603                         unpacked:1, /* see also ignore_packed below */
604                         boundary:1,
605                         parents:1;
606
607         /* Diff flags */
608         unsigned int    diff:1,
609                         full_diff:1,
610                         show_root_diff:1,
611                         no_commit_id:1,
612                         verbose_header:1,
613                         ignore_merges:1,
614                         combine_merges:1,
615                         dense_combined_merges:1,
616                         always_show_header:1;
617
618         /* Format info */
619         unsigned int    shown_one:1,
620                         abbrev_commit:1,
621                         relative_date:1;
622
623         const char **ignore_packed; /* pretend objects in these are unpacked */
624         int num_ignore_packed;
625
626         unsigned int    abbrev;
627         enum cmit_fmt   commit_format;
628         struct log_info *loginfo;
629         int             nr, total;
630         const char      *mime_boundary;
631         const char      *message_id;
632         const char      *ref_message_id;
633         const char      *add_signoff;
634         const char      *extra_headers;
635
636         /* Filter by commit log message */
637         struct grep_opt *grep_filter;
638
639         /* special limits */
640         int max_count;
641         unsigned long max_age;
642         unsigned long min_age;
643
644         /* diff info for patches and for paths limiting */
645         struct diff_options diffopt;
646         struct diff_options pruning;
647
648         topo_sort_set_fn_t topo_setter;
649         topo_sort_get_fn_t topo_getter;
650 };
651
652
653 extern void init_revisions(struct rev_info *revs, const char *prefix);
654 extern int setup_revisions(int argc, const char **argv, struct rev_info *revs, const char *def);
655 extern int handle_revision_arg(const char *arg, struct rev_info *revs,int flags,int cant_be_filename);
656
657 extern void prepare_revision_walk(struct rev_info *revs);
658 extern struct commit *get_revision(struct rev_info *revs);
659
660
661
662 /* from git:log-tree.h */
663
664 int log_tree_commit(struct rev_info *, struct commit *);
665
666
667
668 #endif /* GIT_H */