builtin/fetch.c

   1 /*
   2  * "git fetch"
   3  */
   4 #include "cache.h"
   5 #include "refs.h"
   6 #include "commit.h"
   7 #include "builtin.h"
   8 #include "string-list.h"
   9 #include "remote.h"
  10 #include "transport.h"
  11 #include "run-command.h"
  12 #include "parse-options.h"
  13 #include "sigchain.h"
  14 #include "transport.h"
  15 #include "submodule.h"
  16 #include "connected.h"
  17 #include "argv-array.h"
  18
  19 static const char * const builtin_fetch_usage[] = {
  20         N_("git fetch [<options>] [<repository> [<refspec>...]]"),
  21         N_("git fetch [<options>] <group>"),
  22         N_("git fetch --multiple [<options>] [(<repository> | <group>)...]"),
  23         N_("git fetch --all [<options>]"),
  24         NULL
  25 };
  26
  27 enum {
  28         TAGS_UNSET = 0,
  29         TAGS_DEFAULT = 1,
  30         TAGS_SET = 2
  31 };
  32
  33 static int all, append, dry_run, force, keep, multiple, prune, update_head_ok, verbosity;
  34 static int progress = -1, recurse_submodules = RECURSE_SUBMODULES_DEFAULT;
  35 static int tags = TAGS_DEFAULT;
  36 static const char *depth;
  37 static const char *upload_pack;
  38 static struct strbuf default_rla = STRBUF_INIT;
  39 static struct transport *transport;
  40 static const char *submodule_prefix = "";
  41 static const char *recurse_submodules_default;
  42
  43 static int option_parse_recurse_submodules(const struct option *opt,
  44                                    const char *arg, int unset)
  45 {
  46         if (unset) {
  47                 recurse_submodules = RECURSE_SUBMODULES_OFF;
  48         } else {
  49                 if (arg)
  50                         recurse_submodules = parse_fetch_recurse_submodules_arg(opt->long_name, arg);
  51                 else
  52                         recurse_submodules = RECURSE_SUBMODULES_ON;
  53         }
  54         return 0;
  55 }
  56
  57 static struct option builtin_fetch_options[] = {
  58         OPT__VERBOSITY(&verbosity),
  59         OPT_BOOLEAN(0, "all", &all,
  60                     N_("fetch from all remotes")),
  61         OPT_BOOLEAN('a', "append", &append,
  62                     N_("append to .git/FETCH_HEAD instead of overwriting")),
  63         OPT_STRING(0, "upload-pack", &upload_pack, N_("path"),
  64                    N_("path to upload pack on remote end")),
  65         OPT__FORCE(&force, N_("force overwrite of local branch")),
  66         OPT_BOOLEAN('m', "multiple", &multiple,
  67                     N_("fetch from multiple remotes")),
  68         OPT_SET_INT('t', "tags", &tags,
  69                     N_("fetch all tags and associated objects"), TAGS_SET),
  70         OPT_SET_INT('n', NULL, &tags,
  71                     N_("do not fetch all tags (--no-tags)"), TAGS_UNSET),
  72         OPT_BOOLEAN('p', "prune", &prune,
  73                     N_("prune remote-tracking branches no longer on remote")),
  74         { OPTION_CALLBACK, 0, "recurse-submodules", NULL, N_("on-demand"),
  75                     N_("control recursive fetching of submodules"),
  76                     PARSE_OPT_OPTARG, option_parse_recurse_submodules },
  77         OPT_BOOLEAN(0, "dry-run", &dry_run,
  78                     N_("dry run")),
  79         OPT_BOOLEAN('k', "keep", &keep, N_("keep downloaded pack")),
  80         OPT_BOOLEAN('u', "update-head-ok", &update_head_ok,
  81                     N_("allow updating of HEAD ref")),
  82         OPT_BOOL(0, "progress", &progress, N_("force progress reporting")),
  83         OPT_STRING(0, "depth", &depth, N_("depth"),
  84                    N_("deepen history of shallow clone")),
  85         { OPTION_STRING, 0, "submodule-prefix", &submodule_prefix, N_("dir"),
  86                    N_("prepend this to submodule path output"), PARSE_OPT_HIDDEN },
  87         { OPTION_STRING, 0, "recurse-submodules-default",
  88                    &recurse_submodules_default, NULL,
  89                    N_("default mode for recursion"), PARSE_OPT_HIDDEN },
  90         OPT_END()
  91 };
  92
  93 static void unlock_pack(void)
  94 {
  95         if (transport)
  96                 transport_unlock_pack(transport);
  97 }
  98
  99 static void unlock_pack_on_signal(int signo)
 100 {
 101         unlock_pack();
 102         sigchain_pop(signo);
 103         raise(signo);
 104 }
 105
 106 static void add_merge_config(struct ref **head,
 107                            const struct ref *remote_refs,
 108                            struct branch *branch,
 109                            struct ref ***tail)
 110 {
 111         int i;
 112
 113         for (i = 0; i < branch->merge_nr; i++) {
 114                 struct ref *rm, **old_tail = *tail;
 115                 struct refspec refspec;
 116
 117                 for (rm = *head; rm; rm = rm->next) {
 118                         if (branch_merge_matches(branch, i, rm->name)) {
 119                                 rm->merge = 1;
 120                                 break;
 121                         }
 122                 }
 123                 if (rm)
 124                         continue;
 125
 126                 /*
 127                  * Not fetched to a remote-tracking branch?  We need to fetch
 128                  * it anyway to allow this branch's "branch.$name.merge"
 129                  * to be honored by 'git pull', but we do not have to
 130                  * fail if branch.$name.merge is misconfigured to point
 131                  * at a nonexisting branch.  If we were indeed called by
 132                  * 'git pull', it will notice the misconfiguration because
 133                  * there is no entry in the resulting FETCH_HEAD marked
 134                  * for merging.
 135                  */
 136                 memset(&refspec, 0, sizeof(refspec));
 137                 refspec.src = branch->merge[i]->src;
 138                 get_fetch_map(remote_refs, &refspec, tail, 1);
 139                 for (rm = *old_tail; rm; rm = rm->next)
 140                         rm->merge = 1;
 141         }
 142 }
 143
 144 static void find_non_local_tags(struct transport *transport,
 145                         struct ref **head,
 146                         struct ref ***tail);
 147
 148 static struct ref *get_ref_map(struct transport *transport,
 149                                struct refspec *refs, int ref_count, int tags,
 150                                int *autotags)
 151 {
 152         int i;
 153         struct ref *rm;
 154         struct ref *ref_map = NULL;
 155         struct ref **tail = &ref_map;
 156
 157         const struct ref *remote_refs = transport_get_remote_refs(transport);
 158
 159         if (ref_count || tags == TAGS_SET) {
 160                 for (i = 0; i < ref_count; i++) {
 161                         get_fetch_map(remote_refs, &refs[i], &tail, 0);
 162                         if (refs[i].dst && refs[i].dst[0])
 163                                 *autotags = 1;
 164                 }
 165                 /* Merge everything on the command line, but not --tags */
 166                 for (rm = ref_map; rm; rm = rm->next)
 167                         rm->merge = 1;
 168                 if (tags == TAGS_SET)
 169                         get_fetch_map(remote_refs, tag_refspec, &tail, 0);
 170         } else {
 171                 /* Use the defaults */
 172                 struct remote *remote = transport->remote;
 173                 struct branch *branch = branch_get(NULL);
 174                 int has_merge = branch_has_merge_config(branch);
 175                 if (remote &&
 176                     (remote->fetch_refspec_nr ||
 177                      /* Note: has_merge implies non-NULL branch->remote_name */
 178                      (has_merge && !strcmp(branch->remote_name, remote->name)))) {
 179                         for (i = 0; i < remote->fetch_refspec_nr; i++) {
 180                                 get_fetch_map(remote_refs, &remote->fetch[i], &tail, 0);
 181                                 if (remote->fetch[i].dst &&
 182                                     remote->fetch[i].dst[0])
 183                                         *autotags = 1;
 184                                 if (!i && !has_merge && ref_map &&
 185                                     !remote->fetch[0].pattern)
 186                                         ref_map->merge = 1;
 187                         }
 188                         /*
 189                          * if the remote we're fetching from is the same
 190                          * as given in branch.<name>.remote, we add the
 191                          * ref given in branch.<name>.merge, too.
 192                          *
 193                          * Note: has_merge implies non-NULL branch->remote_name
 194                          */
 195                         if (has_merge &&
 196                             !strcmp(branch->remote_name, remote->name))
 197                                 add_merge_config(&ref_map, remote_refs, branch, &tail);
 198                 } else {
 199                         ref_map = get_remote_ref(remote_refs, "HEAD");
 200                         if (!ref_map)
 201                                 die(_("Couldn't find remote ref HEAD"));
 202                         ref_map->merge = 1;
 203                         tail = &ref_map->next;
 204                 }
 205         }
 206         if (tags == TAGS_DEFAULT && *autotags)
 207                 find_non_local_tags(transport, &ref_map, &tail);
 208         ref_remove_duplicates(ref_map);
 209
 210         return ref_map;
 211 }
 212
 213 #define STORE_REF_ERROR_OTHER 1
 214 #define STORE_REF_ERROR_DF_CONFLICT 2
 215
 216 static int s_update_ref(const char *action,
 217                         struct ref *ref,
 218                         int check_old)
 219 {
 220         char msg[1024];
 221         char *rla = getenv("GIT_REFLOG_ACTION");
 222         static struct ref_lock *lock;
 223
 224         if (dry_run)
 225                 return 0;
 226         if (!rla)
 227                 rla = default_rla.buf;
 228         snprintf(msg, sizeof(msg), "%s: %s", rla, action);
 229         lock = lock_any_ref_for_update(ref->name,
 230                                        check_old ? ref->old_sha1 : NULL, 0);
 231         if (!lock)
 232                 return errno == ENOTDIR ? STORE_REF_ERROR_DF_CONFLICT :
 233                                           STORE_REF_ERROR_OTHER;
 234         if (write_ref_sha1(lock, ref->new_sha1, msg) < 0)
 235                 return errno == ENOTDIR ? STORE_REF_ERROR_DF_CONFLICT :
 236                                           STORE_REF_ERROR_OTHER;
 237         return 0;
 238 }
 239
 240 #define REFCOL_WIDTH  10
 241
 242 static int update_local_ref(struct ref *ref,
 243                             const char *remote,
 244                             const struct ref *remote_ref,
 245                             struct strbuf *display)
 246 {
 247         struct commit *current = NULL, *updated;
 248         enum object_type type;
 249         struct branch *current_branch = branch_get(NULL);
 250         const char *pretty_ref = prettify_refname(ref->name);
 251
 252         type = sha1_object_info(ref->new_sha1, NULL);
 253         if (type < 0)
 254                 die(_("object %s not found"), sha1_to_hex(ref->new_sha1));
 255
 256         if (!hashcmp(ref->old_sha1, ref->new_sha1)) {
 257                 if (verbosity > 0)
 258                         strbuf_addf(display, "= %-*s %-*s -> %s",
 259                                     TRANSPORT_SUMMARY(_("[up to date]")),
 260                                     REFCOL_WIDTH, remote, pretty_ref);
 261                 return 0;
 262         }
 263
 264         if (current_branch &&
 265             !strcmp(ref->name, current_branch->name) &&
 266             !(update_head_ok || is_bare_repository()) &&
 267             !is_null_sha1(ref->old_sha1)) {
 268                 /*
 269                  * If this is the head, and it's not okay to update
 270                  * the head, and the old value of the head isn't empty...
 271                  */
 272                 strbuf_addf(display,
 273                             _("! %-*s %-*s -> %s  (can't fetch in current branch)"),
 274                             TRANSPORT_SUMMARY(_("[rejected]")),
 275                             REFCOL_WIDTH, remote, pretty_ref);
 276                 return 1;
 277         }
 278
 279         if (!is_null_sha1(ref->old_sha1) &&
 280             !prefixcmp(ref->name, "refs/tags/")) {
 281                 int r;
 282                 r = s_update_ref("updating tag", ref, 0);
 283                 strbuf_addf(display, "%c %-*s %-*s -> %s%s",
 284                             r ? '!' : '-',
 285                             TRANSPORT_SUMMARY(_("[tag update]")),
 286                             REFCOL_WIDTH, remote, pretty_ref,
 287                             r ? _("  (unable to update local ref)") : "");
 288                 return r;
 289         }
 290
 291         current = lookup_commit_reference_gently(ref->old_sha1, 1);
 292         updated = lookup_commit_reference_gently(ref->new_sha1, 1);
 293         if (!current || !updated) {
 294                 const char *msg;
 295                 const char *what;
 296                 int r;
 297                 /*
 298                  * Nicely describe the new ref we're fetching.
 299                  * Base this on the remote's ref name, as it's
 300                  * more likely to follow a standard layout.
 301                  */
 302                 const char *name = remote_ref ? remote_ref->name : "";
 303                 if (!prefixcmp(name, "refs/tags/")) {
 304                         msg = "storing tag";
 305                         what = _("[new tag]");
 306                 } else if (!prefixcmp(name, "refs/heads/")) {
 307                         msg = "storing head";
 308                         what = _("[new branch]");
 309                 } else {
 310                         msg = "storing ref";
 311                         what = _("[new ref]");
 312                 }
 313
 314                 if ((recurse_submodules != RECURSE_SUBMODULES_OFF) &&
 315                     (recurse_submodules != RECURSE_SUBMODULES_ON))
 316                         check_for_new_submodule_commits(ref->new_sha1);
 317                 r = s_update_ref(msg, ref, 0);
 318                 strbuf_addf(display, "%c %-*s %-*s -> %s%s",
 319                             r ? '!' : '*',
 320                             TRANSPORT_SUMMARY(what),
 321                             REFCOL_WIDTH, remote, pretty_ref,
 322                             r ? _("  (unable to update local ref)") : "");
 323                 return r;
 324         }
 325
 326         if (in_merge_bases(current, updated)) {
 327                 char quickref[83];
 328                 int r;
 329                 strcpy(quickref, find_unique_abbrev(current->object.sha1, DEFAULT_ABBREV));
 330                 strcat(quickref, "..");
 331                 strcat(quickref, find_unique_abbrev(ref->new_sha1, DEFAULT_ABBREV));
 332                 if ((recurse_submodules != RECURSE_SUBMODULES_OFF) &&
 333                     (recurse_submodules != RECURSE_SUBMODULES_ON))
 334                         check_for_new_submodule_commits(ref->new_sha1);
 335                 r = s_update_ref("fast-forward", ref, 1);
 336                 strbuf_addf(display, "%c %-*s %-*s -> %s%s",
 337                             r ? '!' : ' ',
 338                             TRANSPORT_SUMMARY_WIDTH, quickref,
 339                             REFCOL_WIDTH, remote, pretty_ref,
 340                             r ? _("  (unable to update local ref)") : "");
 341                 return r;
 342         } else if (force || ref->force) {
 343                 char quickref[84];
 344                 int r;
 345                 strcpy(quickref, find_unique_abbrev(current->object.sha1, DEFAULT_ABBREV));
 346                 strcat(quickref, "...");
 347                 strcat(quickref, find_unique_abbrev(ref->new_sha1, DEFAULT_ABBREV));
 348                 if ((recurse_submodules != RECURSE_SUBMODULES_OFF) &&
 349                     (recurse_submodules != RECURSE_SUBMODULES_ON))
 350                         check_for_new_submodule_commits(ref->new_sha1);
 351                 r = s_update_ref("forced-update", ref, 1);
 352                 strbuf_addf(display, "%c %-*s %-*s -> %s  (%s)",
 353                             r ? '!' : '+',
 354                             TRANSPORT_SUMMARY_WIDTH, quickref,
 355                             REFCOL_WIDTH, remote, pretty_ref,
 356                             r ? _("unable to update local ref") : _("forced update"));
 357                 return r;
 358         } else {
 359                 strbuf_addf(display, "! %-*s %-*s -> %s  %s",
 360                             TRANSPORT_SUMMARY(_("[rejected]")),
 361                             REFCOL_WIDTH, remote, pretty_ref,
 362                             _("(non-fast-forward)"));
 363                 return 1;
 364         }
 365 }
 366
 367 static int iterate_ref_map(void *cb_data, unsigned char sha1[20])
 368 {
 369         struct ref **rm = cb_data;
 370         struct ref *ref = *rm;
 371
 372         if (!ref)
 373                 return -1; /* end of the list */
 374         *rm = ref->next;
 375         hashcpy(sha1, ref->old_sha1);
 376         return 0;
 377 }
 378
 379 static int store_updated_refs(const char *raw_url, const char *remote_name,
 380                 struct ref *ref_map)
 381 {
 382         FILE *fp;
 383         struct commit *commit;
 384         int url_len, i, shown_url = 0, rc = 0;
 385         struct strbuf note = STRBUF_INIT;
 386         const char *what, *kind;
 387         struct ref *rm;
 388         char *url, *filename = dry_run ? "/dev/null" : git_path("FETCH_HEAD");
 389         int want_merge;
 390
 391         fp = fopen(filename, "a");
 392         if (!fp)
 393                 return error(_("cannot open %s: %s\n"), filename, strerror(errno));
 394
 395         if (raw_url)
 396                 url = transport_anonymize_url(raw_url);
 397         else
 398                 url = xstrdup("foreign");
 399
 400         rm = ref_map;
 401         if (check_everything_connected(iterate_ref_map, 0, &rm)) {
 402                 rc = error(_("%s did not send all necessary objects\n"), url);
 403                 goto abort;
 404         }
 405
 406         /*
 407          * The first pass writes objects to be merged and then the
 408          * second pass writes the rest, in order to allow using
 409          * FETCH_HEAD as a refname to refer to the ref to be merged.
 410          */
 411         for (want_merge = 1; 0 <= want_merge; want_merge--) {
 412                 for (rm = ref_map; rm; rm = rm->next) {
 413                         struct ref *ref = NULL;
 414
 415                         commit = lookup_commit_reference_gently(rm->old_sha1, 1);
 416                         if (!commit)
 417                                 rm->merge = 0;
 418
 419                         if (rm->merge != want_merge)
 420                                 continue;
 421
 422                         if (rm->peer_ref) {
 423                                 ref = xcalloc(1, sizeof(*ref) + strlen(rm->peer_ref->name) + 1);
 424                                 strcpy(ref->name, rm->peer_ref->name);
 425                                 hashcpy(ref->old_sha1, rm->peer_ref->old_sha1);
 426                                 hashcpy(ref->new_sha1, rm->old_sha1);
 427                                 ref->force = rm->peer_ref->force;
 428                         }
 429
 430
 431                         if (!strcmp(rm->name, "HEAD")) {
 432                                 kind = "";
 433                                 what = "";
 434                         }
 435                         else if (!prefixcmp(rm->name, "refs/heads/")) {
 436                                 kind = "branch";
 437                                 what = rm->name + 11;
 438                         }
 439                         else if (!prefixcmp(rm->name, "refs/tags/")) {
 440                                 kind = "tag";
 441                                 what = rm->name + 10;
 442                         }
 443                         else if (!prefixcmp(rm->name, "refs/remotes/")) {
 444                                 kind = "remote-tracking branch";
 445                                 what = rm->name + 13;
 446                         }
 447                         else {
 448                                 kind = "";
 449                                 what = rm->name;
 450                         }
 451
 452                         url_len = strlen(url);
 453                         for (i = url_len - 1; url[i] == '/' && 0 <= i; i--)
 454                                 ;
 455                         url_len = i + 1;
 456                         if (4 < i && !strncmp(".git", url + i - 3, 4))
 457                                 url_len = i - 3;
 458
 459                         strbuf_reset(&note);
 460                         if (*what) {
 461                                 if (*kind)
 462                                         strbuf_addf(&note, "%s ", kind);
 463                                 strbuf_addf(&note, "'%s' of ", what);
 464                         }
 465                         fprintf(fp, "%s\t%s\t%s",
 466                                 sha1_to_hex(rm->old_sha1),
 467                                 rm->merge ? "" : "not-for-merge",
 468                                 note.buf);
 469                         for (i = 0; i < url_len; ++i)
 470                                 if ('\n' == url[i])
 471                                         fputs("\\n", fp);
 472                                 else
 473                                         fputc(url[i], fp);
 474                         fputc('\n', fp);
 475
 476                         strbuf_reset(&note);
 477                         if (ref) {
 478                                 rc |= update_local_ref(ref, what, rm, &note);
 479                                 free(ref);
 480                         } else
 481                                 strbuf_addf(&note, "* %-*s %-*s -> FETCH_HEAD",
 482                                             TRANSPORT_SUMMARY_WIDTH,
 483                                             *kind ? kind : "branch",
 484                                             REFCOL_WIDTH,
 485                                             *what ? what : "HEAD");
 486                         if (note.len) {
 487                                 if (verbosity >= 0 && !shown_url) {
 488                                         fprintf(stderr, _("From %.*s\n"),
 489                                                         url_len, url);
 490                                         shown_url = 1;
 491                                 }
 492                                 if (verbosity >= 0)
 493                                         fprintf(stderr, " %s\n", note.buf);
 494                         }
 495                 }
 496         }
 497
 498         if (rc & STORE_REF_ERROR_DF_CONFLICT)
 499                 error(_("some local refs could not be updated; try running\n"
 500                       " 'git remote prune %s' to remove any old, conflicting "
 501                       "branches"), remote_name);
 502
 503  abort:
 504         strbuf_release(&note);
 505         free(url);
 506         fclose(fp);
 507         return rc;
 508 }
 509
 510 /*
 511  * We would want to bypass the object transfer altogether if
 512  * everything we are going to fetch already exists and is connected
 513  * locally.
 514  */
 515 static int quickfetch(struct ref *ref_map)
 516 {
 517         struct ref *rm = ref_map;
 518
 519         /*
 520          * If we are deepening a shallow clone we already have these
 521          * objects reachable.  Running rev-list here will return with
 522          * a good (0) exit status and we'll bypass the fetch that we
 523          * really need to perform.  Claiming failure now will ensure
 524          * we perform the network exchange to deepen our history.
 525          */
 526         if (depth)
 527                 return -1;
 528         return check_everything_connected(iterate_ref_map, 1, &rm);
 529 }
 530
 531 static int fetch_refs(struct transport *transport, struct ref *ref_map)
 532 {
 533         int ret = quickfetch(ref_map);
 534         if (ret)
 535                 ret = transport_fetch_refs(transport, ref_map);
 536         if (!ret)
 537                 ret |= store_updated_refs(transport->url,
 538                                 transport->remote->name,
 539                                 ref_map);
 540         transport_unlock_pack(transport);
 541         return ret;
 542 }
 543
 544 static int prune_refs(struct refspec *refs, int ref_count, struct ref *ref_map)
 545 {
 546         int result = 0;
 547         struct ref *ref, *stale_refs = get_stale_heads(refs, ref_count, ref_map);
 548         const char *dangling_msg = dry_run
 549                 ? _("   (%s will become dangling)")
 550                 : _("   (%s has become dangling)");
 551
 552         for (ref = stale_refs; ref; ref = ref->next) {
 553                 if (!dry_run)
 554                         result |= delete_ref(ref->name, NULL, 0);
 555                 if (verbosity >= 0) {
 556                         fprintf(stderr, " x %-*s %-*s -> %s\n",
 557                                 TRANSPORT_SUMMARY(_("[deleted]")),
 558                                 REFCOL_WIDTH, _("(none)"), prettify_refname(ref->name));
 559                         warn_dangling_symref(stderr, dangling_msg, ref->name);
 560                 }
 561         }
 562         free_refs(stale_refs);
 563         return result;
 564 }
 565
 566 static int add_existing(const char *refname, const unsigned char *sha1,
 567                         int flag, void *cbdata)
 568 {
 569         struct string_list *list = (struct string_list *)cbdata;
 570         struct string_list_item *item = string_list_insert(list, refname);
 571         item->util = (void *)sha1;
 572         return 0;
 573 }
 574
 575 static int will_fetch(struct ref **head, const unsigned char *sha1)
 576 {
 577         struct ref *rm = *head;
 578         while (rm) {
 579                 if (!hashcmp(rm->old_sha1, sha1))
 580                         return 1;
 581                 rm = rm->next;
 582         }
 583         return 0;
 584 }
 585
 586 static void find_non_local_tags(struct transport *transport,
 587                         struct ref **head,
 588                         struct ref ***tail)
 589 {
 590         struct string_list existing_refs = STRING_LIST_INIT_NODUP;
 591         struct string_list remote_refs = STRING_LIST_INIT_NODUP;
 592         const struct ref *ref;
 593         struct string_list_item *item = NULL;
 594
 595         for_each_ref(add_existing, &existing_refs);
 596         for (ref = transport_get_remote_refs(transport); ref; ref = ref->next) {
 597                 if (prefixcmp(ref->name, "refs/tags/"))
 598                         continue;
 599
 600                 /*
 601                  * The peeled ref always follows the matching base
 602                  * ref, so if we see a peeled ref that we don't want
 603                  * to fetch then we can mark the ref entry in the list
 604                  * as one to ignore by setting util to NULL.
 605                  */
 606                 if (!suffixcmp(ref->name, "^{}")) {
 607                         if (item && !has_sha1_file(ref->old_sha1) &&
 608                             !will_fetch(head, ref->old_sha1) &&
 609                             !has_sha1_file(item->util) &&
 610                             !will_fetch(head, item->util))
 611                                 item->util = NULL;
 612                         item = NULL;
 613                         continue;
 614                 }
 615
 616                 /*
 617                  * If item is non-NULL here, then we previously saw a
 618                  * ref not followed by a peeled reference, so we need
 619                  * to check if it is a lightweight tag that we want to
 620                  * fetch.
 621                  */
 622                 if (item && !has_sha1_file(item->util) &&
 623                     !will_fetch(head, item->util))
 624                         item->util = NULL;
 625
 626                 item = NULL;
 627
 628                 /* skip duplicates and refs that we already have */
 629                 if (string_list_has_string(&remote_refs, ref->name) ||
 630                     string_list_has_string(&existing_refs, ref->name))
 631                         continue;
 632
 633                 item = string_list_insert(&remote_refs, ref->name);
 634                 item->util = (void *)ref->old_sha1;
 635         }
 636         string_list_clear(&existing_refs, 0);
 637
 638         /*
 639          * We may have a final lightweight tag that needs to be
 640          * checked to see if it needs fetching.
 641          */
 642         if (item && !has_sha1_file(item->util) &&
 643             !will_fetch(head, item->util))
 644                 item->util = NULL;
 645
 646         /*
 647          * For all the tags in the remote_refs string list,
 648          * add them to the list of refs to be fetched
 649          */
 650         for_each_string_list_item(item, &remote_refs) {
 651                 /* Unless we have already decided to ignore this item... */
 652                 if (item->util)
 653                 {
 654                         struct ref *rm = alloc_ref(item->string);
 655                         rm->peer_ref = alloc_ref(item->string);
 656                         hashcpy(rm->old_sha1, item->util);
 657                         **tail = rm;
 658                         *tail = &rm->next;
 659                 }
 660         }
 661
 662         string_list_clear(&remote_refs, 0);
 663 }
 664
 665 static void check_not_current_branch(struct ref *ref_map)
 666 {
 667         struct branch *current_branch = branch_get(NULL);
 668
 669         if (is_bare_repository() || !current_branch)
 670                 return;
 671
 672         for (; ref_map; ref_map = ref_map->next)
 673                 if (ref_map->peer_ref && !strcmp(current_branch->refname,
 674                                         ref_map->peer_ref->name))
 675                         die(_("Refusing to fetch into current branch %s "
 676                             "of non-bare repository"), current_branch->refname);
 677 }
 678
 679 static int truncate_fetch_head(void)
 680 {
 681         char *filename = git_path("FETCH_HEAD");
 682         FILE *fp = fopen(filename, "w");
 683
 684         if (!fp)
 685                 return error(_("cannot open %s: %s\n"), filename, strerror(errno));
 686         fclose(fp);
 687         return 0;
 688 }
 689
 690 static int do_fetch(struct transport *transport,
 691                     struct refspec *refs, int ref_count)
 692 {
 693         struct string_list existing_refs = STRING_LIST_INIT_NODUP;
 694         struct string_list_item *peer_item = NULL;
 695         struct ref *ref_map;
 696         struct ref *rm;
 697         int autotags = (transport->remote->fetch_tags == 1);
 698
 699         for_each_ref(add_existing, &existing_refs);
 700
 701         if (tags == TAGS_DEFAULT) {
 702                 if (transport->remote->fetch_tags == 2)
 703                         tags = TAGS_SET;
 704                 if (transport->remote->fetch_tags == -1)
 705                         tags = TAGS_UNSET;
 706         }
 707
 708         if (!transport->get_refs_list || !transport->fetch)
 709                 die(_("Don't know how to fetch from %s"), transport->url);
 710
 711         /* if not appending, truncate FETCH_HEAD */
 712         if (!append && !dry_run) {
 713                 int errcode = truncate_fetch_head();
 714                 if (errcode)
 715                         return errcode;
 716         }
 717
 718         ref_map = get_ref_map(transport, refs, ref_count, tags, &autotags);
 719         if (!update_head_ok)
 720                 check_not_current_branch(ref_map);
 721
 722         for (rm = ref_map; rm; rm = rm->next) {
 723                 if (rm->peer_ref) {
 724                         peer_item = string_list_lookup(&existing_refs,
 725                                                        rm->peer_ref->name);
 726                         if (peer_item)
 727                                 hashcpy(rm->peer_ref->old_sha1,
 728                                         peer_item->util);
 729                 }
 730         }
 731
 732         if (tags == TAGS_DEFAULT && autotags)
 733                 transport_set_option(transport, TRANS_OPT_FOLLOWTAGS, "1");
 734         if (fetch_refs(transport, ref_map)) {
 735                 free_refs(ref_map);
 736                 return 1;
 737         }
 738         if (prune) {
 739                 /* If --tags was specified, pretend the user gave us the canonical tags refspec */
 740                 if (tags == TAGS_SET) {
 741                         const char *tags_str = "refs/tags/*:refs/tags/*";
 742                         struct refspec *tags_refspec, *refspec;
 743
 744                         /* Copy the refspec and add the tags to it */
 745                         refspec = xcalloc(ref_count + 1, sizeof(struct refspec));
 746                         tags_refspec = parse_fetch_refspec(1, &tags_str);
 747                         memcpy(refspec, refs, ref_count * sizeof(struct refspec));
 748                         memcpy(&refspec[ref_count], tags_refspec, sizeof(struct refspec));
 749                         ref_count++;
 750
 751                         prune_refs(refspec, ref_count, ref_map);
 752
 753                         ref_count--;
 754                         /* The rest of the strings belong to fetch_one */
 755                         free_refspec(1, tags_refspec);
 756                         free(refspec);
 757                 } else if (ref_count) {
 758                         prune_refs(refs, ref_count, ref_map);
 759                 } else {
 760                         prune_refs(transport->remote->fetch, transport->remote->fetch_refspec_nr, ref_map);
 761                 }
 762         }
 763         free_refs(ref_map);
 764
 765         /* if neither --no-tags nor --tags was specified, do automated tag
 766          * following ... */
 767         if (tags == TAGS_DEFAULT && autotags) {
 768                 struct ref **tail = &ref_map;
 769                 ref_map = NULL;
 770                 find_non_local_tags(transport, &ref_map, &tail);
 771                 if (ref_map) {
 772                         transport_set_option(transport, TRANS_OPT_FOLLOWTAGS, NULL);
 773                         transport_set_option(transport, TRANS_OPT_DEPTH, "0");
 774                         fetch_refs(transport, ref_map);
 775                 }
 776                 free_refs(ref_map);
 777         }
 778
 779         return 0;
 780 }
 781
 782 static void set_option(const char *name, const char *value)
 783 {
 784         int r = transport_set_option(transport, name, value);
 785         if (r < 0)
 786                 die(_("Option \"%s\" value \"%s\" is not valid for %s"),
 787                         name, value, transport->url);
 788         if (r > 0)
 789                 warning(_("Option \"%s\" is ignored for %s\n"),
 790                         name, transport->url);
 791 }
 792
 793 static int get_one_remote_for_fetch(struct remote *remote, void *priv)
 794 {
 795         struct string_list *list = priv;
 796         if (!remote->skip_default_update)
 797                 string_list_append(list, remote->name);
 798         return 0;
 799 }
 800
 801 struct remote_group_data {
 802         const char *name;
 803         struct string_list *list;
 804 };
 805
 806 static int get_remote_group(const char *key, const char *value, void *priv)
 807 {
 808         struct remote_group_data *g = priv;
 809
 810         if (!prefixcmp(key, "remotes.") &&
 811                         !strcmp(key + 8, g->name)) {
 812                 /* split list by white space */
 813                 int space = strcspn(value, " \t\n");
 814                 while (*value) {
 815                         if (space > 1) {
 816                                 string_list_append(g->list,
 817                                                    xstrndup(value, space));
 818                         }
 819                         value += space + (value[space] != '\0');
 820                         space = strcspn(value, " \t\n");
 821                 }
 822         }
 823
 824         return 0;
 825 }
 826
 827 static int add_remote_or_group(const char *name, struct string_list *list)
 828 {
 829         int prev_nr = list->nr;
 830         struct remote_group_data g;
 831         g.name = name; g.list = list;
 832
 833         git_config(get_remote_group, &g);
 834         if (list->nr == prev_nr) {
 835                 struct remote *remote;
 836                 if (!remote_is_configured(name))
 837                         return 0;
 838                 remote = remote_get(name);
 839                 string_list_append(list, remote->name);
 840         }
 841         return 1;
 842 }
 843
 844 static void add_options_to_argv(struct argv_array *argv)
 845 {
 846         if (dry_run)
 847                 argv_array_push(argv, "--dry-run");
 848         if (prune)
 849                 argv_array_push(argv, "--prune");
 850         if (update_head_ok)
 851                 argv_array_push(argv, "--update-head-ok");
 852         if (force)
 853                 argv_array_push(argv, "--force");
 854         if (keep)
 855                 argv_array_push(argv, "--keep");
 856         if (recurse_submodules == RECURSE_SUBMODULES_ON)
 857                 argv_array_push(argv, "--recurse-submodules");
 858         else if (recurse_submodules == RECURSE_SUBMODULES_ON_DEMAND)
 859                 argv_array_push(argv, "--recurse-submodules=on-demand");
 860         if (tags == TAGS_SET)
 861                 argv_array_push(argv, "--tags");
 862         else if (tags == TAGS_UNSET)
 863                 argv_array_push(argv, "--no-tags");
 864         if (verbosity >= 2)
 865                 argv_array_push(argv, "-v");
 866         if (verbosity >= 1)
 867                 argv_array_push(argv, "-v");
 868         else if (verbosity < 0)
 869                 argv_array_push(argv, "-q");
 870
 871 }
 872
 873 static int fetch_multiple(struct string_list *list)
 874 {
 875         int i, result = 0;
 876         struct argv_array argv = ARGV_ARRAY_INIT;
 877
 878         if (!append && !dry_run) {
 879                 int errcode = truncate_fetch_head();
 880                 if (errcode)
 881                         return errcode;
 882         }
 883
 884         argv_array_pushl(&argv, "fetch", "--append", NULL);
 885         add_options_to_argv(&argv);
 886
 887         for (i = 0; i < list->nr; i++) {
 888                 const char *name = list->items[i].string;
 889                 argv_array_push(&argv, name);
 890                 if (verbosity >= 0)
 891                         printf(_("Fetching %s\n"), name);
 892                 if (run_command_v_opt(argv.argv, RUN_GIT_CMD)) {
 893                         error(_("Could not fetch %s"), name);
 894                         result = 1;
 895                 }
 896                 argv_array_pop(&argv);
 897         }
 898
 899         argv_array_clear(&argv);
 900         return result;
 901 }
 902
 903 static int fetch_one(struct remote *remote, int argc, const char **argv)
 904 {
 905         int i;
 906         static const char **refs = NULL;
 907         struct refspec *refspec;
 908         int ref_nr = 0;
 909         int exit_code;
 910
 911         if (!remote)
 912                 die(_("No remote repository specified.  Please, specify either a URL or a\n"
 913                     "remote name from which new revisions should be fetched."));
 914
 915         transport = transport_get(remote, NULL);
 916         transport_set_verbosity(transport, verbosity, progress);
 917         if (upload_pack)
 918                 set_option(TRANS_OPT_UPLOADPACK, upload_pack);
 919         if (keep)
 920                 set_option(TRANS_OPT_KEEP, "yes");
 921         if (depth)
 922                 set_option(TRANS_OPT_DEPTH, depth);
 923
 924         if (argc > 0) {
 925                 int j = 0;
 926                 refs = xcalloc(argc + 1, sizeof(const char *));
 927                 for (i = 0; i < argc; i++) {
 928                         if (!strcmp(argv[i], "tag")) {
 929                                 char *ref;
 930                                 i++;
 931                                 if (i >= argc)
 932                                         die(_("You need to specify a tag name."));
 933                                 ref = xmalloc(strlen(argv[i]) * 2 + 22);
 934                                 strcpy(ref, "refs/tags/");
 935                                 strcat(ref, argv[i]);
 936                                 strcat(ref, ":refs/tags/");
 937                                 strcat(ref, argv[i]);
 938                                 refs[j++] = ref;
 939                         } else
 940                                 refs[j++] = argv[i];
 941                 }
 942                 refs[j] = NULL;
 943                 ref_nr = j;
 944         }
 945
 946         sigchain_push_common(unlock_pack_on_signal);
 947         atexit(unlock_pack);
 948         refspec = parse_fetch_refspec(ref_nr, refs);
 949         exit_code = do_fetch(transport, refspec, ref_nr);
 950         free_refspec(ref_nr, refspec);
 951         transport_disconnect(transport);
 952         transport = NULL;
 953         return exit_code;
 954 }
 955
 956 int cmd_fetch(int argc, const char **argv, const char *prefix)
 957 {
 958         int i;
 959         struct string_list list = STRING_LIST_INIT_NODUP;
 960         struct remote *remote;
 961         int result = 0;
 962
 963         packet_trace_identity("fetch");
 964
 965         /* Record the command line for the reflog */
 966         strbuf_addstr(&default_rla, "fetch");
 967         for (i = 1; i < argc; i++)
 968                 strbuf_addf(&default_rla, " %s", argv[i]);
 969
 970         argc = parse_options(argc, argv, prefix,
 971                              builtin_fetch_options, builtin_fetch_usage, 0);
 972
 973         if (recurse_submodules != RECURSE_SUBMODULES_OFF) {
 974                 if (recurse_submodules_default) {
 975                         int arg = parse_fetch_recurse_submodules_arg("--recurse-submodules-default", recurse_submodules_default);
 976                         set_config_fetch_recurse_submodules(arg);
 977                 }
 978                 gitmodules_config();
 979                 git_config(submodule_config, NULL);
 980         }
 981
 982         if (all) {
 983                 if (argc == 1)
 984                         die(_("fetch --all does not take a repository argument"));
 985                 else if (argc > 1)
 986                         die(_("fetch --all does not make sense with refspecs"));
 987                 (void) for_each_remote(get_one_remote_for_fetch, &list);
 988                 result = fetch_multiple(&list);
 989         } else if (argc == 0) {
 990                 /* No arguments -- use default remote */
 991                 remote = remote_get(NULL);
 992                 result = fetch_one(remote, argc, argv);
 993         } else if (multiple) {
 994                 /* All arguments are assumed to be remotes or groups */
 995                 for (i = 0; i < argc; i++)
 996                         if (!add_remote_or_group(argv[i], &list))
 997                                 die(_("No such remote or remote group: %s"), argv[i]);
 998                 result = fetch_multiple(&list);
 999         } else {
1000                 /* Single remote or group */
1001                 (void) add_remote_or_group(argv[0], &list);
1002                 if (list.nr > 1) {
1003                         /* More than one remote */
1004                         if (argc > 1)
1005                                 die(_("Fetching a group and specifying refspecs does not make sense"));
1006                         result = fetch_multiple(&list);
1007                 } else {
1008                         /* Zero or one remotes */
1009                         remote = remote_get(argv[0]);
1010                         result = fetch_one(remote, argc-1, argv+1);
1011                 }
1012         }
1013
1014         if (!result && (recurse_submodules != RECURSE_SUBMODULES_OFF)) {
1015                 struct argv_array options = ARGV_ARRAY_INIT;
1016
1017                 add_options_to_argv(&options);
1018                 result = fetch_populated_submodules(&options,
1019                                                     submodule_prefix,
1020                                                     recurse_submodules,
1021                                                     verbosity < 0);
1022                 argv_array_clear(&options);
1023         }
1024
1025         /* All names were strdup()ed or strndup()ed */
1026         list.strdup_strings = 1;
1027         string_list_clear(&list, 0);
1028
1029         return result;
1030 }