init_buffer(): Kill buf pointer
[git/git.git] / commit.h
1 #ifndef COMMIT_H
2 #define COMMIT_H
3
4 #include "object.h"
5 #include "tree.h"
6 #include "decorate.h"
7
8 struct commit_list {
9 struct commit *item;
10 struct commit_list *next;
11 };
12
13 struct commit {
14 struct object object;
15 void *util;
16 unsigned long date;
17 struct commit_list *parents;
18 struct tree *tree;
19 char *buffer;
20 };
21
22 extern int save_commit_buffer;
23 extern const char *commit_type;
24
25 /* While we can decorate any object with a name, it's only used for commits.. */
26 extern struct decoration name_decoration;
27 struct name_decoration {
28 struct name_decoration *next;
29 char name[1];
30 };
31
32 struct commit *lookup_commit(const unsigned char *sha1);
33 struct commit *lookup_commit_reference(const unsigned char *sha1);
34 struct commit *lookup_commit_reference_gently(const unsigned char *sha1,
35 int quiet);
36
37 int parse_commit_buffer(struct commit *item, void *buffer, unsigned long size);
38
39 int parse_commit(struct commit *item);
40
41 struct commit_list * commit_list_insert(struct commit *item, struct commit_list **list_p);
42 struct commit_list * insert_by_date(struct commit *item, struct commit_list **list);
43
44 void free_commit_list(struct commit_list *list);
45
46 void sort_by_date(struct commit_list **list);
47
48 /* Commit formats */
49 enum cmit_fmt {
50 CMIT_FMT_RAW,
51 CMIT_FMT_MEDIUM,
52 CMIT_FMT_DEFAULT = CMIT_FMT_MEDIUM,
53 CMIT_FMT_SHORT,
54 CMIT_FMT_FULL,
55 CMIT_FMT_FULLER,
56 CMIT_FMT_ONELINE,
57 CMIT_FMT_EMAIL,
58 CMIT_FMT_USERFORMAT,
59
60 CMIT_FMT_UNSPECIFIED,
61 };
62
63 extern enum cmit_fmt get_commit_format(const char *arg);
64 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);
65
66 /** Removes the first commit from a list sorted by date, and adds all
67 * of its parents.
68 **/
69 struct commit *pop_most_recent_commit(struct commit_list **list,
70 unsigned int mark);
71
72 struct commit *pop_commit(struct commit_list **stack);
73
74 void clear_commit_marks(struct commit *commit, unsigned int mark);
75
76 int count_parents(struct commit * commit);
77
78 /*
79 * Performs an in-place topological sort of list supplied.
80 *
81 * Pre-conditions for sort_in_topological_order:
82 * all commits in input list and all parents of those
83 * commits must have object.util == NULL
84 *
85 * Pre-conditions for sort_in_topological_order_fn:
86 * all commits in input list and all parents of those
87 * commits must have getter(commit) == NULL
88 *
89 * Post-conditions:
90 * invariant of resulting list is:
91 * a reachable from b => ord(b) < ord(a)
92 * in addition, when lifo == 0, commits on parallel tracks are
93 * sorted in the dates order.
94 */
95
96 typedef void (*topo_sort_set_fn_t)(struct commit*, void *data);
97 typedef void* (*topo_sort_get_fn_t)(struct commit*);
98
99 void topo_sort_default_setter(struct commit *c, void *data);
100 void *topo_sort_default_getter(struct commit *c);
101
102 void sort_in_topological_order(struct commit_list ** list, int lifo);
103 void sort_in_topological_order_fn(struct commit_list ** list, int lifo,
104 topo_sort_set_fn_t setter,
105 topo_sort_get_fn_t getter);
106
107 struct commit_graft {
108 unsigned char sha1[20];
109 int nr_parent; /* < 0 if shallow commit */
110 unsigned char parent[FLEX_ARRAY][20]; /* more */
111 };
112
113 struct commit_graft *read_graft_line(char *buf, int len);
114 int register_commit_graft(struct commit_graft *, int);
115 int read_graft_file(const char *graft_file);
116
117 extern struct commit_list *get_merge_bases(struct commit *rev1, struct commit *rev2, int cleanup);
118
119 extern int register_shallow(const unsigned char *sha1);
120 extern int unregister_shallow(const unsigned char *sha1);
121 extern int write_shallow_commits(int fd, int use_pack_protocol);
122 extern int is_repository_shallow(void);
123 extern struct commit_list *get_shallow_commits(struct object_array *heads,
124 int depth, int shallow_flag, int not_shallow_flag);
125
126 int in_merge_bases(struct commit *, struct commit **, int);
127 #endif /* COMMIT_H */