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"
14static const char * const builtin_fetch_usage[] = {
16 "git fetch [options] [<repository> <refspec>...]",
17 NULL
18};
19enum {
21 TAGS_UNSET = 0,
22 TAGS_DEFAULT = 1,
23 TAGS_SET = 2
24};
25static int append, force, keep, update_head_ok, verbosity;
27static int tags = TAGS_DEFAULT;
28static const char *depth;
29static const char *upload_pack;
30static struct strbuf default_rla = STRBUF_INIT;
31static struct transport *transport;
32static struct option builtin_fetch_options[] = {
34 OPT__VERBOSITY(&verbosity),
35 OPT_BOOLEAN('a', "append", &append,
36 "append to .git/FETCH_HEAD instead of overwriting"),
37 OPT_STRING(0, "upload-pack", &upload_pack, "PATH",
38 "path to upload pack on remote end"),
39 OPT_BOOLEAN('f', "force", &force,
40 "force overwrite of local branch"),
41 OPT_SET_INT('t', "tags", &tags,
42 "fetch all tags and associated objects", TAGS_SET),
43 OPT_SET_INT('n', NULL, &tags,
44 "do not fetch all tags (--no-tags)", TAGS_UNSET),
45 OPT_BOOLEAN('k', "keep", &keep, "keep downloaded pack"),
46 OPT_BOOLEAN('u', "update-head-ok", &update_head_ok,
47 "allow updating of HEAD ref"),
48 OPT_STRING(0, "depth", &depth, "DEPTH",
49 "deepen history of shallow clone"),
50 OPT_END()
51};
52static void unlock_pack(void)
54{
55 if (transport)
56 transport_unlock_pack(transport);
57}
58static void unlock_pack_on_signal(int signo)
60{
61 unlock_pack();
62 sigchain_pop(signo);
63 raise(signo);
64}
65static void add_merge_config(struct ref **head,
67 const struct ref *remote_refs,
68 struct branch *branch,
69 struct ref ***tail)
70{
71 int i;
72 for (i = 0; i < branch->merge_nr; i++) {
74 struct ref *rm, **old_tail = *tail;
75 struct refspec refspec;
76 for (rm = *head; rm; rm = rm->next) {
78 if (branch_merge_matches(branch, i, rm->name)) {
79 rm->merge = 1;
80 break;
81 }
82 }
83 if (rm)
84 continue;
85 /*
87 * Not fetched to a tracking branch? We need to fetch
88 * it anyway to allow this branch's "branch.$name.merge"
89 * to be honored by 'git pull', but we do not have to
90 * fail if branch.$name.merge is misconfigured to point
91 * at a nonexisting branch. If we were indeed called by
92 * 'git pull', it will notice the misconfiguration because
93 * there is no entry in the resulting FETCH_HEAD marked
94 * for merging.
95 */
96 refspec.src = branch->merge[i]->src;
97 refspec.dst = NULL;
98 refspec.pattern = 0;
99 refspec.force = 0;
100 get_fetch_map(remote_refs, &refspec, tail, 1);
101 for (rm = *old_tail; rm; rm = rm->next)
102 rm->merge = 1;
103 }
104}
105static void find_non_local_tags(struct transport *transport,
107 struct ref **head,
108 struct ref ***tail);
109static struct ref *get_ref_map(struct transport *transport,
111 struct refspec *refs, int ref_count, int tags,
112 int *autotags)
113{
114 int i;
115 struct ref *rm;
116 struct ref *ref_map = NULL;
117 struct ref **tail = &ref_map;
118 const struct ref *remote_refs = transport_get_remote_refs(transport);
120 if (ref_count || tags == TAGS_SET) {
122 for (i = 0; i < ref_count; i++) {
123 get_fetch_map(remote_refs, &refs[i], &tail, 0);
124 if (refs[i].dst && refs[i].dst[0])
125 *autotags = 1;
126 }
127 /* Merge everything on the command line, but not --tags */
128 for (rm = ref_map; rm; rm = rm->next)
129 rm->merge = 1;
130 if (tags == TAGS_SET)
131 get_fetch_map(remote_refs, tag_refspec, &tail, 0);
132 } else {
133 /* Use the defaults */
134 struct remote *remote = transport->remote;
135 struct branch *branch = branch_get(NULL);
136 int has_merge = branch_has_merge_config(branch);
137 if (remote && (remote->fetch_refspec_nr || has_merge)) {
138 for (i = 0; i < remote->fetch_refspec_nr; i++) {
139 get_fetch_map(remote_refs, &remote->fetch[i], &tail, 0);
140 if (remote->fetch[i].dst &&
141 remote->fetch[i].dst[0])
142 *autotags = 1;
143 if (!i && !has_merge && ref_map &&
144 !remote->fetch[0].pattern)
145 ref_map->merge = 1;
146 }
147 /*
148 * if the remote we're fetching from is the same
149 * as given in branch.<name>.remote, we add the
150 * ref given in branch.<name>.merge, too.
151 */
152 if (has_merge &&
153 !strcmp(branch->remote_name, remote->name))
154 add_merge_config(&ref_map, remote_refs, branch, &tail);
155 } else {
156 ref_map = get_remote_ref(remote_refs, "HEAD");
157 if (!ref_map)
158 die("Couldn't find remote ref HEAD");
159 ref_map->merge = 1;
160 tail = &ref_map->next;
161 }
162 }
163 if (tags == TAGS_DEFAULT && *autotags)
164 find_non_local_tags(transport, &ref_map, &tail);
165 ref_remove_duplicates(ref_map);
166 return ref_map;
168}
169static int s_update_ref(const char *action,
171 struct ref *ref,
172 int check_old)
173{
174 char msg[1024];
175 char *rla = getenv("GIT_REFLOG_ACTION");
176 static struct ref_lock *lock;
177 if (!rla)
179 rla = default_rla.buf;
180 snprintf(msg, sizeof(msg), "%s: %s", rla, action);
181 lock = lock_any_ref_for_update(ref->name,
182 check_old ? ref->old_sha1 : NULL, 0);
183 if (!lock)
184 return 2;
185 if (write_ref_sha1(lock, ref->new_sha1, msg) < 0)
186 return 2;
187 return 0;
188}
189#define SUMMARY_WIDTH (2 * DEFAULT_ABBREV + 3)
191#define REFCOL_WIDTH 10
192static int update_local_ref(struct ref *ref,
194 const char *remote,
195 char *display)
196{
197 struct commit *current = NULL, *updated;
198 enum object_type type;
199 struct branch *current_branch = branch_get(NULL);
200 const char *pretty_ref = prettify_refname(ref->name);
201 *display = 0;
203 type = sha1_object_info(ref->new_sha1, NULL);
204 if (type < 0)
205 die("object %s not found", sha1_to_hex(ref->new_sha1));
206 if (!hashcmp(ref->old_sha1, ref->new_sha1)) {
208 if (verbosity > 0)
209 sprintf(display, "= %-*s %-*s -> %s", SUMMARY_WIDTH,
210 "[up to date]", REFCOL_WIDTH, remote,
211 pretty_ref);
212 return 0;
213 }
214 if (current_branch &&
216 !strcmp(ref->name, current_branch->name) &&
217 !(update_head_ok || is_bare_repository()) &&
218 !is_null_sha1(ref->old_sha1)) {
219 /*
220 * If this is the head, and it's not okay to update
221 * the head, and the old value of the head isn't empty...
222 */
223 sprintf(display, "! %-*s %-*s -> %s (can't fetch in current branch)",
224 SUMMARY_WIDTH, "[rejected]", REFCOL_WIDTH, remote,
225 pretty_ref);
226 return 1;
227 }
228 if (!is_null_sha1(ref->old_sha1) &&
230 !prefixcmp(ref->name, "refs/tags/")) {
231 int r;
232 r = s_update_ref("updating tag", ref, 0);
233 sprintf(display, "%c %-*s %-*s -> %s%s", r ? '!' : '-',
234 SUMMARY_WIDTH, "[tag update]", REFCOL_WIDTH, remote,
235 pretty_ref, r ? " (unable to update local ref)" : "");
236 return r;
237 }
238 current = lookup_commit_reference_gently(ref->old_sha1, 1);
240 updated = lookup_commit_reference_gently(ref->new_sha1, 1);
241 if (!current || !updated) {
242 const char *msg;
243 const char *what;
244 int r;
245 if (!strncmp(ref->name, "refs/tags/", 10)) {
246 msg = "storing tag";
247 what = "[new tag]";
248 }
249 else {
250 msg = "storing head";
251 what = "[new branch]";
252 }
253 r = s_update_ref(msg, ref, 0);
255 sprintf(display, "%c %-*s %-*s -> %s%s", r ? '!' : '*',
256 SUMMARY_WIDTH, what, REFCOL_WIDTH, remote, pretty_ref,
257 r ? " (unable to update local ref)" : "");
258 return r;
259 }
260 if (in_merge_bases(current, &updated, 1)) {
262 char quickref[83];
263 int r;
264 strcpy(quickref, find_unique_abbrev(current->object.sha1, DEFAULT_ABBREV));
265 strcat(quickref, "..");
266 strcat(quickref, find_unique_abbrev(ref->new_sha1, DEFAULT_ABBREV));
267 r = s_update_ref("fast forward", ref, 1);
268 sprintf(display, "%c %-*s %-*s -> %s%s", r ? '!' : ' ',
269 SUMMARY_WIDTH, quickref, REFCOL_WIDTH, remote,
270 pretty_ref, r ? " (unable to update local ref)" : "");
271 return r;
272 } else if (force || ref->force) {
273 char quickref[84];
274 int r;
275 strcpy(quickref, find_unique_abbrev(current->object.sha1, DEFAULT_ABBREV));
276 strcat(quickref, "...");
277 strcat(quickref, find_unique_abbrev(ref->new_sha1, DEFAULT_ABBREV));
278 r = s_update_ref("forced-update", ref, 1);
279 sprintf(display, "%c %-*s %-*s -> %s (%s)", r ? '!' : '+',
280 SUMMARY_WIDTH, quickref, REFCOL_WIDTH, remote,
281 pretty_ref,
282 r ? "unable to update local ref" : "forced update");
283 return r;
284 } else {
285 sprintf(display, "! %-*s %-*s -> %s (non fast forward)",
286 SUMMARY_WIDTH, "[rejected]", REFCOL_WIDTH, remote,
287 pretty_ref);
288 return 1;
289 }
290}
291static int store_updated_refs(const char *raw_url, const char *remote_name,
293 struct ref *ref_map)
294{
295 FILE *fp;
296 struct commit *commit;
297 int url_len, i, note_len, shown_url = 0, rc = 0;
298 char note[1024];
299 const char *what, *kind;
300 struct ref *rm;
301 char *url, *filename = git_path("FETCH_HEAD");
302 fp = fopen(filename, "a");
304 if (!fp)
305 return error("cannot open %s: %s\n", filename, strerror(errno));
306 url = transport_anonymize_url(raw_url);
308 for (rm = ref_map; rm; rm = rm->next) {
309 struct ref *ref = NULL;
310 if (rm->peer_ref) {
312 ref = xcalloc(1, sizeof(*ref) + strlen(rm->peer_ref->name) + 1);
313 strcpy(ref->name, rm->peer_ref->name);
314 hashcpy(ref->old_sha1, rm->peer_ref->old_sha1);
315 hashcpy(ref->new_sha1, rm->old_sha1);
316 ref->force = rm->peer_ref->force;
317 }
318 commit = lookup_commit_reference_gently(rm->old_sha1, 1);
320 if (!commit)
321 rm->merge = 0;
322 if (!strcmp(rm->name, "HEAD")) {
324 kind = "";
325 what = "";
326 }
327 else if (!prefixcmp(rm->name, "refs/heads/")) {
328 kind = "branch";
329 what = rm->name + 11;
330 }
331 else if (!prefixcmp(rm->name, "refs/tags/")) {
332 kind = "tag";
333 what = rm->name + 10;
334 }
335 else if (!prefixcmp(rm->name, "refs/remotes/")) {
336 kind = "remote branch";
337 what = rm->name + 13;
338 }
339 else {
340 kind = "";
341 what = rm->name;
342 }
343 url_len = strlen(url);
345 for (i = url_len - 1; url[i] == '/' && 0 <= i; i--)
346 ;
347 url_len = i + 1;
348 if (4 < i && !strncmp(".git", url + i - 3, 4))
349 url_len = i - 3;
350 note_len = 0;
352 if (*what) {
353 if (*kind)
354 note_len += sprintf(note + note_len, "%s ",
355 kind);
356 note_len += sprintf(note + note_len, "'%s' of ", what);
357 }
358 note[note_len] = '\0';
359 fprintf(fp, "%s\t%s\t%s",
360 sha1_to_hex(commit ? commit->object.sha1 :
361 rm->old_sha1),
362 rm->merge ? "" : "not-for-merge",
363 note);
364 for (i = 0; i < url_len; ++i)
365 if ('\n' == url[i])
366 fputs("\\n", fp);
367 else
368 fputc(url[i], fp);
369 fputc('\n', fp);
370 if (ref)
372 rc |= update_local_ref(ref, what, note);
373 else
374 sprintf(note, "* %-*s %-*s -> FETCH_HEAD",
375 SUMMARY_WIDTH, *kind ? kind : "branch",
376 REFCOL_WIDTH, *what ? what : "HEAD");
377 if (*note) {
378 if (verbosity >= 0 && !shown_url) {
379 fprintf(stderr, "From %.*s\n",
380 url_len, url);
381 shown_url = 1;
382 }
383 if (verbosity >= 0)
384 fprintf(stderr, " %s\n", note);
385 }
386 }
387 free(url);
388 fclose(fp);
389 if (rc & 2)
390 error("some local refs could not be updated; try running\n"
391 " 'git remote prune %s' to remove any old, conflicting "
392 "branches", remote_name);
393 return rc;
394}
395/*
397 * We would want to bypass the object transfer altogether if
398 * everything we are going to fetch already exists and connected
399 * locally.
400 *
401 * The refs we are going to fetch are in to_fetch (nr_heads in
402 * total). If running
403 *
404 * $ git rev-list --objects to_fetch[0] to_fetch[1] ... --not --all
405 *
406 * does not error out, that means everything reachable from the
407 * refs we are going to fetch exists and is connected to some of
408 * our existing refs.
409 */
410static int quickfetch(struct ref *ref_map)
411{
412 struct child_process revlist;
413 struct ref *ref;
414 char **argv;
415 int i, err;
416 /*
418 * If we are deepening a shallow clone we already have these
419 * objects reachable. Running rev-list here will return with
420 * a good (0) exit status and we'll bypass the fetch that we
421 * really need to perform. Claiming failure now will ensure
422 * we perform the network exchange to deepen our history.
423 */
424 if (depth)
425 return -1;
426 for (i = 0, ref = ref_map; ref; ref = ref->next)
428 i++;
429 if (!i)
430 return 0;
431 argv = xmalloc(sizeof(*argv) * (i + 6));
433 i = 0;
434 argv[i++] = xstrdup("rev-list");
435 argv[i++] = xstrdup("--quiet");
436 argv[i++] = xstrdup("--objects");
437 for (ref = ref_map; ref; ref = ref->next)
438 argv[i++] = xstrdup(sha1_to_hex(ref->old_sha1));
439 argv[i++] = xstrdup("--not");
440 argv[i++] = xstrdup("--all");
441 argv[i++] = NULL;
442 memset(&revlist, 0, sizeof(revlist));
444 revlist.argv = (const char**)argv;
445 revlist.git_cmd = 1;
446 revlist.no_stdin = 1;
447 revlist.no_stdout = 1;
448 revlist.no_stderr = 1;
449 err = run_command(&revlist);
450 for (i = 0; argv[i]; i++)
452 free(argv[i]);
453 free(argv);
454 return err;
455}
456static int fetch_refs(struct transport *transport, struct ref *ref_map)
458{
459 int ret = quickfetch(ref_map);
460 if (ret)
461 ret = transport_fetch_refs(transport, ref_map);
462 if (!ret)
463 ret |= store_updated_refs(transport->url,
464 transport->remote->name,
465 ref_map);
466 transport_unlock_pack(transport);
467 return ret;
468}
469static int add_existing(const char *refname, const unsigned char *sha1,
471 int flag, void *cbdata)
472{
473 struct string_list *list = (struct string_list *)cbdata;
474 string_list_insert(refname, list);
475 return 0;
476}
477static int will_fetch(struct ref **head, const unsigned char *sha1)
479{
480 struct ref *rm = *head;
481 while (rm) {
482 if (!hashcmp(rm->old_sha1, sha1))
483 return 1;
484 rm = rm->next;
485 }
486 return 0;
487}
488static void find_non_local_tags(struct transport *transport,
490 struct ref **head,
491 struct ref ***tail)
492{
493 struct string_list existing_refs = { NULL, 0, 0, 0 };
494 struct string_list new_refs = { NULL, 0, 0, 1 };
495 char *ref_name;
496 int ref_name_len;
497 const unsigned char *ref_sha1;
498 const struct ref *tag_ref;
499 struct ref *rm = NULL;
500 const struct ref *ref;
501 for_each_ref(add_existing, &existing_refs);
503 for (ref = transport_get_remote_refs(transport); ref; ref = ref->next) {
504 if (prefixcmp(ref->name, "refs/tags"))
505 continue;
506 ref_name = xstrdup(ref->name);
508 ref_name_len = strlen(ref_name);
509 ref_sha1 = ref->old_sha1;
510 if (!strcmp(ref_name + ref_name_len - 3, "^{}")) {
512 ref_name[ref_name_len - 3] = 0;
513 tag_ref = transport_get_remote_refs(transport);
514 while (tag_ref) {
515 if (!strcmp(tag_ref->name, ref_name)) {
516 ref_sha1 = tag_ref->old_sha1;
517 break;
518 }
519 tag_ref = tag_ref->next;
520 }
521 }
522 if (!string_list_has_string(&existing_refs, ref_name) &&
524 !string_list_has_string(&new_refs, ref_name) &&
525 (has_sha1_file(ref->old_sha1) ||
526 will_fetch(head, ref->old_sha1))) {
527 string_list_insert(ref_name, &new_refs);
528 rm = alloc_ref(ref_name);
530 rm->peer_ref = alloc_ref(ref_name);
531 hashcpy(rm->old_sha1, ref_sha1);
532 **tail = rm;
534 *tail = &rm->next;
535 }
536 free(ref_name);
537 }
538 string_list_clear(&existing_refs, 0);
539 string_list_clear(&new_refs, 0);
540}
541static void check_not_current_branch(struct ref *ref_map)
543{
544 struct branch *current_branch = branch_get(NULL);
545 if (is_bare_repository() || !current_branch)
547 return;
548 for (; ref_map; ref_map = ref_map->next)
550 if (ref_map->peer_ref && !strcmp(current_branch->refname,
551 ref_map->peer_ref->name))
552 die("Refusing to fetch into current branch %s "
553 "of non-bare repository", current_branch->refname);
554}
555static int do_fetch(struct transport *transport,
557 struct refspec *refs, int ref_count)
558{
559 struct ref *ref_map;
560 struct ref *rm;
561 int autotags = (transport->remote->fetch_tags == 1);
562 if (transport->remote->fetch_tags == 2 && tags != TAGS_UNSET)
563 tags = TAGS_SET;
564 if (transport->remote->fetch_tags == -1)
565 tags = TAGS_UNSET;
566 if (!transport->get_refs_list || !transport->fetch)
568 die("Don't know how to fetch from %s", transport->url);
569 /* if not appending, truncate FETCH_HEAD */
571 if (!append) {
572 char *filename = git_path("FETCH_HEAD");
573 FILE *fp = fopen(filename, "w");
574 if (!fp)
575 return error("cannot open %s: %s\n", filename, strerror(errno));
576 fclose(fp);
577 }
578 ref_map = get_ref_map(transport, refs, ref_count, tags, &autotags);
580 if (!update_head_ok)
581 check_not_current_branch(ref_map);
582 for (rm = ref_map; rm; rm = rm->next) {
584 if (rm->peer_ref)
585 read_ref(rm->peer_ref->name, rm->peer_ref->old_sha1);
586 }
587 if (tags == TAGS_DEFAULT && autotags)
589 transport_set_option(transport, TRANS_OPT_FOLLOWTAGS, "1");
590 if (fetch_refs(transport, ref_map)) {
591 free_refs(ref_map);
592 return 1;
593 }
594 free_refs(ref_map);
595 /* if neither --no-tags nor --tags was specified, do automated tag
597 * following ... */
598 if (tags == TAGS_DEFAULT && autotags) {
599 struct ref **tail = &ref_map;
600 ref_map = NULL;
601 find_non_local_tags(transport, &ref_map, &tail);
602 if (ref_map) {
603 transport_set_option(transport, TRANS_OPT_FOLLOWTAGS, NULL);
604 transport_set_option(transport, TRANS_OPT_DEPTH, "0");
605 fetch_refs(transport, ref_map);
606 }
607 free_refs(ref_map);
608 }
609 return 0;
611}
612static void set_option(const char *name, const char *value)
614{
615 int r = transport_set_option(transport, name, value);
616 if (r < 0)
617 die("Option \"%s\" value \"%s\" is not valid for %s",
618 name, value, transport->url);
619 if (r > 0)
620 warning("Option \"%s\" is ignored for %s\n",
621 name, transport->url);
622}
623int cmd_fetch(int argc, const char **argv, const char *prefix)
625{
626 struct remote *remote;
627 int i;
628 static const char **refs = NULL;
629 int ref_nr = 0;
630 int exit_code;
631 /* Record the command line for the reflog */
633 strbuf_addstr(&default_rla, "fetch");
634 for (i = 1; i < argc; i++)
635 strbuf_addf(&default_rla, " %s", argv[i]);
636 argc = parse_options(argc, argv,
638 builtin_fetch_options, builtin_fetch_usage, 0);
639 if (argc == 0)
641 remote = remote_get(NULL);
642 else
643 remote = remote_get(argv[0]);
644 if (!remote)
646 die("Where do you want to fetch from today?");
647 transport = transport_get(remote, remote->url[0]);
649 if (verbosity >= 2)
650 transport->verbose = 1;
651 if (verbosity < 0)
652 transport->verbose = -1;
653 if (upload_pack)
654 set_option(TRANS_OPT_UPLOADPACK, upload_pack);
655 if (keep)
656 set_option(TRANS_OPT_KEEP, "yes");
657 if (depth)
658 set_option(TRANS_OPT_DEPTH, depth);
659 if (argc > 1) {
661 int j = 0;
662 refs = xcalloc(argc + 1, sizeof(const char *));
663 for (i = 1; i < argc; i++) {
664 if (!strcmp(argv[i], "tag")) {
665 char *ref;
666 i++;
667 if (i >= argc)
668 die("You need to specify a tag name.");
669 ref = xmalloc(strlen(argv[i]) * 2 + 22);
670 strcpy(ref, "refs/tags/");
671 strcat(ref, argv[i]);
672 strcat(ref, ":refs/tags/");
673 strcat(ref, argv[i]);
674 refs[j++] = ref;
675 } else
676 refs[j++] = argv[i];
677 }
678 refs[j] = NULL;
679 ref_nr = j;
680 }
681 sigchain_push_common(unlock_pack_on_signal);
683 atexit(unlock_pack);
684 exit_code = do_fetch(transport,
685 parse_fetch_refspec(ref_nr, refs), ref_nr);
686 transport_disconnect(transport);
687 transport = NULL;
688 return exit_code;
689}