Merge tag 'v2.23.0-rc2' of git://git.kernel.org/pub/scm/git/git
[git/raj.git] / builtin / fetch.c
blob717dd14e896117c56101f7f56df0261576c323d0
1 /*
2 * "git fetch"
3 */
4 #include "cache.h"
5 #include "config.h"
6 #include "repository.h"
7 #include "refs.h"
8 #include "refspec.h"
9 #include "object-store.h"
10 #include "commit.h"
11 #include "builtin.h"
12 #include "string-list.h"
13 #include "remote.h"
14 #include "transport.h"
15 #include "run-command.h"
16 #include "parse-options.h"
17 #include "sigchain.h"
18 #include "submodule-config.h"
19 #include "submodule.h"
20 #include "connected.h"
21 #include "argv-array.h"
22 #include "utf8.h"
23 #include "packfile.h"
24 #include "list-objects-filter-options.h"
25 #include "commit-reach.h"
27 #define FORCED_UPDATES_DELAY_WARNING_IN_MS (10 * 1000)
29 static const char * const builtin_fetch_usage[] = {
30 N_("git fetch [<options>] [<repository> [<refspec>...]]"),
31 N_("git fetch [<options>] <group>"),
32 N_("git fetch --multiple [<options>] [(<repository> | <group>)...]"),
33 N_("git fetch --all [<options>]"),
34 NULL
37 enum {
38 TAGS_UNSET = 0,
39 TAGS_DEFAULT = 1,
40 TAGS_SET = 2
43 static int fetch_prune_config = -1; /* unspecified */
44 static int fetch_show_forced_updates = 1;
45 static uint64_t forced_updates_ms = 0;
46 static int prune = -1; /* unspecified */
47 #define PRUNE_BY_DEFAULT 0 /* do we prune by default? */
49 static int fetch_prune_tags_config = -1; /* unspecified */
50 static int prune_tags = -1; /* unspecified */
51 #define PRUNE_TAGS_BY_DEFAULT 0 /* do we prune tags by default? */
53 static int all, append, dry_run, force, keep, multiple, update_head_ok, verbosity, deepen_relative;
54 static int progress = -1;
55 static int enable_auto_gc = 1;
56 static int tags = TAGS_DEFAULT, unshallow, update_shallow, deepen;
57 static int max_children = 1;
58 static enum transport_family family;
59 static const char *depth;
60 static const char *deepen_since;
61 static const char *upload_pack;
62 static struct string_list deepen_not = STRING_LIST_INIT_NODUP;
63 static struct strbuf default_rla = STRBUF_INIT;
64 static struct transport *gtransport;
65 static struct transport *gsecondary;
66 static const char *submodule_prefix = "";
67 static int recurse_submodules = RECURSE_SUBMODULES_DEFAULT;
68 static int recurse_submodules_default = RECURSE_SUBMODULES_ON_DEMAND;
69 static int shown_url = 0;
70 static struct refspec refmap = REFSPEC_INIT_FETCH;
71 static struct list_objects_filter_options filter_options;
72 static struct string_list server_options = STRING_LIST_INIT_DUP;
73 static struct string_list negotiation_tip = STRING_LIST_INIT_NODUP;
75 static int git_fetch_config(const char *k, const char *v, void *cb)
77 if (!strcmp(k, "fetch.prune")) {
78 fetch_prune_config = git_config_bool(k, v);
79 return 0;
82 if (!strcmp(k, "fetch.prunetags")) {
83 fetch_prune_tags_config = git_config_bool(k, v);
84 return 0;
87 if (!strcmp(k, "fetch.showforcedupdates")) {
88 fetch_show_forced_updates = git_config_bool(k, v);
89 return 0;
92 if (!strcmp(k, "submodule.recurse")) {
93 int r = git_config_bool(k, v) ?
94 RECURSE_SUBMODULES_ON : RECURSE_SUBMODULES_OFF;
95 recurse_submodules = r;
98 if (!strcmp(k, "submodule.fetchjobs")) {
99 max_children = parse_submodule_fetchjobs(k, v);
100 return 0;
101 } else if (!strcmp(k, "fetch.recursesubmodules")) {
102 recurse_submodules = parse_fetch_recurse_submodules_arg(k, v);
103 return 0;
106 return git_default_config(k, v, cb);
109 static int parse_refmap_arg(const struct option *opt, const char *arg, int unset)
111 BUG_ON_OPT_NEG(unset);
114 * "git fetch --refmap='' origin foo"
115 * can be used to tell the command not to store anywhere
117 refspec_append(&refmap, arg);
119 return 0;
122 static struct option builtin_fetch_options[] = {
123 OPT__VERBOSITY(&verbosity),
124 OPT_BOOL(0, "all", &all,
125 N_("fetch from all remotes")),
126 OPT_BOOL('a', "append", &append,
127 N_("append to .git/FETCH_HEAD instead of overwriting")),
128 OPT_STRING(0, "upload-pack", &upload_pack, N_("path"),
129 N_("path to upload pack on remote end")),
130 OPT__FORCE(&force, N_("force overwrite of local reference"), 0),
131 OPT_BOOL('m', "multiple", &multiple,
132 N_("fetch from multiple remotes")),
133 OPT_SET_INT('t', "tags", &tags,
134 N_("fetch all tags and associated objects"), TAGS_SET),
135 OPT_SET_INT('n', NULL, &tags,
136 N_("do not fetch all tags (--no-tags)"), TAGS_UNSET),
137 OPT_INTEGER('j', "jobs", &max_children,
138 N_("number of submodules fetched in parallel")),
139 OPT_BOOL('p', "prune", &prune,
140 N_("prune remote-tracking branches no longer on remote")),
141 OPT_BOOL('P', "prune-tags", &prune_tags,
142 N_("prune local tags no longer on remote and clobber changed tags")),
143 { OPTION_CALLBACK, 0, "recurse-submodules", &recurse_submodules, N_("on-demand"),
144 N_("control recursive fetching of submodules"),
145 PARSE_OPT_OPTARG, option_fetch_parse_recurse_submodules },
146 OPT_BOOL(0, "dry-run", &dry_run,
147 N_("dry run")),
148 OPT_BOOL('k', "keep", &keep, N_("keep downloaded pack")),
149 OPT_BOOL('u', "update-head-ok", &update_head_ok,
150 N_("allow updating of HEAD ref")),
151 OPT_BOOL(0, "progress", &progress, N_("force progress reporting")),
152 OPT_STRING(0, "depth", &depth, N_("depth"),
153 N_("deepen history of shallow clone")),
154 OPT_STRING(0, "shallow-since", &deepen_since, N_("time"),
155 N_("deepen history of shallow repository based on time")),
156 OPT_STRING_LIST(0, "shallow-exclude", &deepen_not, N_("revision"),
157 N_("deepen history of shallow clone, excluding rev")),
158 OPT_INTEGER(0, "deepen", &deepen_relative,
159 N_("deepen history of shallow clone")),
160 OPT_SET_INT_F(0, "unshallow", &unshallow,
161 N_("convert to a complete repository"),
162 1, PARSE_OPT_NONEG),
163 { OPTION_STRING, 0, "submodule-prefix", &submodule_prefix, N_("dir"),
164 N_("prepend this to submodule path output"), PARSE_OPT_HIDDEN },
165 { OPTION_CALLBACK, 0, "recurse-submodules-default",
166 &recurse_submodules_default, N_("on-demand"),
167 N_("default for recursive fetching of submodules "
168 "(lower priority than config files)"),
169 PARSE_OPT_HIDDEN, option_fetch_parse_recurse_submodules },
170 OPT_BOOL(0, "update-shallow", &update_shallow,
171 N_("accept refs that update .git/shallow")),
172 { OPTION_CALLBACK, 0, "refmap", NULL, N_("refmap"),
173 N_("specify fetch refmap"), PARSE_OPT_NONEG, parse_refmap_arg },
174 OPT_STRING_LIST('o', "server-option", &server_options, N_("server-specific"), N_("option to transmit")),
175 OPT_SET_INT('4', "ipv4", &family, N_("use IPv4 addresses only"),
176 TRANSPORT_FAMILY_IPV4),
177 OPT_SET_INT('6', "ipv6", &family, N_("use IPv6 addresses only"),
178 TRANSPORT_FAMILY_IPV6),
179 OPT_STRING_LIST(0, "negotiation-tip", &negotiation_tip, N_("revision"),
180 N_("report that we have only objects reachable from this object")),
181 OPT_PARSE_LIST_OBJECTS_FILTER(&filter_options),
182 OPT_BOOL(0, "auto-gc", &enable_auto_gc,
183 N_("run 'gc --auto' after fetching")),
184 OPT_BOOL(0, "show-forced-updates", &fetch_show_forced_updates,
185 N_("check for forced-updates on all updated branches")),
186 OPT_END()
189 static void unlock_pack(void)
191 if (gtransport)
192 transport_unlock_pack(gtransport);
193 if (gsecondary)
194 transport_unlock_pack(gsecondary);
197 static void unlock_pack_on_signal(int signo)
199 unlock_pack();
200 sigchain_pop(signo);
201 raise(signo);
204 static void add_merge_config(struct ref **head,
205 const struct ref *remote_refs,
206 struct branch *branch,
207 struct ref ***tail)
209 int i;
211 for (i = 0; i < branch->merge_nr; i++) {
212 struct ref *rm, **old_tail = *tail;
213 struct refspec_item refspec;
215 for (rm = *head; rm; rm = rm->next) {
216 if (branch_merge_matches(branch, i, rm->name)) {
217 rm->fetch_head_status = FETCH_HEAD_MERGE;
218 break;
221 if (rm)
222 continue;
225 * Not fetched to a remote-tracking branch? We need to fetch
226 * it anyway to allow this branch's "branch.$name.merge"
227 * to be honored by 'git pull', but we do not have to
228 * fail if branch.$name.merge is misconfigured to point
229 * at a nonexisting branch. If we were indeed called by
230 * 'git pull', it will notice the misconfiguration because
231 * there is no entry in the resulting FETCH_HEAD marked
232 * for merging.
234 memset(&refspec, 0, sizeof(refspec));
235 refspec.src = branch->merge[i]->src;
236 get_fetch_map(remote_refs, &refspec, tail, 1);
237 for (rm = *old_tail; rm; rm = rm->next)
238 rm->fetch_head_status = FETCH_HEAD_MERGE;
242 static int will_fetch(struct ref **head, const unsigned char *sha1)
244 struct ref *rm = *head;
245 while (rm) {
246 if (hasheq(rm->old_oid.hash, sha1))
247 return 1;
248 rm = rm->next;
250 return 0;
253 struct refname_hash_entry {
254 struct hashmap_entry ent; /* must be the first member */
255 struct object_id oid;
256 int ignore;
257 char refname[FLEX_ARRAY];
260 static int refname_hash_entry_cmp(const void *hashmap_cmp_fn_data,
261 const void *e1_,
262 const void *e2_,
263 const void *keydata)
265 const struct refname_hash_entry *e1 = e1_;
266 const struct refname_hash_entry *e2 = e2_;
268 return strcmp(e1->refname, keydata ? keydata : e2->refname);
271 static struct refname_hash_entry *refname_hash_add(struct hashmap *map,
272 const char *refname,
273 const struct object_id *oid)
275 struct refname_hash_entry *ent;
276 size_t len = strlen(refname);
278 FLEX_ALLOC_MEM(ent, refname, refname, len);
279 hashmap_entry_init(ent, strhash(refname));
280 oidcpy(&ent->oid, oid);
281 hashmap_add(map, ent);
282 return ent;
285 static int add_one_refname(const char *refname,
286 const struct object_id *oid,
287 int flag, void *cbdata)
289 struct hashmap *refname_map = cbdata;
291 (void) refname_hash_add(refname_map, refname, oid);
292 return 0;
295 static void refname_hash_init(struct hashmap *map)
297 hashmap_init(map, refname_hash_entry_cmp, NULL, 0);
300 static int refname_hash_exists(struct hashmap *map, const char *refname)
302 return !!hashmap_get_from_hash(map, strhash(refname), refname);
305 static void clear_item(struct refname_hash_entry *item)
307 item->ignore = 1;
310 static void find_non_local_tags(const struct ref *refs,
311 struct ref **head,
312 struct ref ***tail)
314 struct hashmap existing_refs;
315 struct hashmap remote_refs;
316 struct string_list remote_refs_list = STRING_LIST_INIT_NODUP;
317 struct string_list_item *remote_ref_item;
318 const struct ref *ref;
319 struct refname_hash_entry *item = NULL;
321 refname_hash_init(&existing_refs);
322 refname_hash_init(&remote_refs);
324 for_each_ref(add_one_refname, &existing_refs);
325 for (ref = refs; ref; ref = ref->next) {
326 if (!starts_with(ref->name, "refs/tags/"))
327 continue;
330 * The peeled ref always follows the matching base
331 * ref, so if we see a peeled ref that we don't want
332 * to fetch then we can mark the ref entry in the list
333 * as one to ignore by setting util to NULL.
335 if (ends_with(ref->name, "^{}")) {
336 if (item &&
337 !has_object_file_with_flags(&ref->old_oid,
338 OBJECT_INFO_QUICK) &&
339 !will_fetch(head, ref->old_oid.hash) &&
340 !has_object_file_with_flags(&item->oid, OBJECT_INFO_QUICK) &&
341 !will_fetch(head, item->oid.hash))
342 clear_item(item);
343 item = NULL;
344 continue;
348 * If item is non-NULL here, then we previously saw a
349 * ref not followed by a peeled reference, so we need
350 * to check if it is a lightweight tag that we want to
351 * fetch.
353 if (item &&
354 !has_object_file_with_flags(&item->oid, OBJECT_INFO_QUICK) &&
355 !will_fetch(head, item->oid.hash))
356 clear_item(item);
358 item = NULL;
360 /* skip duplicates and refs that we already have */
361 if (refname_hash_exists(&remote_refs, ref->name) ||
362 refname_hash_exists(&existing_refs, ref->name))
363 continue;
365 item = refname_hash_add(&remote_refs, ref->name, &ref->old_oid);
366 string_list_insert(&remote_refs_list, ref->name);
368 hashmap_free(&existing_refs, 1);
371 * We may have a final lightweight tag that needs to be
372 * checked to see if it needs fetching.
374 if (item &&
375 !has_object_file_with_flags(&item->oid, OBJECT_INFO_QUICK) &&
376 !will_fetch(head, item->oid.hash))
377 clear_item(item);
380 * For all the tags in the remote_refs_list,
381 * add them to the list of refs to be fetched
383 for_each_string_list_item(remote_ref_item, &remote_refs_list) {
384 const char *refname = remote_ref_item->string;
385 struct ref *rm;
387 item = hashmap_get_from_hash(&remote_refs, strhash(refname), refname);
388 if (!item)
389 BUG("unseen remote ref?");
391 /* Unless we have already decided to ignore this item... */
392 if (item->ignore)
393 continue;
395 rm = alloc_ref(item->refname);
396 rm->peer_ref = alloc_ref(item->refname);
397 oidcpy(&rm->old_oid, &item->oid);
398 **tail = rm;
399 *tail = &rm->next;
401 hashmap_free(&remote_refs, 1);
402 string_list_clear(&remote_refs_list, 0);
405 static struct ref *get_ref_map(struct remote *remote,
406 const struct ref *remote_refs,
407 struct refspec *rs,
408 int tags, int *autotags)
410 int i;
411 struct ref *rm;
412 struct ref *ref_map = NULL;
413 struct ref **tail = &ref_map;
415 /* opportunistically-updated references: */
416 struct ref *orefs = NULL, **oref_tail = &orefs;
418 struct hashmap existing_refs;
420 if (rs->nr) {
421 struct refspec *fetch_refspec;
423 for (i = 0; i < rs->nr; i++) {
424 get_fetch_map(remote_refs, &rs->items[i], &tail, 0);
425 if (rs->items[i].dst && rs->items[i].dst[0])
426 *autotags = 1;
428 /* Merge everything on the command line (but not --tags) */
429 for (rm = ref_map; rm; rm = rm->next)
430 rm->fetch_head_status = FETCH_HEAD_MERGE;
433 * For any refs that we happen to be fetching via
434 * command-line arguments, the destination ref might
435 * have been missing or have been different than the
436 * remote-tracking ref that would be derived from the
437 * configured refspec. In these cases, we want to
438 * take the opportunity to update their configured
439 * remote-tracking reference. However, we do not want
440 * to mention these entries in FETCH_HEAD at all, as
441 * they would simply be duplicates of existing
442 * entries, so we set them FETCH_HEAD_IGNORE below.
444 * We compute these entries now, based only on the
445 * refspecs specified on the command line. But we add
446 * them to the list following the refspecs resulting
447 * from the tags option so that one of the latter,
448 * which has FETCH_HEAD_NOT_FOR_MERGE, is not removed
449 * by ref_remove_duplicates() in favor of one of these
450 * opportunistic entries with FETCH_HEAD_IGNORE.
452 if (refmap.nr)
453 fetch_refspec = &refmap;
454 else
455 fetch_refspec = &remote->fetch;
457 for (i = 0; i < fetch_refspec->nr; i++)
458 get_fetch_map(ref_map, &fetch_refspec->items[i], &oref_tail, 1);
459 } else if (refmap.nr) {
460 die("--refmap option is only meaningful with command-line refspec(s).");
461 } else {
462 /* Use the defaults */
463 struct branch *branch = branch_get(NULL);
464 int has_merge = branch_has_merge_config(branch);
465 if (remote &&
466 (remote->fetch.nr ||
467 /* Note: has_merge implies non-NULL branch->remote_name */
468 (has_merge && !strcmp(branch->remote_name, remote->name)))) {
469 for (i = 0; i < remote->fetch.nr; i++) {
470 get_fetch_map(remote_refs, &remote->fetch.items[i], &tail, 0);
471 if (remote->fetch.items[i].dst &&
472 remote->fetch.items[i].dst[0])
473 *autotags = 1;
474 if (!i && !has_merge && ref_map &&
475 !remote->fetch.items[0].pattern)
476 ref_map->fetch_head_status = FETCH_HEAD_MERGE;
479 * if the remote we're fetching from is the same
480 * as given in branch.<name>.remote, we add the
481 * ref given in branch.<name>.merge, too.
483 * Note: has_merge implies non-NULL branch->remote_name
485 if (has_merge &&
486 !strcmp(branch->remote_name, remote->name))
487 add_merge_config(&ref_map, remote_refs, branch, &tail);
488 } else {
489 ref_map = get_remote_ref(remote_refs, "HEAD");
490 if (!ref_map)
491 die(_("Couldn't find remote ref HEAD"));
492 ref_map->fetch_head_status = FETCH_HEAD_MERGE;
493 tail = &ref_map->next;
497 if (tags == TAGS_SET)
498 /* also fetch all tags */
499 get_fetch_map(remote_refs, tag_refspec, &tail, 0);
500 else if (tags == TAGS_DEFAULT && *autotags)
501 find_non_local_tags(remote_refs, &ref_map, &tail);
503 /* Now append any refs to be updated opportunistically: */
504 *tail = orefs;
505 for (rm = orefs; rm; rm = rm->next) {
506 rm->fetch_head_status = FETCH_HEAD_IGNORE;
507 tail = &rm->next;
510 ref_map = ref_remove_duplicates(ref_map);
512 refname_hash_init(&existing_refs);
513 for_each_ref(add_one_refname, &existing_refs);
515 for (rm = ref_map; rm; rm = rm->next) {
516 if (rm->peer_ref) {
517 const char *refname = rm->peer_ref->name;
518 struct refname_hash_entry *peer_item;
520 peer_item = hashmap_get_from_hash(&existing_refs,
521 strhash(refname),
522 refname);
523 if (peer_item) {
524 struct object_id *old_oid = &peer_item->oid;
525 oidcpy(&rm->peer_ref->old_oid, old_oid);
529 hashmap_free(&existing_refs, 1);
531 return ref_map;
534 #define STORE_REF_ERROR_OTHER 1
535 #define STORE_REF_ERROR_DF_CONFLICT 2
537 static int s_update_ref(const char *action,
538 struct ref *ref,
539 int check_old)
541 char *msg;
542 char *rla = getenv("GIT_REFLOG_ACTION");
543 struct ref_transaction *transaction;
544 struct strbuf err = STRBUF_INIT;
545 int ret, df_conflict = 0;
547 if (dry_run)
548 return 0;
549 if (!rla)
550 rla = default_rla.buf;
551 msg = xstrfmt("%s: %s", rla, action);
553 transaction = ref_transaction_begin(&err);
554 if (!transaction ||
555 ref_transaction_update(transaction, ref->name,
556 &ref->new_oid,
557 check_old ? &ref->old_oid : NULL,
558 0, msg, &err))
559 goto fail;
561 ret = ref_transaction_commit(transaction, &err);
562 if (ret) {
563 df_conflict = (ret == TRANSACTION_NAME_CONFLICT);
564 goto fail;
567 ref_transaction_free(transaction);
568 strbuf_release(&err);
569 free(msg);
570 return 0;
571 fail:
572 ref_transaction_free(transaction);
573 error("%s", err.buf);
574 strbuf_release(&err);
575 free(msg);
576 return df_conflict ? STORE_REF_ERROR_DF_CONFLICT
577 : STORE_REF_ERROR_OTHER;
580 static int refcol_width = 10;
581 static int compact_format;
583 static void adjust_refcol_width(const struct ref *ref)
585 int max, rlen, llen, len;
587 /* uptodate lines are only shown on high verbosity level */
588 if (!verbosity && oideq(&ref->peer_ref->old_oid, &ref->old_oid))
589 return;
591 max = term_columns();
592 rlen = utf8_strwidth(prettify_refname(ref->name));
594 llen = utf8_strwidth(prettify_refname(ref->peer_ref->name));
597 * rough estimation to see if the output line is too long and
598 * should not be counted (we can't do precise calculation
599 * anyway because we don't know if the error explanation part
600 * will be printed in update_local_ref)
602 if (compact_format) {
603 llen = 0;
604 max = max * 2 / 3;
606 len = 21 /* flag and summary */ + rlen + 4 /* -> */ + llen;
607 if (len >= max)
608 return;
611 * Not precise calculation for compact mode because '*' can
612 * appear on the left hand side of '->' and shrink the column
613 * back.
615 if (refcol_width < rlen)
616 refcol_width = rlen;
619 static void prepare_format_display(struct ref *ref_map)
621 struct ref *rm;
622 const char *format = "full";
624 git_config_get_string_const("fetch.output", &format);
625 if (!strcasecmp(format, "full"))
626 compact_format = 0;
627 else if (!strcasecmp(format, "compact"))
628 compact_format = 1;
629 else
630 die(_("configuration fetch.output contains invalid value %s"),
631 format);
633 for (rm = ref_map; rm; rm = rm->next) {
634 if (rm->status == REF_STATUS_REJECT_SHALLOW ||
635 !rm->peer_ref ||
636 !strcmp(rm->name, "HEAD"))
637 continue;
639 adjust_refcol_width(rm);
643 static void print_remote_to_local(struct strbuf *display,
644 const char *remote, const char *local)
646 strbuf_addf(display, "%-*s -> %s", refcol_width, remote, local);
649 static int find_and_replace(struct strbuf *haystack,
650 const char *needle,
651 const char *placeholder)
653 const char *p = NULL;
654 int plen, nlen;
656 nlen = strlen(needle);
657 if (ends_with(haystack->buf, needle))
658 p = haystack->buf + haystack->len - nlen;
659 else
660 p = strstr(haystack->buf, needle);
661 if (!p)
662 return 0;
664 if (p > haystack->buf && p[-1] != '/')
665 return 0;
667 plen = strlen(p);
668 if (plen > nlen && p[nlen] != '/')
669 return 0;
671 strbuf_splice(haystack, p - haystack->buf, nlen,
672 placeholder, strlen(placeholder));
673 return 1;
676 static void print_compact(struct strbuf *display,
677 const char *remote, const char *local)
679 struct strbuf r = STRBUF_INIT;
680 struct strbuf l = STRBUF_INIT;
682 if (!strcmp(remote, local)) {
683 strbuf_addf(display, "%-*s -> *", refcol_width, remote);
684 return;
687 strbuf_addstr(&r, remote);
688 strbuf_addstr(&l, local);
690 if (!find_and_replace(&r, local, "*"))
691 find_and_replace(&l, remote, "*");
692 print_remote_to_local(display, r.buf, l.buf);
694 strbuf_release(&r);
695 strbuf_release(&l);
698 static void format_display(struct strbuf *display, char code,
699 const char *summary, const char *error,
700 const char *remote, const char *local,
701 int summary_width)
703 int width = (summary_width + strlen(summary) - gettext_width(summary));
705 strbuf_addf(display, "%c %-*s ", code, width, summary);
706 if (!compact_format)
707 print_remote_to_local(display, remote, local);
708 else
709 print_compact(display, remote, local);
710 if (error)
711 strbuf_addf(display, " (%s)", error);
714 static int update_local_ref(struct ref *ref,
715 const char *remote,
716 const struct ref *remote_ref,
717 struct strbuf *display,
718 int summary_width)
720 struct commit *current = NULL, *updated;
721 enum object_type type;
722 struct branch *current_branch = branch_get(NULL);
723 const char *pretty_ref = prettify_refname(ref->name);
724 int fast_forward = 0;
726 type = oid_object_info(the_repository, &ref->new_oid, NULL);
727 if (type < 0)
728 die(_("object %s not found"), oid_to_hex(&ref->new_oid));
730 if (oideq(&ref->old_oid, &ref->new_oid)) {
731 if (verbosity > 0)
732 format_display(display, '=', _("[up to date]"), NULL,
733 remote, pretty_ref, summary_width);
734 return 0;
737 if (current_branch &&
738 !strcmp(ref->name, current_branch->name) &&
739 !(update_head_ok || is_bare_repository()) &&
740 !is_null_oid(&ref->old_oid)) {
742 * If this is the head, and it's not okay to update
743 * the head, and the old value of the head isn't empty...
745 format_display(display, '!', _("[rejected]"),
746 _("can't fetch in current branch"),
747 remote, pretty_ref, summary_width);
748 return 1;
751 if (!is_null_oid(&ref->old_oid) &&
752 starts_with(ref->name, "refs/tags/")) {
753 if (force || ref->force) {
754 int r;
755 r = s_update_ref("updating tag", ref, 0);
756 format_display(display, r ? '!' : 't', _("[tag update]"),
757 r ? _("unable to update local ref") : NULL,
758 remote, pretty_ref, summary_width);
759 return r;
760 } else {
761 format_display(display, '!', _("[rejected]"), _("would clobber existing tag"),
762 remote, pretty_ref, summary_width);
763 return 1;
767 current = lookup_commit_reference_gently(the_repository,
768 &ref->old_oid, 1);
769 updated = lookup_commit_reference_gently(the_repository,
770 &ref->new_oid, 1);
771 if (!current || !updated) {
772 const char *msg;
773 const char *what;
774 int r;
776 * Nicely describe the new ref we're fetching.
777 * Base this on the remote's ref name, as it's
778 * more likely to follow a standard layout.
780 const char *name = remote_ref ? remote_ref->name : "";
781 if (starts_with(name, "refs/tags/")) {
782 msg = "storing tag";
783 what = _("[new tag]");
784 } else if (starts_with(name, "refs/heads/")) {
785 msg = "storing head";
786 what = _("[new branch]");
787 } else {
788 msg = "storing ref";
789 what = _("[new ref]");
792 r = s_update_ref(msg, ref, 0);
793 format_display(display, r ? '!' : '*', what,
794 r ? _("unable to update local ref") : NULL,
795 remote, pretty_ref, summary_width);
796 return r;
799 if (fetch_show_forced_updates) {
800 uint64_t t_before = getnanotime();
801 fast_forward = in_merge_bases(current, updated);
802 forced_updates_ms += (getnanotime() - t_before) / 1000000;
803 } else {
804 fast_forward = 1;
807 if (fast_forward) {
808 struct strbuf quickref = STRBUF_INIT;
809 int r;
811 strbuf_add_unique_abbrev(&quickref, &current->object.oid, DEFAULT_ABBREV);
812 strbuf_addstr(&quickref, "..");
813 strbuf_add_unique_abbrev(&quickref, &ref->new_oid, DEFAULT_ABBREV);
814 r = s_update_ref("fast-forward", ref, 1);
815 format_display(display, r ? '!' : ' ', quickref.buf,
816 r ? _("unable to update local ref") : NULL,
817 remote, pretty_ref, summary_width);
818 strbuf_release(&quickref);
819 return r;
820 } else if (force || ref->force) {
821 struct strbuf quickref = STRBUF_INIT;
822 int r;
823 strbuf_add_unique_abbrev(&quickref, &current->object.oid, DEFAULT_ABBREV);
824 strbuf_addstr(&quickref, "...");
825 strbuf_add_unique_abbrev(&quickref, &ref->new_oid, DEFAULT_ABBREV);
826 r = s_update_ref("forced-update", ref, 1);
827 format_display(display, r ? '!' : '+', quickref.buf,
828 r ? _("unable to update local ref") : _("forced update"),
829 remote, pretty_ref, summary_width);
830 strbuf_release(&quickref);
831 return r;
832 } else {
833 format_display(display, '!', _("[rejected]"), _("non-fast-forward"),
834 remote, pretty_ref, summary_width);
835 return 1;
839 static int iterate_ref_map(void *cb_data, struct object_id *oid)
841 struct ref **rm = cb_data;
842 struct ref *ref = *rm;
844 while (ref && ref->status == REF_STATUS_REJECT_SHALLOW)
845 ref = ref->next;
846 if (!ref)
847 return -1; /* end of the list */
848 *rm = ref->next;
849 oidcpy(oid, &ref->old_oid);
850 return 0;
853 static const char warn_show_forced_updates[] =
854 N_("Fetch normally indicates which branches had a forced update,\n"
855 "but that check has been disabled. To re-enable, use '--show-forced-updates'\n"
856 "flag or run 'git config fetch.showForcedUpdates true'.");
857 static const char warn_time_show_forced_updates[] =
858 N_("It took %.2f seconds to check forced updates. You can use\n"
859 "'--no-show-forced-updates' or run 'git config fetch.showForcedUpdates false'\n"
860 " to avoid this check.\n");
862 static int store_updated_refs(const char *raw_url, const char *remote_name,
863 int connectivity_checked, struct ref *ref_map)
865 FILE *fp;
866 struct commit *commit;
867 int url_len, i, rc = 0;
868 struct strbuf note = STRBUF_INIT;
869 const char *what, *kind;
870 struct ref *rm;
871 char *url;
872 const char *filename = dry_run ? "/dev/null" : git_path_fetch_head(the_repository);
873 int want_status;
874 int summary_width = transport_summary_width(ref_map);
876 fp = fopen(filename, "a");
877 if (!fp)
878 return error_errno(_("cannot open %s"), filename);
880 if (raw_url)
881 url = transport_anonymize_url(raw_url);
882 else
883 url = xstrdup("foreign");
885 if (!connectivity_checked) {
886 rm = ref_map;
887 if (check_connected(iterate_ref_map, &rm, NULL)) {
888 rc = error(_("%s did not send all necessary objects\n"), url);
889 goto abort;
893 prepare_format_display(ref_map);
896 * We do a pass for each fetch_head_status type in their enum order, so
897 * merged entries are written before not-for-merge. That lets readers
898 * use FETCH_HEAD as a refname to refer to the ref to be merged.
900 for (want_status = FETCH_HEAD_MERGE;
901 want_status <= FETCH_HEAD_IGNORE;
902 want_status++) {
903 for (rm = ref_map; rm; rm = rm->next) {
904 struct ref *ref = NULL;
905 const char *merge_status_marker = "";
907 if (rm->status == REF_STATUS_REJECT_SHALLOW) {
908 if (want_status == FETCH_HEAD_MERGE)
909 warning(_("reject %s because shallow roots are not allowed to be updated"),
910 rm->peer_ref ? rm->peer_ref->name : rm->name);
911 continue;
914 commit = lookup_commit_reference_gently(the_repository,
915 &rm->old_oid,
917 if (!commit)
918 rm->fetch_head_status = FETCH_HEAD_NOT_FOR_MERGE;
920 if (rm->fetch_head_status != want_status)
921 continue;
923 if (rm->peer_ref) {
924 ref = alloc_ref(rm->peer_ref->name);
925 oidcpy(&ref->old_oid, &rm->peer_ref->old_oid);
926 oidcpy(&ref->new_oid, &rm->old_oid);
927 ref->force = rm->peer_ref->force;
930 if (recurse_submodules != RECURSE_SUBMODULES_OFF)
931 check_for_new_submodule_commits(&rm->old_oid);
933 if (!strcmp(rm->name, "HEAD")) {
934 kind = "";
935 what = "";
937 else if (starts_with(rm->name, "refs/heads/")) {
938 kind = "branch";
939 what = rm->name + 11;
941 else if (starts_with(rm->name, "refs/tags/")) {
942 kind = "tag";
943 what = rm->name + 10;
945 else if (starts_with(rm->name, "refs/remotes/")) {
946 kind = "remote-tracking branch";
947 what = rm->name + 13;
949 else {
950 kind = "";
951 what = rm->name;
954 url_len = strlen(url);
955 for (i = url_len - 1; url[i] == '/' && 0 <= i; i--)
957 url_len = i + 1;
958 if (4 < i && !strncmp(".git", url + i - 3, 4))
959 url_len = i - 3;
961 strbuf_reset(&note);
962 if (*what) {
963 if (*kind)
964 strbuf_addf(&note, "%s ", kind);
965 strbuf_addf(&note, "'%s' of ", what);
967 switch (rm->fetch_head_status) {
968 case FETCH_HEAD_NOT_FOR_MERGE:
969 merge_status_marker = "not-for-merge";
970 /* fall-through */
971 case FETCH_HEAD_MERGE:
972 fprintf(fp, "%s\t%s\t%s",
973 oid_to_hex(&rm->old_oid),
974 merge_status_marker,
975 note.buf);
976 for (i = 0; i < url_len; ++i)
977 if ('\n' == url[i])
978 fputs("\\n", fp);
979 else
980 fputc(url[i], fp);
981 fputc('\n', fp);
982 break;
983 default:
984 /* do not write anything to FETCH_HEAD */
985 break;
988 strbuf_reset(&note);
989 if (ref) {
990 rc |= update_local_ref(ref, what, rm, &note,
991 summary_width);
992 free(ref);
993 } else
994 format_display(&note, '*',
995 *kind ? kind : "branch", NULL,
996 *what ? what : "HEAD",
997 "FETCH_HEAD", summary_width);
998 if (note.len) {
999 if (verbosity >= 0 && !shown_url) {
1000 fprintf(stderr, _("From %.*s\n"),
1001 url_len, url);
1002 shown_url = 1;
1004 if (verbosity >= 0)
1005 fprintf(stderr, " %s\n", note.buf);
1010 if (rc & STORE_REF_ERROR_DF_CONFLICT)
1011 error(_("some local refs could not be updated; try running\n"
1012 " 'git remote prune %s' to remove any old, conflicting "
1013 "branches"), remote_name);
1015 if (advice_fetch_show_forced_updates) {
1016 if (!fetch_show_forced_updates) {
1017 warning(_(warn_show_forced_updates));
1018 } else if (forced_updates_ms > FORCED_UPDATES_DELAY_WARNING_IN_MS) {
1019 warning(_(warn_time_show_forced_updates),
1020 forced_updates_ms / 1000.0);
1024 abort:
1025 strbuf_release(&note);
1026 free(url);
1027 fclose(fp);
1028 return rc;
1032 * We would want to bypass the object transfer altogether if
1033 * everything we are going to fetch already exists and is connected
1034 * locally.
1036 static int check_exist_and_connected(struct ref *ref_map)
1038 struct ref *rm = ref_map;
1039 struct check_connected_options opt = CHECK_CONNECTED_INIT;
1040 struct ref *r;
1043 * If we are deepening a shallow clone we already have these
1044 * objects reachable. Running rev-list here will return with
1045 * a good (0) exit status and we'll bypass the fetch that we
1046 * really need to perform. Claiming failure now will ensure
1047 * we perform the network exchange to deepen our history.
1049 if (deepen)
1050 return -1;
1053 * check_connected() allows objects to merely be promised, but
1054 * we need all direct targets to exist.
1056 for (r = rm; r; r = r->next) {
1057 if (!has_object_file(&r->old_oid))
1058 return -1;
1061 opt.quiet = 1;
1062 return check_connected(iterate_ref_map, &rm, &opt);
1065 static int fetch_refs(struct transport *transport, struct ref *ref_map)
1067 int ret = check_exist_and_connected(ref_map);
1068 if (ret)
1069 ret = transport_fetch_refs(transport, ref_map);
1070 if (!ret)
1072 * Keep the new pack's ".keep" file around to allow the caller
1073 * time to update refs to reference the new objects.
1075 return 0;
1076 transport_unlock_pack(transport);
1077 return ret;
1080 /* Update local refs based on the ref values fetched from a remote */
1081 static int consume_refs(struct transport *transport, struct ref *ref_map)
1083 int connectivity_checked = transport->smart_options
1084 ? transport->smart_options->connectivity_checked : 0;
1085 int ret = store_updated_refs(transport->url,
1086 transport->remote->name,
1087 connectivity_checked,
1088 ref_map);
1089 transport_unlock_pack(transport);
1090 return ret;
1093 static int prune_refs(struct refspec *rs, struct ref *ref_map,
1094 const char *raw_url)
1096 int url_len, i, result = 0;
1097 struct ref *ref, *stale_refs = get_stale_heads(rs, ref_map);
1098 char *url;
1099 int summary_width = transport_summary_width(stale_refs);
1100 const char *dangling_msg = dry_run
1101 ? _(" (%s will become dangling)")
1102 : _(" (%s has become dangling)");
1104 if (raw_url)
1105 url = transport_anonymize_url(raw_url);
1106 else
1107 url = xstrdup("foreign");
1109 url_len = strlen(url);
1110 for (i = url_len - 1; url[i] == '/' && 0 <= i; i--)
1113 url_len = i + 1;
1114 if (4 < i && !strncmp(".git", url + i - 3, 4))
1115 url_len = i - 3;
1117 if (!dry_run) {
1118 struct string_list refnames = STRING_LIST_INIT_NODUP;
1120 for (ref = stale_refs; ref; ref = ref->next)
1121 string_list_append(&refnames, ref->name);
1123 result = delete_refs("fetch: prune", &refnames, 0);
1124 string_list_clear(&refnames, 0);
1127 if (verbosity >= 0) {
1128 for (ref = stale_refs; ref; ref = ref->next) {
1129 struct strbuf sb = STRBUF_INIT;
1130 if (!shown_url) {
1131 fprintf(stderr, _("From %.*s\n"), url_len, url);
1132 shown_url = 1;
1134 format_display(&sb, '-', _("[deleted]"), NULL,
1135 _("(none)"), prettify_refname(ref->name),
1136 summary_width);
1137 fprintf(stderr, " %s\n",sb.buf);
1138 strbuf_release(&sb);
1139 warn_dangling_symref(stderr, dangling_msg, ref->name);
1143 free(url);
1144 free_refs(stale_refs);
1145 return result;
1148 static void check_not_current_branch(struct ref *ref_map)
1150 struct branch *current_branch = branch_get(NULL);
1152 if (is_bare_repository() || !current_branch)
1153 return;
1155 for (; ref_map; ref_map = ref_map->next)
1156 if (ref_map->peer_ref && !strcmp(current_branch->refname,
1157 ref_map->peer_ref->name))
1158 die(_("Refusing to fetch into current branch %s "
1159 "of non-bare repository"), current_branch->refname);
1162 static int truncate_fetch_head(void)
1164 const char *filename = git_path_fetch_head(the_repository);
1165 FILE *fp = fopen_for_writing(filename);
1167 if (!fp)
1168 return error_errno(_("cannot open %s"), filename);
1169 fclose(fp);
1170 return 0;
1173 static void set_option(struct transport *transport, const char *name, const char *value)
1175 int r = transport_set_option(transport, name, value);
1176 if (r < 0)
1177 die(_("Option \"%s\" value \"%s\" is not valid for %s"),
1178 name, value, transport->url);
1179 if (r > 0)
1180 warning(_("Option \"%s\" is ignored for %s\n"),
1181 name, transport->url);
1185 static int add_oid(const char *refname, const struct object_id *oid, int flags,
1186 void *cb_data)
1188 struct oid_array *oids = cb_data;
1190 oid_array_append(oids, oid);
1191 return 0;
1194 static void add_negotiation_tips(struct git_transport_options *smart_options)
1196 struct oid_array *oids = xcalloc(1, sizeof(*oids));
1197 int i;
1199 for (i = 0; i < negotiation_tip.nr; i++) {
1200 const char *s = negotiation_tip.items[i].string;
1201 int old_nr;
1202 if (!has_glob_specials(s)) {
1203 struct object_id oid;
1204 if (get_oid(s, &oid))
1205 die("%s is not a valid object", s);
1206 oid_array_append(oids, &oid);
1207 continue;
1209 old_nr = oids->nr;
1210 for_each_glob_ref(add_oid, s, oids);
1211 if (old_nr == oids->nr)
1212 warning("Ignoring --negotiation-tip=%s because it does not match any refs",
1215 smart_options->negotiation_tips = oids;
1218 static struct transport *prepare_transport(struct remote *remote, int deepen)
1220 struct transport *transport;
1222 transport = transport_get(remote, NULL);
1223 transport_set_verbosity(transport, verbosity, progress);
1224 transport->family = family;
1225 if (upload_pack)
1226 set_option(transport, TRANS_OPT_UPLOADPACK, upload_pack);
1227 if (keep)
1228 set_option(transport, TRANS_OPT_KEEP, "yes");
1229 if (depth)
1230 set_option(transport, TRANS_OPT_DEPTH, depth);
1231 if (deepen && deepen_since)
1232 set_option(transport, TRANS_OPT_DEEPEN_SINCE, deepen_since);
1233 if (deepen && deepen_not.nr)
1234 set_option(transport, TRANS_OPT_DEEPEN_NOT,
1235 (const char *)&deepen_not);
1236 if (deepen_relative)
1237 set_option(transport, TRANS_OPT_DEEPEN_RELATIVE, "yes");
1238 if (update_shallow)
1239 set_option(transport, TRANS_OPT_UPDATE_SHALLOW, "yes");
1240 if (filter_options.choice) {
1241 struct strbuf expanded_filter_spec = STRBUF_INIT;
1242 expand_list_objects_filter_spec(&filter_options,
1243 &expanded_filter_spec);
1244 set_option(transport, TRANS_OPT_LIST_OBJECTS_FILTER,
1245 expanded_filter_spec.buf);
1246 set_option(transport, TRANS_OPT_FROM_PROMISOR, "1");
1247 strbuf_release(&expanded_filter_spec);
1249 if (negotiation_tip.nr) {
1250 if (transport->smart_options)
1251 add_negotiation_tips(transport->smart_options);
1252 else
1253 warning("Ignoring --negotiation-tip because the protocol does not support it.");
1255 return transport;
1258 static void backfill_tags(struct transport *transport, struct ref *ref_map)
1260 int cannot_reuse;
1263 * Once we have set TRANS_OPT_DEEPEN_SINCE, we can't unset it
1264 * when remote helper is used (setting it to an empty string
1265 * is not unsetting). We could extend the remote helper
1266 * protocol for that, but for now, just force a new connection
1267 * without deepen-since. Similar story for deepen-not.
1269 cannot_reuse = transport->cannot_reuse ||
1270 deepen_since || deepen_not.nr;
1271 if (cannot_reuse) {
1272 gsecondary = prepare_transport(transport->remote, 0);
1273 transport = gsecondary;
1276 transport_set_option(transport, TRANS_OPT_FOLLOWTAGS, NULL);
1277 transport_set_option(transport, TRANS_OPT_DEPTH, "0");
1278 transport_set_option(transport, TRANS_OPT_DEEPEN_RELATIVE, NULL);
1279 if (!fetch_refs(transport, ref_map))
1280 consume_refs(transport, ref_map);
1282 if (gsecondary) {
1283 transport_disconnect(gsecondary);
1284 gsecondary = NULL;
1288 static int do_fetch(struct transport *transport,
1289 struct refspec *rs)
1291 struct ref *ref_map;
1292 int autotags = (transport->remote->fetch_tags == 1);
1293 int retcode = 0;
1294 const struct ref *remote_refs;
1295 struct argv_array ref_prefixes = ARGV_ARRAY_INIT;
1296 int must_list_refs = 1;
1298 if (tags == TAGS_DEFAULT) {
1299 if (transport->remote->fetch_tags == 2)
1300 tags = TAGS_SET;
1301 if (transport->remote->fetch_tags == -1)
1302 tags = TAGS_UNSET;
1305 /* if not appending, truncate FETCH_HEAD */
1306 if (!append && !dry_run) {
1307 retcode = truncate_fetch_head();
1308 if (retcode)
1309 goto cleanup;
1312 if (rs->nr) {
1313 int i;
1315 refspec_ref_prefixes(rs, &ref_prefixes);
1318 * We can avoid listing refs if all of them are exact
1319 * OIDs
1321 must_list_refs = 0;
1322 for (i = 0; i < rs->nr; i++) {
1323 if (!rs->items[i].exact_sha1) {
1324 must_list_refs = 1;
1325 break;
1328 } else if (transport->remote && transport->remote->fetch.nr)
1329 refspec_ref_prefixes(&transport->remote->fetch, &ref_prefixes);
1331 if (tags == TAGS_SET || tags == TAGS_DEFAULT) {
1332 must_list_refs = 1;
1333 if (ref_prefixes.argc)
1334 argv_array_push(&ref_prefixes, "refs/tags/");
1337 if (must_list_refs)
1338 remote_refs = transport_get_remote_refs(transport, &ref_prefixes);
1339 else
1340 remote_refs = NULL;
1342 argv_array_clear(&ref_prefixes);
1344 ref_map = get_ref_map(transport->remote, remote_refs, rs,
1345 tags, &autotags);
1346 if (!update_head_ok)
1347 check_not_current_branch(ref_map);
1349 if (tags == TAGS_DEFAULT && autotags)
1350 transport_set_option(transport, TRANS_OPT_FOLLOWTAGS, "1");
1351 if (prune) {
1353 * We only prune based on refspecs specified
1354 * explicitly (via command line or configuration); we
1355 * don't care whether --tags was specified.
1357 if (rs->nr) {
1358 prune_refs(rs, ref_map, transport->url);
1359 } else {
1360 prune_refs(&transport->remote->fetch,
1361 ref_map,
1362 transport->url);
1365 if (fetch_refs(transport, ref_map) || consume_refs(transport, ref_map)) {
1366 free_refs(ref_map);
1367 retcode = 1;
1368 goto cleanup;
1370 free_refs(ref_map);
1372 /* if neither --no-tags nor --tags was specified, do automated tag
1373 * following ... */
1374 if (tags == TAGS_DEFAULT && autotags) {
1375 struct ref **tail = &ref_map;
1376 ref_map = NULL;
1377 find_non_local_tags(remote_refs, &ref_map, &tail);
1378 if (ref_map)
1379 backfill_tags(transport, ref_map);
1380 free_refs(ref_map);
1383 cleanup:
1384 return retcode;
1387 static int get_one_remote_for_fetch(struct remote *remote, void *priv)
1389 struct string_list *list = priv;
1390 if (!remote->skip_default_update)
1391 string_list_append(list, remote->name);
1392 return 0;
1395 struct remote_group_data {
1396 const char *name;
1397 struct string_list *list;
1400 static int get_remote_group(const char *key, const char *value, void *priv)
1402 struct remote_group_data *g = priv;
1404 if (skip_prefix(key, "remotes.", &key) && !strcmp(key, g->name)) {
1405 /* split list by white space */
1406 while (*value) {
1407 size_t wordlen = strcspn(value, " \t\n");
1409 if (wordlen >= 1)
1410 string_list_append_nodup(g->list,
1411 xstrndup(value, wordlen));
1412 value += wordlen + (value[wordlen] != '\0');
1416 return 0;
1419 static int add_remote_or_group(const char *name, struct string_list *list)
1421 int prev_nr = list->nr;
1422 struct remote_group_data g;
1423 g.name = name; g.list = list;
1425 git_config(get_remote_group, &g);
1426 if (list->nr == prev_nr) {
1427 struct remote *remote = remote_get(name);
1428 if (!remote_is_configured(remote, 0))
1429 return 0;
1430 string_list_append(list, remote->name);
1432 return 1;
1435 static void add_options_to_argv(struct argv_array *argv)
1437 if (dry_run)
1438 argv_array_push(argv, "--dry-run");
1439 if (prune != -1)
1440 argv_array_push(argv, prune ? "--prune" : "--no-prune");
1441 if (prune_tags != -1)
1442 argv_array_push(argv, prune_tags ? "--prune-tags" : "--no-prune-tags");
1443 if (update_head_ok)
1444 argv_array_push(argv, "--update-head-ok");
1445 if (force)
1446 argv_array_push(argv, "--force");
1447 if (keep)
1448 argv_array_push(argv, "--keep");
1449 if (recurse_submodules == RECURSE_SUBMODULES_ON)
1450 argv_array_push(argv, "--recurse-submodules");
1451 else if (recurse_submodules == RECURSE_SUBMODULES_ON_DEMAND)
1452 argv_array_push(argv, "--recurse-submodules=on-demand");
1453 if (tags == TAGS_SET)
1454 argv_array_push(argv, "--tags");
1455 else if (tags == TAGS_UNSET)
1456 argv_array_push(argv, "--no-tags");
1457 if (verbosity >= 2)
1458 argv_array_push(argv, "-v");
1459 if (verbosity >= 1)
1460 argv_array_push(argv, "-v");
1461 else if (verbosity < 0)
1462 argv_array_push(argv, "-q");
1466 static int fetch_multiple(struct string_list *list)
1468 int i, result = 0;
1469 struct argv_array argv = ARGV_ARRAY_INIT;
1471 if (!append && !dry_run) {
1472 int errcode = truncate_fetch_head();
1473 if (errcode)
1474 return errcode;
1477 argv_array_pushl(&argv, "fetch", "--append", "--no-auto-gc", NULL);
1478 add_options_to_argv(&argv);
1480 for (i = 0; i < list->nr; i++) {
1481 const char *name = list->items[i].string;
1482 argv_array_push(&argv, name);
1483 if (verbosity >= 0)
1484 printf(_("Fetching %s\n"), name);
1485 if (run_command_v_opt(argv.argv, RUN_GIT_CMD)) {
1486 error(_("Could not fetch %s"), name);
1487 result = 1;
1489 argv_array_pop(&argv);
1492 argv_array_clear(&argv);
1493 return result;
1497 * Fetching from the promisor remote should use the given filter-spec
1498 * or inherit the default filter-spec from the config.
1500 static inline void fetch_one_setup_partial(struct remote *remote)
1503 * Explicit --no-filter argument overrides everything, regardless
1504 * of any prior partial clones and fetches.
1506 if (filter_options.no_filter)
1507 return;
1510 * If no prior partial clone/fetch and the current fetch DID NOT
1511 * request a partial-fetch, do a normal fetch.
1513 if (!repository_format_partial_clone && !filter_options.choice)
1514 return;
1517 * If this is the FIRST partial-fetch request, we enable partial
1518 * on this repo and remember the given filter-spec as the default
1519 * for subsequent fetches to this remote.
1521 if (!repository_format_partial_clone && filter_options.choice) {
1522 partial_clone_register(remote->name, &filter_options);
1523 return;
1527 * We are currently limited to only ONE promisor remote and only
1528 * allow partial-fetches from the promisor remote.
1530 if (strcmp(remote->name, repository_format_partial_clone)) {
1531 if (filter_options.choice)
1532 die(_("--filter can only be used with the remote "
1533 "configured in extensions.partialClone"));
1534 return;
1538 * Do a partial-fetch from the promisor remote using either the
1539 * explicitly given filter-spec or inherit the filter-spec from
1540 * the config.
1542 if (!filter_options.choice)
1543 partial_clone_get_default_filter_spec(&filter_options);
1544 return;
1547 static int fetch_one(struct remote *remote, int argc, const char **argv, int prune_tags_ok)
1549 struct refspec rs = REFSPEC_INIT_FETCH;
1550 int i;
1551 int exit_code;
1552 int maybe_prune_tags;
1553 int remote_via_config = remote_is_configured(remote, 0);
1555 if (!remote)
1556 die(_("No remote repository specified. Please, specify either a URL or a\n"
1557 "remote name from which new revisions should be fetched."));
1559 gtransport = prepare_transport(remote, 1);
1561 if (prune < 0) {
1562 /* no command line request */
1563 if (0 <= remote->prune)
1564 prune = remote->prune;
1565 else if (0 <= fetch_prune_config)
1566 prune = fetch_prune_config;
1567 else
1568 prune = PRUNE_BY_DEFAULT;
1571 if (prune_tags < 0) {
1572 /* no command line request */
1573 if (0 <= remote->prune_tags)
1574 prune_tags = remote->prune_tags;
1575 else if (0 <= fetch_prune_tags_config)
1576 prune_tags = fetch_prune_tags_config;
1577 else
1578 prune_tags = PRUNE_TAGS_BY_DEFAULT;
1581 maybe_prune_tags = prune_tags_ok && prune_tags;
1582 if (maybe_prune_tags && remote_via_config)
1583 refspec_append(&remote->fetch, TAG_REFSPEC);
1585 if (maybe_prune_tags && (argc || !remote_via_config))
1586 refspec_append(&rs, TAG_REFSPEC);
1588 for (i = 0; i < argc; i++) {
1589 if (!strcmp(argv[i], "tag")) {
1590 char *tag;
1591 i++;
1592 if (i >= argc)
1593 die(_("You need to specify a tag name."));
1595 tag = xstrfmt("refs/tags/%s:refs/tags/%s",
1596 argv[i], argv[i]);
1597 refspec_append(&rs, tag);
1598 free(tag);
1599 } else {
1600 refspec_append(&rs, argv[i]);
1604 if (server_options.nr)
1605 gtransport->server_options = &server_options;
1607 sigchain_push_common(unlock_pack_on_signal);
1608 atexit(unlock_pack);
1609 sigchain_push(SIGPIPE, SIG_IGN);
1610 exit_code = do_fetch(gtransport, &rs);
1611 sigchain_pop(SIGPIPE);
1612 refspec_clear(&rs);
1613 transport_disconnect(gtransport);
1614 gtransport = NULL;
1615 return exit_code;
1618 int cmd_fetch(int argc, const char **argv, const char *prefix)
1620 int i;
1621 struct string_list list = STRING_LIST_INIT_DUP;
1622 struct remote *remote = NULL;
1623 int result = 0;
1624 int prune_tags_ok = 1;
1625 struct argv_array argv_gc_auto = ARGV_ARRAY_INIT;
1627 packet_trace_identity("fetch");
1629 fetch_if_missing = 0;
1631 /* Record the command line for the reflog */
1632 strbuf_addstr(&default_rla, "fetch");
1633 for (i = 1; i < argc; i++)
1634 strbuf_addf(&default_rla, " %s", argv[i]);
1636 fetch_config_from_gitmodules(&max_children, &recurse_submodules);
1637 git_config(git_fetch_config, NULL);
1639 argc = parse_options(argc, argv, prefix,
1640 builtin_fetch_options, builtin_fetch_usage, 0);
1642 if (deepen_relative) {
1643 if (deepen_relative < 0)
1644 die(_("Negative depth in --deepen is not supported"));
1645 if (depth)
1646 die(_("--deepen and --depth are mutually exclusive"));
1647 depth = xstrfmt("%d", deepen_relative);
1649 if (unshallow) {
1650 if (depth)
1651 die(_("--depth and --unshallow cannot be used together"));
1652 else if (!is_repository_shallow(the_repository))
1653 die(_("--unshallow on a complete repository does not make sense"));
1654 else
1655 depth = xstrfmt("%d", INFINITE_DEPTH);
1658 /* no need to be strict, transport_set_option() will validate it again */
1659 if (depth && atoi(depth) < 1)
1660 die(_("depth %s is not a positive number"), depth);
1661 if (depth || deepen_since || deepen_not.nr)
1662 deepen = 1;
1664 if (filter_options.choice && !repository_format_partial_clone)
1665 die("--filter can only be used when extensions.partialClone is set");
1667 if (all) {
1668 if (argc == 1)
1669 die(_("fetch --all does not take a repository argument"));
1670 else if (argc > 1)
1671 die(_("fetch --all does not make sense with refspecs"));
1672 (void) for_each_remote(get_one_remote_for_fetch, &list);
1673 } else if (argc == 0) {
1674 /* No arguments -- use default remote */
1675 remote = remote_get(NULL);
1676 } else if (multiple) {
1677 /* All arguments are assumed to be remotes or groups */
1678 for (i = 0; i < argc; i++)
1679 if (!add_remote_or_group(argv[i], &list))
1680 die(_("No such remote or remote group: %s"), argv[i]);
1681 } else {
1682 /* Single remote or group */
1683 (void) add_remote_or_group(argv[0], &list);
1684 if (list.nr > 1) {
1685 /* More than one remote */
1686 if (argc > 1)
1687 die(_("Fetching a group and specifying refspecs does not make sense"));
1688 } else {
1689 /* Zero or one remotes */
1690 remote = remote_get(argv[0]);
1691 prune_tags_ok = (argc == 1);
1692 argc--;
1693 argv++;
1697 if (remote) {
1698 if (filter_options.choice || repository_format_partial_clone)
1699 fetch_one_setup_partial(remote);
1700 result = fetch_one(remote, argc, argv, prune_tags_ok);
1701 } else {
1702 if (filter_options.choice)
1703 die(_("--filter can only be used with the remote "
1704 "configured in extensions.partialclone"));
1705 /* TODO should this also die if we have a previous partial-clone? */
1706 result = fetch_multiple(&list);
1709 if (!result && (recurse_submodules != RECURSE_SUBMODULES_OFF)) {
1710 struct argv_array options = ARGV_ARRAY_INIT;
1712 add_options_to_argv(&options);
1713 result = fetch_populated_submodules(the_repository,
1714 &options,
1715 submodule_prefix,
1716 recurse_submodules,
1717 recurse_submodules_default,
1718 verbosity < 0,
1719 max_children);
1720 argv_array_clear(&options);
1723 string_list_clear(&list, 0);
1725 close_object_store(the_repository->objects);
1727 if (enable_auto_gc) {
1728 argv_array_pushl(&argv_gc_auto, "gc", "--auto", NULL);
1729 if (verbosity < 0)
1730 argv_array_push(&argv_gc_auto, "--quiet");
1731 run_command_v_opt(argv_gc_auto.argv, RUN_GIT_CMD);
1732 argv_array_clear(&argv_gc_auto);
1735 return result;