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 /** Returns the object, having parsed it to find out what it is. **/
 282 struct object *parse_object(const unsigned char *sha1);
 283
 284
 285 /*
 286  * from git:tree.h
 287  */
 288
 289 struct tree {
 290         struct object object;
 291         void *buffer;
 292         unsigned long size;
 293 };
 294
 295
 296 struct tree *lookup_tree(const unsigned char *sha1);
 297 int parse_tree_buffer(struct tree *item, void *buffer, unsigned long size);
 298 int parse_tree(struct tree *tree);
 299 struct tree *parse_tree_indirect(const unsigned char *sha1);
 300
 301 typedef int (*read_tree_fn_t)(const unsigned char *, const char *, int, const char *, unsigned int, int);
 302
 303 extern int read_tree_recursive(struct tree *tree,
 304                                const char *base, int baselen,
 305                                int stage, const char **match,
 306                                read_tree_fn_t fn);
 307
 308 extern int read_tree(struct tree *tree, int stage, const char **paths);
 309
 310
 311 /* from git:commit.h */
 312
 313 struct commit_list {
 314         struct commit *item;
 315         struct commit_list *next;
 316 };
 317
 318 struct commit {
 319         struct object object;
 320         void *util;
 321         unsigned long date;
 322         struct commit_list *parents;
 323         struct tree *tree;
 324         char *buffer;
 325 };
 326
 327
 328 struct commit *lookup_commit(const unsigned char *sha1);
 329 struct commit *lookup_commit_reference(const unsigned char *sha1);
 330 struct commit *lookup_commit_reference_gently(const unsigned char *sha1,
 331                                               int quiet);
 332
 333 int parse_commit_buffer(struct commit *item, void *buffer, unsigned long size);
 334 int parse_commit(struct commit *item);
 335
 336 struct commit_list * commit_list_insert(struct commit *item, struct commit_list **list_p);
 337 struct commit_list * insert_by_date(struct commit *item, struct commit_list **list);
 338
 339 void free_commit_list(struct commit_list *list);
 340
 341 void sort_by_date(struct commit_list **list);
 342
 343 /* Commit formats */
 344 enum cmit_fmt {
 345         CMIT_FMT_RAW,
 346         CMIT_FMT_MEDIUM,
 347         CMIT_FMT_DEFAULT = CMIT_FMT_MEDIUM,
 348         CMIT_FMT_SHORT,
 349         CMIT_FMT_FULL,
 350         CMIT_FMT_FULLER,
 351         CMIT_FMT_ONELINE,
 352         CMIT_FMT_EMAIL,
 353
 354         CMIT_FMT_UNSPECIFIED,
 355 };
 356
 357 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);
 358
 359
 360 typedef void (*topo_sort_set_fn_t)(struct commit*, void *data);
 361 typedef void* (*topo_sort_get_fn_t)(struct commit*);
 362
 363
 364
 365 /*
 366  * from git:tag.h
 367  */
 368
 369 extern const char *tag_type;
 370
 371 struct tag {
 372         struct object object;
 373         struct object *tagged;
 374         char *tag;
 375         char *signature; /* not actually implemented */
 376 };
 377
 378 extern struct tag *lookup_tag(const unsigned char *sha1);
 379 extern int parse_tag_buffer(struct tag *item, void *data, unsigned long size);
 380 extern int parse_tag(struct tag *item);
 381 extern struct object *deref_tag(struct object *, const char *, int);
 382
 383
 384 /*
 385  * from git:diffcore.h
 386  */
 387
 388 struct diff_filespec {
 389         unsigned char sha1[20];
 390         char *path;
 391         void *data;
 392         void *cnt_data;
 393         unsigned long size;
 394         int xfrm_flags;          /* for use by the xfrm */
 395         unsigned short mode;     /* file mode */
 396         unsigned sha1_valid : 1; /* if true, use sha1 and trust mode;
 397                                   * if false, use the name and read from
 398                                   * the filesystem.
 399                                   */
 400 #define DIFF_FILE_VALID(spec) (((spec)->mode) != 0)
 401         unsigned should_free : 1; /* data should be free()'ed */
 402         unsigned should_munmap : 1; /* data should be munmap()'ed */
 403 };
 404
 405 struct diff_filepair {
 406         struct diff_filespec *one;
 407         struct diff_filespec *two;
 408         unsigned short int score;
 409         char status; /* M C R N D U (see Documentation/diff-format.txt) */
 410         unsigned source_stays : 1; /* all of R/C are copies */
 411         unsigned broken_pair : 1;
 412         unsigned renamed_pair : 1;
 413 };
 414
 415 #define DIFF_PAIR_UNMERGED(p) \
 416         (!DIFF_FILE_VALID((p)->one) && !DIFF_FILE_VALID((p)->two))
 417
 418 #define DIFF_PAIR_RENAME(p) ((p)->renamed_pair)
 419
 420 #define DIFF_PAIR_BROKEN(p) \
 421         ( (!DIFF_FILE_VALID((p)->one) != !DIFF_FILE_VALID((p)->two)) && \
 422           ((p)->broken_pair != 0) )
 423
 424 #define DIFF_PAIR_TYPE_CHANGED(p) \
 425         ((S_IFMT & (p)->one->mode) != (S_IFMT & (p)->two->mode))
 426
 427 #define DIFF_PAIR_MODE_CHANGED(p) ((p)->one->mode != (p)->two->mode)
 428
 429 extern void diff_free_filepair(struct diff_filepair *);
 430
 431 extern int diff_unmodified_pair(struct diff_filepair *);
 432
 433 struct diff_queue_struct {
 434         struct diff_filepair **queue;
 435         int alloc;
 436         int nr;
 437 };
 438
 439
 440 /*
 441  *  from git:diff.h
 442  */
 443
 444
 445 struct rev_info;
 446 struct diff_options;
 447 struct diff_queue_struct;
 448
 449 typedef void (*change_fn_t)(struct diff_options *options,
 450                  unsigned old_mode, unsigned new_mode,
 451                  const unsigned char *old_sha1,
 452                  const unsigned char *new_sha1,
 453                  const char *base, const char *path);
 454
 455 typedef void (*add_remove_fn_t)(struct diff_options *options,
 456                     int addremove, unsigned mode,
 457                     const unsigned char *sha1,
 458                     const char *base, const char *path);
 459
 460 typedef void (*diff_format_fn_t)(struct diff_queue_struct *q,
 461                 struct diff_options *options, void *data);
 462
 463 #define DIFF_FORMAT_RAW         0x0001
 464 #define DIFF_FORMAT_DIFFSTAT    0x0002
 465 #define DIFF_FORMAT_NUMSTAT     0x0004
 466 #define DIFF_FORMAT_SUMMARY     0x0008
 467 #define DIFF_FORMAT_PATCH       0x0010
 468
 469 /* These override all above */
 470 #define DIFF_FORMAT_NAME        0x0100
 471 #define DIFF_FORMAT_NAME_STATUS 0x0200
 472 #define DIFF_FORMAT_CHECKDIFF   0x0400
 473
 474 /* Same as output_format = 0 but we know that -s flag was given
 475  * and we should not give default value to output_format.
 476  */
 477 #define DIFF_FORMAT_NO_OUTPUT   0x0800
 478
 479 #define DIFF_FORMAT_CALLBACK    0x1000
 480
 481 struct diff_options {
 482         const char *filter;
 483         const char *orderfile;
 484         const char *pickaxe;
 485         const char *single_follow;
 486         unsigned recursive:1,
 487                  tree_in_recursive:1,
 488                  binary:1,
 489                  text:1,
 490                  full_index:1,
 491                  silent_on_remove:1,
 492                  find_copies_harder:1,
 493                  color_diff:1,
 494                  color_diff_words:1;
 495         int context;
 496         int break_opt;
 497         int detect_rename;
 498         int line_termination;
 499         int output_format;
 500         int pickaxe_opts;
 501         int rename_score;
 502         int reverse_diff;
 503         int rename_limit;
 504         int setup;
 505         int abbrev;
 506         const char *msg_sep;
 507         const char *stat_sep;
 508         long xdl_opts;
 509
 510         int stat_width;
 511         int stat_name_width;
 512
 513         int nr_paths;
 514         const char **paths;
 515         int *pathlens;
 516         change_fn_t change;
 517         add_remove_fn_t add_remove;
 518         diff_format_fn_t format_callback;
 519         void *format_callback_data;
 520 };
 521
 522 enum color_diff {
 523         DIFF_RESET = 0,
 524         DIFF_PLAIN = 1,
 525         DIFF_METAINFO = 2,
 526         DIFF_FRAGINFO = 3,
 527         DIFF_FILE_OLD = 4,
 528         DIFF_FILE_NEW = 5,
 529         DIFF_COMMIT = 6,
 530         DIFF_WHITESPACE = 7,
 531 };
 532
 533
 534 extern int diff_tree_sha1(const unsigned char *old, const unsigned char *new,
 535                           const char *base, struct diff_options *opt);
 536
 537 extern int diff_root_tree_sha1(const unsigned char *new, const char *base,
 538                                struct diff_options *opt);
 539
 540 extern int git_diff_ui_config(const char *var, const char *value);
 541 extern void diff_setup(struct diff_options *);
 542 extern int diff_opt_parse(struct diff_options *, const char **, int);
 543 extern int diff_setup_done(struct diff_options *);
 544
 545
 546 extern void diffcore_std(struct diff_options *);
 547 extern void diff_flush(struct diff_options*);
 548
 549
 550 /* diff-raw status letters */
 551 #define DIFF_STATUS_ADDED               'A'
 552 #define DIFF_STATUS_COPIED              'C'
 553 #define DIFF_STATUS_DELETED             'D'
 554 #define DIFF_STATUS_MODIFIED            'M'
 555 #define DIFF_STATUS_RENAMED             'R'
 556 #define DIFF_STATUS_TYPE_CHANGED        'T'
 557 #define DIFF_STATUS_UNKNOWN             'X'
 558 #define DIFF_STATUS_UNMERGED            'U'
 559
 560
 561
 562 /*
 563  * from git:refs.g
 564  */
 565
 566 typedef int each_ref_fn(const char *refname, const unsigned char *sha1, int flags, void *cb_data);
 567 extern int head_ref(each_ref_fn, void *);
 568 extern int for_each_ref(each_ref_fn, void *);
 569 extern int for_each_tag_ref(each_ref_fn, void *);
 570 extern int for_each_branch_ref(each_ref_fn, void *);
 571 extern int for_each_remote_ref(each_ref_fn, void *);
 572
 573
 574
 575 /*
 576  * from git:revision.h
 577  */
 578
 579 struct rev_info;
 580 struct log_info;
 581
 582 typedef void (prune_fn_t)(struct rev_info *revs, struct commit *commit);
 583
 584 struct rev_info {
 585         /* Starting list */
 586         struct commit_list *commits;
 587         struct object_array pending;
 588
 589         /* Basic information */
 590         const char *prefix;
 591         void *prune_data;
 592         prune_fn_t *prune_fn;
 593
 594         /* Traversal flags */
 595         unsigned int    dense:1,
 596                         no_merges:1,
 597                         no_walk:1,
 598                         remove_empty_trees:1,
 599                         simplify_history:1,
 600                         lifo:1,
 601                         topo_order:1,
 602                         tag_objects:1,
 603                         tree_objects:1,
 604                         blob_objects:1,
 605                         edge_hint:1,
 606                         limited:1,
 607                         unpacked:1, /* see also ignore_packed below */
 608                         boundary:1,
 609                         parents:1;
 610
 611         /* Diff flags */
 612         unsigned int    diff:1,
 613                         full_diff:1,
 614                         show_root_diff:1,
 615                         no_commit_id:1,
 616                         verbose_header:1,
 617                         ignore_merges:1,
 618                         combine_merges:1,
 619                         dense_combined_merges:1,
 620                         always_show_header:1;
 621
 622         /* Format info */
 623         unsigned int    shown_one:1,
 624                         abbrev_commit:1,
 625                         relative_date:1;
 626
 627         const char **ignore_packed; /* pretend objects in these are unpacked */
 628         int num_ignore_packed;
 629
 630         unsigned int    abbrev;
 631         enum cmit_fmt   commit_format;
 632         struct log_info *loginfo;
 633         int             nr, total;
 634         const char      *mime_boundary;
 635         const char      *message_id;
 636         const char      *ref_message_id;
 637         const char      *add_signoff;
 638         const char      *extra_headers;
 639
 640         /* Filter by commit log message */
 641         struct grep_opt *grep_filter;
 642
 643         /* special limits */
 644         int max_count;
 645         unsigned long max_age;
 646         unsigned long min_age;
 647
 648         /* diff info for patches and for paths limiting */
 649         struct diff_options diffopt;
 650         struct diff_options pruning;
 651
 652         topo_sort_set_fn_t topo_setter;
 653         topo_sort_get_fn_t topo_getter;
 654 };
 655
 656
 657 extern void init_revisions(struct rev_info *revs, const char *prefix);
 658 extern int setup_revisions(int argc, const char **argv, struct rev_info *revs, const char *def);
 659 extern int handle_revision_arg(const char *arg, struct rev_info *revs,int flags,int cant_be_filename);
 660
 661 extern void prepare_revision_walk(struct rev_info *revs);
 662 extern struct commit *get_revision(struct rev_info *revs);
 663
 664
 665
 666 /* from git:log-tree.h */
 667
 668 int log_tree_commit(struct rev_info *, struct commit *);
 669
 670
 671
 672 #endif /* GIT_H */