builtin / checkout.con commit checkout: introduce --detach synonym for "git checkout foo^{commit}" (3266967)
   1#include "cache.h"
   2#include "builtin.h"
   3#include "parse-options.h"
   4#include "refs.h"
   5#include "commit.h"
   6#include "tree.h"
   7#include "tree-walk.h"
   8#include "cache-tree.h"
   9#include "unpack-trees.h"
  10#include "dir.h"
  11#include "run-command.h"
  12#include "merge-recursive.h"
  13#include "branch.h"
  14#include "diff.h"
  15#include "revision.h"
  16#include "remote.h"
  17#include "blob.h"
  18#include "xdiff-interface.h"
  19#include "ll-merge.h"
  20#include "resolve-undo.h"
  21#include "submodule.h"
  22
  23static const char * const checkout_usage[] = {
  24        "git checkout [options] <branch>",
  25        "git checkout [options] [<branch>] -- <file>...",
  26        NULL,
  27};
  28
  29struct checkout_opts {
  30        int quiet;
  31        int merge;
  32        int force;
  33        int force_detach;
  34        int writeout_stage;
  35        int writeout_error;
  36
  37        /* not set by parse_options */
  38        int branch_exists;
  39
  40        const char *new_branch;
  41        const char *new_branch_force;
  42        const char *new_orphan_branch;
  43        int new_branch_log;
  44        enum branch_track track;
  45        struct diff_options diff_options;
  46};
  47
  48static int post_checkout_hook(struct commit *old, struct commit *new,
  49                              int changed)
  50{
  51        return run_hook(NULL, "post-checkout",
  52                        sha1_to_hex(old ? old->object.sha1 : null_sha1),
  53                        sha1_to_hex(new ? new->object.sha1 : null_sha1),
  54                        changed ? "1" : "0", NULL);
  55        /* "new" can be NULL when checking out from the index before
  56           a commit exists. */
  57
  58}
  59
  60static int update_some(const unsigned char *sha1, const char *base, int baselen,
  61                const char *pathname, unsigned mode, int stage, void *context)
  62{
  63        int len;
  64        struct cache_entry *ce;
  65
  66        if (S_ISDIR(mode))
  67                return READ_TREE_RECURSIVE;
  68
  69        len = baselen + strlen(pathname);
  70        ce = xcalloc(1, cache_entry_size(len));
  71        hashcpy(ce->sha1, sha1);
  72        memcpy(ce->name, base, baselen);
  73        memcpy(ce->name + baselen, pathname, len - baselen);
  74        ce->ce_flags = create_ce_flags(len, 0);
  75        ce->ce_mode = create_ce_mode(mode);
  76        add_cache_entry(ce, ADD_CACHE_OK_TO_ADD | ADD_CACHE_OK_TO_REPLACE);
  77        return 0;
  78}
  79
  80static int read_tree_some(struct tree *tree, const char **pathspec)
  81{
  82        read_tree_recursive(tree, "", 0, 0, pathspec, update_some, NULL);
  83
  84        /* update the index with the given tree's info
  85         * for all args, expanding wildcards, and exit
  86         * with any non-zero return code.
  87         */
  88        return 0;
  89}
  90
  91static int skip_same_name(struct cache_entry *ce, int pos)
  92{
  93        while (++pos < active_nr &&
  94               !strcmp(active_cache[pos]->name, ce->name))
  95                ; /* skip */
  96        return pos;
  97}
  98
  99static int check_stage(int stage, struct cache_entry *ce, int pos)
 100{
 101        while (pos < active_nr &&
 102               !strcmp(active_cache[pos]->name, ce->name)) {
 103                if (ce_stage(active_cache[pos]) == stage)
 104                        return 0;
 105                pos++;
 106        }
 107        return error("path '%s' does not have %s version",
 108                     ce->name,
 109                     (stage == 2) ? "our" : "their");
 110}
 111
 112static int check_all_stages(struct cache_entry *ce, int pos)
 113{
 114        if (ce_stage(ce) != 1 ||
 115            active_nr <= pos + 2 ||
 116            strcmp(active_cache[pos+1]->name, ce->name) ||
 117            ce_stage(active_cache[pos+1]) != 2 ||
 118            strcmp(active_cache[pos+2]->name, ce->name) ||
 119            ce_stage(active_cache[pos+2]) != 3)
 120                return error("path '%s' does not have all three versions",
 121                             ce->name);
 122        return 0;
 123}
 124
 125static int checkout_stage(int stage, struct cache_entry *ce, int pos,
 126                          struct checkout *state)
 127{
 128        while (pos < active_nr &&
 129               !strcmp(active_cache[pos]->name, ce->name)) {
 130                if (ce_stage(active_cache[pos]) == stage)
 131                        return checkout_entry(active_cache[pos], state, NULL);
 132                pos++;
 133        }
 134        return error("path '%s' does not have %s version",
 135                     ce->name,
 136                     (stage == 2) ? "our" : "their");
 137}
 138
 139static int checkout_merged(int pos, struct checkout *state)
 140{
 141        struct cache_entry *ce = active_cache[pos];
 142        const char *path = ce->name;
 143        mmfile_t ancestor, ours, theirs;
 144        int status;
 145        unsigned char sha1[20];
 146        mmbuffer_t result_buf;
 147
 148        if (ce_stage(ce) != 1 ||
 149            active_nr <= pos + 2 ||
 150            strcmp(active_cache[pos+1]->name, path) ||
 151            ce_stage(active_cache[pos+1]) != 2 ||
 152            strcmp(active_cache[pos+2]->name, path) ||
 153            ce_stage(active_cache[pos+2]) != 3)
 154                return error("path '%s' does not have all 3 versions", path);
 155
 156        read_mmblob(&ancestor, active_cache[pos]->sha1);
 157        read_mmblob(&ours, active_cache[pos+1]->sha1);
 158        read_mmblob(&theirs, active_cache[pos+2]->sha1);
 159
 160        /*
 161         * NEEDSWORK: re-create conflicts from merges with
 162         * merge.renormalize set, too
 163         */
 164        status = ll_merge(&result_buf, path, &ancestor, "base",
 165                          &ours, "ours", &theirs, "theirs", 0);
 166        free(ancestor.ptr);
 167        free(ours.ptr);
 168        free(theirs.ptr);
 169        if (status < 0 || !result_buf.ptr) {
 170                free(result_buf.ptr);
 171                return error("path '%s': cannot merge", path);
 172        }
 173
 174        /*
 175         * NEEDSWORK:
 176         * There is absolutely no reason to write this as a blob object
 177         * and create a phony cache entry just to leak.  This hack is
 178         * primarily to get to the write_entry() machinery that massages
 179         * the contents to work-tree format and writes out which only
 180         * allows it for a cache entry.  The code in write_entry() needs
 181         * to be refactored to allow us to feed a <buffer, size, mode>
 182         * instead of a cache entry.  Such a refactoring would help
 183         * merge_recursive as well (it also writes the merge result to the
 184         * object database even when it may contain conflicts).
 185         */
 186        if (write_sha1_file(result_buf.ptr, result_buf.size,
 187                            blob_type, sha1))
 188                die("Unable to add merge result for '%s'", path);
 189        ce = make_cache_entry(create_ce_mode(active_cache[pos+1]->ce_mode),
 190                              sha1,
 191                              path, 2, 0);
 192        if (!ce)
 193                die("make_cache_entry failed for path '%s'", path);
 194        status = checkout_entry(ce, state, NULL);
 195        return status;
 196}
 197
 198static int checkout_paths(struct tree *source_tree, const char **pathspec,
 199                          struct checkout_opts *opts)
 200{
 201        int pos;
 202        struct checkout state;
 203        static char *ps_matched;
 204        unsigned char rev[20];
 205        int flag;
 206        struct commit *head;
 207        int errs = 0;
 208        int stage = opts->writeout_stage;
 209        int merge = opts->merge;
 210        int newfd;
 211        struct lock_file *lock_file = xcalloc(1, sizeof(struct lock_file));
 212
 213        newfd = hold_locked_index(lock_file, 1);
 214        if (read_cache_preload(pathspec) < 0)
 215                return error("corrupt index file");
 216
 217        if (source_tree)
 218                read_tree_some(source_tree, pathspec);
 219
 220        for (pos = 0; pathspec[pos]; pos++)
 221                ;
 222        ps_matched = xcalloc(1, pos);
 223
 224        for (pos = 0; pos < active_nr; pos++) {
 225                struct cache_entry *ce = active_cache[pos];
 226                match_pathspec(pathspec, ce->name, ce_namelen(ce), 0, ps_matched);
 227        }
 228
 229        if (report_path_error(ps_matched, pathspec, 0))
 230                return 1;
 231
 232        /* "checkout -m path" to recreate conflicted state */
 233        if (opts->merge)
 234                unmerge_cache(pathspec);
 235
 236        /* Any unmerged paths? */
 237        for (pos = 0; pos < active_nr; pos++) {
 238                struct cache_entry *ce = active_cache[pos];
 239                if (match_pathspec(pathspec, ce->name, ce_namelen(ce), 0, NULL)) {
 240                        if (!ce_stage(ce))
 241                                continue;
 242                        if (opts->force) {
 243                                warning("path '%s' is unmerged", ce->name);
 244                        } else if (stage) {
 245                                errs |= check_stage(stage, ce, pos);
 246                        } else if (opts->merge) {
 247                                errs |= check_all_stages(ce, pos);
 248                        } else {
 249                                errs = 1;
 250                                error("path '%s' is unmerged", ce->name);
 251                        }
 252                        pos = skip_same_name(ce, pos) - 1;
 253                }
 254        }
 255        if (errs)
 256                return 1;
 257
 258        /* Now we are committed to check them out */
 259        memset(&state, 0, sizeof(state));
 260        state.force = 1;
 261        state.refresh_cache = 1;
 262        for (pos = 0; pos < active_nr; pos++) {
 263                struct cache_entry *ce = active_cache[pos];
 264                if (match_pathspec(pathspec, ce->name, ce_namelen(ce), 0, NULL)) {
 265                        if (!ce_stage(ce)) {
 266                                errs |= checkout_entry(ce, &state, NULL);
 267                                continue;
 268                        }
 269                        if (stage)
 270                                errs |= checkout_stage(stage, ce, pos, &state);
 271                        else if (merge)
 272                                errs |= checkout_merged(pos, &state);
 273                        pos = skip_same_name(ce, pos) - 1;
 274                }
 275        }
 276
 277        if (write_cache(newfd, active_cache, active_nr) ||
 278            commit_locked_index(lock_file))
 279                die("unable to write new index file");
 280
 281        resolve_ref("HEAD", rev, 0, &flag);
 282        head = lookup_commit_reference_gently(rev, 1);
 283
 284        errs |= post_checkout_hook(head, head, 0);
 285        return errs;
 286}
 287
 288static void show_local_changes(struct object *head, struct diff_options *opts)
 289{
 290        struct rev_info rev;
 291        /* I think we want full paths, even if we're in a subdirectory. */
 292        init_revisions(&rev, NULL);
 293        rev.diffopt.flags = opts->flags;
 294        rev.diffopt.output_format |= DIFF_FORMAT_NAME_STATUS;
 295        if (diff_setup_done(&rev.diffopt) < 0)
 296                die("diff_setup_done failed");
 297        add_pending_object(&rev, head, NULL);
 298        run_diff_index(&rev, 0);
 299}
 300
 301static void describe_detached_head(char *msg, struct commit *commit)
 302{
 303        struct strbuf sb = STRBUF_INIT;
 304        struct pretty_print_context ctx = {0};
 305        parse_commit(commit);
 306        pretty_print_commit(CMIT_FMT_ONELINE, commit, &sb, &ctx);
 307        fprintf(stderr, "%s %s... %s\n", msg,
 308                find_unique_abbrev(commit->object.sha1, DEFAULT_ABBREV), sb.buf);
 309        strbuf_release(&sb);
 310}
 311
 312static int reset_tree(struct tree *tree, struct checkout_opts *o, int worktree)
 313{
 314        struct unpack_trees_options opts;
 315        struct tree_desc tree_desc;
 316
 317        memset(&opts, 0, sizeof(opts));
 318        opts.head_idx = -1;
 319        opts.update = worktree;
 320        opts.skip_unmerged = !worktree;
 321        opts.reset = 1;
 322        opts.merge = 1;
 323        opts.fn = oneway_merge;
 324        opts.verbose_update = !o->quiet;
 325        opts.src_index = &the_index;
 326        opts.dst_index = &the_index;
 327        parse_tree(tree);
 328        init_tree_desc(&tree_desc, tree->buffer, tree->size);
 329        switch (unpack_trees(1, &tree_desc, &opts)) {
 330        case -2:
 331                o->writeout_error = 1;
 332                /*
 333                 * We return 0 nevertheless, as the index is all right
 334                 * and more importantly we have made best efforts to
 335                 * update paths in the work tree, and we cannot revert
 336                 * them.
 337                 */
 338        case 0:
 339                return 0;
 340        default:
 341                return 128;
 342        }
 343}
 344
 345struct branch_info {
 346        const char *name; /* The short name used */
 347        const char *path; /* The full name of a real branch */
 348        struct commit *commit; /* The named commit */
 349};
 350
 351static void setup_branch_path(struct branch_info *branch)
 352{
 353        struct strbuf buf = STRBUF_INIT;
 354
 355        strbuf_branchname(&buf, branch->name);
 356        if (strcmp(buf.buf, branch->name))
 357                branch->name = xstrdup(buf.buf);
 358        strbuf_splice(&buf, 0, 0, "refs/heads/", 11);
 359        branch->path = strbuf_detach(&buf, NULL);
 360}
 361
 362static int merge_working_tree(struct checkout_opts *opts,
 363                              struct branch_info *old, struct branch_info *new)
 364{
 365        int ret;
 366        struct lock_file *lock_file = xcalloc(1, sizeof(struct lock_file));
 367        int newfd = hold_locked_index(lock_file, 1);
 368
 369        if (read_cache_preload(NULL) < 0)
 370                return error("corrupt index file");
 371
 372        resolve_undo_clear();
 373        if (opts->force) {
 374                ret = reset_tree(new->commit->tree, opts, 1);
 375                if (ret)
 376                        return ret;
 377        } else {
 378                struct tree_desc trees[2];
 379                struct tree *tree;
 380                struct unpack_trees_options topts;
 381
 382                memset(&topts, 0, sizeof(topts));
 383                topts.head_idx = -1;
 384                topts.src_index = &the_index;
 385                topts.dst_index = &the_index;
 386
 387                setup_unpack_trees_porcelain(&topts, "checkout");
 388
 389                refresh_cache(REFRESH_QUIET);
 390
 391                if (unmerged_cache()) {
 392                        error("you need to resolve your current index first");
 393                        return 1;
 394                }
 395
 396                /* 2-way merge to the new branch */
 397                topts.initial_checkout = is_cache_unborn();
 398                topts.update = 1;
 399                topts.merge = 1;
 400                topts.gently = opts->merge && old->commit;
 401                topts.verbose_update = !opts->quiet;
 402                topts.fn = twoway_merge;
 403                topts.dir = xcalloc(1, sizeof(*topts.dir));
 404                topts.dir->flags |= DIR_SHOW_IGNORED;
 405                topts.dir->exclude_per_dir = ".gitignore";
 406                tree = parse_tree_indirect(old->commit ?
 407                                           old->commit->object.sha1 :
 408                                           (unsigned char *)EMPTY_TREE_SHA1_BIN);
 409                init_tree_desc(&trees[0], tree->buffer, tree->size);
 410                tree = parse_tree_indirect(new->commit->object.sha1);
 411                init_tree_desc(&trees[1], tree->buffer, tree->size);
 412
 413                ret = unpack_trees(2, trees, &topts);
 414                if (ret == -1) {
 415                        /*
 416                         * Unpack couldn't do a trivial merge; either
 417                         * give up or do a real merge, depending on
 418                         * whether the merge flag was used.
 419                         */
 420                        struct tree *result;
 421                        struct tree *work;
 422                        struct merge_options o;
 423                        if (!opts->merge)
 424                                return 1;
 425
 426                        /*
 427                         * Without old->commit, the below is the same as
 428                         * the two-tree unpack we already tried and failed.
 429                         */
 430                        if (!old->commit)
 431                                return 1;
 432
 433                        /* Do more real merge */
 434
 435                        /*
 436                         * We update the index fully, then write the
 437                         * tree from the index, then merge the new
 438                         * branch with the current tree, with the old
 439                         * branch as the base. Then we reset the index
 440                         * (but not the working tree) to the new
 441                         * branch, leaving the working tree as the
 442                         * merged version, but skipping unmerged
 443                         * entries in the index.
 444                         */
 445
 446                        add_files_to_cache(NULL, NULL, 0);
 447                        /*
 448                         * NEEDSWORK: carrying over local changes
 449                         * when branches have different end-of-line
 450                         * normalization (or clean+smudge rules) is
 451                         * a pain; plumb in an option to set
 452                         * o.renormalize?
 453                         */
 454                        init_merge_options(&o);
 455                        o.verbosity = 0;
 456                        work = write_tree_from_memory(&o);
 457
 458                        ret = reset_tree(new->commit->tree, opts, 1);
 459                        if (ret)
 460                                return ret;
 461                        o.ancestor = old->name;
 462                        o.branch1 = new->name;
 463                        o.branch2 = "local";
 464                        merge_trees(&o, new->commit->tree, work,
 465                                old->commit->tree, &result);
 466                        ret = reset_tree(new->commit->tree, opts, 0);
 467                        if (ret)
 468                                return ret;
 469                }
 470        }
 471
 472        if (write_cache(newfd, active_cache, active_nr) ||
 473            commit_locked_index(lock_file))
 474                die("unable to write new index file");
 475
 476        if (!opts->force && !opts->quiet)
 477                show_local_changes(&new->commit->object, &opts->diff_options);
 478
 479        return 0;
 480}
 481
 482static void report_tracking(struct branch_info *new)
 483{
 484        struct strbuf sb = STRBUF_INIT;
 485        struct branch *branch = branch_get(new->name);
 486
 487        if (!format_tracking_info(branch, &sb))
 488                return;
 489        fputs(sb.buf, stdout);
 490        strbuf_release(&sb);
 491}
 492
 493static void detach_advice(const char *old_path, const char *new_name)
 494{
 495        const char fmt[] =
 496        "Note: checking out '%s'.\n\n"
 497        "You are in 'detached HEAD' state. You can look around, make experimental\n"
 498        "changes and commit them, and you can discard any commits you make in this\n"
 499        "state without impacting any branches by performing another checkout.\n\n"
 500        "If you want to create a new branch to retain commits you create, you may\n"
 501        "do so (now or later) by using -b with the checkout command again. Example:\n\n"
 502        "  git checkout -b new_branch_name\n\n";
 503
 504        fprintf(stderr, fmt, new_name);
 505}
 506
 507static void update_refs_for_switch(struct checkout_opts *opts,
 508                                   struct branch_info *old,
 509                                   struct branch_info *new)
 510{
 511        struct strbuf msg = STRBUF_INIT;
 512        const char *old_desc;
 513        if (opts->new_branch) {
 514                if (opts->new_orphan_branch) {
 515                        if (opts->new_branch_log && !log_all_ref_updates) {
 516                                int temp;
 517                                char log_file[PATH_MAX];
 518                                char *ref_name = mkpath("refs/heads/%s", opts->new_orphan_branch);
 519
 520                                temp = log_all_ref_updates;
 521                                log_all_ref_updates = 1;
 522                                if (log_ref_setup(ref_name, log_file, sizeof(log_file))) {
 523                                        fprintf(stderr, "Can not do reflog for '%s'\n",
 524                                            opts->new_orphan_branch);
 525                                        log_all_ref_updates = temp;
 526                                        return;
 527                                }
 528                                log_all_ref_updates = temp;
 529                        }
 530                }
 531                else
 532                        create_branch(old->name, opts->new_branch, new->name,
 533                                      opts->new_branch_force ? 1 : 0,
 534                                      opts->new_branch_log, opts->track);
 535                new->name = opts->new_branch;
 536                setup_branch_path(new);
 537        }
 538
 539        old_desc = old->name;
 540        if (!old_desc && old->commit)
 541                old_desc = sha1_to_hex(old->commit->object.sha1);
 542        strbuf_addf(&msg, "checkout: moving from %s to %s",
 543                    old_desc ? old_desc : "(invalid)", new->name);
 544
 545        if (new->path) {
 546                create_symref("HEAD", new->path, msg.buf);
 547                if (!opts->quiet) {
 548                        if (old->path && !strcmp(new->path, old->path))
 549                                fprintf(stderr, "Already on '%s'\n",
 550                                        new->name);
 551                        else if (opts->new_branch)
 552                                fprintf(stderr, "Switched to%s branch '%s'\n",
 553                                        opts->branch_exists ? " and reset" : " a new",
 554                                        new->name);
 555                        else
 556                                fprintf(stderr, "Switched to branch '%s'\n",
 557                                        new->name);
 558                }
 559                if (old->path && old->name) {
 560                        char log_file[PATH_MAX], ref_file[PATH_MAX];
 561
 562                        git_snpath(log_file, sizeof(log_file), "logs/%s", old->path);
 563                        git_snpath(ref_file, sizeof(ref_file), "%s", old->path);
 564                        if (!file_exists(ref_file) && file_exists(log_file))
 565                                remove_path(log_file);
 566                }
 567        } else if (opts->force_detach || strcmp(new->name, "HEAD")) {
 568                update_ref(msg.buf, "HEAD", new->commit->object.sha1, NULL,
 569                           REF_NODEREF, DIE_ON_ERR);
 570                if (!opts->quiet) {
 571                        if (old->path && advice_detached_head)
 572                                detach_advice(old->path, new->name);
 573                        describe_detached_head("HEAD is now at", new->commit);
 574                }
 575        }
 576        remove_branch_state();
 577        strbuf_release(&msg);
 578        if (!opts->quiet &&
 579            (new->path || (!opts->force_detach && !strcmp(new->name, "HEAD"))))
 580                report_tracking(new);
 581}
 582
 583static int switch_branches(struct checkout_opts *opts, struct branch_info *new)
 584{
 585        int ret = 0;
 586        struct branch_info old;
 587        unsigned char rev[20];
 588        int flag;
 589        memset(&old, 0, sizeof(old));
 590        old.path = resolve_ref("HEAD", rev, 0, &flag);
 591        old.commit = lookup_commit_reference_gently(rev, 1);
 592        if (!(flag & REF_ISSYMREF))
 593                old.path = NULL;
 594
 595        if (old.path && !prefixcmp(old.path, "refs/heads/"))
 596                old.name = old.path + strlen("refs/heads/");
 597
 598        if (!new->name) {
 599                new->name = "HEAD";
 600                new->commit = old.commit;
 601                if (!new->commit)
 602                        die("You are on a branch yet to be born");
 603                parse_commit(new->commit);
 604        }
 605
 606        ret = merge_working_tree(opts, &old, new);
 607        if (ret)
 608                return ret;
 609
 610        /*
 611         * If we were on a detached HEAD, but have now moved to
 612         * a new commit, we want to mention the old commit once more
 613         * to remind the user that it might be lost.
 614         */
 615        if (!opts->quiet && !old.path && old.commit && new->commit != old.commit)
 616                describe_detached_head("Previous HEAD position was", old.commit);
 617
 618        update_refs_for_switch(opts, &old, new);
 619
 620        ret = post_checkout_hook(old.commit, new->commit, 1);
 621        return ret || opts->writeout_error;
 622}
 623
 624static int git_checkout_config(const char *var, const char *value, void *cb)
 625{
 626        if (!strcmp(var, "diff.ignoresubmodules")) {
 627                struct checkout_opts *opts = cb;
 628                handle_ignore_submodules_arg(&opts->diff_options, value);
 629                return 0;
 630        }
 631
 632        if (!prefixcmp(var, "submodule."))
 633                return parse_submodule_config_option(var, value);
 634
 635        return git_xmerge_config(var, value, NULL);
 636}
 637
 638static int interactive_checkout(const char *revision, const char **pathspec,
 639                                struct checkout_opts *opts)
 640{
 641        return run_add_interactive(revision, "--patch=checkout", pathspec);
 642}
 643
 644struct tracking_name_data {
 645        const char *name;
 646        char *remote;
 647        int unique;
 648};
 649
 650static int check_tracking_name(const char *refname, const unsigned char *sha1,
 651                               int flags, void *cb_data)
 652{
 653        struct tracking_name_data *cb = cb_data;
 654        const char *slash;
 655
 656        if (prefixcmp(refname, "refs/remotes/"))
 657                return 0;
 658        slash = strchr(refname + 13, '/');
 659        if (!slash || strcmp(slash + 1, cb->name))
 660                return 0;
 661        if (cb->remote) {
 662                cb->unique = 0;
 663                return 0;
 664        }
 665        cb->remote = xstrdup(refname);
 666        return 0;
 667}
 668
 669static const char *unique_tracking_name(const char *name)
 670{
 671        struct tracking_name_data cb_data = { NULL, NULL, 1 };
 672        cb_data.name = name;
 673        for_each_ref(check_tracking_name, &cb_data);
 674        if (cb_data.unique)
 675                return cb_data.remote;
 676        free(cb_data.remote);
 677        return NULL;
 678}
 679
 680static int parse_branchname_arg(int argc, const char **argv,
 681                                int dwim_new_local_branch_ok,
 682                                int force_detach,
 683                                struct branch_info *new,
 684                                struct tree **source_tree,
 685                                unsigned char rev[20],
 686                                const char **new_branch)
 687{
 688        int argcount = 0;
 689        unsigned char branch_rev[20];
 690        const char *arg;
 691        int has_dash_dash;
 692
 693        /*
 694         * case 1: git checkout <ref> -- [<paths>]
 695         *
 696         *   <ref> must be a valid tree, everything after the '--' must be
 697         *   a path.
 698         *
 699         * case 2: git checkout -- [<paths>]
 700         *
 701         *   everything after the '--' must be paths.
 702         *
 703         * case 3: git checkout <something> [<paths>]
 704         *
 705         *   With no paths, if <something> is a commit, that is to
 706         *   switch to the branch or detach HEAD at it.  As a special case,
 707         *   if <something> is A...B (missing A or B means HEAD but you can
 708         *   omit at most one side), and if there is a unique merge base
 709         *   between A and B, A...B names that merge base.
 710         *
 711         *   With no paths, if <something> is _not_ a commit, no -t nor -b
 712         *   was given, and there is a tracking branch whose name is
 713         *   <something> in one and only one remote, then this is a short-hand
 714         *   to fork local <something> from that remote tracking branch.
 715         *
 716         *   Otherwise <something> shall not be ambiguous.
 717         *   - If it's *only* a reference, treat it like case (1).
 718         *   - If it's only a path, treat it like case (2).
 719         *   - else: fail.
 720         *
 721         */
 722        if (!argc)
 723                return 0;
 724
 725        if (!strcmp(argv[0], "--"))     /* case (2) */
 726                return 1;
 727
 728        arg = argv[0];
 729        has_dash_dash = (argc > 1) && !strcmp(argv[1], "--");
 730
 731        if (!strcmp(arg, "-"))
 732                arg = "@{-1}";
 733
 734        if (get_sha1_mb(arg, rev)) {
 735                if (has_dash_dash)          /* case (1) */
 736                        die("invalid reference: %s", arg);
 737                if (dwim_new_local_branch_ok &&
 738                    !check_filename(NULL, arg) &&
 739                    argc == 1) {
 740                        const char *remote = unique_tracking_name(arg);
 741                        if (!remote || get_sha1(remote, rev))
 742                                return argcount;
 743                        *new_branch = arg;
 744                        arg = remote;
 745                        /* DWIMmed to create local branch */
 746                } else {
 747                        return argcount;
 748                }
 749        }
 750
 751        /* we can't end up being in (2) anymore, eat the argument */
 752        argcount++;
 753        argv++;
 754        argc--;
 755
 756        new->name = arg;
 757        setup_branch_path(new);
 758
 759        if (!force_detach &&
 760            check_ref_format(new->path) == CHECK_REF_FORMAT_OK &&
 761            resolve_ref(new->path, branch_rev, 1, NULL))
 762                hashcpy(rev, branch_rev);
 763        else
 764                new->path = NULL; /* not an existing branch */
 765
 766        new->commit = lookup_commit_reference_gently(rev, 1);
 767        if (!new->commit) {
 768                /* not a commit */
 769                *source_tree = parse_tree_indirect(rev);
 770        } else {
 771                parse_commit(new->commit);
 772                *source_tree = new->commit->tree;
 773        }
 774
 775        if (!*source_tree)                   /* case (1): want a tree */
 776                die("reference is not a tree: %s", arg);
 777        if (!has_dash_dash) {/* case (3 -> 1) */
 778                /*
 779                 * Do not complain the most common case
 780                 *      git checkout branch
 781                 * even if there happen to be a file called 'branch';
 782                 * it would be extremely annoying.
 783                 */
 784                if (argc)
 785                        verify_non_filename(NULL, arg);
 786        } else {
 787                argcount++;
 788                argv++;
 789                argc--;
 790        }
 791
 792        return argcount;
 793}
 794
 795int cmd_checkout(int argc, const char **argv, const char *prefix)
 796{
 797        struct checkout_opts opts;
 798        unsigned char rev[20];
 799        struct branch_info new;
 800        struct tree *source_tree = NULL;
 801        char *conflict_style = NULL;
 802        int patch_mode = 0;
 803        int dwim_new_local_branch = 1;
 804        struct option options[] = {
 805                OPT__QUIET(&opts.quiet),
 806                OPT_STRING('b', NULL, &opts.new_branch, "branch",
 807                           "create and checkout a new branch"),
 808                OPT_STRING('B', NULL, &opts.new_branch_force, "branch",
 809                           "create/reset and checkout a branch"),
 810                OPT_BOOLEAN('l', NULL, &opts.new_branch_log, "create reflog for new branch"),
 811                OPT_BOOLEAN(0, "detach", &opts.force_detach, "detach the HEAD at named commit"),
 812                OPT_SET_INT('t', "track",  &opts.track, "set upstream info for new branch",
 813                        BRANCH_TRACK_EXPLICIT),
 814                OPT_STRING(0, "orphan", &opts.new_orphan_branch, "new branch", "new unparented branch"),
 815                OPT_SET_INT('2', "ours", &opts.writeout_stage, "checkout our version for unmerged files",
 816                            2),
 817                OPT_SET_INT('3', "theirs", &opts.writeout_stage, "checkout their version for unmerged files",
 818                            3),
 819                OPT_BOOLEAN('f', "force", &opts.force, "force checkout (throw away local modifications)"),
 820                OPT_BOOLEAN('m', "merge", &opts.merge, "perform a 3-way merge with the new branch"),
 821                OPT_STRING(0, "conflict", &conflict_style, "style",
 822                           "conflict style (merge or diff3)"),
 823                OPT_BOOLEAN('p', "patch", &patch_mode, "select hunks interactively"),
 824                { OPTION_BOOLEAN, 0, "guess", &dwim_new_local_branch, NULL,
 825                  "second guess 'git checkout no-such-branch'",
 826                  PARSE_OPT_NOARG | PARSE_OPT_HIDDEN },
 827                OPT_END(),
 828        };
 829
 830        memset(&opts, 0, sizeof(opts));
 831        memset(&new, 0, sizeof(new));
 832
 833        gitmodules_config();
 834        git_config(git_checkout_config, &opts);
 835
 836        opts.track = BRANCH_TRACK_UNSPECIFIED;
 837
 838        argc = parse_options(argc, argv, prefix, options, checkout_usage,
 839                             PARSE_OPT_KEEP_DASHDASH);
 840
 841        /* we can assume from now on new_branch = !new_branch_force */
 842        if (opts.new_branch && opts.new_branch_force)
 843                die("-B cannot be used with -b");
 844
 845        /* copy -B over to -b, so that we can just check the latter */
 846        if (opts.new_branch_force)
 847                opts.new_branch = opts.new_branch_force;
 848
 849        if (patch_mode && (opts.track > 0 || opts.new_branch
 850                           || opts.new_branch_log || opts.merge || opts.force
 851                           || opts.force_detach))
 852                die ("--patch is incompatible with all other options");
 853
 854        if (opts.force_detach && (opts.new_branch || opts.new_orphan_branch))
 855                die("--detach cannot be used with -b/-B/--orphan");
 856        if (opts.force_detach && 0 < opts.track)
 857                die("--detach cannot be used with -t");
 858
 859        /* --track without -b should DWIM */
 860        if (0 < opts.track && !opts.new_branch) {
 861                const char *argv0 = argv[0];
 862                if (!argc || !strcmp(argv0, "--"))
 863                        die ("--track needs a branch name");
 864                if (!prefixcmp(argv0, "refs/"))
 865                        argv0 += 5;
 866                if (!prefixcmp(argv0, "remotes/"))
 867                        argv0 += 8;
 868                argv0 = strchr(argv0, '/');
 869                if (!argv0 || !argv0[1])
 870                        die ("Missing branch name; try -b");
 871                opts.new_branch = argv0 + 1;
 872        }
 873
 874        if (opts.new_orphan_branch) {
 875                if (opts.new_branch)
 876                        die("--orphan and -b|-B are mutually exclusive");
 877                if (opts.track > 0)
 878                        die("--orphan cannot be used with -t");
 879                opts.new_branch = opts.new_orphan_branch;
 880        }
 881
 882        if (conflict_style) {
 883                opts.merge = 1; /* implied */
 884                git_xmerge_config("merge.conflictstyle", conflict_style, NULL);
 885        }
 886
 887        if (opts.force && opts.merge)
 888                die("git checkout: -f and -m are incompatible");
 889
 890        /*
 891         * Extract branch name from command line arguments, so
 892         * all that is left is pathspecs.
 893         *
 894         * Handle
 895         *
 896         *  1) git checkout <tree> -- [<paths>]
 897         *  2) git checkout -- [<paths>]
 898         *  3) git checkout <something> [<paths>]
 899         *
 900         * including "last branch" syntax and DWIM-ery for names of
 901         * remote branches, erroring out for invalid or ambiguous cases.
 902         */
 903        if (argc) {
 904                int dwim_ok =
 905                        !patch_mode &&
 906                        dwim_new_local_branch &&
 907                        opts.track == BRANCH_TRACK_UNSPECIFIED &&
 908                        !opts.new_branch;
 909                int n = parse_branchname_arg(argc, argv,
 910                                dwim_ok, opts.force_detach,
 911                                &new, &source_tree, rev, &opts.new_branch);
 912                argv += n;
 913                argc -= n;
 914        }
 915
 916        if (opts.track == BRANCH_TRACK_UNSPECIFIED)
 917                opts.track = git_branch_track;
 918
 919        if (argc) {
 920                const char **pathspec = get_pathspec(prefix, argv);
 921
 922                if (!pathspec)
 923                        die("invalid path specification");
 924
 925                if (patch_mode)
 926                        return interactive_checkout(new.name, pathspec, &opts);
 927
 928                /* Checkout paths */
 929                if (opts.new_branch) {
 930                        if (argc == 1) {
 931                                die("git checkout: updating paths is incompatible with switching branches.\nDid you intend to checkout '%s' which can not be resolved as commit?", argv[0]);
 932                        } else {
 933                                die("git checkout: updating paths is incompatible with switching branches.");
 934                        }
 935                }
 936
 937                if (opts.force_detach)
 938                        die("git checkout: --detach does not take a path argument");
 939
 940                if (1 < !!opts.writeout_stage + !!opts.force + !!opts.merge)
 941                        die("git checkout: --ours/--theirs, --force and --merge are incompatible when\nchecking out of the index.");
 942
 943                return checkout_paths(source_tree, pathspec, &opts);
 944        }
 945
 946        if (patch_mode)
 947                return interactive_checkout(new.name, NULL, &opts);
 948
 949        if (opts.new_branch) {
 950                struct strbuf buf = STRBUF_INIT;
 951                if (strbuf_check_branch_ref(&buf, opts.new_branch))
 952                        die("git checkout: we do not like '%s' as a branch name.",
 953                            opts.new_branch);
 954                if (!get_sha1(buf.buf, rev)) {
 955                        opts.branch_exists = 1;
 956                        if (!opts.new_branch_force)
 957                                die("git checkout: branch %s already exists",
 958                                    opts.new_branch);
 959                }
 960                strbuf_release(&buf);
 961        }
 962
 963        if (new.name && !new.commit) {
 964                die("Cannot switch branch to a non-commit.");
 965        }
 966        if (opts.writeout_stage)
 967                die("--ours/--theirs is incompatible with switching branches.");
 968
 969        return switch_branches(&opts, &new);
 970}