Show usage string for 'git commit-tree -h'
[git/jnareb-git.git] / builtin-fetch.c
bloba35a6f8cb8030bf9be98a001da26fddf0efdb912
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"
15 static const char * const builtin_fetch_usage[] = {
16 "git fetch [options] [<repository> <refspec>...]",
17 NULL
20 enum {
21 TAGS_UNSET = 0,
22 TAGS_DEFAULT = 1,
23 TAGS_SET = 2
26 static int append, force, keep, update_head_ok, verbosity;
27 static int tags = TAGS_DEFAULT;
28 static const char *depth;
29 static const char *upload_pack;
30 static struct strbuf default_rla = STRBUF_INIT;
31 static struct transport *transport;
33 static 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()
53 static void unlock_pack(void)
55 if (transport)
56 transport_unlock_pack(transport);
59 static void unlock_pack_on_signal(int signo)
61 unlock_pack();
62 sigchain_pop(signo);
63 raise(signo);
66 static void add_merge_config(struct ref **head,
67 const struct ref *remote_refs,
68 struct branch *branch,
69 struct ref ***tail)
71 int i;
73 for (i = 0; i < branch->merge_nr; i++) {
74 struct ref *rm, **old_tail = *tail;
75 struct refspec refspec;
77 for (rm = *head; rm; rm = rm->next) {
78 if (branch_merge_matches(branch, i, rm->name)) {
79 rm->merge = 1;
80 break;
83 if (rm)
84 continue;
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.
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;
106 static void find_non_local_tags(struct transport *transport,
107 struct ref **head,
108 struct ref ***tail);
110 static struct ref *get_ref_map(struct transport *transport,
111 struct refspec *refs, int ref_count, int tags,
112 int *autotags)
114 int i;
115 struct ref *rm;
116 struct ref *ref_map = NULL;
117 struct ref **tail = &ref_map;
119 const struct ref *remote_refs = transport_get_remote_refs(transport);
121 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;
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;
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.
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;
163 if (tags == TAGS_DEFAULT && *autotags)
164 find_non_local_tags(transport, &ref_map, &tail);
165 ref_remove_duplicates(ref_map);
167 return ref_map;
170 #define STORE_REF_ERROR_OTHER 1
171 #define STORE_REF_ERROR_DF_CONFLICT 2
173 static int s_update_ref(const char *action,
174 struct ref *ref,
175 int check_old)
177 char msg[1024];
178 char *rla = getenv("GIT_REFLOG_ACTION");
179 static struct ref_lock *lock;
181 if (!rla)
182 rla = default_rla.buf;
183 snprintf(msg, sizeof(msg), "%s: %s", rla, action);
184 lock = lock_any_ref_for_update(ref->name,
185 check_old ? ref->old_sha1 : NULL, 0);
186 if (!lock)
187 return errno == ENOTDIR ? STORE_REF_ERROR_DF_CONFLICT :
188 STORE_REF_ERROR_OTHER;
189 if (write_ref_sha1(lock, ref->new_sha1, msg) < 0)
190 return errno == ENOTDIR ? STORE_REF_ERROR_DF_CONFLICT :
191 STORE_REF_ERROR_OTHER;
192 return 0;
195 #define SUMMARY_WIDTH (2 * DEFAULT_ABBREV + 3)
196 #define REFCOL_WIDTH 10
198 static int update_local_ref(struct ref *ref,
199 const char *remote,
200 char *display)
202 struct commit *current = NULL, *updated;
203 enum object_type type;
204 struct branch *current_branch = branch_get(NULL);
205 const char *pretty_ref = prettify_refname(ref->name);
207 *display = 0;
208 type = sha1_object_info(ref->new_sha1, NULL);
209 if (type < 0)
210 die("object %s not found", sha1_to_hex(ref->new_sha1));
212 if (!hashcmp(ref->old_sha1, ref->new_sha1)) {
213 if (verbosity > 0)
214 sprintf(display, "= %-*s %-*s -> %s", SUMMARY_WIDTH,
215 "[up to date]", REFCOL_WIDTH, remote,
216 pretty_ref);
217 return 0;
220 if (current_branch &&
221 !strcmp(ref->name, current_branch->name) &&
222 !(update_head_ok || is_bare_repository()) &&
223 !is_null_sha1(ref->old_sha1)) {
225 * If this is the head, and it's not okay to update
226 * the head, and the old value of the head isn't empty...
228 sprintf(display, "! %-*s %-*s -> %s (can't fetch in current branch)",
229 SUMMARY_WIDTH, "[rejected]", REFCOL_WIDTH, remote,
230 pretty_ref);
231 return 1;
234 if (!is_null_sha1(ref->old_sha1) &&
235 !prefixcmp(ref->name, "refs/tags/")) {
236 int r;
237 r = s_update_ref("updating tag", ref, 0);
238 sprintf(display, "%c %-*s %-*s -> %s%s", r ? '!' : '-',
239 SUMMARY_WIDTH, "[tag update]", REFCOL_WIDTH, remote,
240 pretty_ref, r ? " (unable to update local ref)" : "");
241 return r;
244 current = lookup_commit_reference_gently(ref->old_sha1, 1);
245 updated = lookup_commit_reference_gently(ref->new_sha1, 1);
246 if (!current || !updated) {
247 const char *msg;
248 const char *what;
249 int r;
250 if (!strncmp(ref->name, "refs/tags/", 10)) {
251 msg = "storing tag";
252 what = "[new tag]";
254 else {
255 msg = "storing head";
256 what = "[new branch]";
259 r = s_update_ref(msg, ref, 0);
260 sprintf(display, "%c %-*s %-*s -> %s%s", r ? '!' : '*',
261 SUMMARY_WIDTH, what, REFCOL_WIDTH, remote, pretty_ref,
262 r ? " (unable to update local ref)" : "");
263 return r;
266 if (in_merge_bases(current, &updated, 1)) {
267 char quickref[83];
268 int r;
269 strcpy(quickref, find_unique_abbrev(current->object.sha1, DEFAULT_ABBREV));
270 strcat(quickref, "..");
271 strcat(quickref, find_unique_abbrev(ref->new_sha1, DEFAULT_ABBREV));
272 r = s_update_ref("fast forward", ref, 1);
273 sprintf(display, "%c %-*s %-*s -> %s%s", r ? '!' : ' ',
274 SUMMARY_WIDTH, quickref, REFCOL_WIDTH, remote,
275 pretty_ref, r ? " (unable to update local ref)" : "");
276 return r;
277 } else if (force || ref->force) {
278 char quickref[84];
279 int r;
280 strcpy(quickref, find_unique_abbrev(current->object.sha1, DEFAULT_ABBREV));
281 strcat(quickref, "...");
282 strcat(quickref, find_unique_abbrev(ref->new_sha1, DEFAULT_ABBREV));
283 r = s_update_ref("forced-update", ref, 1);
284 sprintf(display, "%c %-*s %-*s -> %s (%s)", r ? '!' : '+',
285 SUMMARY_WIDTH, quickref, REFCOL_WIDTH, remote,
286 pretty_ref,
287 r ? "unable to update local ref" : "forced update");
288 return r;
289 } else {
290 sprintf(display, "! %-*s %-*s -> %s (non fast forward)",
291 SUMMARY_WIDTH, "[rejected]", REFCOL_WIDTH, remote,
292 pretty_ref);
293 return 1;
297 static int store_updated_refs(const char *raw_url, const char *remote_name,
298 struct ref *ref_map)
300 FILE *fp;
301 struct commit *commit;
302 int url_len, i, note_len, shown_url = 0, rc = 0;
303 char note[1024];
304 const char *what, *kind;
305 struct ref *rm;
306 char *url, *filename = git_path("FETCH_HEAD");
308 fp = fopen(filename, "a");
309 if (!fp)
310 return error("cannot open %s: %s\n", filename, strerror(errno));
312 url = transport_anonymize_url(raw_url);
313 for (rm = ref_map; rm; rm = rm->next) {
314 struct ref *ref = NULL;
316 if (rm->peer_ref) {
317 ref = xcalloc(1, sizeof(*ref) + strlen(rm->peer_ref->name) + 1);
318 strcpy(ref->name, rm->peer_ref->name);
319 hashcpy(ref->old_sha1, rm->peer_ref->old_sha1);
320 hashcpy(ref->new_sha1, rm->old_sha1);
321 ref->force = rm->peer_ref->force;
324 commit = lookup_commit_reference_gently(rm->old_sha1, 1);
325 if (!commit)
326 rm->merge = 0;
328 if (!strcmp(rm->name, "HEAD")) {
329 kind = "";
330 what = "";
332 else if (!prefixcmp(rm->name, "refs/heads/")) {
333 kind = "branch";
334 what = rm->name + 11;
336 else if (!prefixcmp(rm->name, "refs/tags/")) {
337 kind = "tag";
338 what = rm->name + 10;
340 else if (!prefixcmp(rm->name, "refs/remotes/")) {
341 kind = "remote branch";
342 what = rm->name + 13;
344 else {
345 kind = "";
346 what = rm->name;
349 url_len = strlen(url);
350 for (i = url_len - 1; url[i] == '/' && 0 <= i; i--)
352 url_len = i + 1;
353 if (4 < i && !strncmp(".git", url + i - 3, 4))
354 url_len = i - 3;
356 note_len = 0;
357 if (*what) {
358 if (*kind)
359 note_len += sprintf(note + note_len, "%s ",
360 kind);
361 note_len += sprintf(note + note_len, "'%s' of ", what);
363 note[note_len] = '\0';
364 fprintf(fp, "%s\t%s\t%s",
365 sha1_to_hex(commit ? commit->object.sha1 :
366 rm->old_sha1),
367 rm->merge ? "" : "not-for-merge",
368 note);
369 for (i = 0; i < url_len; ++i)
370 if ('\n' == url[i])
371 fputs("\\n", fp);
372 else
373 fputc(url[i], fp);
374 fputc('\n', fp);
376 if (ref)
377 rc |= update_local_ref(ref, what, note);
378 else
379 sprintf(note, "* %-*s %-*s -> FETCH_HEAD",
380 SUMMARY_WIDTH, *kind ? kind : "branch",
381 REFCOL_WIDTH, *what ? what : "HEAD");
382 if (*note) {
383 if (verbosity >= 0 && !shown_url) {
384 fprintf(stderr, "From %.*s\n",
385 url_len, url);
386 shown_url = 1;
388 if (verbosity >= 0)
389 fprintf(stderr, " %s\n", note);
392 free(url);
393 fclose(fp);
394 if (rc & STORE_REF_ERROR_DF_CONFLICT)
395 error("some local refs could not be updated; try running\n"
396 " 'git remote prune %s' to remove any old, conflicting "
397 "branches", remote_name);
398 return rc;
402 * We would want to bypass the object transfer altogether if
403 * everything we are going to fetch already exists and is connected
404 * locally.
406 * The refs we are going to fetch are in ref_map. If running
408 * $ git rev-list --objects --stdin --not --all
410 * (feeding all the refs in ref_map on its standard input)
411 * does not error out, that means everything reachable from the
412 * refs we are going to fetch exists and is connected to some of
413 * our existing refs.
415 static int quickfetch(struct ref *ref_map)
417 struct child_process revlist;
418 struct ref *ref;
419 int err;
420 const char *argv[] = {"rev-list",
421 "--quiet", "--objects", "--stdin", "--not", "--all", NULL};
424 * If we are deepening a shallow clone we already have these
425 * objects reachable. Running rev-list here will return with
426 * a good (0) exit status and we'll bypass the fetch that we
427 * really need to perform. Claiming failure now will ensure
428 * we perform the network exchange to deepen our history.
430 if (depth)
431 return -1;
433 if (!ref_map)
434 return 0;
436 memset(&revlist, 0, sizeof(revlist));
437 revlist.argv = argv;
438 revlist.git_cmd = 1;
439 revlist.no_stdout = 1;
440 revlist.no_stderr = 1;
441 revlist.in = -1;
443 err = start_command(&revlist);
444 if (err) {
445 error("could not run rev-list");
446 return err;
450 * If rev-list --stdin encounters an unknown commit, it terminates,
451 * which will cause SIGPIPE in the write loop below.
453 sigchain_push(SIGPIPE, SIG_IGN);
455 for (ref = ref_map; ref; ref = ref->next) {
456 if (write_in_full(revlist.in, sha1_to_hex(ref->old_sha1), 40) < 0 ||
457 write_str_in_full(revlist.in, "\n") < 0) {
458 if (errno != EPIPE && errno != EINVAL)
459 error("failed write to rev-list: %s", strerror(errno));
460 err = -1;
461 break;
465 if (close(revlist.in)) {
466 error("failed to close rev-list's stdin: %s", strerror(errno));
467 err = -1;
470 sigchain_pop(SIGPIPE);
472 return finish_command(&revlist) || err;
475 static int fetch_refs(struct transport *transport, struct ref *ref_map)
477 int ret = quickfetch(ref_map);
478 if (ret)
479 ret = transport_fetch_refs(transport, ref_map);
480 if (!ret)
481 ret |= store_updated_refs(transport->url,
482 transport->remote->name,
483 ref_map);
484 transport_unlock_pack(transport);
485 return ret;
488 static int add_existing(const char *refname, const unsigned char *sha1,
489 int flag, void *cbdata)
491 struct string_list *list = (struct string_list *)cbdata;
492 string_list_insert(refname, list);
493 return 0;
496 static int will_fetch(struct ref **head, const unsigned char *sha1)
498 struct ref *rm = *head;
499 while (rm) {
500 if (!hashcmp(rm->old_sha1, sha1))
501 return 1;
502 rm = rm->next;
504 return 0;
507 struct tag_data {
508 struct ref **head;
509 struct ref ***tail;
512 static int add_to_tail(struct string_list_item *item, void *cb_data)
514 struct tag_data *data = (struct tag_data *)cb_data;
515 struct ref *rm = NULL;
517 /* We have already decided to ignore this item */
518 if (!item->util)
519 return 0;
521 rm = alloc_ref(item->string);
522 rm->peer_ref = alloc_ref(item->string);
523 hashcpy(rm->old_sha1, item->util);
525 **data->tail = rm;
526 *data->tail = &rm->next;
528 return 0;
531 static void find_non_local_tags(struct transport *transport,
532 struct ref **head,
533 struct ref ***tail)
535 struct string_list existing_refs = { NULL, 0, 0, 0 };
536 struct string_list remote_refs = { NULL, 0, 0, 0 };
537 struct tag_data data = {head, tail};
538 const struct ref *ref;
539 struct string_list_item *item = NULL;
541 for_each_ref(add_existing, &existing_refs);
542 for (ref = transport_get_remote_refs(transport); ref; ref = ref->next) {
543 if (prefixcmp(ref->name, "refs/tags"))
544 continue;
547 * The peeled ref always follows the matching base
548 * ref, so if we see a peeled ref that we don't want
549 * to fetch then we can mark the ref entry in the list
550 * as one to ignore by setting util to NULL.
552 if (!strcmp(ref->name + strlen(ref->name) - 3, "^{}")) {
553 if (item && !has_sha1_file(ref->old_sha1) &&
554 !will_fetch(head, ref->old_sha1) &&
555 !has_sha1_file(item->util) &&
556 !will_fetch(head, item->util))
557 item->util = NULL;
558 item = NULL;
559 continue;
563 * If item is non-NULL here, then we previously saw a
564 * ref not followed by a peeled reference, so we need
565 * to check if it is a lightweight tag that we want to
566 * fetch.
568 if (item && !has_sha1_file(item->util) &&
569 !will_fetch(head, item->util))
570 item->util = NULL;
572 item = NULL;
574 /* skip duplicates and refs that we already have */
575 if (string_list_has_string(&remote_refs, ref->name) ||
576 string_list_has_string(&existing_refs, ref->name))
577 continue;
579 item = string_list_insert(ref->name, &remote_refs);
580 item->util = (void *)ref->old_sha1;
582 string_list_clear(&existing_refs, 0);
585 * We may have a final lightweight tag that needs to be
586 * checked to see if it needs fetching.
588 if (item && !has_sha1_file(item->util) &&
589 !will_fetch(head, item->util))
590 item->util = NULL;
593 * For all the tags in the remote_refs string list, call
594 * add_to_tail to add them to the list of refs to be fetched
596 for_each_string_list(add_to_tail, &remote_refs, &data);
598 string_list_clear(&remote_refs, 0);
601 static void check_not_current_branch(struct ref *ref_map)
603 struct branch *current_branch = branch_get(NULL);
605 if (is_bare_repository() || !current_branch)
606 return;
608 for (; ref_map; ref_map = ref_map->next)
609 if (ref_map->peer_ref && !strcmp(current_branch->refname,
610 ref_map->peer_ref->name))
611 die("Refusing to fetch into current branch %s "
612 "of non-bare repository", current_branch->refname);
615 static int do_fetch(struct transport *transport,
616 struct refspec *refs, int ref_count)
618 struct ref *ref_map;
619 struct ref *rm;
620 int autotags = (transport->remote->fetch_tags == 1);
621 if (transport->remote->fetch_tags == 2 && tags != TAGS_UNSET)
622 tags = TAGS_SET;
623 if (transport->remote->fetch_tags == -1)
624 tags = TAGS_UNSET;
626 if (!transport->get_refs_list || !transport->fetch)
627 die("Don't know how to fetch from %s", transport->url);
629 /* if not appending, truncate FETCH_HEAD */
630 if (!append) {
631 char *filename = git_path("FETCH_HEAD");
632 FILE *fp = fopen(filename, "w");
633 if (!fp)
634 return error("cannot open %s: %s\n", filename, strerror(errno));
635 fclose(fp);
638 ref_map = get_ref_map(transport, refs, ref_count, tags, &autotags);
639 if (!update_head_ok)
640 check_not_current_branch(ref_map);
642 for (rm = ref_map; rm; rm = rm->next) {
643 if (rm->peer_ref)
644 read_ref(rm->peer_ref->name, rm->peer_ref->old_sha1);
647 if (tags == TAGS_DEFAULT && autotags)
648 transport_set_option(transport, TRANS_OPT_FOLLOWTAGS, "1");
649 if (fetch_refs(transport, ref_map)) {
650 free_refs(ref_map);
651 return 1;
653 free_refs(ref_map);
655 /* if neither --no-tags nor --tags was specified, do automated tag
656 * following ... */
657 if (tags == TAGS_DEFAULT && autotags) {
658 struct ref **tail = &ref_map;
659 ref_map = NULL;
660 find_non_local_tags(transport, &ref_map, &tail);
661 if (ref_map) {
662 transport_set_option(transport, TRANS_OPT_FOLLOWTAGS, NULL);
663 transport_set_option(transport, TRANS_OPT_DEPTH, "0");
664 fetch_refs(transport, ref_map);
666 free_refs(ref_map);
669 return 0;
672 static void set_option(const char *name, const char *value)
674 int r = transport_set_option(transport, name, value);
675 if (r < 0)
676 die("Option \"%s\" value \"%s\" is not valid for %s",
677 name, value, transport->url);
678 if (r > 0)
679 warning("Option \"%s\" is ignored for %s\n",
680 name, transport->url);
683 int cmd_fetch(int argc, const char **argv, const char *prefix)
685 struct remote *remote;
686 int i;
687 static const char **refs = NULL;
688 int ref_nr = 0;
689 int exit_code;
691 /* Record the command line for the reflog */
692 strbuf_addstr(&default_rla, "fetch");
693 for (i = 1; i < argc; i++)
694 strbuf_addf(&default_rla, " %s", argv[i]);
696 argc = parse_options(argc, argv, prefix,
697 builtin_fetch_options, builtin_fetch_usage, 0);
699 if (argc == 0)
700 remote = remote_get(NULL);
701 else
702 remote = remote_get(argv[0]);
704 if (!remote)
705 die("Where do you want to fetch from today?");
707 transport = transport_get(remote, remote->url[0]);
708 if (verbosity >= 2)
709 transport->verbose = 1;
710 if (verbosity < 0)
711 transport->verbose = -1;
712 if (upload_pack)
713 set_option(TRANS_OPT_UPLOADPACK, upload_pack);
714 if (keep)
715 set_option(TRANS_OPT_KEEP, "yes");
716 if (depth)
717 set_option(TRANS_OPT_DEPTH, depth);
719 if (argc > 1) {
720 int j = 0;
721 refs = xcalloc(argc + 1, sizeof(const char *));
722 for (i = 1; i < argc; i++) {
723 if (!strcmp(argv[i], "tag")) {
724 char *ref;
725 i++;
726 if (i >= argc)
727 die("You need to specify a tag name.");
728 ref = xmalloc(strlen(argv[i]) * 2 + 22);
729 strcpy(ref, "refs/tags/");
730 strcat(ref, argv[i]);
731 strcat(ref, ":refs/tags/");
732 strcat(ref, argv[i]);
733 refs[j++] = ref;
734 } else
735 refs[j++] = argv[i];
737 refs[j] = NULL;
738 ref_nr = j;
741 sigchain_push_common(unlock_pack_on_signal);
742 atexit(unlock_pack);
743 exit_code = do_fetch(transport,
744 parse_fetch_refspec(ref_nr, refs), ref_nr);
745 transport_disconnect(transport);
746 transport = NULL;
747 return exit_code;