Merge branch 'jk/diff-driver-binary-doc' into maint
[git/jnareb-git/bp-gitweb.git] / ll-merge.c
blob6bb3095c3a85d771bb60e8f2f025287d16e792df
1 /*
2 * Low level 3-way in-core file merge.
4 * Copyright (c) 2007 Junio C Hamano
5 */
7 #include "cache.h"
8 #include "attr.h"
9 #include "xdiff-interface.h"
10 #include "run-command.h"
11 #include "ll-merge.h"
13 struct ll_merge_driver;
15 typedef int (*ll_merge_fn)(const struct ll_merge_driver *,
16 mmbuffer_t *result,
17 const char *path,
18 mmfile_t *orig, const char *orig_name,
19 mmfile_t *src1, const char *name1,
20 mmfile_t *src2, const char *name2,
21 int flag,
22 int marker_size);
24 struct ll_merge_driver {
25 const char *name;
26 const char *description;
27 ll_merge_fn fn;
28 const char *recursive;
29 struct ll_merge_driver *next;
30 char *cmdline;
34 * Built-in low-levels
36 static int ll_binary_merge(const struct ll_merge_driver *drv_unused,
37 mmbuffer_t *result,
38 const char *path_unused,
39 mmfile_t *orig, const char *orig_name,
40 mmfile_t *src1, const char *name1,
41 mmfile_t *src2, const char *name2,
42 int flag, int marker_size)
45 * The tentative merge result is "ours" for the final round,
46 * or common ancestor for an internal merge. Still return
47 * "conflicted merge" status.
49 mmfile_t *stolen = (flag & LL_OPT_VIRTUAL_ANCESTOR) ? orig : src1;
51 result->ptr = stolen->ptr;
52 result->size = stolen->size;
53 stolen->ptr = NULL;
54 return 1;
57 static int ll_xdl_merge(const struct ll_merge_driver *drv_unused,
58 mmbuffer_t *result,
59 const char *path,
60 mmfile_t *orig, const char *orig_name,
61 mmfile_t *src1, const char *name1,
62 mmfile_t *src2, const char *name2,
63 int flag, int marker_size)
65 xmparam_t xmp;
67 if (buffer_is_binary(orig->ptr, orig->size) ||
68 buffer_is_binary(src1->ptr, src1->size) ||
69 buffer_is_binary(src2->ptr, src2->size)) {
70 warning("Cannot merge binary files: %s (%s vs. %s)\n",
71 path, name1, name2);
72 return ll_binary_merge(drv_unused, result,
73 path,
74 orig, orig_name,
75 src1, name1,
76 src2, name2,
77 flag, marker_size);
80 memset(&xmp, 0, sizeof(xmp));
81 xmp.level = XDL_MERGE_ZEALOUS;
82 xmp.favor = ll_opt_favor(flag);
83 if (git_xmerge_style >= 0)
84 xmp.style = git_xmerge_style;
85 if (marker_size > 0)
86 xmp.marker_size = marker_size;
87 xmp.ancestor = orig_name;
88 xmp.file1 = name1;
89 xmp.file2 = name2;
90 return xdl_merge(orig, src1, src2, &xmp, result);
93 static int ll_union_merge(const struct ll_merge_driver *drv_unused,
94 mmbuffer_t *result,
95 const char *path_unused,
96 mmfile_t *orig, const char *orig_name,
97 mmfile_t *src1, const char *name1,
98 mmfile_t *src2, const char *name2,
99 int flag, int marker_size)
101 /* Use union favor */
102 flag &= ~LL_OPT_FAVOR_MASK;
103 flag |= create_ll_flag(XDL_MERGE_FAVOR_UNION);
104 return ll_xdl_merge(drv_unused, result, path_unused,
105 orig, NULL, src1, NULL, src2, NULL,
106 flag, marker_size);
107 return 0;
110 #define LL_BINARY_MERGE 0
111 #define LL_TEXT_MERGE 1
112 #define LL_UNION_MERGE 2
113 static struct ll_merge_driver ll_merge_drv[] = {
114 { "binary", "built-in binary merge", ll_binary_merge },
115 { "text", "built-in 3-way text merge", ll_xdl_merge },
116 { "union", "built-in union merge", ll_union_merge },
119 static void create_temp(mmfile_t *src, char *path)
121 int fd;
123 strcpy(path, ".merge_file_XXXXXX");
124 fd = xmkstemp(path);
125 if (write_in_full(fd, src->ptr, src->size) != src->size)
126 die_errno("unable to write temp-file");
127 close(fd);
131 * User defined low-level merge driver support.
133 static int ll_ext_merge(const struct ll_merge_driver *fn,
134 mmbuffer_t *result,
135 const char *path,
136 mmfile_t *orig, const char *orig_name,
137 mmfile_t *src1, const char *name1,
138 mmfile_t *src2, const char *name2,
139 int flag, int marker_size)
141 char temp[4][50];
142 struct strbuf cmd = STRBUF_INIT;
143 struct strbuf_expand_dict_entry dict[5];
144 const char *args[] = { NULL, NULL };
145 int status, fd, i;
146 struct stat st;
148 dict[0].placeholder = "O"; dict[0].value = temp[0];
149 dict[1].placeholder = "A"; dict[1].value = temp[1];
150 dict[2].placeholder = "B"; dict[2].value = temp[2];
151 dict[3].placeholder = "L"; dict[3].value = temp[3];
152 dict[4].placeholder = NULL; dict[4].value = NULL;
154 if (fn->cmdline == NULL)
155 die("custom merge driver %s lacks command line.", fn->name);
157 result->ptr = NULL;
158 result->size = 0;
159 create_temp(orig, temp[0]);
160 create_temp(src1, temp[1]);
161 create_temp(src2, temp[2]);
162 sprintf(temp[3], "%d", marker_size);
164 strbuf_expand(&cmd, fn->cmdline, strbuf_expand_dict_cb, &dict);
166 args[0] = cmd.buf;
167 status = run_command_v_opt(args, RUN_USING_SHELL);
168 fd = open(temp[1], O_RDONLY);
169 if (fd < 0)
170 goto bad;
171 if (fstat(fd, &st))
172 goto close_bad;
173 result->size = st.st_size;
174 result->ptr = xmalloc(result->size + 1);
175 if (read_in_full(fd, result->ptr, result->size) != result->size) {
176 free(result->ptr);
177 result->ptr = NULL;
178 result->size = 0;
180 close_bad:
181 close(fd);
182 bad:
183 for (i = 0; i < 3; i++)
184 unlink_or_warn(temp[i]);
185 strbuf_release(&cmd);
186 return status;
190 * merge.default and merge.driver configuration items
192 static struct ll_merge_driver *ll_user_merge, **ll_user_merge_tail;
193 static const char *default_ll_merge;
195 static int read_merge_config(const char *var, const char *value, void *cb)
197 struct ll_merge_driver *fn;
198 const char *ep, *name;
199 int namelen;
201 if (!strcmp(var, "merge.default")) {
202 if (value)
203 default_ll_merge = xstrdup(value);
204 return 0;
208 * We are not interested in anything but "merge.<name>.variable";
209 * especially, we do not want to look at variables such as
210 * "merge.summary", "merge.tool", and "merge.verbosity".
212 if (prefixcmp(var, "merge.") || (ep = strrchr(var, '.')) == var + 5)
213 return 0;
216 * Find existing one as we might be processing merge.<name>.var2
217 * after seeing merge.<name>.var1.
219 name = var + 6;
220 namelen = ep - name;
221 for (fn = ll_user_merge; fn; fn = fn->next)
222 if (!strncmp(fn->name, name, namelen) && !fn->name[namelen])
223 break;
224 if (!fn) {
225 fn = xcalloc(1, sizeof(struct ll_merge_driver));
226 fn->name = xmemdupz(name, namelen);
227 fn->fn = ll_ext_merge;
228 *ll_user_merge_tail = fn;
229 ll_user_merge_tail = &(fn->next);
232 ep++;
234 if (!strcmp("name", ep)) {
235 if (!value)
236 return error("%s: lacks value", var);
237 fn->description = xstrdup(value);
238 return 0;
241 if (!strcmp("driver", ep)) {
242 if (!value)
243 return error("%s: lacks value", var);
245 * merge.<name>.driver specifies the command line:
247 * command-line
249 * The command-line will be interpolated with the following
250 * tokens and is given to the shell:
252 * %O - temporary file name for the merge base.
253 * %A - temporary file name for our version.
254 * %B - temporary file name for the other branches' version.
255 * %L - conflict marker length
257 * The external merge driver should write the results in the
258 * file named by %A, and signal that it has done with zero exit
259 * status.
261 fn->cmdline = xstrdup(value);
262 return 0;
265 if (!strcmp("recursive", ep)) {
266 if (!value)
267 return error("%s: lacks value", var);
268 fn->recursive = xstrdup(value);
269 return 0;
272 return 0;
275 static void initialize_ll_merge(void)
277 if (ll_user_merge_tail)
278 return;
279 ll_user_merge_tail = &ll_user_merge;
280 git_config(read_merge_config, NULL);
283 static const struct ll_merge_driver *find_ll_merge_driver(const char *merge_attr)
285 struct ll_merge_driver *fn;
286 const char *name;
287 int i;
289 initialize_ll_merge();
291 if (ATTR_TRUE(merge_attr))
292 return &ll_merge_drv[LL_TEXT_MERGE];
293 else if (ATTR_FALSE(merge_attr))
294 return &ll_merge_drv[LL_BINARY_MERGE];
295 else if (ATTR_UNSET(merge_attr)) {
296 if (!default_ll_merge)
297 return &ll_merge_drv[LL_TEXT_MERGE];
298 else
299 name = default_ll_merge;
301 else
302 name = merge_attr;
304 for (fn = ll_user_merge; fn; fn = fn->next)
305 if (!strcmp(fn->name, name))
306 return fn;
308 for (i = 0; i < ARRAY_SIZE(ll_merge_drv); i++)
309 if (!strcmp(ll_merge_drv[i].name, name))
310 return &ll_merge_drv[i];
312 /* default to the 3-way */
313 return &ll_merge_drv[LL_TEXT_MERGE];
316 static int git_path_check_merge(const char *path, struct git_attr_check check[2])
318 if (!check[0].attr) {
319 check[0].attr = git_attr("merge");
320 check[1].attr = git_attr("conflict-marker-size");
322 return git_checkattr(path, 2, check);
325 static void normalize_file(mmfile_t *mm, const char *path)
327 struct strbuf strbuf = STRBUF_INIT;
328 if (renormalize_buffer(path, mm->ptr, mm->size, &strbuf)) {
329 free(mm->ptr);
330 mm->size = strbuf.len;
331 mm->ptr = strbuf_detach(&strbuf, NULL);
335 int ll_merge(mmbuffer_t *result_buf,
336 const char *path,
337 mmfile_t *ancestor, const char *ancestor_label,
338 mmfile_t *ours, const char *our_label,
339 mmfile_t *theirs, const char *their_label,
340 int flag)
342 static struct git_attr_check check[2];
343 const char *ll_driver_name = NULL;
344 int marker_size = DEFAULT_CONFLICT_MARKER_SIZE;
345 const struct ll_merge_driver *driver;
346 int virtual_ancestor = flag & LL_OPT_VIRTUAL_ANCESTOR;
348 if (flag & LL_OPT_RENORMALIZE) {
349 normalize_file(ancestor, path);
350 normalize_file(ours, path);
351 normalize_file(theirs, path);
353 if (!git_path_check_merge(path, check)) {
354 ll_driver_name = check[0].value;
355 if (check[1].value) {
356 marker_size = atoi(check[1].value);
357 if (marker_size <= 0)
358 marker_size = DEFAULT_CONFLICT_MARKER_SIZE;
361 driver = find_ll_merge_driver(ll_driver_name);
362 if (virtual_ancestor && driver->recursive)
363 driver = find_ll_merge_driver(driver->recursive);
364 return driver->fn(driver, result_buf, path, ancestor, ancestor_label,
365 ours, our_label, theirs, their_label,
366 flag, marker_size);
369 int ll_merge_marker_size(const char *path)
371 static struct git_attr_check check;
372 int marker_size = DEFAULT_CONFLICT_MARKER_SIZE;
374 if (!check.attr)
375 check.attr = git_attr("conflict-marker-size");
376 if (!git_checkattr(path, 1, &check) && check.value) {
377 marker_size = atoi(check.value);
378 if (marker_size <= 0)
379 marker_size = DEFAULT_CONFLICT_MARKER_SIZE;
381 return marker_size;