2 #include "parse-options.h"
5 #include "string-list.h"
7 #include "run-command.h"
10 static const char * const builtin_remote_usage[] = {
11 "git remote [-v | --verbose]",
12 "git remote add [-t <branch>] [-m <master>] [-f] [--mirror] <name> <url>",
13 "git remote rename <old> <new>",
14 "git remote rm <name>",
15 "git remote set-head <name> (-a | -d | <branch>)",
16 "git remote [-v | --verbose] show [-n] <name>",
17 "git remote prune [-n | --dry-run] <name>",
18 "git remote [-v | --verbose] update [-p | --prune] [(<group> | <remote>)...]",
19 "git remote set-branches <name> [--add] <branch>...",
20 "git remote set-url <name> <newurl> [<oldurl>]",
21 "git remote set-url --add <name> <newurl>",
22 "git remote set-url --delete <name> <url>",
26 static const char * const builtin_remote_add_usage[] = {
27 "git remote add [<options>] <name> <url>",
31 static const char * const builtin_remote_rename_usage[] = {
32 "git remote rename <old> <new>",
36 static const char * const builtin_remote_rm_usage[] = {
37 "git remote rm <name>",
41 static const char * const builtin_remote_sethead_usage[] = {
42 "git remote set-head <name> (-a | -d | <branch>])",
46 static const char * const builtin_remote_setbranches_usage[] = {
47 "git remote set-branches <name> <branch>...",
48 "git remote set-branches --add <name> <branch>...",
52 static const char * const builtin_remote_show_usage[] = {
53 "git remote show [<options>] <name>",
57 static const char * const builtin_remote_prune_usage[] = {
58 "git remote prune [<options>] <name>",
62 static const char * const builtin_remote_update_usage[] = {
63 "git remote update [<options>] [<group> | <remote>]...",
67 static const char * const builtin_remote_seturl_usage[] = {
68 "git remote set-url [--push] <name> <newurl> [<oldurl>]",
69 "git remote set-url --add <name> <newurl>",
70 "git remote set-url --delete <name> <url>",
74 #define GET_REF_STATES (1<<0)
75 #define GET_HEAD_NAMES (1<<1)
76 #define GET_PUSH_REF_STATES (1<<2)
80 static int show_all(void);
81 static int prune_remote(const char *remote, int dry_run);
83 static inline int postfixcmp(const char *string, const char *postfix)
85 int len1 = strlen(string), len2 = strlen(postfix);
88 return strcmp(string + len1 - len2, postfix);
91 static int opt_parse_track(const struct option *opt, const char *arg, int not)
93 struct string_list *list = opt->value;
95 string_list_clear(list, 0);
97 string_list_append(list, arg);
101 static int fetch_remote(const char *name)
103 const char *argv[] = { "fetch", name, NULL, NULL };
108 printf("Updating %s\n", name);
109 if (run_command_v_opt(argv, RUN_GIT_CMD))
110 return error("Could not fetch %s", name);
120 static int add_branch(const char *key, const char *branchname,
121 const char *remotename, int mirror, struct strbuf *tmp)
124 strbuf_addch(tmp, '+');
126 strbuf_addf(tmp, "refs/%s:refs/%s",
127 branchname, branchname);
129 strbuf_addf(tmp, "refs/heads/%s:refs/remotes/%s/%s",
130 branchname, remotename, branchname);
131 return git_config_set_multivar(key, tmp->buf, "^$", 0);
134 static int add(int argc, const char **argv)
136 int fetch = 0, mirror = 0, fetch_tags = TAGS_DEFAULT;
137 struct string_list track = STRING_LIST_INIT_NODUP;
138 const char *master = NULL;
139 struct remote *remote;
140 struct strbuf buf = STRBUF_INIT, buf2 = STRBUF_INIT;
141 const char *name, *url;
144 struct option options[] = {
145 OPT_BOOLEAN('f', "fetch", &fetch, "fetch the remote branches"),
146 OPT_SET_INT(0, "tags", &fetch_tags,
147 "import all tags and associated objects when fetching",
149 OPT_SET_INT(0, NULL, &fetch_tags,
150 "or do not fetch any tag at all (--no-tags)", TAGS_UNSET),
151 OPT_CALLBACK('t', "track", &track, "branch",
152 "branch(es) to track", opt_parse_track),
153 OPT_STRING('m', "master", &master, "branch", "master branch"),
154 OPT_BOOLEAN(0, "mirror", &mirror, "no separate remotes"),
158 argc = parse_options(argc, argv, NULL, options, builtin_remote_add_usage,
162 usage_with_options(builtin_remote_add_usage, options);
164 if (mirror && master)
165 die("specifying a master branch makes no sense with --mirror");
166 if (mirror && track.nr)
167 die("specifying branches to track makes no sense with --mirror");
172 remote = remote_get(name);
173 if (remote && (remote->url_nr > 1 || strcmp(name, remote->url[0]) ||
174 remote->fetch_refspec_nr))
175 die("remote %s already exists.", name);
177 strbuf_addf(&buf2, "refs/heads/test:refs/remotes/%s/test", name);
178 if (!valid_fetch_refspec(buf2.buf))
179 die("'%s' is not a valid remote name", name);
181 strbuf_addf(&buf, "remote.%s.url", name);
182 if (git_config_set(buf.buf, url))
186 strbuf_addf(&buf, "remote.%s.fetch", name);
189 string_list_append(&track, "*");
190 for (i = 0; i < track.nr; i++) {
191 if (add_branch(buf.buf, track.items[i].string,
192 name, mirror, &buf2))
198 strbuf_addf(&buf, "remote.%s.mirror", name);
199 if (git_config_set(buf.buf, "true"))
203 if (fetch_tags != TAGS_DEFAULT) {
205 strbuf_addf(&buf, "remote.%s.tagopt", name);
206 if (git_config_set(buf.buf,
207 fetch_tags == TAGS_SET ? "--tags" : "--no-tags"))
211 if (fetch && fetch_remote(name))
216 strbuf_addf(&buf, "refs/remotes/%s/HEAD", name);
219 strbuf_addf(&buf2, "refs/remotes/%s/%s", name, master);
221 if (create_symref(buf.buf, buf2.buf, "remote add"))
222 return error("Could not setup master '%s'", master);
225 strbuf_release(&buf);
226 strbuf_release(&buf2);
227 string_list_clear(&track, 0);
234 struct string_list merge;
238 static struct string_list branch_list;
240 static const char *abbrev_ref(const char *name, const char *prefix)
242 const char *abbrev = skip_prefix(name, prefix);
247 #define abbrev_branch(name) abbrev_ref((name), "refs/heads/")
249 static int config_read_branches(const char *key, const char *value, void *cb)
251 if (!prefixcmp(key, "branch.")) {
252 const char *orig_key = key;
254 struct string_list_item *item;
255 struct branch_info *info;
256 enum { REMOTE, MERGE, REBASE } type;
259 if (!postfixcmp(key, ".remote")) {
260 name = xstrndup(key, strlen(key) - 7);
262 } else if (!postfixcmp(key, ".merge")) {
263 name = xstrndup(key, strlen(key) - 6);
265 } else if (!postfixcmp(key, ".rebase")) {
266 name = xstrndup(key, strlen(key) - 7);
271 item = string_list_insert(&branch_list, name);
274 item->util = xcalloc(sizeof(struct branch_info), 1);
276 if (type == REMOTE) {
277 if (info->remote_name)
278 warning("more than one %s", orig_key);
279 info->remote_name = xstrdup(value);
280 } else if (type == MERGE) {
281 char *space = strchr(value, ' ');
282 value = abbrev_branch(value);
285 merge = xstrndup(value, space - value);
286 string_list_append(&info->merge, merge);
287 value = abbrev_branch(space + 1);
288 space = strchr(value, ' ');
290 string_list_append(&info->merge, xstrdup(value));
292 info->rebase = git_config_bool(orig_key, value);
297 static void read_branches(void)
301 git_config(config_read_branches, NULL);
305 struct remote *remote;
306 struct string_list new, stale, tracked, heads, push;
310 static int get_ref_states(const struct ref *remote_refs, struct ref_states *states)
312 struct ref *fetch_map = NULL, **tail = &fetch_map;
313 struct ref *ref, *stale_refs;
316 for (i = 0; i < states->remote->fetch_refspec_nr; i++)
317 if (get_fetch_map(remote_refs, states->remote->fetch + i, &tail, 1))
318 die("Could not get fetch map for refspec %s",
319 states->remote->fetch_refspec[i]);
321 states->new.strdup_strings = 1;
322 states->tracked.strdup_strings = 1;
323 states->stale.strdup_strings = 1;
324 for (ref = fetch_map; ref; ref = ref->next) {
325 unsigned char sha1[20];
326 if (!ref->peer_ref || read_ref(ref->peer_ref->name, sha1))
327 string_list_append(&states->new, abbrev_branch(ref->name));
329 string_list_append(&states->tracked, abbrev_branch(ref->name));
331 stale_refs = get_stale_heads(states->remote, fetch_map);
332 for (ref = stale_refs; ref; ref = ref->next) {
333 struct string_list_item *item =
334 string_list_append(&states->stale, abbrev_branch(ref->name));
335 item->util = xstrdup(ref->name);
337 free_refs(stale_refs);
338 free_refs(fetch_map);
340 sort_string_list(&states->new);
341 sort_string_list(&states->tracked);
342 sort_string_list(&states->stale);
351 PUSH_STATUS_CREATE = 0,
353 PUSH_STATUS_UPTODATE,
354 PUSH_STATUS_FASTFORWARD,
355 PUSH_STATUS_OUTOFDATE,
356 PUSH_STATUS_NOTQUERIED
360 static int get_push_ref_states(const struct ref *remote_refs,
361 struct ref_states *states)
363 struct remote *remote = states->remote;
364 struct ref *ref, *local_refs, *push_map;
368 local_refs = get_local_heads();
369 push_map = copy_ref_list(remote_refs);
371 match_refs(local_refs, &push_map, remote->push_refspec_nr,
372 remote->push_refspec, MATCH_REFS_NONE);
374 states->push.strdup_strings = 1;
375 for (ref = push_map; ref; ref = ref->next) {
376 struct string_list_item *item;
377 struct push_info *info;
381 hashcpy(ref->new_sha1, ref->peer_ref->new_sha1);
383 item = string_list_append(&states->push,
384 abbrev_branch(ref->peer_ref->name));
385 item->util = xcalloc(sizeof(struct push_info), 1);
387 info->forced = ref->force;
388 info->dest = xstrdup(abbrev_branch(ref->name));
390 if (is_null_sha1(ref->new_sha1)) {
391 info->status = PUSH_STATUS_DELETE;
392 } else if (!hashcmp(ref->old_sha1, ref->new_sha1))
393 info->status = PUSH_STATUS_UPTODATE;
394 else if (is_null_sha1(ref->old_sha1))
395 info->status = PUSH_STATUS_CREATE;
396 else if (has_sha1_file(ref->old_sha1) &&
397 ref_newer(ref->new_sha1, ref->old_sha1))
398 info->status = PUSH_STATUS_FASTFORWARD;
400 info->status = PUSH_STATUS_OUTOFDATE;
402 free_refs(local_refs);
407 static int get_push_ref_states_noquery(struct ref_states *states)
410 struct remote *remote = states->remote;
411 struct string_list_item *item;
412 struct push_info *info;
417 states->push.strdup_strings = 1;
418 if (!remote->push_refspec_nr) {
419 item = string_list_append(&states->push, "(matching)");
420 info = item->util = xcalloc(sizeof(struct push_info), 1);
421 info->status = PUSH_STATUS_NOTQUERIED;
422 info->dest = xstrdup(item->string);
424 for (i = 0; i < remote->push_refspec_nr; i++) {
425 struct refspec *spec = remote->push + i;
427 item = string_list_append(&states->push, "(matching)");
428 else if (strlen(spec->src))
429 item = string_list_append(&states->push, spec->src);
431 item = string_list_append(&states->push, "(delete)");
433 info = item->util = xcalloc(sizeof(struct push_info), 1);
434 info->forced = spec->force;
435 info->status = PUSH_STATUS_NOTQUERIED;
436 info->dest = xstrdup(spec->dst ? spec->dst : item->string);
441 static int get_head_names(const struct ref *remote_refs, struct ref_states *states)
443 struct ref *ref, *matches;
444 struct ref *fetch_map = NULL, **fetch_map_tail = &fetch_map;
445 struct refspec refspec;
449 refspec.src = refspec.dst = "refs/heads/*";
450 states->heads.strdup_strings = 1;
451 get_fetch_map(remote_refs, &refspec, &fetch_map_tail, 0);
452 matches = guess_remote_head(find_ref_by_name(remote_refs, "HEAD"),
454 for (ref = matches; ref; ref = ref->next)
455 string_list_append(&states->heads, abbrev_branch(ref->name));
457 free_refs(fetch_map);
463 struct known_remote {
464 struct known_remote *next;
465 struct remote *remote;
468 struct known_remotes {
469 struct remote *to_delete;
470 struct known_remote *list;
473 static int add_known_remote(struct remote *remote, void *cb_data)
475 struct known_remotes *all = cb_data;
476 struct known_remote *r;
478 if (!strcmp(all->to_delete->name, remote->name))
481 r = xmalloc(sizeof(*r));
488 struct branches_for_remote {
489 struct remote *remote;
490 struct string_list *branches, *skipped;
491 struct known_remotes *keep;
494 static int add_branch_for_removal(const char *refname,
495 const unsigned char *sha1, int flags, void *cb_data)
497 struct branches_for_remote *branches = cb_data;
498 struct refspec refspec;
499 struct string_list_item *item;
500 struct known_remote *kr;
502 memset(&refspec, 0, sizeof(refspec));
503 refspec.dst = (char *)refname;
504 if (remote_find_tracking(branches->remote, &refspec))
507 /* don't delete a branch if another remote also uses it */
508 for (kr = branches->keep->list; kr; kr = kr->next) {
509 memset(&refspec, 0, sizeof(refspec));
510 refspec.dst = (char *)refname;
511 if (!remote_find_tracking(kr->remote, &refspec))
515 /* don't delete non-remote-tracking refs */
516 if (prefixcmp(refname, "refs/remotes")) {
517 /* advise user how to delete local branches */
518 if (!prefixcmp(refname, "refs/heads/"))
519 string_list_append(branches->skipped,
520 abbrev_branch(refname));
521 /* silently skip over other non-remote refs */
525 /* make sure that symrefs are deleted */
526 if (flags & REF_ISSYMREF)
527 return unlink(git_path("%s", refname));
529 item = string_list_append(branches->branches, refname);
530 item->util = xmalloc(20);
531 hashcpy(item->util, sha1);
539 struct string_list *remote_branches;
542 static int read_remote_branches(const char *refname,
543 const unsigned char *sha1, int flags, void *cb_data)
545 struct rename_info *rename = cb_data;
546 struct strbuf buf = STRBUF_INIT;
547 struct string_list_item *item;
549 unsigned char orig_sha1[20];
552 strbuf_addf(&buf, "refs/remotes/%s", rename->old);
553 if (!prefixcmp(refname, buf.buf)) {
554 item = string_list_append(rename->remote_branches, xstrdup(refname));
555 symref = resolve_ref(refname, orig_sha1, 1, &flag);
556 if (flag & REF_ISSYMREF)
557 item->util = xstrdup(symref);
565 static int migrate_file(struct remote *remote)
567 struct strbuf buf = STRBUF_INIT;
571 strbuf_addf(&buf, "remote.%s.url", remote->name);
572 for (i = 0; i < remote->url_nr; i++)
573 if (git_config_set_multivar(buf.buf, remote->url[i], "^$", 0))
574 return error("Could not append '%s' to '%s'",
575 remote->url[i], buf.buf);
577 strbuf_addf(&buf, "remote.%s.push", remote->name);
578 for (i = 0; i < remote->push_refspec_nr; i++)
579 if (git_config_set_multivar(buf.buf, remote->push_refspec[i], "^$", 0))
580 return error("Could not append '%s' to '%s'",
581 remote->push_refspec[i], buf.buf);
583 strbuf_addf(&buf, "remote.%s.fetch", remote->name);
584 for (i = 0; i < remote->fetch_refspec_nr; i++)
585 if (git_config_set_multivar(buf.buf, remote->fetch_refspec[i], "^$", 0))
586 return error("Could not append '%s' to '%s'",
587 remote->fetch_refspec[i], buf.buf);
588 if (remote->origin == REMOTE_REMOTES)
589 path = git_path("remotes/%s", remote->name);
590 else if (remote->origin == REMOTE_BRANCHES)
591 path = git_path("branches/%s", remote->name);
593 unlink_or_warn(path);
597 static int mv(int argc, const char **argv)
599 struct option options[] = {
602 struct remote *oldremote, *newremote;
603 struct strbuf buf = STRBUF_INIT, buf2 = STRBUF_INIT, buf3 = STRBUF_INIT;
604 struct string_list remote_branches = STRING_LIST_INIT_NODUP;
605 struct rename_info rename;
609 usage_with_options(builtin_remote_rename_usage, options);
611 rename.old = argv[1];
612 rename.new = argv[2];
613 rename.remote_branches = &remote_branches;
615 oldremote = remote_get(rename.old);
617 die("No such remote: %s", rename.old);
619 if (!strcmp(rename.old, rename.new) && oldremote->origin != REMOTE_CONFIG)
620 return migrate_file(oldremote);
622 newremote = remote_get(rename.new);
623 if (newremote && (newremote->url_nr > 1 || newremote->fetch_refspec_nr))
624 die("remote %s already exists.", rename.new);
626 strbuf_addf(&buf, "refs/heads/test:refs/remotes/%s/test", rename.new);
627 if (!valid_fetch_refspec(buf.buf))
628 die("'%s' is not a valid remote name", rename.new);
631 strbuf_addf(&buf, "remote.%s", rename.old);
632 strbuf_addf(&buf2, "remote.%s", rename.new);
633 if (git_config_rename_section(buf.buf, buf2.buf) < 1)
634 return error("Could not rename config section '%s' to '%s'",
638 strbuf_addf(&buf, "remote.%s.fetch", rename.new);
639 if (git_config_set_multivar(buf.buf, NULL, NULL, 1))
640 return error("Could not remove config section '%s'", buf.buf);
641 for (i = 0; i < oldremote->fetch_refspec_nr; i++) {
645 strbuf_addstr(&buf2, oldremote->fetch_refspec[i]);
646 ptr = strstr(buf2.buf, rename.old);
648 strbuf_splice(&buf2, ptr-buf2.buf, strlen(rename.old),
649 rename.new, strlen(rename.new));
650 if (git_config_set_multivar(buf.buf, buf2.buf, "^$", 0))
651 return error("Could not append '%s'", buf.buf);
655 for (i = 0; i < branch_list.nr; i++) {
656 struct string_list_item *item = branch_list.items + i;
657 struct branch_info *info = item->util;
658 if (info->remote_name && !strcmp(info->remote_name, rename.old)) {
660 strbuf_addf(&buf, "branch.%s.remote", item->string);
661 if (git_config_set(buf.buf, rename.new)) {
662 return error("Could not set '%s'", buf.buf);
668 * First remove symrefs, then rename the rest, finally create
671 for_each_ref(read_remote_branches, &rename);
672 for (i = 0; i < remote_branches.nr; i++) {
673 struct string_list_item *item = remote_branches.items + i;
675 unsigned char sha1[20];
677 resolve_ref(item->string, sha1, 1, &flag);
678 if (!(flag & REF_ISSYMREF))
680 if (delete_ref(item->string, NULL, REF_NODEREF))
681 die("deleting '%s' failed", item->string);
683 for (i = 0; i < remote_branches.nr; i++) {
684 struct string_list_item *item = remote_branches.items + i;
689 strbuf_addstr(&buf, item->string);
690 strbuf_splice(&buf, strlen("refs/remotes/"), strlen(rename.old),
691 rename.new, strlen(rename.new));
693 strbuf_addf(&buf2, "remote: renamed %s to %s",
694 item->string, buf.buf);
695 if (rename_ref(item->string, buf.buf, buf2.buf))
696 die("renaming '%s' failed", item->string);
698 for (i = 0; i < remote_branches.nr; i++) {
699 struct string_list_item *item = remote_branches.items + i;
704 strbuf_addstr(&buf, item->string);
705 strbuf_splice(&buf, strlen("refs/remotes/"), strlen(rename.old),
706 rename.new, strlen(rename.new));
708 strbuf_addstr(&buf2, item->util);
709 strbuf_splice(&buf2, strlen("refs/remotes/"), strlen(rename.old),
710 rename.new, strlen(rename.new));
712 strbuf_addf(&buf3, "remote: renamed %s to %s",
713 item->string, buf.buf);
714 if (create_symref(buf.buf, buf2.buf, buf3.buf))
715 die("creating '%s' failed", buf.buf);
720 static int remove_branches(struct string_list *branches)
723 for (i = 0; i < branches->nr; i++) {
724 struct string_list_item *item = branches->items + i;
725 const char *refname = item->string;
726 unsigned char *sha1 = item->util;
728 if (delete_ref(refname, sha1, 0))
729 result |= error("Could not remove branch %s", refname);
734 static int rm(int argc, const char **argv)
736 struct option options[] = {
739 struct remote *remote;
740 struct strbuf buf = STRBUF_INIT;
741 struct known_remotes known_remotes = { NULL, NULL };
742 struct string_list branches = STRING_LIST_INIT_DUP;
743 struct string_list skipped = STRING_LIST_INIT_DUP;
744 struct branches_for_remote cb_data;
747 memset(&cb_data, 0, sizeof(cb_data));
748 cb_data.branches = &branches;
749 cb_data.skipped = &skipped;
750 cb_data.keep = &known_remotes;
753 usage_with_options(builtin_remote_rm_usage, options);
755 remote = remote_get(argv[1]);
757 die("No such remote: %s", argv[1]);
759 known_remotes.to_delete = remote;
760 for_each_remote(add_known_remote, &known_remotes);
762 strbuf_addf(&buf, "remote.%s", remote->name);
763 if (git_config_rename_section(buf.buf, NULL) < 1)
764 return error("Could not remove config section '%s'", buf.buf);
767 for (i = 0; i < branch_list.nr; i++) {
768 struct string_list_item *item = branch_list.items + i;
769 struct branch_info *info = item->util;
770 if (info->remote_name && !strcmp(info->remote_name, remote->name)) {
771 const char *keys[] = { "remote", "merge", NULL }, **k;
772 for (k = keys; *k; k++) {
774 strbuf_addf(&buf, "branch.%s.%s",
776 if (git_config_set(buf.buf, NULL)) {
777 strbuf_release(&buf);
785 * We cannot just pass a function to for_each_ref() which deletes
786 * the branches one by one, since for_each_ref() relies on cached
787 * refs, which are invalidated when deleting a branch.
789 cb_data.remote = remote;
790 result = for_each_ref(add_branch_for_removal, &cb_data);
791 strbuf_release(&buf);
794 result = remove_branches(&branches);
795 string_list_clear(&branches, 1);
798 fprintf(stderr, skipped.nr == 1 ?
799 "Note: A branch outside the refs/remotes/ hierarchy was not removed;\n"
800 "to delete it, use:\n" :
801 "Note: Some branches outside the refs/remotes/ hierarchy were not removed;\n"
802 "to delete them, use:\n");
803 for (i = 0; i < skipped.nr; i++)
804 fprintf(stderr, " git branch -d %s\n",
805 skipped.items[i].string);
807 string_list_clear(&skipped, 0);
812 static void clear_push_info(void *util, const char *string)
814 struct push_info *info = util;
819 static void free_remote_ref_states(struct ref_states *states)
821 string_list_clear(&states->new, 0);
822 string_list_clear(&states->stale, 1);
823 string_list_clear(&states->tracked, 0);
824 string_list_clear(&states->heads, 0);
825 string_list_clear_func(&states->push, clear_push_info);
828 static int append_ref_to_tracked_list(const char *refname,
829 const unsigned char *sha1, int flags, void *cb_data)
831 struct ref_states *states = cb_data;
832 struct refspec refspec;
834 if (flags & REF_ISSYMREF)
837 memset(&refspec, 0, sizeof(refspec));
838 refspec.dst = (char *)refname;
839 if (!remote_find_tracking(states->remote, &refspec))
840 string_list_append(&states->tracked, abbrev_branch(refspec.src));
845 static int get_remote_ref_states(const char *name,
846 struct ref_states *states,
849 struct transport *transport;
850 const struct ref *remote_refs;
852 states->remote = remote_get(name);
854 return error("No such remote: %s", name);
859 transport = transport_get(states->remote, states->remote->url_nr > 0 ?
860 states->remote->url[0] : NULL);
861 remote_refs = transport_get_remote_refs(transport);
862 transport_disconnect(transport);
865 if (query & GET_REF_STATES)
866 get_ref_states(remote_refs, states);
867 if (query & GET_HEAD_NAMES)
868 get_head_names(remote_refs, states);
869 if (query & GET_PUSH_REF_STATES)
870 get_push_ref_states(remote_refs, states);
872 for_each_ref(append_ref_to_tracked_list, states);
873 sort_string_list(&states->tracked);
874 get_push_ref_states_noquery(states);
881 struct string_list *list;
882 struct ref_states *states;
887 static int add_remote_to_show_info(struct string_list_item *item, void *cb_data)
889 struct show_info *info = cb_data;
890 int n = strlen(item->string);
893 string_list_insert(info->list, item->string);
897 static int show_remote_info_item(struct string_list_item *item, void *cb_data)
899 struct show_info *info = cb_data;
900 struct ref_states *states = info->states;
901 const char *name = item->string;
903 if (states->queried) {
904 const char *fmt = "%s";
905 const char *arg = "";
906 if (string_list_has_string(&states->new, name)) {
907 fmt = " new (next fetch will store in remotes/%s)";
908 arg = states->remote->name;
909 } else if (string_list_has_string(&states->tracked, name))
911 else if (string_list_has_string(&states->stale, name))
912 arg = " stale (use 'git remote prune' to remove)";
915 printf(" %-*s", info->width, name);
919 printf(" %s\n", name);
924 static int add_local_to_show_info(struct string_list_item *branch_item, void *cb_data)
926 struct show_info *show_info = cb_data;
927 struct ref_states *states = show_info->states;
928 struct branch_info *branch_info = branch_item->util;
929 struct string_list_item *item;
932 if (!branch_info->merge.nr || !branch_info->remote_name ||
933 strcmp(states->remote->name, branch_info->remote_name))
935 if ((n = strlen(branch_item->string)) > show_info->width)
936 show_info->width = n;
937 if (branch_info->rebase)
938 show_info->any_rebase = 1;
940 item = string_list_insert(show_info->list, branch_item->string);
941 item->util = branch_info;
946 static int show_local_info_item(struct string_list_item *item, void *cb_data)
948 struct show_info *show_info = cb_data;
949 struct branch_info *branch_info = item->util;
950 struct string_list *merge = &branch_info->merge;
954 if (branch_info->rebase && branch_info->merge.nr > 1) {
955 error("invalid branch.%s.merge; cannot rebase onto > 1 branch",
960 printf(" %-*s ", show_info->width, item->string);
961 if (branch_info->rebase) {
962 printf("rebases onto remote %s\n", merge->items[0].string);
964 } else if (show_info->any_rebase) {
965 printf(" merges with remote %s\n", merge->items[0].string);
966 also = " and with remote";
968 printf("merges with remote %s\n", merge->items[0].string);
969 also = " and with remote";
971 for (i = 1; i < merge->nr; i++)
972 printf(" %-*s %s %s\n", show_info->width, "", also,
973 merge->items[i].string);
978 static int add_push_to_show_info(struct string_list_item *push_item, void *cb_data)
980 struct show_info *show_info = cb_data;
981 struct push_info *push_info = push_item->util;
982 struct string_list_item *item;
984 if ((n = strlen(push_item->string)) > show_info->width)
985 show_info->width = n;
986 if ((n = strlen(push_info->dest)) > show_info->width2)
987 show_info->width2 = n;
988 item = string_list_append(show_info->list, push_item->string);
989 item->util = push_item->util;
994 * Sorting comparison for a string list that has push_info
995 * structs in its util field
997 static int cmp_string_with_push(const void *va, const void *vb)
999 const struct string_list_item *a = va;
1000 const struct string_list_item *b = vb;
1001 const struct push_info *a_push = a->util;
1002 const struct push_info *b_push = b->util;
1003 int cmp = strcmp(a->string, b->string);
1004 return cmp ? cmp : strcmp(a_push->dest, b_push->dest);
1007 static int show_push_info_item(struct string_list_item *item, void *cb_data)
1009 struct show_info *show_info = cb_data;
1010 struct push_info *push_info = item->util;
1011 char *src = item->string, *status = NULL;
1013 switch (push_info->status) {
1014 case PUSH_STATUS_CREATE:
1017 case PUSH_STATUS_DELETE:
1021 case PUSH_STATUS_UPTODATE:
1022 status = "up to date";
1024 case PUSH_STATUS_FASTFORWARD:
1025 status = "fast-forwardable";
1027 case PUSH_STATUS_OUTOFDATE:
1028 status = "local out of date";
1030 case PUSH_STATUS_NOTQUERIED:
1034 printf(" %-*s %s to %-*s (%s)\n", show_info->width, src,
1035 push_info->forced ? "forces" : "pushes",
1036 show_info->width2, push_info->dest, status);
1038 printf(" %-*s %s to %s\n", show_info->width, src,
1039 push_info->forced ? "forces" : "pushes",
1044 static int show(int argc, const char **argv)
1046 int no_query = 0, result = 0, query_flag = 0;
1047 struct option options[] = {
1048 OPT_BOOLEAN('n', NULL, &no_query, "do not query remotes"),
1051 struct ref_states states;
1052 struct string_list info_list = STRING_LIST_INIT_NODUP;
1053 struct show_info info;
1055 argc = parse_options(argc, argv, NULL, options, builtin_remote_show_usage,
1062 query_flag = (GET_REF_STATES | GET_HEAD_NAMES | GET_PUSH_REF_STATES);
1064 memset(&states, 0, sizeof(states));
1065 memset(&info, 0, sizeof(info));
1066 info.states = &states;
1067 info.list = &info_list;
1068 for (; argc; argc--, argv++) {
1073 get_remote_ref_states(*argv, &states, query_flag);
1075 printf("* remote %s\n", *argv);
1076 printf(" Fetch URL: %s\n", states.remote->url_nr > 0 ?
1077 states.remote->url[0] : "(no URL)");
1078 if (states.remote->pushurl_nr) {
1079 url = states.remote->pushurl;
1080 url_nr = states.remote->pushurl_nr;
1082 url = states.remote->url;
1083 url_nr = states.remote->url_nr;
1085 for (i=0; i < url_nr; i++)
1086 printf(" Push URL: %s\n", url[i]);
1088 printf(" Push URL: %s\n", "(no URL)");
1090 printf(" HEAD branch: (not queried)\n");
1091 else if (!states.heads.nr)
1092 printf(" HEAD branch: (unknown)\n");
1093 else if (states.heads.nr == 1)
1094 printf(" HEAD branch: %s\n", states.heads.items[0].string);
1096 printf(" HEAD branch (remote HEAD is ambiguous,"
1097 " may be one of the following):\n");
1098 for (i = 0; i < states.heads.nr; i++)
1099 printf(" %s\n", states.heads.items[i].string);
1102 /* remote branch info */
1104 for_each_string_list(&states.new, add_remote_to_show_info, &info);
1105 for_each_string_list(&states.tracked, add_remote_to_show_info, &info);
1106 for_each_string_list(&states.stale, add_remote_to_show_info, &info);
1108 printf(" Remote branch%s:%s\n",
1109 info.list->nr > 1 ? "es" : "",
1110 no_query ? " (status not queried)" : "");
1111 for_each_string_list(info.list, show_remote_info_item, &info);
1112 string_list_clear(info.list, 0);
1116 info.any_rebase = 0;
1117 for_each_string_list(&branch_list, add_local_to_show_info, &info);
1119 printf(" Local branch%s configured for 'git pull':\n",
1120 info.list->nr > 1 ? "es" : "");
1121 for_each_string_list(info.list, show_local_info_item, &info);
1122 string_list_clear(info.list, 0);
1125 if (states.remote->mirror)
1126 printf(" Local refs will be mirrored by 'git push'\n");
1128 info.width = info.width2 = 0;
1129 for_each_string_list(&states.push, add_push_to_show_info, &info);
1130 qsort(info.list->items, info.list->nr,
1131 sizeof(*info.list->items), cmp_string_with_push);
1133 printf(" Local ref%s configured for 'git push'%s:\n",
1134 info.list->nr > 1 ? "s" : "",
1135 no_query ? " (status not queried)" : "");
1136 for_each_string_list(info.list, show_push_info_item, &info);
1137 string_list_clear(info.list, 0);
1139 free_remote_ref_states(&states);
1145 static int set_head(int argc, const char **argv)
1147 int i, opt_a = 0, opt_d = 0, result = 0;
1148 struct strbuf buf = STRBUF_INIT, buf2 = STRBUF_INIT;
1149 char *head_name = NULL;
1151 struct option options[] = {
1152 OPT_BOOLEAN('a', "auto", &opt_a,
1153 "set refs/remotes/<name>/HEAD according to remote"),
1154 OPT_BOOLEAN('d', "delete", &opt_d,
1155 "delete refs/remotes/<name>/HEAD"),
1158 argc = parse_options(argc, argv, NULL, options, builtin_remote_sethead_usage,
1161 strbuf_addf(&buf, "refs/remotes/%s/HEAD", argv[0]);
1163 if (!opt_a && !opt_d && argc == 2) {
1164 head_name = xstrdup(argv[1]);
1165 } else if (opt_a && !opt_d && argc == 1) {
1166 struct ref_states states;
1167 memset(&states, 0, sizeof(states));
1168 get_remote_ref_states(argv[0], &states, GET_HEAD_NAMES);
1169 if (!states.heads.nr)
1170 result |= error("Cannot determine remote HEAD");
1171 else if (states.heads.nr > 1) {
1172 result |= error("Multiple remote HEAD branches. "
1173 "Please choose one explicitly with:");
1174 for (i = 0; i < states.heads.nr; i++)
1175 fprintf(stderr, " git remote set-head %s %s\n",
1176 argv[0], states.heads.items[i].string);
1178 head_name = xstrdup(states.heads.items[0].string);
1179 free_remote_ref_states(&states);
1180 } else if (opt_d && !opt_a && argc == 1) {
1181 if (delete_ref(buf.buf, NULL, REF_NODEREF))
1182 result |= error("Could not delete %s", buf.buf);
1184 usage_with_options(builtin_remote_sethead_usage, options);
1187 unsigned char sha1[20];
1188 strbuf_addf(&buf2, "refs/remotes/%s/%s", argv[0], head_name);
1189 /* make sure it's valid */
1190 if (!resolve_ref(buf2.buf, sha1, 1, NULL))
1191 result |= error("Not a valid ref: %s", buf2.buf);
1192 else if (create_symref(buf.buf, buf2.buf, "remote set-head"))
1193 result |= error("Could not setup %s", buf.buf);
1195 printf("%s/HEAD set to %s\n", argv[0], head_name);
1199 strbuf_release(&buf);
1200 strbuf_release(&buf2);
1204 static int prune(int argc, const char **argv)
1206 int dry_run = 0, result = 0;
1207 struct option options[] = {
1208 OPT__DRY_RUN(&dry_run, "dry run"),
1212 argc = parse_options(argc, argv, NULL, options, builtin_remote_prune_usage,
1216 usage_with_options(builtin_remote_prune_usage, options);
1218 for (; argc; argc--, argv++)
1219 result |= prune_remote(*argv, dry_run);
1224 static int prune_remote(const char *remote, int dry_run)
1227 struct ref_states states;
1228 const char *dangling_msg = dry_run
1229 ? " %s will become dangling!\n"
1230 : " %s has become dangling!\n";
1232 memset(&states, 0, sizeof(states));
1233 get_remote_ref_states(remote, &states, GET_REF_STATES);
1235 if (states.stale.nr) {
1236 printf("Pruning %s\n", remote);
1238 states.remote->url_nr
1239 ? states.remote->url[0]
1243 for (i = 0; i < states.stale.nr; i++) {
1244 const char *refname = states.stale.items[i].util;
1247 result |= delete_ref(refname, NULL, 0);
1249 printf(" * [%s] %s\n", dry_run ? "would prune" : "pruned",
1250 abbrev_ref(refname, "refs/remotes/"));
1251 warn_dangling_symref(stdout, dangling_msg, refname);
1254 free_remote_ref_states(&states);
1258 static int get_remote_default(const char *key, const char *value, void *priv)
1260 if (strcmp(key, "remotes.default") == 0) {
1267 static int update(int argc, const char **argv)
1270 struct option options[] = {
1271 OPT_BOOLEAN('p', "prune", &prune,
1272 "prune remotes after fetching"),
1275 const char **fetch_argv;
1277 int default_defined = 0;
1279 fetch_argv = xmalloc(sizeof(char *) * (argc+5));
1281 argc = parse_options(argc, argv, NULL, options, builtin_remote_update_usage,
1282 PARSE_OPT_KEEP_ARGV0);
1284 fetch_argv[fetch_argc++] = "fetch";
1287 fetch_argv[fetch_argc++] = "--prune";
1289 fetch_argv[fetch_argc++] = "-v";
1290 fetch_argv[fetch_argc++] = "--multiple";
1292 fetch_argv[fetch_argc++] = "default";
1293 for (i = 1; i < argc; i++)
1294 fetch_argv[fetch_argc++] = argv[i];
1296 if (strcmp(fetch_argv[fetch_argc-1], "default") == 0) {
1297 git_config(get_remote_default, &default_defined);
1298 if (!default_defined)
1299 fetch_argv[fetch_argc-1] = "--all";
1302 fetch_argv[fetch_argc] = NULL;
1304 return run_command_v_opt(fetch_argv, RUN_GIT_CMD);
1307 static int remove_all_fetch_refspecs(const char *remote, const char *key)
1309 return git_config_set_multivar(key, NULL, NULL, 1);
1312 static int add_branches(struct remote *remote, const char **branches,
1315 const char *remotename = remote->name;
1316 int mirror = remote->mirror;
1317 struct strbuf refspec = STRBUF_INIT;
1319 for (; *branches; branches++)
1320 if (add_branch(key, *branches, remotename, mirror, &refspec)) {
1321 strbuf_release(&refspec);
1325 strbuf_release(&refspec);
1329 static int set_remote_branches(const char *remotename, const char **branches,
1332 struct strbuf key = STRBUF_INIT;
1333 struct remote *remote;
1335 strbuf_addf(&key, "remote.%s.fetch", remotename);
1337 if (!remote_is_configured(remotename))
1338 die("No such remote '%s'", remotename);
1339 remote = remote_get(remotename);
1341 if (!add_mode && remove_all_fetch_refspecs(remotename, key.buf)) {
1342 strbuf_release(&key);
1345 if (add_branches(remote, branches, key.buf)) {
1346 strbuf_release(&key);
1350 strbuf_release(&key);
1354 static int set_branches(int argc, const char **argv)
1357 struct option options[] = {
1358 OPT_BOOLEAN('\0', "add", &add_mode, "add branch"),
1362 argc = parse_options(argc, argv, NULL, options,
1363 builtin_remote_setbranches_usage, 0);
1365 error("no remote specified");
1366 usage_with_options(builtin_remote_seturl_usage, options);
1370 return set_remote_branches(argv[0], argv + 1, add_mode);
1373 static int set_url(int argc, const char **argv)
1375 int i, push_mode = 0, add_mode = 0, delete_mode = 0;
1376 int matches = 0, negative_matches = 0;
1377 const char *remotename = NULL;
1378 const char *newurl = NULL;
1379 const char *oldurl = NULL;
1380 struct remote *remote;
1382 const char **urlset;
1384 struct strbuf name_buf = STRBUF_INIT;
1385 struct option options[] = {
1386 OPT_BOOLEAN('\0', "push", &push_mode,
1387 "manipulate push URLs"),
1388 OPT_BOOLEAN('\0', "add", &add_mode,
1390 OPT_BOOLEAN('\0', "delete", &delete_mode,
1394 argc = parse_options(argc, argv, NULL, options, builtin_remote_update_usage,
1395 PARSE_OPT_KEEP_ARGV0);
1397 if (add_mode && delete_mode)
1398 die("--add --delete doesn't make sense");
1400 if (argc < 3 || argc > 4 || ((add_mode || delete_mode) && argc != 3))
1401 usage_with_options(builtin_remote_seturl_usage, options);
1403 remotename = argv[1];
1411 if (!remote_is_configured(remotename))
1412 die("No such remote '%s'", remotename);
1413 remote = remote_get(remotename);
1416 strbuf_addf(&name_buf, "remote.%s.pushurl", remotename);
1417 urlset = remote->pushurl;
1418 urlset_nr = remote->pushurl_nr;
1420 strbuf_addf(&name_buf, "remote.%s.url", remotename);
1421 urlset = remote->url;
1422 urlset_nr = remote->url_nr;
1425 /* Special cases that add new entry. */
1426 if ((!oldurl && !delete_mode) || add_mode) {
1428 git_config_set_multivar(name_buf.buf, newurl,
1431 git_config_set(name_buf.buf, newurl);
1432 strbuf_release(&name_buf);
1436 /* Old URL specified. Demand that one matches. */
1437 if (regcomp(&old_regex, oldurl, REG_EXTENDED))
1438 die("Invalid old URL pattern: %s", oldurl);
1440 for (i = 0; i < urlset_nr; i++)
1441 if (!regexec(&old_regex, urlset[i], 0, NULL, 0))
1445 if (!delete_mode && !matches)
1446 die("No such URL found: %s", oldurl);
1447 if (delete_mode && !negative_matches && !push_mode)
1448 die("Will not delete all non-push URLs");
1450 regfree(&old_regex);
1453 git_config_set_multivar(name_buf.buf, newurl, oldurl, 0);
1455 git_config_set_multivar(name_buf.buf, NULL, oldurl, 1);
1459 static int get_one_entry(struct remote *remote, void *priv)
1461 struct string_list *list = priv;
1462 struct strbuf url_buf = STRBUF_INIT;
1466 if (remote->url_nr > 0) {
1467 strbuf_addf(&url_buf, "%s (fetch)", remote->url[0]);
1468 string_list_append(list, remote->name)->util =
1469 strbuf_detach(&url_buf, NULL);
1471 string_list_append(list, remote->name)->util = NULL;
1472 if (remote->pushurl_nr) {
1473 url = remote->pushurl;
1474 url_nr = remote->pushurl_nr;
1477 url_nr = remote->url_nr;
1479 for (i = 0; i < url_nr; i++)
1481 strbuf_addf(&url_buf, "%s (push)", url[i]);
1482 string_list_append(list, remote->name)->util =
1483 strbuf_detach(&url_buf, NULL);
1489 static int show_all(void)
1491 struct string_list list = STRING_LIST_INIT_NODUP;
1494 list.strdup_strings = 1;
1495 result = for_each_remote(get_one_entry, &list);
1500 sort_string_list(&list);
1501 for (i = 0; i < list.nr; i++) {
1502 struct string_list_item *item = list.items + i;
1504 printf("%s\t%s\n", item->string,
1505 item->util ? (const char *)item->util : "");
1507 if (i && !strcmp((item - 1)->string, item->string))
1509 printf("%s\n", item->string);
1513 string_list_clear(&list, 1);
1517 int cmd_remote(int argc, const char **argv, const char *prefix)
1519 struct option options[] = {
1520 OPT__VERBOSE(&verbose, "be verbose; must be placed before a subcommand"),
1525 argc = parse_options(argc, argv, prefix, options, builtin_remote_usage,
1526 PARSE_OPT_STOP_AT_NON_OPTION);
1529 result = show_all();
1530 else if (!strcmp(argv[0], "add"))
1531 result = add(argc, argv);
1532 else if (!strcmp(argv[0], "rename"))
1533 result = mv(argc, argv);
1534 else if (!strcmp(argv[0], "rm"))
1535 result = rm(argc, argv);
1536 else if (!strcmp(argv[0], "set-head"))
1537 result = set_head(argc, argv);
1538 else if (!strcmp(argv[0], "set-branches"))
1539 result = set_branches(argc, argv);
1540 else if (!strcmp(argv[0], "set-url"))
1541 result = set_url(argc, argv);
1542 else if (!strcmp(argv[0], "show"))
1543 result = show(argc, argv);
1544 else if (!strcmp(argv[0], "prune"))
1545 result = prune(argc, argv);
1546 else if (!strcmp(argv[0], "update"))
1547 result = update(argc, argv);
1549 error("Unknown subcommand: %s", argv[0]);
1550 usage_with_options(builtin_remote_usage, options);
1553 return result ? 1 : 0;