]>
Commit | Line | Data |
---|---|---|
427dcb4b JH |
1 | /* |
2 | * Copyright (C) 2005 Junio C Hamano | |
3 | */ | |
e0173ad9 JH |
4 | #ifndef DIFFCORE_H |
5 | #define DIFFCORE_H | |
427dcb4b | 6 | |
ef3ca954 EN |
7 | #include "cache.h" |
8 | ||
9 | struct diff_options; | |
b78ea5fc NTND |
10 | struct repository; |
11 | struct userdiff_driver; | |
ef3ca954 | 12 | |
427dcb4b JH |
13 | /* This header file is internal between diff.c and its diff transformers |
14 | * (e.g. diffcore-rename, diffcore-pickaxe). Never include this header | |
15 | * in anything else. | |
16 | */ | |
eeaa4603 JH |
17 | |
18 | /* We internally use unsigned short as the score value, | |
19 | * and rely on an int capable to hold 32-bits. -B can take | |
20 | * -Bmerge_score/break_score format and the two scores are | |
21 | * passed around in one int (high 16-bit for merge and low 16-bit | |
22 | * for break). | |
23 | */ | |
ee3d299e | 24 | #define MAX_SCORE 60000.0 |
f345b0a0 | 25 | #define DEFAULT_RENAME_SCORE 30000 /* rename/copy similarity minimum (50%) */ |
4d0f39ce | 26 | #define DEFAULT_BREAK_SCORE 30000 /* minimum for break to happen (50%) */ |
cf958afd | 27 | #define DEFAULT_MERGE_SCORE 36000 /* maximum for break-merge to happen (60%) */ |
eeaa4603 JH |
28 | |
29 | #define MINIMUM_BREAK_SIZE 400 /* do not break a file smaller than this */ | |
427dcb4b | 30 | |
13c4d7eb HW |
31 | /** |
32 | * the internal representation for a single file (blob). It records the blob | |
33 | * object name (if known -- for a work tree file it typically is a NUL SHA-1), | |
34 | * filemode and pathname. This is what the `diff_addremove()`, `diff_change()` | |
35 | * and `diff_unmerge()` synthesize and feed `diff_queue()` function with. | |
36 | */ | |
427dcb4b | 37 | struct diff_filespec { |
a0d12c44 | 38 | struct object_id oid; |
427dcb4b JH |
39 | char *path; |
40 | void *data; | |
c06c7966 | 41 | void *cnt_data; |
427dcb4b | 42 | unsigned long size; |
9fb88419 | 43 | int count; /* Reference count */ |
64479711 | 44 | int rename_used; /* Count of rename users */ |
427dcb4b | 45 | unsigned short mode; /* file mode */ |
41c9560e | 46 | unsigned oid_valid : 1; /* if true, use oid and trust mode; |
427dcb4b JH |
47 | * if false, use the name and read from |
48 | * the filesystem. | |
49 | */ | |
dc7090ef | 50 | #define DIFF_FILE_VALID(spec) (((spec)->mode) != 0) |
427dcb4b JH |
51 | unsigned should_free : 1; /* data should be free()'ed */ |
52 | unsigned should_munmap : 1; /* data should be munmap()'ed */ | |
c7e1a736 JL |
53 | unsigned dirty_submodule : 2; /* For submodules: its work tree is dirty */ |
54 | #define DIRTY_SUBMODULE_UNTRACKED 1 | |
55 | #define DIRTY_SUBMODULE_MODIFIED 2 | |
b837f5d6 | 56 | unsigned is_stdin : 1; |
25e5e2bf | 57 | unsigned has_more_entries : 1; /* only appear in combined diff */ |
122aa6f9 | 58 | /* data should be considered "binary"; -1 means "don't know yet" */ |
7d0a9a75 | 59 | signed int is_binary : 2; |
b38f70a8 | 60 | struct userdiff_driver *driver; |
427dcb4b JH |
61 | }; |
62 | ||
78d70d9b NTND |
63 | struct diff_filespec *alloc_filespec(const char *); |
64 | void free_filespec(struct diff_filespec *); | |
65 | void fill_filespec(struct diff_filespec *, const struct object_id *, | |
66 | int, unsigned short); | |
427dcb4b | 67 | |
95acf11a JT |
68 | /* |
69 | * Prefetch the entries in diff_queued_diff. The parameter is a pointer to a | |
70 | * struct repository. | |
71 | */ | |
72 | void diff_queued_diff_prefetch(void *repository); | |
73 | ||
1c37e86a JT |
74 | struct diff_populate_filespec_options { |
75 | unsigned check_size_only : 1; | |
76 | unsigned check_binary : 1; | |
95acf11a JT |
77 | |
78 | /* | |
79 | * If an object is missing, diff_populate_filespec() will invoke this | |
80 | * callback before attempting to read that object again. | |
81 | */ | |
82 | void (*missing_object_cb)(void *); | |
83 | void *missing_object_data; | |
1c37e86a JT |
84 | }; |
85 | int diff_populate_filespec(struct repository *, struct diff_filespec *, | |
86 | const struct diff_populate_filespec_options *); | |
78d70d9b NTND |
87 | void diff_free_filespec_data(struct diff_filespec *); |
88 | void diff_free_filespec_blob(struct diff_filespec *); | |
b78ea5fc | 89 | int diff_filespec_is_binary(struct repository *, struct diff_filespec *); |
427dcb4b | 90 | |
13c4d7eb HW |
91 | /** |
92 | * This records a pair of `struct diff_filespec`; the filespec for a file in | |
93 | * the "old" set (i.e. preimage) is called `one`, and the filespec for a file | |
94 | * in the "new" set (i.e. postimage) is called `two`. A change that represents | |
95 | * file creation has NULL in `one`, and file deletion has NULL in `two`. | |
96 | * | |
97 | * A `filepair` starts pointing at `one` and `two` that are from the same | |
98 | * filename, but `diffcore_std()` can break pairs and match component filespecs | |
99 | * with other filespecs from a different filepair to form new filepair. This is | |
100 | * called 'rename detection'. | |
101 | */ | |
52e95789 | 102 | struct diff_filepair { |
427dcb4b JH |
103 | struct diff_filespec *one; |
104 | struct diff_filespec *two; | |
01c4e70f | 105 | unsigned short int score; |
a5a323f3 | 106 | char status; /* M C R A D U etc. (see Documentation/diff-format.txt or DIFF_STATUS_* in diff.h) */ |
f345b0a0 | 107 | unsigned broken_pair : 1; |
ef677686 | 108 | unsigned renamed_pair : 1; |
e9c84099 | 109 | unsigned is_unmerged : 1; |
f34b205f NTND |
110 | unsigned done_skip_stat_unmatch : 1; |
111 | unsigned skip_stat_unmatch_result : 1; | |
427dcb4b | 112 | }; |
13c4d7eb | 113 | |
e9c84099 | 114 | #define DIFF_PAIR_UNMERGED(p) ((p)->is_unmerged) |
427dcb4b | 115 | |
ef677686 | 116 | #define DIFF_PAIR_RENAME(p) ((p)->renamed_pair) |
01c4e70f | 117 | |
f345b0a0 JH |
118 | #define DIFF_PAIR_BROKEN(p) \ |
119 | ( (!DIFF_FILE_VALID((p)->one) != !DIFF_FILE_VALID((p)->two)) && \ | |
120 | ((p)->broken_pair != 0) ) | |
121 | ||
96716a19 JH |
122 | #define DIFF_PAIR_TYPE_CHANGED(p) \ |
123 | ((S_IFMT & (p)->one->mode) != (S_IFMT & (p)->two->mode)) | |
124 | ||
4130b995 JH |
125 | #define DIFF_PAIR_MODE_CHANGED(p) ((p)->one->mode != (p)->two->mode) |
126 | ||
78d70d9b | 127 | void diff_free_filepair(struct diff_filepair *); |
226406f6 | 128 | |
78d70d9b | 129 | int diff_unmodified_pair(struct diff_filepair *); |
f7c1512a | 130 | |
13c4d7eb HW |
131 | /** |
132 | * This is a collection of filepairs. Notable members are: | |
133 | * | |
134 | * - `queue`: | |
135 | * An array of pointers to `struct diff_filepair`. This dynamically grows as | |
136 | * you add filepairs; | |
137 | * | |
138 | * - `alloc`: | |
139 | * The allocated size of the `queue` array; | |
140 | * | |
141 | * - `nr`: | |
142 | * The number of elements in the `queue` array. | |
143 | */ | |
427dcb4b | 144 | struct diff_queue_struct { |
52e95789 | 145 | struct diff_filepair **queue; |
427dcb4b JH |
146 | int alloc; |
147 | int nr; | |
148 | }; | |
13c4d7eb | 149 | |
9ca5df90 BY |
150 | #define DIFF_QUEUE_CLEAR(q) \ |
151 | do { \ | |
152 | (q)->queue = NULL; \ | |
153 | (q)->nr = (q)->alloc = 0; \ | |
98746061 | 154 | } while (0) |
427dcb4b | 155 | |
38c6f780 | 156 | extern struct diff_queue_struct diff_queued_diff; |
78d70d9b NTND |
157 | struct diff_filepair *diff_queue(struct diff_queue_struct *, |
158 | struct diff_filespec *, | |
159 | struct diff_filespec *); | |
160 | void diff_q(struct diff_queue_struct *, struct diff_filepair *); | |
f7c1512a | 161 | |
b78ea5fc | 162 | void diffcore_break(struct repository *, int); |
78d70d9b NTND |
163 | void diffcore_rename(struct diff_options *); |
164 | void diffcore_merge_broken(void); | |
165 | void diffcore_pickaxe(struct diff_options *); | |
166 | void diffcore_order(const char *orderfile); | |
ce240675 | 167 | |
1df4320f KS |
168 | /* low-level interface to diffcore_order */ |
169 | struct obj_order { | |
170 | void *obj; /* setup by caller */ | |
171 | ||
172 | /* setup/used by order_objects() */ | |
173 | int orig_order; | |
174 | int order; | |
175 | }; | |
176 | ||
177 | typedef const char *(*obj_path_fn_t)(void *obj); | |
178 | ||
179 | void order_objects(const char *orderfile, obj_path_fn_t obj_path, | |
180 | struct obj_order *objs, int nr); | |
181 | ||
25d5ea41 JH |
182 | #define DIFF_DEBUG 0 |
183 | #if DIFF_DEBUG | |
184 | void diff_debug_filespec(struct diff_filespec *, int, const char *); | |
185 | void diff_debug_filepair(const struct diff_filepair *, int); | |
186 | void diff_debug_queue(const char *, struct diff_queue_struct *); | |
187 | #else | |
98746061 JN |
188 | #define diff_debug_filespec(a,b,c) do { /* nothing */ } while (0) |
189 | #define diff_debug_filepair(a,b) do { /* nothing */ } while (0) | |
190 | #define diff_debug_queue(a,b) do { /* nothing */ } while (0) | |
25d5ea41 JH |
191 | #endif |
192 | ||
b78ea5fc NTND |
193 | int diffcore_count_changes(struct repository *r, |
194 | struct diff_filespec *src, | |
78d70d9b NTND |
195 | struct diff_filespec *dst, |
196 | void **src_count_p, | |
197 | void **dst_count_p, | |
198 | unsigned long *src_copied, | |
199 | unsigned long *literal_added); | |
65416758 | 200 | |
95acf11a JT |
201 | /* |
202 | * If filespec contains an OID and if that object is missing from the given | |
203 | * repository, add that OID to to_fetch. | |
204 | */ | |
205 | void diff_add_if_missing(struct repository *r, | |
206 | struct oid_array *to_fetch, | |
207 | const struct diff_filespec *filespec); | |
208 | ||
427dcb4b | 209 | #endif |