2 #include "parse-options.h"
5 #include "string-list.h"
7 #include "run-command.h"
9 #include "argv-array.h"
11 static const char * const builtin_remote_usage[] = {
12 N_("git remote [-v | --verbose]"),
13 N_("git remote add [-t <branch>] [-m <master>] [-f] [--tags|--no-tags] [--mirror=<fetch|push>] <name> <url>"),
14 N_("git remote rename <old> <new>"),
15 N_("git remote remove <name>"),
16 N_("git remote set-head <name> (-a | --auto | -d | --delete |<branch>)"),
17 N_("git remote [-v | --verbose] show [-n] <name>"),
18 N_("git remote prune [-n | --dry-run] <name>"),
19 N_("git remote [-v | --verbose] update [-p | --prune] [(<group> | <remote>)...]"),
20 N_("git remote set-branches [--add] <name> <branch>..."),
21 N_("git remote set-url [--push] <name> <newurl> [<oldurl>]"),
22 N_("git remote set-url --add <name> <newurl>"),
23 N_("git remote set-url --delete <name> <url>"),
27 static const char * const builtin_remote_add_usage[] = {
28 N_("git remote add [<options>] <name> <url>"),
32 static const char * const builtin_remote_rename_usage[] = {
33 N_("git remote rename <old> <new>"),
37 static const char * const builtin_remote_rm_usage[] = {
38 N_("git remote remove <name>"),
42 static const char * const builtin_remote_sethead_usage[] = {
43 N_("git remote set-head <name> (-a | --auto | -d | --delete | <branch>)"),
47 static const char * const builtin_remote_setbranches_usage[] = {
48 N_("git remote set-branches <name> <branch>..."),
49 N_("git remote set-branches --add <name> <branch>..."),
53 static const char * const builtin_remote_show_usage[] = {
54 N_("git remote show [<options>] <name>"),
58 static const char * const builtin_remote_prune_usage[] = {
59 N_("git remote prune [<options>] <name>"),
63 static const char * const builtin_remote_update_usage[] = {
64 N_("git remote update [<options>] [<group> | <remote>]..."),
68 static const char * const builtin_remote_seturl_usage[] = {
69 N_("git remote set-url [--push] <name> <newurl> [<oldurl>]"),
70 N_("git remote set-url --add <name> <newurl>"),
71 N_("git remote set-url --delete <name> <url>"),
75 #define GET_REF_STATES (1<<0)
76 #define GET_HEAD_NAMES (1<<1)
77 #define GET_PUSH_REF_STATES (1<<2)
81 static int fetch_remote(const char *name)
83 const char *argv[] = { "fetch", name, NULL, NULL };
88 printf_ln(_("Updating %s"), name);
89 if (run_command_v_opt(argv, RUN_GIT_CMD))
90 return error(_("Could not fetch %s"), name);
100 #define MIRROR_NONE 0
101 #define MIRROR_FETCH 1
102 #define MIRROR_PUSH 2
103 #define MIRROR_BOTH (MIRROR_FETCH|MIRROR_PUSH)
105 static int add_branch(const char *key, const char *branchname,
106 const char *remotename, int mirror, struct strbuf *tmp)
109 strbuf_addch(tmp, '+');
111 strbuf_addf(tmp, "refs/%s:refs/%s",
112 branchname, branchname);
114 strbuf_addf(tmp, "refs/heads/%s:refs/remotes/%s/%s",
115 branchname, remotename, branchname);
116 return git_config_set_multivar(key, tmp->buf, "^$", 0);
119 static const char mirror_advice[] =
120 N_("--mirror is dangerous and deprecated; please\n"
121 "\t use --mirror=fetch or --mirror=push instead");
123 static int parse_mirror_opt(const struct option *opt, const char *arg, int not)
125 unsigned *mirror = opt->value;
127 *mirror = MIRROR_NONE;
129 warning("%s", _(mirror_advice));
130 *mirror = MIRROR_BOTH;
132 else if (!strcmp(arg, "fetch"))
133 *mirror = MIRROR_FETCH;
134 else if (!strcmp(arg, "push"))
135 *mirror = MIRROR_PUSH;
137 return error(_("unknown mirror argument: %s"), arg);
141 static int add(int argc, const char **argv)
143 int fetch = 0, fetch_tags = TAGS_DEFAULT;
144 unsigned mirror = MIRROR_NONE;
145 struct string_list track = STRING_LIST_INIT_NODUP;
146 const char *master = NULL;
147 struct remote *remote;
148 struct strbuf buf = STRBUF_INIT, buf2 = STRBUF_INIT;
149 const char *name, *url;
152 struct option options[] = {
153 OPT_BOOL('f', "fetch", &fetch, N_("fetch the remote branches")),
154 OPT_SET_INT(0, "tags", &fetch_tags,
155 N_("import all tags and associated objects when fetching"),
157 OPT_SET_INT(0, NULL, &fetch_tags,
158 N_("or do not fetch any tag at all (--no-tags)"), TAGS_UNSET),
159 OPT_STRING_LIST('t', "track", &track, N_("branch"),
160 N_("branch(es) to track")),
161 OPT_STRING('m', "master", &master, N_("branch"), N_("master branch")),
162 { OPTION_CALLBACK, 0, "mirror", &mirror, N_("push|fetch"),
163 N_("set up remote as a mirror to push to or fetch from"),
164 PARSE_OPT_OPTARG, parse_mirror_opt },
168 argc = parse_options(argc, argv, NULL, options, builtin_remote_add_usage,
172 usage_with_options(builtin_remote_add_usage, options);
174 if (mirror && master)
175 die(_("specifying a master branch makes no sense with --mirror"));
176 if (mirror && !(mirror & MIRROR_FETCH) && track.nr)
177 die(_("specifying branches to track makes sense only with fetch mirrors"));
182 remote = remote_get(name);
183 if (remote && (remote->url_nr > 1 || strcmp(name, remote->url[0]) ||
184 remote->fetch_refspec_nr))
185 die(_("remote %s already exists."), name);
187 strbuf_addf(&buf2, "refs/heads/test:refs/remotes/%s/test", name);
188 if (!valid_fetch_refspec(buf2.buf))
189 die(_("'%s' is not a valid remote name"), name);
191 strbuf_addf(&buf, "remote.%s.url", name);
192 if (git_config_set(buf.buf, url))
195 if (!mirror || mirror & MIRROR_FETCH) {
197 strbuf_addf(&buf, "remote.%s.fetch", name);
199 string_list_append(&track, "*");
200 for (i = 0; i < track.nr; i++) {
201 if (add_branch(buf.buf, track.items[i].string,
202 name, mirror, &buf2))
207 if (mirror & MIRROR_PUSH) {
209 strbuf_addf(&buf, "remote.%s.mirror", name);
210 if (git_config_set(buf.buf, "true"))
214 if (fetch_tags != TAGS_DEFAULT) {
216 strbuf_addf(&buf, "remote.%s.tagopt", name);
217 if (git_config_set(buf.buf,
218 fetch_tags == TAGS_SET ? "--tags" : "--no-tags"))
222 if (fetch && fetch_remote(name))
227 strbuf_addf(&buf, "refs/remotes/%s/HEAD", name);
230 strbuf_addf(&buf2, "refs/remotes/%s/%s", name, master);
232 if (create_symref(buf.buf, buf2.buf, "remote add"))
233 return error(_("Could not setup master '%s'"), master);
236 strbuf_release(&buf);
237 strbuf_release(&buf2);
238 string_list_clear(&track, 0);
245 struct string_list merge;
249 static struct string_list branch_list;
251 static const char *abbrev_ref(const char *name, const char *prefix)
253 const char *abbrev = skip_prefix(name, prefix);
258 #define abbrev_branch(name) abbrev_ref((name), "refs/heads/")
260 static int config_read_branches(const char *key, const char *value, void *cb)
262 if (starts_with(key, "branch.")) {
263 const char *orig_key = key;
265 struct string_list_item *item;
266 struct branch_info *info;
267 enum { REMOTE, MERGE, REBASE, PULLMODE } type;
270 if (ends_with(key, ".remote")) {
271 name = xstrndup(key, strlen(key) - 7);
273 } else if (ends_with(key, ".merge")) {
274 name = xstrndup(key, strlen(key) - 6);
276 } else if (ends_with(key, ".rebase")) {
277 name = xstrndup(key, strlen(key) - 7);
279 } else if (ends_with(key, ".pullmode")) {
280 name = xstrndup(key, strlen(key) - 9);
285 item = string_list_insert(&branch_list, name);
288 item->util = xcalloc(sizeof(struct branch_info), 1);
290 if (type == REMOTE) {
291 if (info->remote_name)
292 warning(_("more than one %s"), orig_key);
293 info->remote_name = xstrdup(value);
294 } else if (type == MERGE) {
295 char *space = strchr(value, ' ');
296 value = abbrev_branch(value);
299 merge = xstrndup(value, space - value);
300 string_list_append(&info->merge, merge);
301 value = abbrev_branch(space + 1);
302 space = strchr(value, ' ');
304 string_list_append(&info->merge, xstrdup(value));
305 } else if (type == REBASE) {
306 int v = git_config_maybe_bool(orig_key, value);
309 else if (!strcmp(value, "preserve"))
312 if (!strcmp(value, "rebase"))
314 else if (!strcmp(value, "merge"))
316 else if (!strcmp(value, "rebase-preserve"))
323 static void read_branches(void)
327 git_config(config_read_branches, NULL);
331 struct remote *remote;
332 struct string_list new, stale, tracked, heads, push;
336 static int get_ref_states(const struct ref *remote_refs, struct ref_states *states)
338 struct ref *fetch_map = NULL, **tail = &fetch_map;
339 struct ref *ref, *stale_refs;
342 for (i = 0; i < states->remote->fetch_refspec_nr; i++)
343 if (get_fetch_map(remote_refs, states->remote->fetch + i, &tail, 1))
344 die(_("Could not get fetch map for refspec %s"),
345 states->remote->fetch_refspec[i]);
347 states->new.strdup_strings = 1;
348 states->tracked.strdup_strings = 1;
349 states->stale.strdup_strings = 1;
350 for (ref = fetch_map; ref; ref = ref->next) {
351 if (!ref->peer_ref || !ref_exists(ref->peer_ref->name))
352 string_list_append(&states->new, abbrev_branch(ref->name));
354 string_list_append(&states->tracked, abbrev_branch(ref->name));
356 stale_refs = get_stale_heads(states->remote->fetch,
357 states->remote->fetch_refspec_nr, fetch_map);
358 for (ref = stale_refs; ref; ref = ref->next) {
359 struct string_list_item *item =
360 string_list_append(&states->stale, abbrev_branch(ref->name));
361 item->util = xstrdup(ref->name);
363 free_refs(stale_refs);
364 free_refs(fetch_map);
366 sort_string_list(&states->new);
367 sort_string_list(&states->tracked);
368 sort_string_list(&states->stale);
377 PUSH_STATUS_CREATE = 0,
379 PUSH_STATUS_UPTODATE,
380 PUSH_STATUS_FASTFORWARD,
381 PUSH_STATUS_OUTOFDATE,
382 PUSH_STATUS_NOTQUERIED
386 static int get_push_ref_states(const struct ref *remote_refs,
387 struct ref_states *states)
389 struct remote *remote = states->remote;
390 struct ref *ref, *local_refs, *push_map;
394 local_refs = get_local_heads();
395 push_map = copy_ref_list(remote_refs);
397 match_push_refs(local_refs, &push_map, remote->push_refspec_nr,
398 remote->push_refspec, MATCH_REFS_NONE);
400 states->push.strdup_strings = 1;
401 for (ref = push_map; ref; ref = ref->next) {
402 struct string_list_item *item;
403 struct push_info *info;
407 hashcpy(ref->new_sha1, ref->peer_ref->new_sha1);
409 item = string_list_append(&states->push,
410 abbrev_branch(ref->peer_ref->name));
411 item->util = xcalloc(sizeof(struct push_info), 1);
413 info->forced = ref->force;
414 info->dest = xstrdup(abbrev_branch(ref->name));
416 if (is_null_sha1(ref->new_sha1)) {
417 info->status = PUSH_STATUS_DELETE;
418 } else if (!hashcmp(ref->old_sha1, ref->new_sha1))
419 info->status = PUSH_STATUS_UPTODATE;
420 else if (is_null_sha1(ref->old_sha1))
421 info->status = PUSH_STATUS_CREATE;
422 else if (has_sha1_file(ref->old_sha1) &&
423 ref_newer(ref->new_sha1, ref->old_sha1))
424 info->status = PUSH_STATUS_FASTFORWARD;
426 info->status = PUSH_STATUS_OUTOFDATE;
428 free_refs(local_refs);
433 static int get_push_ref_states_noquery(struct ref_states *states)
436 struct remote *remote = states->remote;
437 struct string_list_item *item;
438 struct push_info *info;
443 states->push.strdup_strings = 1;
444 if (!remote->push_refspec_nr) {
445 item = string_list_append(&states->push, _("(matching)"));
446 info = item->util = xcalloc(sizeof(struct push_info), 1);
447 info->status = PUSH_STATUS_NOTQUERIED;
448 info->dest = xstrdup(item->string);
450 for (i = 0; i < remote->push_refspec_nr; i++) {
451 struct refspec *spec = remote->push + i;
453 item = string_list_append(&states->push, _("(matching)"));
454 else if (strlen(spec->src))
455 item = string_list_append(&states->push, spec->src);
457 item = string_list_append(&states->push, _("(delete)"));
459 info = item->util = xcalloc(sizeof(struct push_info), 1);
460 info->forced = spec->force;
461 info->status = PUSH_STATUS_NOTQUERIED;
462 info->dest = xstrdup(spec->dst ? spec->dst : item->string);
467 static int get_head_names(const struct ref *remote_refs, struct ref_states *states)
469 struct ref *ref, *matches;
470 struct ref *fetch_map = NULL, **fetch_map_tail = &fetch_map;
471 struct refspec refspec;
475 refspec.src = refspec.dst = "refs/heads/*";
476 states->heads.strdup_strings = 1;
477 get_fetch_map(remote_refs, &refspec, &fetch_map_tail, 0);
478 matches = guess_remote_head(find_ref_by_name(remote_refs, "HEAD"),
480 for (ref = matches; ref; ref = ref->next)
481 string_list_append(&states->heads, abbrev_branch(ref->name));
483 free_refs(fetch_map);
489 struct known_remote {
490 struct known_remote *next;
491 struct remote *remote;
494 struct known_remotes {
495 struct remote *to_delete;
496 struct known_remote *list;
499 static int add_known_remote(struct remote *remote, void *cb_data)
501 struct known_remotes *all = cb_data;
502 struct known_remote *r;
504 if (!strcmp(all->to_delete->name, remote->name))
507 r = xmalloc(sizeof(*r));
514 struct branches_for_remote {
515 struct remote *remote;
516 struct string_list *branches, *skipped;
517 struct known_remotes *keep;
520 static int add_branch_for_removal(const char *refname,
521 const unsigned char *sha1, int flags, void *cb_data)
523 struct branches_for_remote *branches = cb_data;
524 struct refspec refspec;
525 struct string_list_item *item;
526 struct known_remote *kr;
528 memset(&refspec, 0, sizeof(refspec));
529 refspec.dst = (char *)refname;
530 if (remote_find_tracking(branches->remote, &refspec))
533 /* don't delete a branch if another remote also uses it */
534 for (kr = branches->keep->list; kr; kr = kr->next) {
535 memset(&refspec, 0, sizeof(refspec));
536 refspec.dst = (char *)refname;
537 if (!remote_find_tracking(kr->remote, &refspec))
541 /* don't delete non-remote-tracking refs */
542 if (!starts_with(refname, "refs/remotes/")) {
543 /* advise user how to delete local branches */
544 if (starts_with(refname, "refs/heads/"))
545 string_list_append(branches->skipped,
546 abbrev_branch(refname));
547 /* silently skip over other non-remote refs */
551 /* make sure that symrefs are deleted */
552 if (flags & REF_ISSYMREF)
553 return unlink(git_path("%s", refname));
555 item = string_list_append(branches->branches, refname);
556 item->util = xmalloc(20);
557 hashcpy(item->util, sha1);
565 struct string_list *remote_branches;
568 static int read_remote_branches(const char *refname,
569 const unsigned char *sha1, int flags, void *cb_data)
571 struct rename_info *rename = cb_data;
572 struct strbuf buf = STRBUF_INIT;
573 struct string_list_item *item;
575 unsigned char orig_sha1[20];
578 strbuf_addf(&buf, "refs/remotes/%s/", rename->old);
579 if (starts_with(refname, buf.buf)) {
580 item = string_list_append(rename->remote_branches, xstrdup(refname));
581 symref = resolve_ref_unsafe(refname, orig_sha1, 1, &flag);
582 if (flag & REF_ISSYMREF)
583 item->util = xstrdup(symref);
591 static int migrate_file(struct remote *remote)
593 struct strbuf buf = STRBUF_INIT;
597 strbuf_addf(&buf, "remote.%s.url", remote->name);
598 for (i = 0; i < remote->url_nr; i++)
599 if (git_config_set_multivar(buf.buf, remote->url[i], "^$", 0))
600 return error(_("Could not append '%s' to '%s'"),
601 remote->url[i], buf.buf);
603 strbuf_addf(&buf, "remote.%s.push", remote->name);
604 for (i = 0; i < remote->push_refspec_nr; i++)
605 if (git_config_set_multivar(buf.buf, remote->push_refspec[i], "^$", 0))
606 return error(_("Could not append '%s' to '%s'"),
607 remote->push_refspec[i], buf.buf);
609 strbuf_addf(&buf, "remote.%s.fetch", remote->name);
610 for (i = 0; i < remote->fetch_refspec_nr; i++)
611 if (git_config_set_multivar(buf.buf, remote->fetch_refspec[i], "^$", 0))
612 return error(_("Could not append '%s' to '%s'"),
613 remote->fetch_refspec[i], buf.buf);
614 if (remote->origin == REMOTE_REMOTES)
615 path = git_path("remotes/%s", remote->name);
616 else if (remote->origin == REMOTE_BRANCHES)
617 path = git_path("branches/%s", remote->name);
619 unlink_or_warn(path);
623 static int mv(int argc, const char **argv)
625 struct option options[] = {
628 struct remote *oldremote, *newremote;
629 struct strbuf buf = STRBUF_INIT, buf2 = STRBUF_INIT, buf3 = STRBUF_INIT,
630 old_remote_context = STRBUF_INIT;
631 struct string_list remote_branches = STRING_LIST_INIT_NODUP;
632 struct rename_info rename;
633 int i, refspec_updated = 0;
636 usage_with_options(builtin_remote_rename_usage, options);
638 rename.old = argv[1];
639 rename.new = argv[2];
640 rename.remote_branches = &remote_branches;
642 oldremote = remote_get(rename.old);
644 die(_("No such remote: %s"), rename.old);
646 if (!strcmp(rename.old, rename.new) && oldremote->origin != REMOTE_CONFIG)
647 return migrate_file(oldremote);
649 newremote = remote_get(rename.new);
650 if (newremote && (newremote->url_nr > 1 || newremote->fetch_refspec_nr))
651 die(_("remote %s already exists."), rename.new);
653 strbuf_addf(&buf, "refs/heads/test:refs/remotes/%s/test", rename.new);
654 if (!valid_fetch_refspec(buf.buf))
655 die(_("'%s' is not a valid remote name"), rename.new);
658 strbuf_addf(&buf, "remote.%s", rename.old);
659 strbuf_addf(&buf2, "remote.%s", rename.new);
660 if (git_config_rename_section(buf.buf, buf2.buf) < 1)
661 return error(_("Could not rename config section '%s' to '%s'"),
665 strbuf_addf(&buf, "remote.%s.fetch", rename.new);
666 if (git_config_set_multivar(buf.buf, NULL, NULL, 1))
667 return error(_("Could not remove config section '%s'"), buf.buf);
668 strbuf_addf(&old_remote_context, ":refs/remotes/%s/", rename.old);
669 for (i = 0; i < oldremote->fetch_refspec_nr; i++) {
673 strbuf_addstr(&buf2, oldremote->fetch_refspec[i]);
674 ptr = strstr(buf2.buf, old_remote_context.buf);
678 ptr-buf2.buf + strlen(":refs/remotes/"),
679 strlen(rename.old), rename.new,
682 warning(_("Not updating non-default fetch refspec\n"
684 "\tPlease update the configuration manually if necessary."),
687 if (git_config_set_multivar(buf.buf, buf2.buf, "^$", 0))
688 return error(_("Could not append '%s'"), buf.buf);
692 for (i = 0; i < branch_list.nr; i++) {
693 struct string_list_item *item = branch_list.items + i;
694 struct branch_info *info = item->util;
695 if (info->remote_name && !strcmp(info->remote_name, rename.old)) {
697 strbuf_addf(&buf, "branch.%s.remote", item->string);
698 if (git_config_set(buf.buf, rename.new)) {
699 return error(_("Could not set '%s'"), buf.buf);
704 if (!refspec_updated)
708 * First remove symrefs, then rename the rest, finally create
711 for_each_ref(read_remote_branches, &rename);
712 for (i = 0; i < remote_branches.nr; i++) {
713 struct string_list_item *item = remote_branches.items + i;
715 unsigned char sha1[20];
717 read_ref_full(item->string, sha1, 1, &flag);
718 if (!(flag & REF_ISSYMREF))
720 if (delete_ref(item->string, NULL, REF_NODEREF))
721 die(_("deleting '%s' failed"), item->string);
723 for (i = 0; i < remote_branches.nr; i++) {
724 struct string_list_item *item = remote_branches.items + i;
729 strbuf_addstr(&buf, item->string);
730 strbuf_splice(&buf, strlen("refs/remotes/"), strlen(rename.old),
731 rename.new, strlen(rename.new));
733 strbuf_addf(&buf2, "remote: renamed %s to %s",
734 item->string, buf.buf);
735 if (rename_ref(item->string, buf.buf, buf2.buf))
736 die(_("renaming '%s' failed"), item->string);
738 for (i = 0; i < remote_branches.nr; i++) {
739 struct string_list_item *item = remote_branches.items + i;
744 strbuf_addstr(&buf, item->string);
745 strbuf_splice(&buf, strlen("refs/remotes/"), strlen(rename.old),
746 rename.new, strlen(rename.new));
748 strbuf_addstr(&buf2, item->util);
749 strbuf_splice(&buf2, strlen("refs/remotes/"), strlen(rename.old),
750 rename.new, strlen(rename.new));
752 strbuf_addf(&buf3, "remote: renamed %s to %s",
753 item->string, buf.buf);
754 if (create_symref(buf.buf, buf2.buf, buf3.buf))
755 die(_("creating '%s' failed"), buf.buf);
760 static int remove_branches(struct string_list *branches)
763 for (i = 0; i < branches->nr; i++) {
764 struct string_list_item *item = branches->items + i;
765 const char *refname = item->string;
766 unsigned char *sha1 = item->util;
768 if (delete_ref(refname, sha1, 0))
769 result |= error(_("Could not remove branch %s"), refname);
774 static int rm(int argc, const char **argv)
776 struct option options[] = {
779 struct remote *remote;
780 struct strbuf buf = STRBUF_INIT;
781 struct known_remotes known_remotes = { NULL, NULL };
782 struct string_list branches = STRING_LIST_INIT_DUP;
783 struct string_list skipped = STRING_LIST_INIT_DUP;
784 struct branches_for_remote cb_data;
787 memset(&cb_data, 0, sizeof(cb_data));
788 cb_data.branches = &branches;
789 cb_data.skipped = &skipped;
790 cb_data.keep = &known_remotes;
793 usage_with_options(builtin_remote_rm_usage, options);
795 remote = remote_get(argv[1]);
797 die(_("No such remote: %s"), argv[1]);
799 known_remotes.to_delete = remote;
800 for_each_remote(add_known_remote, &known_remotes);
802 strbuf_addf(&buf, "remote.%s", remote->name);
803 if (git_config_rename_section(buf.buf, NULL) < 1)
804 return error(_("Could not remove config section '%s'"), buf.buf);
807 for (i = 0; i < branch_list.nr; i++) {
808 struct string_list_item *item = branch_list.items + i;
809 struct branch_info *info = item->util;
810 if (info->remote_name && !strcmp(info->remote_name, remote->name)) {
811 const char *keys[] = { "remote", "merge", NULL }, **k;
812 for (k = keys; *k; k++) {
814 strbuf_addf(&buf, "branch.%s.%s",
816 if (git_config_set(buf.buf, NULL)) {
817 strbuf_release(&buf);
825 * We cannot just pass a function to for_each_ref() which deletes
826 * the branches one by one, since for_each_ref() relies on cached
827 * refs, which are invalidated when deleting a branch.
829 cb_data.remote = remote;
830 result = for_each_ref(add_branch_for_removal, &cb_data);
831 strbuf_release(&buf);
834 result = remove_branches(&branches);
835 string_list_clear(&branches, 1);
839 Q_("Note: A branch outside the refs/remotes/ hierarchy was not removed;\n"
840 "to delete it, use:",
841 "Note: Some branches outside the refs/remotes/ hierarchy were not removed;\n"
842 "to delete them, use:",
844 for (i = 0; i < skipped.nr; i++)
845 fprintf(stderr, " git branch -d %s\n",
846 skipped.items[i].string);
848 string_list_clear(&skipped, 0);
853 static void clear_push_info(void *util, const char *string)
855 struct push_info *info = util;
860 static void free_remote_ref_states(struct ref_states *states)
862 string_list_clear(&states->new, 0);
863 string_list_clear(&states->stale, 1);
864 string_list_clear(&states->tracked, 0);
865 string_list_clear(&states->heads, 0);
866 string_list_clear_func(&states->push, clear_push_info);
869 static int append_ref_to_tracked_list(const char *refname,
870 const unsigned char *sha1, int flags, void *cb_data)
872 struct ref_states *states = cb_data;
873 struct refspec refspec;
875 if (flags & REF_ISSYMREF)
878 memset(&refspec, 0, sizeof(refspec));
879 refspec.dst = (char *)refname;
880 if (!remote_find_tracking(states->remote, &refspec))
881 string_list_append(&states->tracked, abbrev_branch(refspec.src));
886 static int get_remote_ref_states(const char *name,
887 struct ref_states *states,
890 struct transport *transport;
891 const struct ref *remote_refs;
893 states->remote = remote_get(name);
895 return error(_("No such remote: %s"), name);
900 transport = transport_get(states->remote, states->remote->url_nr > 0 ?
901 states->remote->url[0] : NULL);
902 remote_refs = transport_get_remote_refs(transport);
903 transport_disconnect(transport);
906 if (query & GET_REF_STATES)
907 get_ref_states(remote_refs, states);
908 if (query & GET_HEAD_NAMES)
909 get_head_names(remote_refs, states);
910 if (query & GET_PUSH_REF_STATES)
911 get_push_ref_states(remote_refs, states);
913 for_each_ref(append_ref_to_tracked_list, states);
914 sort_string_list(&states->tracked);
915 get_push_ref_states_noquery(states);
922 struct string_list *list;
923 struct ref_states *states;
928 static int add_remote_to_show_info(struct string_list_item *item, void *cb_data)
930 struct show_info *info = cb_data;
931 int n = strlen(item->string);
934 string_list_insert(info->list, item->string);
938 static int show_remote_info_item(struct string_list_item *item, void *cb_data)
940 struct show_info *info = cb_data;
941 struct ref_states *states = info->states;
942 const char *name = item->string;
944 if (states->queried) {
945 const char *fmt = "%s";
946 const char *arg = "";
947 if (string_list_has_string(&states->new, name)) {
948 fmt = _(" new (next fetch will store in remotes/%s)");
949 arg = states->remote->name;
950 } else if (string_list_has_string(&states->tracked, name))
952 else if (string_list_has_string(&states->stale, name))
953 arg = _(" stale (use 'git remote prune' to remove)");
956 printf(" %-*s", info->width, name);
960 printf(" %s\n", name);
965 static int add_local_to_show_info(struct string_list_item *branch_item, void *cb_data)
967 struct show_info *show_info = cb_data;
968 struct ref_states *states = show_info->states;
969 struct branch_info *branch_info = branch_item->util;
970 struct string_list_item *item;
973 if (!branch_info->merge.nr || !branch_info->remote_name ||
974 strcmp(states->remote->name, branch_info->remote_name))
976 if ((n = strlen(branch_item->string)) > show_info->width)
977 show_info->width = n;
978 if (branch_info->rebase)
979 show_info->any_rebase = 1;
981 item = string_list_insert(show_info->list, branch_item->string);
982 item->util = branch_info;
987 static int show_local_info_item(struct string_list_item *item, void *cb_data)
989 struct show_info *show_info = cb_data;
990 struct branch_info *branch_info = item->util;
991 struct string_list *merge = &branch_info->merge;
995 if (branch_info->rebase && branch_info->merge.nr > 1) {
996 error(_("invalid branch.%s.merge; cannot rebase onto > 1 branch"),
1001 printf(" %-*s ", show_info->width, item->string);
1002 if (branch_info->rebase) {
1003 printf_ln(_("rebases onto remote %s"), merge->items[0].string);
1005 } else if (show_info->any_rebase) {
1006 printf_ln(_(" merges with remote %s"), merge->items[0].string);
1007 also = _(" and with remote");
1009 printf_ln(_("merges with remote %s"), merge->items[0].string);
1010 also = _(" and with remote");
1012 for (i = 1; i < merge->nr; i++)
1013 printf(" %-*s %s %s\n", show_info->width, "", also,
1014 merge->items[i].string);
1019 static int add_push_to_show_info(struct string_list_item *push_item, void *cb_data)
1021 struct show_info *show_info = cb_data;
1022 struct push_info *push_info = push_item->util;
1023 struct string_list_item *item;
1025 if ((n = strlen(push_item->string)) > show_info->width)
1026 show_info->width = n;
1027 if ((n = strlen(push_info->dest)) > show_info->width2)
1028 show_info->width2 = n;
1029 item = string_list_append(show_info->list, push_item->string);
1030 item->util = push_item->util;
1035 * Sorting comparison for a string list that has push_info
1036 * structs in its util field
1038 static int cmp_string_with_push(const void *va, const void *vb)
1040 const struct string_list_item *a = va;
1041 const struct string_list_item *b = vb;
1042 const struct push_info *a_push = a->util;
1043 const struct push_info *b_push = b->util;
1044 int cmp = strcmp(a->string, b->string);
1045 return cmp ? cmp : strcmp(a_push->dest, b_push->dest);
1048 static int show_push_info_item(struct string_list_item *item, void *cb_data)
1050 struct show_info *show_info = cb_data;
1051 struct push_info *push_info = item->util;
1052 const char *src = item->string, *status = NULL;
1054 switch (push_info->status) {
1055 case PUSH_STATUS_CREATE:
1056 status = _("create");
1058 case PUSH_STATUS_DELETE:
1059 status = _("delete");
1062 case PUSH_STATUS_UPTODATE:
1063 status = _("up to date");
1065 case PUSH_STATUS_FASTFORWARD:
1066 status = _("fast-forwardable");
1068 case PUSH_STATUS_OUTOFDATE:
1069 status = _("local out of date");
1071 case PUSH_STATUS_NOTQUERIED:
1075 if (push_info->forced)
1076 printf_ln(_(" %-*s forces to %-*s (%s)"), show_info->width, src,
1077 show_info->width2, push_info->dest, status);
1079 printf_ln(_(" %-*s pushes to %-*s (%s)"), show_info->width, src,
1080 show_info->width2, push_info->dest, status);
1082 if (push_info->forced)
1083 printf_ln(_(" %-*s forces to %s"), show_info->width, src,
1086 printf_ln(_(" %-*s pushes to %s"), show_info->width, src,
1092 static int get_one_entry(struct remote *remote, void *priv)
1094 struct string_list *list = priv;
1095 struct strbuf url_buf = STRBUF_INIT;
1099 if (remote->url_nr > 0) {
1100 strbuf_addf(&url_buf, "%s (fetch)", remote->url[0]);
1101 string_list_append(list, remote->name)->util =
1102 strbuf_detach(&url_buf, NULL);
1104 string_list_append(list, remote->name)->util = NULL;
1105 if (remote->pushurl_nr) {
1106 url = remote->pushurl;
1107 url_nr = remote->pushurl_nr;
1110 url_nr = remote->url_nr;
1112 for (i = 0; i < url_nr; i++)
1114 strbuf_addf(&url_buf, "%s (push)", url[i]);
1115 string_list_append(list, remote->name)->util =
1116 strbuf_detach(&url_buf, NULL);
1122 static int show_all(void)
1124 struct string_list list = STRING_LIST_INIT_NODUP;
1127 list.strdup_strings = 1;
1128 result = for_each_remote(get_one_entry, &list);
1133 sort_string_list(&list);
1134 for (i = 0; i < list.nr; i++) {
1135 struct string_list_item *item = list.items + i;
1137 printf("%s\t%s\n", item->string,
1138 item->util ? (const char *)item->util : "");
1140 if (i && !strcmp((item - 1)->string, item->string))
1142 printf("%s\n", item->string);
1146 string_list_clear(&list, 1);
1150 static int show(int argc, const char **argv)
1152 int no_query = 0, result = 0, query_flag = 0;
1153 struct option options[] = {
1154 OPT_BOOL('n', NULL, &no_query, N_("do not query remotes")),
1157 struct ref_states states;
1158 struct string_list info_list = STRING_LIST_INIT_NODUP;
1159 struct show_info info;
1161 argc = parse_options(argc, argv, NULL, options, builtin_remote_show_usage,
1168 query_flag = (GET_REF_STATES | GET_HEAD_NAMES | GET_PUSH_REF_STATES);
1170 memset(&states, 0, sizeof(states));
1171 memset(&info, 0, sizeof(info));
1172 info.states = &states;
1173 info.list = &info_list;
1174 for (; argc; argc--, argv++) {
1179 get_remote_ref_states(*argv, &states, query_flag);
1181 printf_ln(_("* remote %s"), *argv);
1182 printf_ln(_(" Fetch URL: %s"), states.remote->url_nr > 0 ?
1183 states.remote->url[0] : _("(no URL)"));
1184 if (states.remote->pushurl_nr) {
1185 url = states.remote->pushurl;
1186 url_nr = states.remote->pushurl_nr;
1188 url = states.remote->url;
1189 url_nr = states.remote->url_nr;
1191 for (i = 0; i < url_nr; i++)
1192 printf_ln(_(" Push URL: %s"), url[i]);
1194 printf_ln(_(" Push URL: %s"), "(no URL)");
1196 printf_ln(_(" HEAD branch: %s"), "(not queried)");
1197 else if (!states.heads.nr)
1198 printf_ln(_(" HEAD branch: %s"), "(unknown)");
1199 else if (states.heads.nr == 1)
1200 printf_ln(_(" HEAD branch: %s"), states.heads.items[0].string);
1202 printf(_(" HEAD branch (remote HEAD is ambiguous,"
1203 " may be one of the following):\n"));
1204 for (i = 0; i < states.heads.nr; i++)
1205 printf(" %s\n", states.heads.items[i].string);
1208 /* remote branch info */
1210 for_each_string_list(&states.new, add_remote_to_show_info, &info);
1211 for_each_string_list(&states.tracked, add_remote_to_show_info, &info);
1212 for_each_string_list(&states.stale, add_remote_to_show_info, &info);
1214 printf_ln(Q_(" Remote branch:%s",
1215 " Remote branches:%s",
1217 no_query ? _(" (status not queried)") : "");
1218 for_each_string_list(info.list, show_remote_info_item, &info);
1219 string_list_clear(info.list, 0);
1223 info.any_rebase = 0;
1224 for_each_string_list(&branch_list, add_local_to_show_info, &info);
1226 printf_ln(Q_(" Local branch configured for 'git pull':",
1227 " Local branches configured for 'git pull':",
1229 for_each_string_list(info.list, show_local_info_item, &info);
1230 string_list_clear(info.list, 0);
1233 if (states.remote->mirror)
1234 printf_ln(_(" Local refs will be mirrored by 'git push'"));
1236 info.width = info.width2 = 0;
1237 for_each_string_list(&states.push, add_push_to_show_info, &info);
1238 qsort(info.list->items, info.list->nr,
1239 sizeof(*info.list->items), cmp_string_with_push);
1241 printf_ln(Q_(" Local ref configured for 'git push'%s:",
1242 " Local refs configured for 'git push'%s:",
1244 no_query ? _(" (status not queried)") : "");
1245 for_each_string_list(info.list, show_push_info_item, &info);
1246 string_list_clear(info.list, 0);
1248 free_remote_ref_states(&states);
1254 static int set_head(int argc, const char **argv)
1256 int i, opt_a = 0, opt_d = 0, result = 0;
1257 struct strbuf buf = STRBUF_INIT, buf2 = STRBUF_INIT;
1258 char *head_name = NULL;
1260 struct option options[] = {
1261 OPT_BOOL('a', "auto", &opt_a,
1262 N_("set refs/remotes/<name>/HEAD according to remote")),
1263 OPT_BOOL('d', "delete", &opt_d,
1264 N_("delete refs/remotes/<name>/HEAD")),
1267 argc = parse_options(argc, argv, NULL, options, builtin_remote_sethead_usage,
1270 strbuf_addf(&buf, "refs/remotes/%s/HEAD", argv[0]);
1272 if (!opt_a && !opt_d && argc == 2) {
1273 head_name = xstrdup(argv[1]);
1274 } else if (opt_a && !opt_d && argc == 1) {
1275 struct ref_states states;
1276 memset(&states, 0, sizeof(states));
1277 get_remote_ref_states(argv[0], &states, GET_HEAD_NAMES);
1278 if (!states.heads.nr)
1279 result |= error(_("Cannot determine remote HEAD"));
1280 else if (states.heads.nr > 1) {
1281 result |= error(_("Multiple remote HEAD branches. "
1282 "Please choose one explicitly with:"));
1283 for (i = 0; i < states.heads.nr; i++)
1284 fprintf(stderr, " git remote set-head %s %s\n",
1285 argv[0], states.heads.items[i].string);
1287 head_name = xstrdup(states.heads.items[0].string);
1288 free_remote_ref_states(&states);
1289 } else if (opt_d && !opt_a && argc == 1) {
1290 if (delete_ref(buf.buf, NULL, REF_NODEREF))
1291 result |= error(_("Could not delete %s"), buf.buf);
1293 usage_with_options(builtin_remote_sethead_usage, options);
1296 strbuf_addf(&buf2, "refs/remotes/%s/%s", argv[0], head_name);
1297 /* make sure it's valid */
1298 if (!ref_exists(buf2.buf))
1299 result |= error(_("Not a valid ref: %s"), buf2.buf);
1300 else if (create_symref(buf.buf, buf2.buf, "remote set-head"))
1301 result |= error(_("Could not setup %s"), buf.buf);
1303 printf("%s/HEAD set to %s\n", argv[0], head_name);
1307 strbuf_release(&buf);
1308 strbuf_release(&buf2);
1312 static int prune_remote(const char *remote, int dry_run)
1315 struct ref_states states;
1316 const char *dangling_msg = dry_run
1317 ? _(" %s will become dangling!")
1318 : _(" %s has become dangling!");
1320 memset(&states, 0, sizeof(states));
1321 get_remote_ref_states(remote, &states, GET_REF_STATES);
1323 if (states.stale.nr) {
1324 printf_ln(_("Pruning %s"), remote);
1325 printf_ln(_("URL: %s"),
1326 states.remote->url_nr
1327 ? states.remote->url[0]
1331 for (i = 0; i < states.stale.nr; i++) {
1332 const char *refname = states.stale.items[i].util;
1335 result |= delete_ref(refname, NULL, 0);
1338 printf_ln(_(" * [would prune] %s"),
1339 abbrev_ref(refname, "refs/remotes/"));
1341 printf_ln(_(" * [pruned] %s"),
1342 abbrev_ref(refname, "refs/remotes/"));
1343 warn_dangling_symref(stdout, dangling_msg, refname);
1346 free_remote_ref_states(&states);
1350 static int prune(int argc, const char **argv)
1352 int dry_run = 0, result = 0;
1353 struct option options[] = {
1354 OPT__DRY_RUN(&dry_run, N_("dry run")),
1358 argc = parse_options(argc, argv, NULL, options, builtin_remote_prune_usage,
1362 usage_with_options(builtin_remote_prune_usage, options);
1364 for (; argc; argc--, argv++)
1365 result |= prune_remote(*argv, dry_run);
1370 static int get_remote_default(const char *key, const char *value, void *priv)
1372 if (strcmp(key, "remotes.default") == 0) {
1379 static int update(int argc, const char **argv)
1382 struct option options[] = {
1383 OPT_BOOL('p', "prune", &prune,
1384 N_("prune remotes after fetching")),
1387 struct argv_array fetch_argv = ARGV_ARRAY_INIT;
1388 int default_defined = 0;
1391 argc = parse_options(argc, argv, NULL, options, builtin_remote_update_usage,
1392 PARSE_OPT_KEEP_ARGV0);
1394 argv_array_push(&fetch_argv, "fetch");
1397 argv_array_push(&fetch_argv, prune ? "--prune" : "--no-prune");
1399 argv_array_push(&fetch_argv, "-v");
1400 argv_array_push(&fetch_argv, "--multiple");
1402 argv_array_push(&fetch_argv, "default");
1403 for (i = 1; i < argc; i++)
1404 argv_array_push(&fetch_argv, argv[i]);
1406 if (strcmp(fetch_argv.argv[fetch_argv.argc-1], "default") == 0) {
1407 git_config(get_remote_default, &default_defined);
1408 if (!default_defined) {
1409 argv_array_pop(&fetch_argv);
1410 argv_array_push(&fetch_argv, "--all");
1414 retval = run_command_v_opt(fetch_argv.argv, RUN_GIT_CMD);
1415 argv_array_clear(&fetch_argv);
1419 static int remove_all_fetch_refspecs(const char *remote, const char *key)
1421 return git_config_set_multivar(key, NULL, NULL, 1);
1424 static int add_branches(struct remote *remote, const char **branches,
1427 const char *remotename = remote->name;
1428 int mirror = remote->mirror;
1429 struct strbuf refspec = STRBUF_INIT;
1431 for (; *branches; branches++)
1432 if (add_branch(key, *branches, remotename, mirror, &refspec)) {
1433 strbuf_release(&refspec);
1437 strbuf_release(&refspec);
1441 static int set_remote_branches(const char *remotename, const char **branches,
1444 struct strbuf key = STRBUF_INIT;
1445 struct remote *remote;
1447 strbuf_addf(&key, "remote.%s.fetch", remotename);
1449 if (!remote_is_configured(remotename))
1450 die(_("No such remote '%s'"), remotename);
1451 remote = remote_get(remotename);
1453 if (!add_mode && remove_all_fetch_refspecs(remotename, key.buf)) {
1454 strbuf_release(&key);
1457 if (add_branches(remote, branches, key.buf)) {
1458 strbuf_release(&key);
1462 strbuf_release(&key);
1466 static int set_branches(int argc, const char **argv)
1469 struct option options[] = {
1470 OPT_BOOL('\0', "add", &add_mode, N_("add branch")),
1474 argc = parse_options(argc, argv, NULL, options,
1475 builtin_remote_setbranches_usage, 0);
1477 error(_("no remote specified"));
1478 usage_with_options(builtin_remote_setbranches_usage, options);
1482 return set_remote_branches(argv[0], argv + 1, add_mode);
1485 static int set_url(int argc, const char **argv)
1487 int i, push_mode = 0, add_mode = 0, delete_mode = 0;
1488 int matches = 0, negative_matches = 0;
1489 const char *remotename = NULL;
1490 const char *newurl = NULL;
1491 const char *oldurl = NULL;
1492 struct remote *remote;
1494 const char **urlset;
1496 struct strbuf name_buf = STRBUF_INIT;
1497 struct option options[] = {
1498 OPT_BOOL('\0', "push", &push_mode,
1499 N_("manipulate push URLs")),
1500 OPT_BOOL('\0', "add", &add_mode,
1502 OPT_BOOL('\0', "delete", &delete_mode,
1506 argc = parse_options(argc, argv, NULL, options, builtin_remote_seturl_usage,
1507 PARSE_OPT_KEEP_ARGV0);
1509 if (add_mode && delete_mode)
1510 die(_("--add --delete doesn't make sense"));
1512 if (argc < 3 || argc > 4 || ((add_mode || delete_mode) && argc != 3))
1513 usage_with_options(builtin_remote_seturl_usage, options);
1515 remotename = argv[1];
1523 if (!remote_is_configured(remotename))
1524 die(_("No such remote '%s'"), remotename);
1525 remote = remote_get(remotename);
1528 strbuf_addf(&name_buf, "remote.%s.pushurl", remotename);
1529 urlset = remote->pushurl;
1530 urlset_nr = remote->pushurl_nr;
1532 strbuf_addf(&name_buf, "remote.%s.url", remotename);
1533 urlset = remote->url;
1534 urlset_nr = remote->url_nr;
1537 /* Special cases that add new entry. */
1538 if ((!oldurl && !delete_mode) || add_mode) {
1540 git_config_set_multivar(name_buf.buf, newurl,
1543 git_config_set(name_buf.buf, newurl);
1544 strbuf_release(&name_buf);
1548 /* Old URL specified. Demand that one matches. */
1549 if (regcomp(&old_regex, oldurl, REG_EXTENDED))
1550 die(_("Invalid old URL pattern: %s"), oldurl);
1552 for (i = 0; i < urlset_nr; i++)
1553 if (!regexec(&old_regex, urlset[i], 0, NULL, 0))
1557 if (!delete_mode && !matches)
1558 die(_("No such URL found: %s"), oldurl);
1559 if (delete_mode && !negative_matches && !push_mode)
1560 die(_("Will not delete all non-push URLs"));
1562 regfree(&old_regex);
1565 git_config_set_multivar(name_buf.buf, newurl, oldurl, 0);
1567 git_config_set_multivar(name_buf.buf, NULL, oldurl, 1);
1571 int cmd_remote(int argc, const char **argv, const char *prefix)
1573 struct option options[] = {
1574 OPT__VERBOSE(&verbose, N_("be verbose; must be placed before a subcommand")),
1579 argc = parse_options(argc, argv, prefix, options, builtin_remote_usage,
1580 PARSE_OPT_STOP_AT_NON_OPTION);
1583 result = show_all();
1584 else if (!strcmp(argv[0], "add"))
1585 result = add(argc, argv);
1586 else if (!strcmp(argv[0], "rename"))
1587 result = mv(argc, argv);
1588 else if (!strcmp(argv[0], "rm") || !strcmp(argv[0], "remove"))
1589 result = rm(argc, argv);
1590 else if (!strcmp(argv[0], "set-head"))
1591 result = set_head(argc, argv);
1592 else if (!strcmp(argv[0], "set-branches"))
1593 result = set_branches(argc, argv);
1594 else if (!strcmp(argv[0], "set-url"))
1595 result = set_url(argc, argv);
1596 else if (!strcmp(argv[0], "show"))
1597 result = show(argc, argv);
1598 else if (!strcmp(argv[0], "prune"))
1599 result = prune(argc, argv);
1600 else if (!strcmp(argv[0], "update"))
1601 result = update(argc, argv);
1603 error(_("Unknown subcommand: %s"), argv[0]);
1604 usage_with_options(builtin_remote_usage, options);
1607 return result ? 1 : 0;