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 get-url [--push] [--all] <name>"),
22 N_("git remote set-url [--push] <name> <newurl> [<oldurl>]"),
23 N_("git remote set-url --add <name> <newurl>"),
24 N_("git remote set-url --delete <name> <url>"),
28 static const char * const builtin_remote_add_usage[] = {
29 N_("git remote add [<options>] <name> <url>"),
33 static const char * const builtin_remote_rename_usage[] = {
34 N_("git remote rename <old> <new>"),
38 static const char * const builtin_remote_rm_usage[] = {
39 N_("git remote remove <name>"),
43 static const char * const builtin_remote_sethead_usage[] = {
44 N_("git remote set-head <name> (-a | --auto | -d | --delete | <branch>)"),
48 static const char * const builtin_remote_setbranches_usage[] = {
49 N_("git remote set-branches <name> <branch>..."),
50 N_("git remote set-branches --add <name> <branch>..."),
54 static const char * const builtin_remote_show_usage[] = {
55 N_("git remote show [<options>] <name>"),
59 static const char * const builtin_remote_prune_usage[] = {
60 N_("git remote prune [<options>] <name>"),
64 static const char * const builtin_remote_update_usage[] = {
65 N_("git remote update [<options>] [<group> | <remote>]..."),
69 static const char * const builtin_remote_geturl_usage[] = {
70 N_("git remote get-url [--push] [--all] <name>"),
74 static const char * const builtin_remote_seturl_usage[] = {
75 N_("git remote set-url [--push] <name> <newurl> [<oldurl>]"),
76 N_("git remote set-url --add <name> <newurl>"),
77 N_("git remote set-url --delete <name> <url>"),
81 #define GET_REF_STATES (1<<0)
82 #define GET_HEAD_NAMES (1<<1)
83 #define GET_PUSH_REF_STATES (1<<2)
87 static int fetch_remote(const char *name)
89 const char *argv[] = { "fetch", name, NULL, NULL };
94 printf_ln(_("Updating %s"), name);
95 if (run_command_v_opt(argv, RUN_GIT_CMD))
96 return error(_("Could not fetch %s"), name);
106 #define MIRROR_NONE 0
107 #define MIRROR_FETCH 1
108 #define MIRROR_PUSH 2
109 #define MIRROR_BOTH (MIRROR_FETCH|MIRROR_PUSH)
111 static int add_branch(const char *key, const char *branchname,
112 const char *remotename, int mirror, struct strbuf *tmp)
115 strbuf_addch(tmp, '+');
117 strbuf_addf(tmp, "refs/%s:refs/%s",
118 branchname, branchname);
120 strbuf_addf(tmp, "refs/heads/%s:refs/remotes/%s/%s",
121 branchname, remotename, branchname);
122 return git_config_set_multivar(key, tmp->buf, "^$", 0);
125 static const char mirror_advice[] =
126 N_("--mirror is dangerous and deprecated; please\n"
127 "\t use --mirror=fetch or --mirror=push instead");
129 static int parse_mirror_opt(const struct option *opt, const char *arg, int not)
131 unsigned *mirror = opt->value;
133 *mirror = MIRROR_NONE;
135 warning("%s", _(mirror_advice));
136 *mirror = MIRROR_BOTH;
138 else if (!strcmp(arg, "fetch"))
139 *mirror = MIRROR_FETCH;
140 else if (!strcmp(arg, "push"))
141 *mirror = MIRROR_PUSH;
143 return error(_("unknown mirror argument: %s"), arg);
147 static int add(int argc, const char **argv)
149 int fetch = 0, fetch_tags = TAGS_DEFAULT;
150 unsigned mirror = MIRROR_NONE;
151 struct string_list track = STRING_LIST_INIT_NODUP;
152 const char *master = NULL;
153 struct remote *remote;
154 struct strbuf buf = STRBUF_INIT, buf2 = STRBUF_INIT;
155 const char *name, *url;
158 struct option options[] = {
159 OPT_BOOL('f', "fetch", &fetch, N_("fetch the remote branches")),
160 OPT_SET_INT(0, "tags", &fetch_tags,
161 N_("import all tags and associated objects when fetching"),
163 OPT_SET_INT(0, NULL, &fetch_tags,
164 N_("or do not fetch any tag at all (--no-tags)"), TAGS_UNSET),
165 OPT_STRING_LIST('t', "track", &track, N_("branch"),
166 N_("branch(es) to track")),
167 OPT_STRING('m', "master", &master, N_("branch"), N_("master branch")),
168 { OPTION_CALLBACK, 0, "mirror", &mirror, N_("push|fetch"),
169 N_("set up remote as a mirror to push to or fetch from"),
170 PARSE_OPT_OPTARG, parse_mirror_opt },
174 argc = parse_options(argc, argv, NULL, options, builtin_remote_add_usage,
178 usage_with_options(builtin_remote_add_usage, options);
180 if (mirror && master)
181 die(_("specifying a master branch makes no sense with --mirror"));
182 if (mirror && !(mirror & MIRROR_FETCH) && track.nr)
183 die(_("specifying branches to track makes sense only with fetch mirrors"));
188 remote = remote_get(name);
189 if (remote && (remote->url_nr > 1 ||
190 (strcmp(name, remote->url[0]) &&
191 strcmp(url, remote->url[0])) ||
192 remote->fetch_refspec_nr))
193 die(_("remote %s already exists."), name);
195 strbuf_addf(&buf2, "refs/heads/test:refs/remotes/%s/test", name);
196 if (!valid_fetch_refspec(buf2.buf))
197 die(_("'%s' is not a valid remote name"), name);
199 strbuf_addf(&buf, "remote.%s.url", name);
200 if (git_config_set(buf.buf, url))
203 if (!mirror || mirror & MIRROR_FETCH) {
205 strbuf_addf(&buf, "remote.%s.fetch", name);
207 string_list_append(&track, "*");
208 for (i = 0; i < track.nr; i++) {
209 if (add_branch(buf.buf, track.items[i].string,
210 name, mirror, &buf2))
215 if (mirror & MIRROR_PUSH) {
217 strbuf_addf(&buf, "remote.%s.mirror", name);
218 if (git_config_set(buf.buf, "true"))
222 if (fetch_tags != TAGS_DEFAULT) {
224 strbuf_addf(&buf, "remote.%s.tagopt", name);
225 if (git_config_set(buf.buf,
226 fetch_tags == TAGS_SET ? "--tags" : "--no-tags"))
230 if (fetch && fetch_remote(name))
235 strbuf_addf(&buf, "refs/remotes/%s/HEAD", name);
238 strbuf_addf(&buf2, "refs/remotes/%s/%s", name, master);
240 if (create_symref(buf.buf, buf2.buf, "remote add"))
241 return error(_("Could not setup master '%s'"), master);
244 strbuf_release(&buf);
245 strbuf_release(&buf2);
246 string_list_clear(&track, 0);
253 struct string_list merge;
254 enum { NO_REBASE, NORMAL_REBASE, INTERACTIVE_REBASE } rebase;
257 static struct string_list branch_list;
259 static const char *abbrev_ref(const char *name, const char *prefix)
261 skip_prefix(name, prefix, &name);
264 #define abbrev_branch(name) abbrev_ref((name), "refs/heads/")
266 static int config_read_branches(const char *key, const char *value, void *cb)
268 if (starts_with(key, "branch.")) {
269 const char *orig_key = key;
271 struct string_list_item *item;
272 struct branch_info *info;
273 enum { REMOTE, MERGE, REBASE } type;
277 if (strip_suffix(key, ".remote", &key_len)) {
278 name = xmemdupz(key, key_len);
280 } else if (strip_suffix(key, ".merge", &key_len)) {
281 name = xmemdupz(key, key_len);
283 } else if (strip_suffix(key, ".rebase", &key_len)) {
284 name = xmemdupz(key, key_len);
289 item = string_list_insert(&branch_list, name);
292 item->util = xcalloc(1, sizeof(struct branch_info));
294 if (type == REMOTE) {
295 if (info->remote_name)
296 warning(_("more than one %s"), orig_key);
297 info->remote_name = xstrdup(value);
298 } else if (type == MERGE) {
299 char *space = strchr(value, ' ');
300 value = abbrev_branch(value);
303 merge = xstrndup(value, space - value);
304 string_list_append(&info->merge, merge);
305 value = abbrev_branch(space + 1);
306 space = strchr(value, ' ');
308 string_list_append(&info->merge, xstrdup(value));
310 int v = git_config_maybe_bool(orig_key, value);
313 else if (!strcmp(value, "preserve"))
314 info->rebase = NORMAL_REBASE;
315 else if (!strcmp(value, "interactive"))
316 info->rebase = INTERACTIVE_REBASE;
322 static void read_branches(void)
326 git_config(config_read_branches, NULL);
330 struct remote *remote;
331 struct string_list new, stale, tracked, heads, push;
335 static int get_ref_states(const struct ref *remote_refs, struct ref_states *states)
337 struct ref *fetch_map = NULL, **tail = &fetch_map;
338 struct ref *ref, *stale_refs;
341 for (i = 0; i < states->remote->fetch_refspec_nr; i++)
342 if (get_fetch_map(remote_refs, states->remote->fetch + i, &tail, 1))
343 die(_("Could not get fetch map for refspec %s"),
344 states->remote->fetch_refspec[i]);
346 states->new.strdup_strings = 1;
347 states->tracked.strdup_strings = 1;
348 states->stale.strdup_strings = 1;
349 for (ref = fetch_map; ref; ref = ref->next) {
350 if (!ref->peer_ref || !ref_exists(ref->peer_ref->name))
351 string_list_append(&states->new, abbrev_branch(ref->name));
353 string_list_append(&states->tracked, abbrev_branch(ref->name));
355 stale_refs = get_stale_heads(states->remote->fetch,
356 states->remote->fetch_refspec_nr, fetch_map);
357 for (ref = stale_refs; ref; ref = ref->next) {
358 struct string_list_item *item =
359 string_list_append(&states->stale, abbrev_branch(ref->name));
360 item->util = xstrdup(ref->name);
362 free_refs(stale_refs);
363 free_refs(fetch_map);
365 string_list_sort(&states->new);
366 string_list_sort(&states->tracked);
367 string_list_sort(&states->stale);
376 PUSH_STATUS_CREATE = 0,
378 PUSH_STATUS_UPTODATE,
379 PUSH_STATUS_FASTFORWARD,
380 PUSH_STATUS_OUTOFDATE,
381 PUSH_STATUS_NOTQUERIED
385 static int get_push_ref_states(const struct ref *remote_refs,
386 struct ref_states *states)
388 struct remote *remote = states->remote;
389 struct ref *ref, *local_refs, *push_map;
393 local_refs = get_local_heads();
394 push_map = copy_ref_list(remote_refs);
396 match_push_refs(local_refs, &push_map, remote->push_refspec_nr,
397 remote->push_refspec, MATCH_REFS_NONE);
399 states->push.strdup_strings = 1;
400 for (ref = push_map; ref; ref = ref->next) {
401 struct string_list_item *item;
402 struct push_info *info;
406 oidcpy(&ref->new_oid, &ref->peer_ref->new_oid);
408 item = string_list_append(&states->push,
409 abbrev_branch(ref->peer_ref->name));
410 item->util = xcalloc(1, sizeof(struct push_info));
412 info->forced = ref->force;
413 info->dest = xstrdup(abbrev_branch(ref->name));
415 if (is_null_oid(&ref->new_oid)) {
416 info->status = PUSH_STATUS_DELETE;
417 } else if (!oidcmp(&ref->old_oid, &ref->new_oid))
418 info->status = PUSH_STATUS_UPTODATE;
419 else if (is_null_oid(&ref->old_oid))
420 info->status = PUSH_STATUS_CREATE;
421 else if (has_object_file(&ref->old_oid) &&
422 ref_newer(&ref->new_oid, &ref->old_oid))
423 info->status = PUSH_STATUS_FASTFORWARD;
425 info->status = PUSH_STATUS_OUTOFDATE;
427 free_refs(local_refs);
432 static int get_push_ref_states_noquery(struct ref_states *states)
435 struct remote *remote = states->remote;
436 struct string_list_item *item;
437 struct push_info *info;
442 states->push.strdup_strings = 1;
443 if (!remote->push_refspec_nr) {
444 item = string_list_append(&states->push, _("(matching)"));
445 info = item->util = xcalloc(1, sizeof(struct push_info));
446 info->status = PUSH_STATUS_NOTQUERIED;
447 info->dest = xstrdup(item->string);
449 for (i = 0; i < remote->push_refspec_nr; i++) {
450 struct refspec *spec = remote->push + i;
452 item = string_list_append(&states->push, _("(matching)"));
453 else if (strlen(spec->src))
454 item = string_list_append(&states->push, spec->src);
456 item = string_list_append(&states->push, _("(delete)"));
458 info = item->util = xcalloc(1, sizeof(struct push_info));
459 info->forced = spec->force;
460 info->status = PUSH_STATUS_NOTQUERIED;
461 info->dest = xstrdup(spec->dst ? spec->dst : item->string);
466 static int get_head_names(const struct ref *remote_refs, struct ref_states *states)
468 struct ref *ref, *matches;
469 struct ref *fetch_map = NULL, **fetch_map_tail = &fetch_map;
470 struct refspec refspec;
474 refspec.src = refspec.dst = "refs/heads/*";
475 states->heads.strdup_strings = 1;
476 get_fetch_map(remote_refs, &refspec, &fetch_map_tail, 0);
477 matches = guess_remote_head(find_ref_by_name(remote_refs, "HEAD"),
479 for (ref = matches; ref; ref = ref->next)
480 string_list_append(&states->heads, abbrev_branch(ref->name));
482 free_refs(fetch_map);
488 struct known_remote {
489 struct known_remote *next;
490 struct remote *remote;
493 struct known_remotes {
494 struct remote *to_delete;
495 struct known_remote *list;
498 static int add_known_remote(struct remote *remote, void *cb_data)
500 struct known_remotes *all = cb_data;
501 struct known_remote *r;
503 if (!strcmp(all->to_delete->name, remote->name))
506 r = xmalloc(sizeof(*r));
513 struct branches_for_remote {
514 struct remote *remote;
515 struct string_list *branches, *skipped;
516 struct known_remotes *keep;
519 static int add_branch_for_removal(const char *refname,
520 const struct object_id *oid, int flags, void *cb_data)
522 struct branches_for_remote *branches = cb_data;
523 struct refspec refspec;
524 struct known_remote *kr;
526 memset(&refspec, 0, sizeof(refspec));
527 refspec.dst = (char *)refname;
528 if (remote_find_tracking(branches->remote, &refspec))
531 /* don't delete a branch if another remote also uses it */
532 for (kr = branches->keep->list; kr; kr = kr->next) {
533 memset(&refspec, 0, sizeof(refspec));
534 refspec.dst = (char *)refname;
535 if (!remote_find_tracking(kr->remote, &refspec))
539 /* don't delete non-remote-tracking refs */
540 if (!starts_with(refname, "refs/remotes/")) {
541 /* advise user how to delete local branches */
542 if (starts_with(refname, "refs/heads/"))
543 string_list_append(branches->skipped,
544 abbrev_branch(refname));
545 /* silently skip over other non-remote refs */
549 /* make sure that symrefs are deleted */
550 if (flags & REF_ISSYMREF)
551 return unlink(git_path("%s", refname));
553 string_list_append(branches->branches, refname);
561 struct string_list *remote_branches;
564 static int read_remote_branches(const char *refname,
565 const struct object_id *oid, int flags, void *cb_data)
567 struct rename_info *rename = cb_data;
568 struct strbuf buf = STRBUF_INIT;
569 struct string_list_item *item;
571 struct object_id orig_oid;
574 strbuf_addf(&buf, "refs/remotes/%s/", rename->old);
575 if (starts_with(refname, buf.buf)) {
576 item = string_list_append(rename->remote_branches, xstrdup(refname));
577 symref = resolve_ref_unsafe(refname, RESOLVE_REF_READING,
578 orig_oid.hash, &flag);
579 if (flag & REF_ISSYMREF)
580 item->util = xstrdup(symref);
588 static int migrate_file(struct remote *remote)
590 struct strbuf buf = STRBUF_INIT;
593 strbuf_addf(&buf, "remote.%s.url", remote->name);
594 for (i = 0; i < remote->url_nr; i++)
595 if (git_config_set_multivar(buf.buf, remote->url[i], "^$", 0))
596 return error(_("Could not append '%s' to '%s'"),
597 remote->url[i], buf.buf);
599 strbuf_addf(&buf, "remote.%s.push", remote->name);
600 for (i = 0; i < remote->push_refspec_nr; i++)
601 if (git_config_set_multivar(buf.buf, remote->push_refspec[i], "^$", 0))
602 return error(_("Could not append '%s' to '%s'"),
603 remote->push_refspec[i], buf.buf);
605 strbuf_addf(&buf, "remote.%s.fetch", remote->name);
606 for (i = 0; i < remote->fetch_refspec_nr; i++)
607 if (git_config_set_multivar(buf.buf, remote->fetch_refspec[i], "^$", 0))
608 return error(_("Could not append '%s' to '%s'"),
609 remote->fetch_refspec[i], buf.buf);
610 if (remote->origin == REMOTE_REMOTES)
611 unlink_or_warn(git_path("remotes/%s", remote->name));
612 else if (remote->origin == REMOTE_BRANCHES)
613 unlink_or_warn(git_path("branches/%s", remote->name));
617 static int mv(int argc, const char **argv)
619 struct option options[] = {
622 struct remote *oldremote, *newremote;
623 struct strbuf buf = STRBUF_INIT, buf2 = STRBUF_INIT, buf3 = STRBUF_INIT,
624 old_remote_context = STRBUF_INIT;
625 struct string_list remote_branches = STRING_LIST_INIT_NODUP;
626 struct rename_info rename;
627 int i, refspec_updated = 0;
630 usage_with_options(builtin_remote_rename_usage, options);
632 rename.old = argv[1];
633 rename.new = argv[2];
634 rename.remote_branches = &remote_branches;
636 oldremote = remote_get(rename.old);
637 if (!remote_is_configured(oldremote))
638 die(_("No such remote: %s"), rename.old);
640 if (!strcmp(rename.old, rename.new) && oldremote->origin != REMOTE_CONFIG)
641 return migrate_file(oldremote);
643 newremote = remote_get(rename.new);
644 if (newremote && (newremote->url_nr > 1 || newremote->fetch_refspec_nr))
645 die(_("remote %s already exists."), rename.new);
647 strbuf_addf(&buf, "refs/heads/test:refs/remotes/%s/test", rename.new);
648 if (!valid_fetch_refspec(buf.buf))
649 die(_("'%s' is not a valid remote name"), rename.new);
652 strbuf_addf(&buf, "remote.%s", rename.old);
653 strbuf_addf(&buf2, "remote.%s", rename.new);
654 if (git_config_rename_section(buf.buf, buf2.buf) < 1)
655 return error(_("Could not rename config section '%s' to '%s'"),
659 strbuf_addf(&buf, "remote.%s.fetch", rename.new);
660 if (git_config_set_multivar(buf.buf, NULL, NULL, 1))
661 return error(_("Could not remove config section '%s'"), buf.buf);
662 strbuf_addf(&old_remote_context, ":refs/remotes/%s/", rename.old);
663 for (i = 0; i < oldremote->fetch_refspec_nr; i++) {
667 strbuf_addstr(&buf2, oldremote->fetch_refspec[i]);
668 ptr = strstr(buf2.buf, old_remote_context.buf);
672 ptr-buf2.buf + strlen(":refs/remotes/"),
673 strlen(rename.old), rename.new,
676 warning(_("Not updating non-default fetch refspec\n"
678 "\tPlease update the configuration manually if necessary."),
681 if (git_config_set_multivar(buf.buf, buf2.buf, "^$", 0))
682 return error(_("Could not append '%s'"), buf.buf);
686 for (i = 0; i < branch_list.nr; i++) {
687 struct string_list_item *item = branch_list.items + i;
688 struct branch_info *info = item->util;
689 if (info->remote_name && !strcmp(info->remote_name, rename.old)) {
691 strbuf_addf(&buf, "branch.%s.remote", item->string);
692 if (git_config_set(buf.buf, rename.new)) {
693 return error(_("Could not set '%s'"), buf.buf);
698 if (!refspec_updated)
702 * First remove symrefs, then rename the rest, finally create
705 for_each_ref(read_remote_branches, &rename);
706 for (i = 0; i < remote_branches.nr; i++) {
707 struct string_list_item *item = remote_branches.items + i;
709 struct object_id oid;
711 read_ref_full(item->string, RESOLVE_REF_READING, oid.hash, &flag);
712 if (!(flag & REF_ISSYMREF))
714 if (delete_ref(item->string, NULL, REF_NODEREF))
715 die(_("deleting '%s' failed"), item->string);
717 for (i = 0; i < remote_branches.nr; i++) {
718 struct string_list_item *item = remote_branches.items + i;
723 strbuf_addstr(&buf, item->string);
724 strbuf_splice(&buf, strlen("refs/remotes/"), strlen(rename.old),
725 rename.new, strlen(rename.new));
727 strbuf_addf(&buf2, "remote: renamed %s to %s",
728 item->string, buf.buf);
729 if (rename_ref(item->string, buf.buf, buf2.buf))
730 die(_("renaming '%s' failed"), item->string);
732 for (i = 0; i < remote_branches.nr; i++) {
733 struct string_list_item *item = remote_branches.items + i;
738 strbuf_addstr(&buf, item->string);
739 strbuf_splice(&buf, strlen("refs/remotes/"), strlen(rename.old),
740 rename.new, strlen(rename.new));
742 strbuf_addstr(&buf2, item->util);
743 strbuf_splice(&buf2, strlen("refs/remotes/"), strlen(rename.old),
744 rename.new, strlen(rename.new));
746 strbuf_addf(&buf3, "remote: renamed %s to %s",
747 item->string, buf.buf);
748 if (create_symref(buf.buf, buf2.buf, buf3.buf))
749 die(_("creating '%s' failed"), buf.buf);
754 static int rm(int argc, const char **argv)
756 struct option options[] = {
759 struct remote *remote;
760 struct strbuf buf = STRBUF_INIT;
761 struct known_remotes known_remotes = { NULL, NULL };
762 struct string_list branches = STRING_LIST_INIT_DUP;
763 struct string_list skipped = STRING_LIST_INIT_DUP;
764 struct branches_for_remote cb_data;
767 memset(&cb_data, 0, sizeof(cb_data));
768 cb_data.branches = &branches;
769 cb_data.skipped = &skipped;
770 cb_data.keep = &known_remotes;
773 usage_with_options(builtin_remote_rm_usage, options);
775 remote = remote_get(argv[1]);
776 if (!remote_is_configured(remote))
777 die(_("No such remote: %s"), argv[1]);
779 known_remotes.to_delete = remote;
780 for_each_remote(add_known_remote, &known_remotes);
783 for (i = 0; i < branch_list.nr; i++) {
784 struct string_list_item *item = branch_list.items + i;
785 struct branch_info *info = item->util;
786 if (info->remote_name && !strcmp(info->remote_name, remote->name)) {
787 const char *keys[] = { "remote", "merge", NULL }, **k;
788 for (k = keys; *k; k++) {
790 strbuf_addf(&buf, "branch.%s.%s",
792 if (git_config_set(buf.buf, NULL)) {
793 strbuf_release(&buf);
801 * We cannot just pass a function to for_each_ref() which deletes
802 * the branches one by one, since for_each_ref() relies on cached
803 * refs, which are invalidated when deleting a branch.
805 cb_data.remote = remote;
806 result = for_each_ref(add_branch_for_removal, &cb_data);
807 strbuf_release(&buf);
810 result = delete_refs(&branches);
811 string_list_clear(&branches, 0);
815 Q_("Note: A branch outside the refs/remotes/ hierarchy was not removed;\n"
816 "to delete it, use:",
817 "Note: Some branches outside the refs/remotes/ hierarchy were not removed;\n"
818 "to delete them, use:",
820 for (i = 0; i < skipped.nr; i++)
821 fprintf(stderr, " git branch -d %s\n",
822 skipped.items[i].string);
824 string_list_clear(&skipped, 0);
827 strbuf_addf(&buf, "remote.%s", remote->name);
828 if (git_config_rename_section(buf.buf, NULL) < 1)
829 return error(_("Could not remove config section '%s'"), buf.buf);
835 static void clear_push_info(void *util, const char *string)
837 struct push_info *info = util;
842 static void free_remote_ref_states(struct ref_states *states)
844 string_list_clear(&states->new, 0);
845 string_list_clear(&states->stale, 1);
846 string_list_clear(&states->tracked, 0);
847 string_list_clear(&states->heads, 0);
848 string_list_clear_func(&states->push, clear_push_info);
851 static int append_ref_to_tracked_list(const char *refname,
852 const struct object_id *oid, int flags, void *cb_data)
854 struct ref_states *states = cb_data;
855 struct refspec refspec;
857 if (flags & REF_ISSYMREF)
860 memset(&refspec, 0, sizeof(refspec));
861 refspec.dst = (char *)refname;
862 if (!remote_find_tracking(states->remote, &refspec))
863 string_list_append(&states->tracked, abbrev_branch(refspec.src));
868 static int get_remote_ref_states(const char *name,
869 struct ref_states *states,
872 struct transport *transport;
873 const struct ref *remote_refs;
875 states->remote = remote_get(name);
877 return error(_("No such remote: %s"), name);
882 transport = transport_get(states->remote, states->remote->url_nr > 0 ?
883 states->remote->url[0] : NULL);
884 remote_refs = transport_get_remote_refs(transport);
885 transport_disconnect(transport);
888 if (query & GET_REF_STATES)
889 get_ref_states(remote_refs, states);
890 if (query & GET_HEAD_NAMES)
891 get_head_names(remote_refs, states);
892 if (query & GET_PUSH_REF_STATES)
893 get_push_ref_states(remote_refs, states);
895 for_each_ref(append_ref_to_tracked_list, states);
896 string_list_sort(&states->tracked);
897 get_push_ref_states_noquery(states);
904 struct string_list *list;
905 struct ref_states *states;
910 static int add_remote_to_show_info(struct string_list_item *item, void *cb_data)
912 struct show_info *info = cb_data;
913 int n = strlen(item->string);
916 string_list_insert(info->list, item->string);
920 static int show_remote_info_item(struct string_list_item *item, void *cb_data)
922 struct show_info *info = cb_data;
923 struct ref_states *states = info->states;
924 const char *name = item->string;
926 if (states->queried) {
927 const char *fmt = "%s";
928 const char *arg = "";
929 if (string_list_has_string(&states->new, name)) {
930 fmt = _(" new (next fetch will store in remotes/%s)");
931 arg = states->remote->name;
932 } else if (string_list_has_string(&states->tracked, name))
934 else if (string_list_has_string(&states->stale, name))
935 arg = _(" stale (use 'git remote prune' to remove)");
938 printf(" %-*s", info->width, name);
942 printf(" %s\n", name);
947 static int add_local_to_show_info(struct string_list_item *branch_item, void *cb_data)
949 struct show_info *show_info = cb_data;
950 struct ref_states *states = show_info->states;
951 struct branch_info *branch_info = branch_item->util;
952 struct string_list_item *item;
955 if (!branch_info->merge.nr || !branch_info->remote_name ||
956 strcmp(states->remote->name, branch_info->remote_name))
958 if ((n = strlen(branch_item->string)) > show_info->width)
959 show_info->width = n;
960 if (branch_info->rebase)
961 show_info->any_rebase = 1;
963 item = string_list_insert(show_info->list, branch_item->string);
964 item->util = branch_info;
969 static int show_local_info_item(struct string_list_item *item, void *cb_data)
971 struct show_info *show_info = cb_data;
972 struct branch_info *branch_info = item->util;
973 struct string_list *merge = &branch_info->merge;
977 if (branch_info->rebase && branch_info->merge.nr > 1) {
978 error(_("invalid branch.%s.merge; cannot rebase onto > 1 branch"),
983 printf(" %-*s ", show_info->width, item->string);
984 if (branch_info->rebase) {
985 printf_ln(_(branch_info->rebase == INTERACTIVE_REBASE ?
986 "rebases interactively onto remote %s" :
987 "rebases onto remote %s"), merge->items[0].string);
989 } else if (show_info->any_rebase) {
990 printf_ln(_(" merges with remote %s"), merge->items[0].string);
991 also = _(" and with remote");
993 printf_ln(_("merges with remote %s"), merge->items[0].string);
994 also = _(" and with remote");
996 for (i = 1; i < merge->nr; i++)
997 printf(" %-*s %s %s\n", show_info->width, "", also,
998 merge->items[i].string);
1003 static int add_push_to_show_info(struct string_list_item *push_item, void *cb_data)
1005 struct show_info *show_info = cb_data;
1006 struct push_info *push_info = push_item->util;
1007 struct string_list_item *item;
1009 if ((n = strlen(push_item->string)) > show_info->width)
1010 show_info->width = n;
1011 if ((n = strlen(push_info->dest)) > show_info->width2)
1012 show_info->width2 = n;
1013 item = string_list_append(show_info->list, push_item->string);
1014 item->util = push_item->util;
1019 * Sorting comparison for a string list that has push_info
1020 * structs in its util field
1022 static int cmp_string_with_push(const void *va, const void *vb)
1024 const struct string_list_item *a = va;
1025 const struct string_list_item *b = vb;
1026 const struct push_info *a_push = a->util;
1027 const struct push_info *b_push = b->util;
1028 int cmp = strcmp(a->string, b->string);
1029 return cmp ? cmp : strcmp(a_push->dest, b_push->dest);
1032 static int show_push_info_item(struct string_list_item *item, void *cb_data)
1034 struct show_info *show_info = cb_data;
1035 struct push_info *push_info = item->util;
1036 const char *src = item->string, *status = NULL;
1038 switch (push_info->status) {
1039 case PUSH_STATUS_CREATE:
1040 status = _("create");
1042 case PUSH_STATUS_DELETE:
1043 status = _("delete");
1046 case PUSH_STATUS_UPTODATE:
1047 status = _("up to date");
1049 case PUSH_STATUS_FASTFORWARD:
1050 status = _("fast-forwardable");
1052 case PUSH_STATUS_OUTOFDATE:
1053 status = _("local out of date");
1055 case PUSH_STATUS_NOTQUERIED:
1059 if (push_info->forced)
1060 printf_ln(_(" %-*s forces to %-*s (%s)"), show_info->width, src,
1061 show_info->width2, push_info->dest, status);
1063 printf_ln(_(" %-*s pushes to %-*s (%s)"), show_info->width, src,
1064 show_info->width2, push_info->dest, status);
1066 if (push_info->forced)
1067 printf_ln(_(" %-*s forces to %s"), show_info->width, src,
1070 printf_ln(_(" %-*s pushes to %s"), show_info->width, src,
1076 static int get_one_entry(struct remote *remote, void *priv)
1078 struct string_list *list = priv;
1079 struct strbuf url_buf = STRBUF_INIT;
1083 if (remote->url_nr > 0) {
1084 strbuf_addf(&url_buf, "%s (fetch)", remote->url[0]);
1085 string_list_append(list, remote->name)->util =
1086 strbuf_detach(&url_buf, NULL);
1088 string_list_append(list, remote->name)->util = NULL;
1089 if (remote->pushurl_nr) {
1090 url = remote->pushurl;
1091 url_nr = remote->pushurl_nr;
1094 url_nr = remote->url_nr;
1096 for (i = 0; i < url_nr; i++)
1098 strbuf_addf(&url_buf, "%s (push)", url[i]);
1099 string_list_append(list, remote->name)->util =
1100 strbuf_detach(&url_buf, NULL);
1106 static int show_all(void)
1108 struct string_list list = STRING_LIST_INIT_NODUP;
1111 list.strdup_strings = 1;
1112 result = for_each_remote(get_one_entry, &list);
1117 string_list_sort(&list);
1118 for (i = 0; i < list.nr; i++) {
1119 struct string_list_item *item = list.items + i;
1121 printf("%s\t%s\n", item->string,
1122 item->util ? (const char *)item->util : "");
1124 if (i && !strcmp((item - 1)->string, item->string))
1126 printf("%s\n", item->string);
1130 string_list_clear(&list, 1);
1134 static int show(int argc, const char **argv)
1136 int no_query = 0, result = 0, query_flag = 0;
1137 struct option options[] = {
1138 OPT_BOOL('n', NULL, &no_query, N_("do not query remotes")),
1141 struct ref_states states;
1142 struct string_list info_list = STRING_LIST_INIT_NODUP;
1143 struct show_info info;
1145 argc = parse_options(argc, argv, NULL, options, builtin_remote_show_usage,
1152 query_flag = (GET_REF_STATES | GET_HEAD_NAMES | GET_PUSH_REF_STATES);
1154 memset(&states, 0, sizeof(states));
1155 memset(&info, 0, sizeof(info));
1156 info.states = &states;
1157 info.list = &info_list;
1158 for (; argc; argc--, argv++) {
1163 get_remote_ref_states(*argv, &states, query_flag);
1165 printf_ln(_("* remote %s"), *argv);
1166 printf_ln(_(" Fetch URL: %s"), states.remote->url_nr > 0 ?
1167 states.remote->url[0] : _("(no URL)"));
1168 if (states.remote->pushurl_nr) {
1169 url = states.remote->pushurl;
1170 url_nr = states.remote->pushurl_nr;
1172 url = states.remote->url;
1173 url_nr = states.remote->url_nr;
1175 for (i = 0; i < url_nr; i++)
1176 printf_ln(_(" Push URL: %s"), url[i]);
1178 printf_ln(_(" Push URL: %s"), "(no URL)");
1180 printf_ln(_(" HEAD branch: %s"), "(not queried)");
1181 else if (!states.heads.nr)
1182 printf_ln(_(" HEAD branch: %s"), "(unknown)");
1183 else if (states.heads.nr == 1)
1184 printf_ln(_(" HEAD branch: %s"), states.heads.items[0].string);
1186 printf(_(" HEAD branch (remote HEAD is ambiguous,"
1187 " may be one of the following):\n"));
1188 for (i = 0; i < states.heads.nr; i++)
1189 printf(" %s\n", states.heads.items[i].string);
1192 /* remote branch info */
1194 for_each_string_list(&states.new, add_remote_to_show_info, &info);
1195 for_each_string_list(&states.tracked, add_remote_to_show_info, &info);
1196 for_each_string_list(&states.stale, add_remote_to_show_info, &info);
1198 printf_ln(Q_(" Remote branch:%s",
1199 " Remote branches:%s",
1201 no_query ? _(" (status not queried)") : "");
1202 for_each_string_list(info.list, show_remote_info_item, &info);
1203 string_list_clear(info.list, 0);
1207 info.any_rebase = 0;
1208 for_each_string_list(&branch_list, add_local_to_show_info, &info);
1210 printf_ln(Q_(" Local branch configured for 'git pull':",
1211 " Local branches configured for 'git pull':",
1213 for_each_string_list(info.list, show_local_info_item, &info);
1214 string_list_clear(info.list, 0);
1217 if (states.remote->mirror)
1218 printf_ln(_(" Local refs will be mirrored by 'git push'"));
1220 info.width = info.width2 = 0;
1221 for_each_string_list(&states.push, add_push_to_show_info, &info);
1222 qsort(info.list->items, info.list->nr,
1223 sizeof(*info.list->items), cmp_string_with_push);
1225 printf_ln(Q_(" Local ref configured for 'git push'%s:",
1226 " Local refs configured for 'git push'%s:",
1228 no_query ? _(" (status not queried)") : "");
1229 for_each_string_list(info.list, show_push_info_item, &info);
1230 string_list_clear(info.list, 0);
1232 free_remote_ref_states(&states);
1238 static int set_head(int argc, const char **argv)
1240 int i, opt_a = 0, opt_d = 0, result = 0;
1241 struct strbuf buf = STRBUF_INIT, buf2 = STRBUF_INIT;
1242 char *head_name = NULL;
1244 struct option options[] = {
1245 OPT_BOOL('a', "auto", &opt_a,
1246 N_("set refs/remotes/<name>/HEAD according to remote")),
1247 OPT_BOOL('d', "delete", &opt_d,
1248 N_("delete refs/remotes/<name>/HEAD")),
1251 argc = parse_options(argc, argv, NULL, options, builtin_remote_sethead_usage,
1254 strbuf_addf(&buf, "refs/remotes/%s/HEAD", argv[0]);
1256 if (!opt_a && !opt_d && argc == 2) {
1257 head_name = xstrdup(argv[1]);
1258 } else if (opt_a && !opt_d && argc == 1) {
1259 struct ref_states states;
1260 memset(&states, 0, sizeof(states));
1261 get_remote_ref_states(argv[0], &states, GET_HEAD_NAMES);
1262 if (!states.heads.nr)
1263 result |= error(_("Cannot determine remote HEAD"));
1264 else if (states.heads.nr > 1) {
1265 result |= error(_("Multiple remote HEAD branches. "
1266 "Please choose one explicitly with:"));
1267 for (i = 0; i < states.heads.nr; i++)
1268 fprintf(stderr, " git remote set-head %s %s\n",
1269 argv[0], states.heads.items[i].string);
1271 head_name = xstrdup(states.heads.items[0].string);
1272 free_remote_ref_states(&states);
1273 } else if (opt_d && !opt_a && argc == 1) {
1274 if (delete_ref(buf.buf, NULL, REF_NODEREF))
1275 result |= error(_("Could not delete %s"), buf.buf);
1277 usage_with_options(builtin_remote_sethead_usage, options);
1280 strbuf_addf(&buf2, "refs/remotes/%s/%s", argv[0], head_name);
1281 /* make sure it's valid */
1282 if (!ref_exists(buf2.buf))
1283 result |= error(_("Not a valid ref: %s"), buf2.buf);
1284 else if (create_symref(buf.buf, buf2.buf, "remote set-head"))
1285 result |= error(_("Could not setup %s"), buf.buf);
1287 printf("%s/HEAD set to %s\n", argv[0], head_name);
1291 strbuf_release(&buf);
1292 strbuf_release(&buf2);
1296 static int prune_remote(const char *remote, int dry_run)
1299 struct ref_states states;
1300 struct string_list refs_to_prune = STRING_LIST_INIT_NODUP;
1301 struct string_list_item *item;
1302 const char *dangling_msg = dry_run
1303 ? _(" %s will become dangling!")
1304 : _(" %s has become dangling!");
1306 memset(&states, 0, sizeof(states));
1307 get_remote_ref_states(remote, &states, GET_REF_STATES);
1309 if (!states.stale.nr) {
1310 free_remote_ref_states(&states);
1314 printf_ln(_("Pruning %s"), remote);
1315 printf_ln(_("URL: %s"),
1316 states.remote->url_nr
1317 ? states.remote->url[0]
1320 for_each_string_list_item(item, &states.stale)
1321 string_list_append(&refs_to_prune, item->util);
1322 string_list_sort(&refs_to_prune);
1325 result |= delete_refs(&refs_to_prune);
1327 for_each_string_list_item(item, &states.stale) {
1328 const char *refname = item->util;
1331 printf_ln(_(" * [would prune] %s"),
1332 abbrev_ref(refname, "refs/remotes/"));
1334 printf_ln(_(" * [pruned] %s"),
1335 abbrev_ref(refname, "refs/remotes/"));
1338 warn_dangling_symrefs(stdout, dangling_msg, &refs_to_prune);
1340 string_list_clear(&refs_to_prune, 0);
1341 free_remote_ref_states(&states);
1345 static int prune(int argc, const char **argv)
1347 int dry_run = 0, result = 0;
1348 struct option options[] = {
1349 OPT__DRY_RUN(&dry_run, N_("dry run")),
1353 argc = parse_options(argc, argv, NULL, options, builtin_remote_prune_usage,
1357 usage_with_options(builtin_remote_prune_usage, options);
1359 for (; argc; argc--, argv++)
1360 result |= prune_remote(*argv, dry_run);
1365 static int get_remote_default(const char *key, const char *value, void *priv)
1367 if (strcmp(key, "remotes.default") == 0) {
1374 static int update(int argc, const char **argv)
1377 struct option options[] = {
1378 OPT_BOOL('p', "prune", &prune,
1379 N_("prune remotes after fetching")),
1382 struct argv_array fetch_argv = ARGV_ARRAY_INIT;
1383 int default_defined = 0;
1386 argc = parse_options(argc, argv, NULL, options, builtin_remote_update_usage,
1387 PARSE_OPT_KEEP_ARGV0);
1389 argv_array_push(&fetch_argv, "fetch");
1392 argv_array_push(&fetch_argv, prune ? "--prune" : "--no-prune");
1394 argv_array_push(&fetch_argv, "-v");
1395 argv_array_push(&fetch_argv, "--multiple");
1397 argv_array_push(&fetch_argv, "default");
1398 for (i = 1; i < argc; i++)
1399 argv_array_push(&fetch_argv, argv[i]);
1401 if (strcmp(fetch_argv.argv[fetch_argv.argc-1], "default") == 0) {
1402 git_config(get_remote_default, &default_defined);
1403 if (!default_defined) {
1404 argv_array_pop(&fetch_argv);
1405 argv_array_push(&fetch_argv, "--all");
1409 retval = run_command_v_opt(fetch_argv.argv, RUN_GIT_CMD);
1410 argv_array_clear(&fetch_argv);
1414 static int remove_all_fetch_refspecs(const char *remote, const char *key)
1416 return git_config_set_multivar(key, NULL, NULL, 1);
1419 static int add_branches(struct remote *remote, const char **branches,
1422 const char *remotename = remote->name;
1423 int mirror = remote->mirror;
1424 struct strbuf refspec = STRBUF_INIT;
1426 for (; *branches; branches++)
1427 if (add_branch(key, *branches, remotename, mirror, &refspec)) {
1428 strbuf_release(&refspec);
1432 strbuf_release(&refspec);
1436 static int set_remote_branches(const char *remotename, const char **branches,
1439 struct strbuf key = STRBUF_INIT;
1440 struct remote *remote;
1442 strbuf_addf(&key, "remote.%s.fetch", remotename);
1444 remote = remote_get(remotename);
1445 if (!remote_is_configured(remote))
1446 die(_("No such remote '%s'"), remotename);
1448 if (!add_mode && remove_all_fetch_refspecs(remotename, key.buf)) {
1449 strbuf_release(&key);
1452 if (add_branches(remote, branches, key.buf)) {
1453 strbuf_release(&key);
1457 strbuf_release(&key);
1461 static int set_branches(int argc, const char **argv)
1464 struct option options[] = {
1465 OPT_BOOL('\0', "add", &add_mode, N_("add branch")),
1469 argc = parse_options(argc, argv, NULL, options,
1470 builtin_remote_setbranches_usage, 0);
1472 error(_("no remote specified"));
1473 usage_with_options(builtin_remote_setbranches_usage, options);
1477 return set_remote_branches(argv[0], argv + 1, add_mode);
1480 static int get_url(int argc, const char **argv)
1482 int i, push_mode = 0, all_mode = 0;
1483 const char *remotename = NULL;
1484 struct remote *remote;
1487 struct option options[] = {
1488 OPT_BOOL('\0', "push", &push_mode,
1489 N_("query push URLs rather than fetch URLs")),
1490 OPT_BOOL('\0', "all", &all_mode,
1491 N_("return all URLs")),
1494 argc = parse_options(argc, argv, NULL, options, builtin_remote_geturl_usage, 0);
1497 usage_with_options(builtin_remote_geturl_usage, options);
1499 remotename = argv[0];
1501 remote = remote_get(remotename);
1502 if (!remote_is_configured(remote))
1503 die(_("No such remote '%s'"), remotename);
1507 url = remote->pushurl;
1508 url_nr = remote->pushurl_nr;
1510 /* else fetch mode */
1512 /* Use the fetch URL when no push URLs were found or requested. */
1515 url_nr = remote->url_nr;
1519 die(_("no URLs configured for remote '%s'"), remotename);
1522 for (i = 0; i < url_nr; i++)
1523 printf_ln("%s", url[i]);
1525 printf_ln("%s", *url);
1531 static int set_url(int argc, const char **argv)
1533 int i, push_mode = 0, add_mode = 0, delete_mode = 0;
1534 int matches = 0, negative_matches = 0;
1535 const char *remotename = NULL;
1536 const char *newurl = NULL;
1537 const char *oldurl = NULL;
1538 struct remote *remote;
1540 const char **urlset;
1542 struct strbuf name_buf = STRBUF_INIT;
1543 struct option options[] = {
1544 OPT_BOOL('\0', "push", &push_mode,
1545 N_("manipulate push URLs")),
1546 OPT_BOOL('\0', "add", &add_mode,
1548 OPT_BOOL('\0', "delete", &delete_mode,
1552 argc = parse_options(argc, argv, NULL, options, builtin_remote_seturl_usage,
1553 PARSE_OPT_KEEP_ARGV0);
1555 if (add_mode && delete_mode)
1556 die(_("--add --delete doesn't make sense"));
1558 if (argc < 3 || argc > 4 || ((add_mode || delete_mode) && argc != 3))
1559 usage_with_options(builtin_remote_seturl_usage, options);
1561 remotename = argv[1];
1569 remote = remote_get(remotename);
1570 if (!remote_is_configured(remote))
1571 die(_("No such remote '%s'"), remotename);
1574 strbuf_addf(&name_buf, "remote.%s.pushurl", remotename);
1575 urlset = remote->pushurl;
1576 urlset_nr = remote->pushurl_nr;
1578 strbuf_addf(&name_buf, "remote.%s.url", remotename);
1579 urlset = remote->url;
1580 urlset_nr = remote->url_nr;
1583 /* Special cases that add new entry. */
1584 if ((!oldurl && !delete_mode) || add_mode) {
1586 git_config_set_multivar(name_buf.buf, newurl,
1589 git_config_set(name_buf.buf, newurl);
1590 strbuf_release(&name_buf);
1594 /* Old URL specified. Demand that one matches. */
1595 if (regcomp(&old_regex, oldurl, REG_EXTENDED))
1596 die(_("Invalid old URL pattern: %s"), oldurl);
1598 for (i = 0; i < urlset_nr; i++)
1599 if (!regexec(&old_regex, urlset[i], 0, NULL, 0))
1603 if (!delete_mode && !matches)
1604 die(_("No such URL found: %s"), oldurl);
1605 if (delete_mode && !negative_matches && !push_mode)
1606 die(_("Will not delete all non-push URLs"));
1608 regfree(&old_regex);
1611 git_config_set_multivar(name_buf.buf, newurl, oldurl, 0);
1613 git_config_set_multivar(name_buf.buf, NULL, oldurl, 1);
1617 int cmd_remote(int argc, const char **argv, const char *prefix)
1619 struct option options[] = {
1620 OPT__VERBOSE(&verbose, N_("be verbose; must be placed before a subcommand")),
1625 argc = parse_options(argc, argv, prefix, options, builtin_remote_usage,
1626 PARSE_OPT_STOP_AT_NON_OPTION);
1629 result = show_all();
1630 else if (!strcmp(argv[0], "add"))
1631 result = add(argc, argv);
1632 else if (!strcmp(argv[0], "rename"))
1633 result = mv(argc, argv);
1634 else if (!strcmp(argv[0], "rm") || !strcmp(argv[0], "remove"))
1635 result = rm(argc, argv);
1636 else if (!strcmp(argv[0], "set-head"))
1637 result = set_head(argc, argv);
1638 else if (!strcmp(argv[0], "set-branches"))
1639 result = set_branches(argc, argv);
1640 else if (!strcmp(argv[0], "get-url"))
1641 result = get_url(argc, argv);
1642 else if (!strcmp(argv[0], "set-url"))
1643 result = set_url(argc, argv);
1644 else if (!strcmp(argv[0], "show"))
1645 result = show(argc, argv);
1646 else if (!strcmp(argv[0], "prune"))
1647 result = prune(argc, argv);
1648 else if (!strcmp(argv[0], "update"))
1649 result = update(argc, argv);
1651 error(_("Unknown subcommand: %s"), argv[0]);
1652 usage_with_options(builtin_remote_usage, options);
1655 return result ? 1 : 0;