ll-merge.con commit docs/git-tag: explain lightweight versus annotated tags (29d5553)
   1/*
   2 * Low level 3-way in-core file merge.
   3 *
   4 * Copyright (c) 2007 Junio C Hamano
   5 */
   6
   7#include "cache.h"
   8#include "attr.h"
   9#include "xdiff-interface.h"
  10#include "run-command.h"
  11#include "ll-merge.h"
  12
  13struct ll_merge_driver;
  14
  15typedef 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                           const struct ll_merge_options *opts,
  22                           int marker_size);
  23
  24struct 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;
  31};
  32
  33/*
  34 * Built-in low-levels
  35 */
  36static int ll_binary_merge(const struct ll_merge_driver *drv_unused,
  37                           mmbuffer_t *result,
  38                           const char *path,
  39                           mmfile_t *orig, const char *orig_name,
  40                           mmfile_t *src1, const char *name1,
  41                           mmfile_t *src2, const char *name2,
  42                           const struct ll_merge_options *opts,
  43                           int marker_size)
  44{
  45        mmfile_t *stolen;
  46        assert(opts);
  47
  48        /*
  49         * The tentative merge result is the or common ancestor for an internal merge.
  50         */
  51        if (opts->virtual_ancestor) {
  52                stolen = orig;
  53        } else {
  54                switch (opts->variant) {
  55                default:
  56                        warning("Cannot merge binary files: %s (%s vs. %s)",
  57                                path, name1, name2);
  58                        /* fallthru */
  59                case XDL_MERGE_FAVOR_OURS:
  60                        stolen = src1;
  61                        break;
  62                case XDL_MERGE_FAVOR_THEIRS:
  63                        stolen = src2;
  64                        break;
  65                }
  66        }
  67
  68        result->ptr = stolen->ptr;
  69        result->size = stolen->size;
  70        stolen->ptr = NULL;
  71
  72        /*
  73         * With -Xtheirs or -Xours, we have cleanly merged;
  74         * otherwise we got a conflict.
  75         */
  76        return (opts->variant ? 0 : 1);
  77}
  78
  79static int ll_xdl_merge(const struct ll_merge_driver *drv_unused,
  80                        mmbuffer_t *result,
  81                        const char *path,
  82                        mmfile_t *orig, const char *orig_name,
  83                        mmfile_t *src1, const char *name1,
  84                        mmfile_t *src2, const char *name2,
  85                        const struct ll_merge_options *opts,
  86                        int marker_size)
  87{
  88        xmparam_t xmp;
  89        assert(opts);
  90
  91        if (buffer_is_binary(orig->ptr, orig->size) ||
  92            buffer_is_binary(src1->ptr, src1->size) ||
  93            buffer_is_binary(src2->ptr, src2->size)) {
  94                return ll_binary_merge(drv_unused, result,
  95                                       path,
  96                                       orig, orig_name,
  97                                       src1, name1,
  98                                       src2, name2,
  99                                       opts, marker_size);
 100        }
 101
 102        memset(&xmp, 0, sizeof(xmp));
 103        xmp.level = XDL_MERGE_ZEALOUS;
 104        xmp.favor = opts->variant;
 105        xmp.xpp.flags = opts->xdl_opts;
 106        if (git_xmerge_style >= 0)
 107                xmp.style = git_xmerge_style;
 108        if (marker_size > 0)
 109                xmp.marker_size = marker_size;
 110        xmp.ancestor = orig_name;
 111        xmp.file1 = name1;
 112        xmp.file2 = name2;
 113        return xdl_merge(orig, src1, src2, &xmp, result);
 114}
 115
 116static int ll_union_merge(const struct ll_merge_driver *drv_unused,
 117                          mmbuffer_t *result,
 118                          const char *path_unused,
 119                          mmfile_t *orig, const char *orig_name,
 120                          mmfile_t *src1, const char *name1,
 121                          mmfile_t *src2, const char *name2,
 122                          const struct ll_merge_options *opts,
 123                          int marker_size)
 124{
 125        /* Use union favor */
 126        struct ll_merge_options o;
 127        assert(opts);
 128        o = *opts;
 129        o.variant = XDL_MERGE_FAVOR_UNION;
 130        return ll_xdl_merge(drv_unused, result, path_unused,
 131                            orig, NULL, src1, NULL, src2, NULL,
 132                            &o, marker_size);
 133}
 134
 135#define LL_BINARY_MERGE 0
 136#define LL_TEXT_MERGE 1
 137#define LL_UNION_MERGE 2
 138static struct ll_merge_driver ll_merge_drv[] = {
 139        { "binary", "built-in binary merge", ll_binary_merge },
 140        { "text", "built-in 3-way text merge", ll_xdl_merge },
 141        { "union", "built-in union merge", ll_union_merge },
 142};
 143
 144static void create_temp(mmfile_t *src, char *path)
 145{
 146        int fd;
 147
 148        strcpy(path, ".merge_file_XXXXXX");
 149        fd = xmkstemp(path);
 150        if (write_in_full(fd, src->ptr, src->size) != src->size)
 151                die_errno("unable to write temp-file");
 152        close(fd);
 153}
 154
 155/*
 156 * User defined low-level merge driver support.
 157 */
 158static int ll_ext_merge(const struct ll_merge_driver *fn,
 159                        mmbuffer_t *result,
 160                        const char *path,
 161                        mmfile_t *orig, const char *orig_name,
 162                        mmfile_t *src1, const char *name1,
 163                        mmfile_t *src2, const char *name2,
 164                        const struct ll_merge_options *opts,
 165                        int marker_size)
 166{
 167        char temp[4][50];
 168        struct strbuf cmd = STRBUF_INIT;
 169        struct strbuf_expand_dict_entry dict[5];
 170        const char *args[] = { NULL, NULL };
 171        int status, fd, i;
 172        struct stat st;
 173        assert(opts);
 174
 175        dict[0].placeholder = "O"; dict[0].value = temp[0];
 176        dict[1].placeholder = "A"; dict[1].value = temp[1];
 177        dict[2].placeholder = "B"; dict[2].value = temp[2];
 178        dict[3].placeholder = "L"; dict[3].value = temp[3];
 179        dict[4].placeholder = NULL; dict[4].value = NULL;
 180
 181        if (fn->cmdline == NULL)
 182                die("custom merge driver %s lacks command line.", fn->name);
 183
 184        result->ptr = NULL;
 185        result->size = 0;
 186        create_temp(orig, temp[0]);
 187        create_temp(src1, temp[1]);
 188        create_temp(src2, temp[2]);
 189        sprintf(temp[3], "%d", marker_size);
 190
 191        strbuf_expand(&cmd, fn->cmdline, strbuf_expand_dict_cb, &dict);
 192
 193        args[0] = cmd.buf;
 194        status = run_command_v_opt(args, RUN_USING_SHELL);
 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;
 206        }
 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;
 214}
 215
 216/*
 217 * merge.default and merge.driver configuration items
 218 */
 219static struct ll_merge_driver *ll_user_merge, **ll_user_merge_tail;
 220static const char *default_ll_merge;
 221
 222static int read_merge_config(const char *var, const char *value, void *cb)
 223{
 224        struct ll_merge_driver *fn;
 225        const char *ep, *name;
 226        int namelen;
 227
 228        if (!strcmp(var, "merge.default")) {
 229                if (value)
 230                        default_ll_merge = xstrdup(value);
 231                return 0;
 232        }
 233
 234        /*
 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".
 238         */
 239        if (prefixcmp(var, "merge.") || (ep = strrchr(var, '.')) == var + 5)
 240                return 0;
 241
 242        /*
 243         * Find existing one as we might be processing merge.<name>.var2
 244         * after seeing merge.<name>.var1.
 245         */
 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);
 257        }
 258
 259        ep++;
 260
 261        if (!strcmp("name", ep)) {
 262                if (!value)
 263                        return error("%s: lacks value", var);
 264                fn->description = xstrdup(value);
 265                return 0;
 266        }
 267
 268        if (!strcmp("driver", ep)) {
 269                if (!value)
 270                        return error("%s: lacks value", var);
 271                /*
 272                 * merge.<name>.driver specifies the command line:
 273                 *
 274                 *      command-line
 275                 *
 276                 * The command-line will be interpolated with the following
 277                 * tokens and is given to the shell:
 278                 *
 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.
 282                 *    %L - conflict marker length
 283                 *
 284                 * The external merge driver should write the results in the
 285                 * file named by %A, and signal that it has done with zero exit
 286                 * status.
 287                 */
 288                fn->cmdline = xstrdup(value);
 289                return 0;
 290        }
 291
 292        if (!strcmp("recursive", ep)) {
 293                if (!value)
 294                        return error("%s: lacks value", var);
 295                fn->recursive = xstrdup(value);
 296                return 0;
 297        }
 298
 299        return 0;
 300}
 301
 302static void initialize_ll_merge(void)
 303{
 304        if (ll_user_merge_tail)
 305                return;
 306        ll_user_merge_tail = &ll_user_merge;
 307        git_config(read_merge_config, NULL);
 308}
 309
 310static const struct ll_merge_driver *find_ll_merge_driver(const char *merge_attr)
 311{
 312        struct ll_merge_driver *fn;
 313        const char *name;
 314        int i;
 315
 316        initialize_ll_merge();
 317
 318        if (ATTR_TRUE(merge_attr))
 319                return &ll_merge_drv[LL_TEXT_MERGE];
 320        else if (ATTR_FALSE(merge_attr))
 321                return &ll_merge_drv[LL_BINARY_MERGE];
 322        else if (ATTR_UNSET(merge_attr)) {
 323                if (!default_ll_merge)
 324                        return &ll_merge_drv[LL_TEXT_MERGE];
 325                else
 326                        name = default_ll_merge;
 327        }
 328        else
 329                name = merge_attr;
 330
 331        for (fn = ll_user_merge; fn; fn = fn->next)
 332                if (!strcmp(fn->name, name))
 333                        return fn;
 334
 335        for (i = 0; i < ARRAY_SIZE(ll_merge_drv); i++)
 336                if (!strcmp(ll_merge_drv[i].name, name))
 337                        return &ll_merge_drv[i];
 338
 339        /* default to the 3-way */
 340        return &ll_merge_drv[LL_TEXT_MERGE];
 341}
 342
 343static int git_path_check_merge(const char *path, struct git_attr_check check[2])
 344{
 345        if (!check[0].attr) {
 346                check[0].attr = git_attr("merge");
 347                check[1].attr = git_attr("conflict-marker-size");
 348        }
 349        return git_check_attr(path, 2, check);
 350}
 351
 352static void normalize_file(mmfile_t *mm, const char *path)
 353{
 354        struct strbuf strbuf = STRBUF_INIT;
 355        if (renormalize_buffer(path, mm->ptr, mm->size, &strbuf)) {
 356                free(mm->ptr);
 357                mm->size = strbuf.len;
 358                mm->ptr = strbuf_detach(&strbuf, NULL);
 359        }
 360}
 361
 362int ll_merge(mmbuffer_t *result_buf,
 363             const char *path,
 364             mmfile_t *ancestor, const char *ancestor_label,
 365             mmfile_t *ours, const char *our_label,
 366             mmfile_t *theirs, const char *their_label,
 367             const struct ll_merge_options *opts)
 368{
 369        static struct git_attr_check check[2];
 370        static const struct ll_merge_options default_opts;
 371        const char *ll_driver_name = NULL;
 372        int marker_size = DEFAULT_CONFLICT_MARKER_SIZE;
 373        const struct ll_merge_driver *driver;
 374
 375        if (!opts)
 376                opts = &default_opts;
 377
 378        if (opts->renormalize) {
 379                normalize_file(ancestor, path);
 380                normalize_file(ours, path);
 381                normalize_file(theirs, path);
 382        }
 383        if (!git_path_check_merge(path, check)) {
 384                ll_driver_name = check[0].value;
 385                if (check[1].value) {
 386                        marker_size = atoi(check[1].value);
 387                        if (marker_size <= 0)
 388                                marker_size = DEFAULT_CONFLICT_MARKER_SIZE;
 389                }
 390        }
 391        driver = find_ll_merge_driver(ll_driver_name);
 392        if (opts->virtual_ancestor && driver->recursive)
 393                driver = find_ll_merge_driver(driver->recursive);
 394        return driver->fn(driver, result_buf, path, ancestor, ancestor_label,
 395                          ours, our_label, theirs, their_label,
 396                          opts, marker_size);
 397}
 398
 399int ll_merge_marker_size(const char *path)
 400{
 401        static struct git_attr_check check;
 402        int marker_size = DEFAULT_CONFLICT_MARKER_SIZE;
 403
 404        if (!check.attr)
 405                check.attr = git_attr("conflict-marker-size");
 406        if (!git_check_attr(path, 1, &check) && check.value) {
 407                marker_size = atoi(check.value);
 408                if (marker_size <= 0)
 409                        marker_size = DEFAULT_CONFLICT_MARKER_SIZE;
 410        }
 411        return marker_size;
 412}