Documentation: merge: add a section about fast-forward
[git/gsoc2010-gitweb.git] / ll-merge.c
blob2d6b6d6cb1d2bc2d334bf058feb3444e94b5a781
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,
19 mmfile_t *src1, const char *name1,
20 mmfile_t *src2, const char *name2,
21 int virtual_ancestor);
23 struct ll_merge_driver {
24 const char *name;
25 const char *description;
26 ll_merge_fn fn;
27 const char *recursive;
28 struct ll_merge_driver *next;
29 char *cmdline;
33 * Built-in low-levels
35 static int ll_binary_merge(const struct ll_merge_driver *drv_unused,
36 mmbuffer_t *result,
37 const char *path_unused,
38 mmfile_t *orig,
39 mmfile_t *src1, const char *name1,
40 mmfile_t *src2, const char *name2,
41 int virtual_ancestor)
44 * The tentative merge result is "ours" for the final round,
45 * or common ancestor for an internal merge. Still return
46 * "conflicted merge" status.
48 mmfile_t *stolen = virtual_ancestor ? orig : src1;
50 result->ptr = stolen->ptr;
51 result->size = stolen->size;
52 stolen->ptr = NULL;
53 return 1;
56 static int ll_xdl_merge(const struct ll_merge_driver *drv_unused,
57 mmbuffer_t *result,
58 const char *path,
59 mmfile_t *orig,
60 mmfile_t *src1, const char *name1,
61 mmfile_t *src2, const char *name2,
62 int virtual_ancestor)
64 xpparam_t xpp;
65 int style = 0;
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, src1, name1,
75 src2, name2,
76 virtual_ancestor);
79 memset(&xpp, 0, sizeof(xpp));
80 if (git_xmerge_style >= 0)
81 style = git_xmerge_style;
82 return xdl_merge(orig,
83 src1, name1,
84 src2, name2,
85 &xpp, XDL_MERGE_ZEALOUS | style,
86 result);
89 static int ll_union_merge(const struct ll_merge_driver *drv_unused,
90 mmbuffer_t *result,
91 const char *path_unused,
92 mmfile_t *orig,
93 mmfile_t *src1, const char *name1,
94 mmfile_t *src2, const char *name2,
95 int virtual_ancestor)
97 char *src, *dst;
98 long size;
99 const int marker_size = 7;
100 int status, saved_style;
102 /* We have to force the RCS "merge" style */
103 saved_style = git_xmerge_style;
104 git_xmerge_style = 0;
105 status = ll_xdl_merge(drv_unused, result, path_unused,
106 orig, src1, NULL, src2, NULL,
107 virtual_ancestor);
108 git_xmerge_style = saved_style;
109 if (status <= 0)
110 return status;
111 size = result->size;
112 src = dst = result->ptr;
113 while (size) {
114 char ch;
115 if ((marker_size < size) &&
116 (*src == '<' || *src == '=' || *src == '>')) {
117 int i;
118 ch = *src;
119 for (i = 0; i < marker_size; i++)
120 if (src[i] != ch)
121 goto not_a_marker;
122 if (src[marker_size] != '\n')
123 goto not_a_marker;
124 src += marker_size + 1;
125 size -= marker_size + 1;
126 continue;
128 not_a_marker:
129 do {
130 ch = *src++;
131 *dst++ = ch;
132 size--;
133 } while (ch != '\n' && size);
135 result->size = dst - result->ptr;
136 return 0;
139 #define LL_BINARY_MERGE 0
140 #define LL_TEXT_MERGE 1
141 #define LL_UNION_MERGE 2
142 static struct ll_merge_driver ll_merge_drv[] = {
143 { "binary", "built-in binary merge", ll_binary_merge },
144 { "text", "built-in 3-way text merge", ll_xdl_merge },
145 { "union", "built-in union merge", ll_union_merge },
148 static void create_temp(mmfile_t *src, char *path)
150 int fd;
152 strcpy(path, ".merge_file_XXXXXX");
153 fd = xmkstemp(path);
154 if (write_in_full(fd, src->ptr, src->size) != src->size)
155 die_errno("unable to write temp-file");
156 close(fd);
160 * User defined low-level merge driver support.
162 static int ll_ext_merge(const struct ll_merge_driver *fn,
163 mmbuffer_t *result,
164 const char *path,
165 mmfile_t *orig,
166 mmfile_t *src1, const char *name1,
167 mmfile_t *src2, const char *name2,
168 int virtual_ancestor)
170 char temp[3][50];
171 struct strbuf cmd = STRBUF_INIT;
172 struct strbuf_expand_dict_entry dict[] = {
173 { "O", temp[0] },
174 { "A", temp[1] },
175 { "B", temp[2] },
176 { NULL }
178 const char *args[] = { "sh", "-c", NULL, NULL };
179 int status, fd, i;
180 struct stat st;
182 if (fn->cmdline == NULL)
183 die("custom merge driver %s lacks command line.", fn->name);
185 result->ptr = NULL;
186 result->size = 0;
187 create_temp(orig, temp[0]);
188 create_temp(src1, temp[1]);
189 create_temp(src2, temp[2]);
191 strbuf_expand(&cmd, fn->cmdline, strbuf_expand_dict_cb, &dict);
193 args[2] = cmd.buf;
194 status = run_command_v_opt(args, 0);
195 fd = open(temp[1], O_RDONLY);
196 if (fd < 0)
197 goto bad;
198 if (fstat(fd, &st))
199 goto close_bad;
200 result->size = st.st_size;
201 result->ptr = xmalloc(result->size + 1);
202 if (read_in_full(fd, result->ptr, result->size) != result->size) {
203 free(result->ptr);
204 result->ptr = NULL;
205 result->size = 0;
207 close_bad:
208 close(fd);
209 bad:
210 for (i = 0; i < 3; i++)
211 unlink_or_warn(temp[i]);
212 strbuf_release(&cmd);
213 return status;
217 * merge.default and merge.driver configuration items
219 static struct ll_merge_driver *ll_user_merge, **ll_user_merge_tail;
220 static const char *default_ll_merge;
222 static int read_merge_config(const char *var, const char *value, void *cb)
224 struct ll_merge_driver *fn;
225 const char *ep, *name;
226 int namelen;
228 if (!strcmp(var, "merge.default")) {
229 if (value)
230 default_ll_merge = xstrdup(value);
231 return 0;
235 * We are not interested in anything but "merge.<name>.variable";
236 * especially, we do not want to look at variables such as
237 * "merge.summary", "merge.tool", and "merge.verbosity".
239 if (prefixcmp(var, "merge.") || (ep = strrchr(var, '.')) == var + 5)
240 return 0;
243 * Find existing one as we might be processing merge.<name>.var2
244 * after seeing merge.<name>.var1.
246 name = var + 6;
247 namelen = ep - name;
248 for (fn = ll_user_merge; fn; fn = fn->next)
249 if (!strncmp(fn->name, name, namelen) && !fn->name[namelen])
250 break;
251 if (!fn) {
252 fn = xcalloc(1, sizeof(struct ll_merge_driver));
253 fn->name = xmemdupz(name, namelen);
254 fn->fn = ll_ext_merge;
255 *ll_user_merge_tail = fn;
256 ll_user_merge_tail = &(fn->next);
259 ep++;
261 if (!strcmp("name", ep)) {
262 if (!value)
263 return error("%s: lacks value", var);
264 fn->description = xstrdup(value);
265 return 0;
268 if (!strcmp("driver", ep)) {
269 if (!value)
270 return error("%s: lacks value", var);
272 * merge.<name>.driver specifies the command line:
274 * command-line
276 * The command-line will be interpolated with the following
277 * tokens and is given to the shell:
279 * %O - temporary file name for the merge base.
280 * %A - temporary file name for our version.
281 * %B - temporary file name for the other branches' version.
283 * The external merge driver should write the results in the
284 * file named by %A, and signal that it has done with zero exit
285 * status.
287 fn->cmdline = xstrdup(value);
288 return 0;
291 if (!strcmp("recursive", ep)) {
292 if (!value)
293 return error("%s: lacks value", var);
294 fn->recursive = xstrdup(value);
295 return 0;
298 return 0;
301 static void initialize_ll_merge(void)
303 if (ll_user_merge_tail)
304 return;
305 ll_user_merge_tail = &ll_user_merge;
306 git_config(read_merge_config, NULL);
309 static const struct ll_merge_driver *find_ll_merge_driver(const char *merge_attr)
311 struct ll_merge_driver *fn;
312 const char *name;
313 int i;
315 initialize_ll_merge();
317 if (ATTR_TRUE(merge_attr))
318 return &ll_merge_drv[LL_TEXT_MERGE];
319 else if (ATTR_FALSE(merge_attr))
320 return &ll_merge_drv[LL_BINARY_MERGE];
321 else if (ATTR_UNSET(merge_attr)) {
322 if (!default_ll_merge)
323 return &ll_merge_drv[LL_TEXT_MERGE];
324 else
325 name = default_ll_merge;
327 else
328 name = merge_attr;
330 for (fn = ll_user_merge; fn; fn = fn->next)
331 if (!strcmp(fn->name, name))
332 return fn;
334 for (i = 0; i < ARRAY_SIZE(ll_merge_drv); i++)
335 if (!strcmp(ll_merge_drv[i].name, name))
336 return &ll_merge_drv[i];
338 /* default to the 3-way */
339 return &ll_merge_drv[LL_TEXT_MERGE];
342 static const char *git_path_check_merge(const char *path)
344 static struct git_attr_check attr_merge_check;
346 if (!attr_merge_check.attr)
347 attr_merge_check.attr = git_attr("merge", 5);
349 if (git_checkattr(path, 1, &attr_merge_check))
350 return NULL;
351 return attr_merge_check.value;
354 int ll_merge(mmbuffer_t *result_buf,
355 const char *path,
356 mmfile_t *ancestor,
357 mmfile_t *ours, const char *our_label,
358 mmfile_t *theirs, const char *their_label,
359 int virtual_ancestor)
361 const char *ll_driver_name;
362 const struct ll_merge_driver *driver;
364 ll_driver_name = git_path_check_merge(path);
365 driver = find_ll_merge_driver(ll_driver_name);
367 if (virtual_ancestor && driver->recursive)
368 driver = find_ll_merge_driver(driver->recursive);
369 return driver->fn(driver, result_buf, path,
370 ancestor,
371 ours, our_label,
372 theirs, their_label, virtual_ancestor);