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=<fetch|push>] <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 #define MIRROR_NONE 0
121 #define MIRROR_FETCH 1
122 #define MIRROR_PUSH 2
123 #define MIRROR_BOTH (MIRROR_FETCH|MIRROR_PUSH)
125 static int add_branch(const char *key, const char *branchname,
126 const char *remotename, int mirror, struct strbuf *tmp)
129 strbuf_addch(tmp, '+');
131 strbuf_addf(tmp, "refs/%s:refs/%s",
132 branchname, branchname);
134 strbuf_addf(tmp, "refs/heads/%s:refs/remotes/%s/%s",
135 branchname, remotename, branchname);
136 return git_config_set_multivar(key, tmp->buf, "^$", 0);
139 static const char mirror_advice[] =
140 "--mirror is dangerous and deprecated; please\n"
141 "\t use --mirror=fetch or --mirror=push instead";
143 static int parse_mirror_opt(const struct option *opt, const char *arg, int not)
145 unsigned *mirror = opt->value;
147 *mirror = MIRROR_NONE;
149 warning("%s", mirror_advice);
150 *mirror = MIRROR_BOTH;
152 else if (!strcmp(arg, "fetch"))
153 *mirror = MIRROR_FETCH;
154 else if (!strcmp(arg, "push"))
155 *mirror = MIRROR_PUSH;
157 return error("unknown mirror argument: %s", arg);
161 static int add(int argc, const char **argv)
163 int fetch = 0, fetch_tags = TAGS_DEFAULT;
164 unsigned mirror = MIRROR_NONE;
165 struct string_list track = STRING_LIST_INIT_NODUP;
166 const char *master = NULL;
167 struct remote *remote;
168 struct strbuf buf = STRBUF_INIT, buf2 = STRBUF_INIT;
169 const char *name, *url;
172 struct option options[] = {
173 OPT_BOOLEAN('f', "fetch", &fetch, "fetch the remote branches"),
174 OPT_SET_INT(0, "tags", &fetch_tags,
175 "import all tags and associated objects when fetching",
177 OPT_SET_INT(0, NULL, &fetch_tags,
178 "or do not fetch any tag at all (--no-tags)", TAGS_UNSET),
179 OPT_CALLBACK('t', "track", &track, "branch",
180 "branch(es) to track", opt_parse_track),
181 OPT_STRING('m', "master", &master, "branch", "master branch"),
182 { OPTION_CALLBACK, 0, "mirror", &mirror, "push|fetch",
183 "set up remote as a mirror to push to or fetch from",
184 PARSE_OPT_OPTARG, parse_mirror_opt },
188 argc = parse_options(argc, argv, NULL, options, builtin_remote_add_usage,
192 usage_with_options(builtin_remote_add_usage, options);
194 if (mirror && master)
195 die("specifying a master branch makes no sense with --mirror");
196 if (mirror && !(mirror & MIRROR_FETCH) && track.nr)
197 die("specifying branches to track makes sense only with fetch mirrors");
202 remote = remote_get(name);
203 if (remote && (remote->url_nr > 1 || strcmp(name, remote->url[0]) ||
204 remote->fetch_refspec_nr))
205 die("remote %s already exists.", name);
207 strbuf_addf(&buf2, "refs/heads/test:refs/remotes/%s/test", name);
208 if (!valid_fetch_refspec(buf2.buf))
209 die("'%s' is not a valid remote name", name);
211 strbuf_addf(&buf, "remote.%s.url", name);
212 if (git_config_set(buf.buf, url))
215 if (!mirror || mirror & MIRROR_FETCH) {
217 strbuf_addf(&buf, "remote.%s.fetch", name);
219 string_list_append(&track, "*");
220 for (i = 0; i < track.nr; i++) {
221 if (add_branch(buf.buf, track.items[i].string,
222 name, mirror, &buf2))
227 if (mirror & MIRROR_PUSH) {
229 strbuf_addf(&buf, "remote.%s.mirror", name);
230 if (git_config_set(buf.buf, "true"))
234 if (fetch_tags != TAGS_DEFAULT) {
236 strbuf_addf(&buf, "remote.%s.tagopt", name);
237 if (git_config_set(buf.buf,
238 fetch_tags == TAGS_SET ? "--tags" : "--no-tags"))
242 if (fetch && fetch_remote(name))
247 strbuf_addf(&buf, "refs/remotes/%s/HEAD", name);
250 strbuf_addf(&buf2, "refs/remotes/%s/%s", name, master);
252 if (create_symref(buf.buf, buf2.buf, "remote add"))
253 return error("Could not setup master '%s'", master);
256 strbuf_release(&buf);
257 strbuf_release(&buf2);
258 string_list_clear(&track, 0);
265 struct string_list merge;
269 static struct string_list branch_list;
271 static const char *abbrev_ref(const char *name, const char *prefix)
273 const char *abbrev = skip_prefix(name, prefix);
278 #define abbrev_branch(name) abbrev_ref((name), "refs/heads/")
280 static int config_read_branches(const char *key, const char *value, void *cb)
282 if (!prefixcmp(key, "branch.")) {
283 const char *orig_key = key;
285 struct string_list_item *item;
286 struct branch_info *info;
287 enum { REMOTE, MERGE, REBASE } type;
290 if (!postfixcmp(key, ".remote")) {
291 name = xstrndup(key, strlen(key) - 7);
293 } else if (!postfixcmp(key, ".merge")) {
294 name = xstrndup(key, strlen(key) - 6);
296 } else if (!postfixcmp(key, ".rebase")) {
297 name = xstrndup(key, strlen(key) - 7);
302 item = string_list_insert(&branch_list, name);
305 item->util = xcalloc(sizeof(struct branch_info), 1);
307 if (type == REMOTE) {
308 if (info->remote_name)
309 warning("more than one %s", orig_key);
310 info->remote_name = xstrdup(value);
311 } else if (type == MERGE) {
312 char *space = strchr(value, ' ');
313 value = abbrev_branch(value);
316 merge = xstrndup(value, space - value);
317 string_list_append(&info->merge, merge);
318 value = abbrev_branch(space + 1);
319 space = strchr(value, ' ');
321 string_list_append(&info->merge, xstrdup(value));
323 info->rebase = git_config_bool(orig_key, value);
328 static void read_branches(void)
332 git_config(config_read_branches, NULL);
336 struct remote *remote;
337 struct string_list new, stale, tracked, heads, push;
341 static int get_ref_states(const struct ref *remote_refs, struct ref_states *states)
343 struct ref *fetch_map = NULL, **tail = &fetch_map;
344 struct ref *ref, *stale_refs;
347 for (i = 0; i < states->remote->fetch_refspec_nr; i++)
348 if (get_fetch_map(remote_refs, states->remote->fetch + i, &tail, 1))
349 die("Could not get fetch map for refspec %s",
350 states->remote->fetch_refspec[i]);
352 states->new.strdup_strings = 1;
353 states->tracked.strdup_strings = 1;
354 states->stale.strdup_strings = 1;
355 for (ref = fetch_map; ref; ref = ref->next) {
356 unsigned char sha1[20];
357 if (!ref->peer_ref || read_ref(ref->peer_ref->name, sha1))
358 string_list_append(&states->new, abbrev_branch(ref->name));
360 string_list_append(&states->tracked, abbrev_branch(ref->name));
362 stale_refs = get_stale_heads(states->remote, fetch_map);
363 for (ref = stale_refs; ref; ref = ref->next) {
364 struct string_list_item *item =
365 string_list_append(&states->stale, abbrev_branch(ref->name));
366 item->util = xstrdup(ref->name);
368 free_refs(stale_refs);
369 free_refs(fetch_map);
371 sort_string_list(&states->new);
372 sort_string_list(&states->tracked);
373 sort_string_list(&states->stale);
382 PUSH_STATUS_CREATE = 0,
384 PUSH_STATUS_UPTODATE,
385 PUSH_STATUS_FASTFORWARD,
386 PUSH_STATUS_OUTOFDATE,
387 PUSH_STATUS_NOTQUERIED
391 static int get_push_ref_states(const struct ref *remote_refs,
392 struct ref_states *states)
394 struct remote *remote = states->remote;
395 struct ref *ref, *local_refs, *push_map;
399 local_refs = get_local_heads();
400 push_map = copy_ref_list(remote_refs);
402 match_refs(local_refs, &push_map, remote->push_refspec_nr,
403 remote->push_refspec, MATCH_REFS_NONE);
405 states->push.strdup_strings = 1;
406 for (ref = push_map; ref; ref = ref->next) {
407 struct string_list_item *item;
408 struct push_info *info;
412 hashcpy(ref->new_sha1, ref->peer_ref->new_sha1);
414 item = string_list_append(&states->push,
415 abbrev_branch(ref->peer_ref->name));
416 item->util = xcalloc(sizeof(struct push_info), 1);
418 info->forced = ref->force;
419 info->dest = xstrdup(abbrev_branch(ref->name));
421 if (is_null_sha1(ref->new_sha1)) {
422 info->status = PUSH_STATUS_DELETE;
423 } else if (!hashcmp(ref->old_sha1, ref->new_sha1))
424 info->status = PUSH_STATUS_UPTODATE;
425 else if (is_null_sha1(ref->old_sha1))
426 info->status = PUSH_STATUS_CREATE;
427 else if (has_sha1_file(ref->old_sha1) &&
428 ref_newer(ref->new_sha1, ref->old_sha1))
429 info->status = PUSH_STATUS_FASTFORWARD;
431 info->status = PUSH_STATUS_OUTOFDATE;
433 free_refs(local_refs);
438 static int get_push_ref_states_noquery(struct ref_states *states)
441 struct remote *remote = states->remote;
442 struct string_list_item *item;
443 struct push_info *info;
448 states->push.strdup_strings = 1;
449 if (!remote->push_refspec_nr) {
450 item = string_list_append(&states->push, "(matching)");
451 info = item->util = xcalloc(sizeof(struct push_info), 1);
452 info->status = PUSH_STATUS_NOTQUERIED;
453 info->dest = xstrdup(item->string);
455 for (i = 0; i < remote->push_refspec_nr; i++) {
456 struct refspec *spec = remote->push + i;
458 item = string_list_append(&states->push, "(matching)");
459 else if (strlen(spec->src))
460 item = string_list_append(&states->push, spec->src);
462 item = string_list_append(&states->push, "(delete)");
464 info = item->util = xcalloc(sizeof(struct push_info), 1);
465 info->forced = spec->force;
466 info->status = PUSH_STATUS_NOTQUERIED;
467 info->dest = xstrdup(spec->dst ? spec->dst : item->string);
472 static int get_head_names(const struct ref *remote_refs, struct ref_states *states)
474 struct ref *ref, *matches;
475 struct ref *fetch_map = NULL, **fetch_map_tail = &fetch_map;
476 struct refspec refspec;
480 refspec.src = refspec.dst = "refs/heads/*";
481 states->heads.strdup_strings = 1;
482 get_fetch_map(remote_refs, &refspec, &fetch_map_tail, 0);
483 matches = guess_remote_head(find_ref_by_name(remote_refs, "HEAD"),
485 for (ref = matches; ref; ref = ref->next)
486 string_list_append(&states->heads, abbrev_branch(ref->name));
488 free_refs(fetch_map);
494 struct known_remote {
495 struct known_remote *next;
496 struct remote *remote;
499 struct known_remotes {
500 struct remote *to_delete;
501 struct known_remote *list;
504 static int add_known_remote(struct remote *remote, void *cb_data)
506 struct known_remotes *all = cb_data;
507 struct known_remote *r;
509 if (!strcmp(all->to_delete->name, remote->name))
512 r = xmalloc(sizeof(*r));
519 struct branches_for_remote {
520 struct remote *remote;
521 struct string_list *branches, *skipped;
522 struct known_remotes *keep;
525 static int add_branch_for_removal(const char *refname,
526 const unsigned char *sha1, int flags, void *cb_data)
528 struct branches_for_remote *branches = cb_data;
529 struct refspec refspec;
530 struct string_list_item *item;
531 struct known_remote *kr;
533 memset(&refspec, 0, sizeof(refspec));
534 refspec.dst = (char *)refname;
535 if (remote_find_tracking(branches->remote, &refspec))
538 /* don't delete a branch if another remote also uses it */
539 for (kr = branches->keep->list; kr; kr = kr->next) {
540 memset(&refspec, 0, sizeof(refspec));
541 refspec.dst = (char *)refname;
542 if (!remote_find_tracking(kr->remote, &refspec))
546 /* don't delete non-remote-tracking refs */
547 if (prefixcmp(refname, "refs/remotes")) {
548 /* advise user how to delete local branches */
549 if (!prefixcmp(refname, "refs/heads/"))
550 string_list_append(branches->skipped,
551 abbrev_branch(refname));
552 /* silently skip over other non-remote refs */
556 /* make sure that symrefs are deleted */
557 if (flags & REF_ISSYMREF)
558 return unlink(git_path("%s", refname));
560 item = string_list_append(branches->branches, refname);
561 item->util = xmalloc(20);
562 hashcpy(item->util, sha1);
570 struct string_list *remote_branches;
573 static int read_remote_branches(const char *refname,
574 const unsigned char *sha1, int flags, void *cb_data)
576 struct rename_info *rename = cb_data;
577 struct strbuf buf = STRBUF_INIT;
578 struct string_list_item *item;
580 unsigned char orig_sha1[20];
583 strbuf_addf(&buf, "refs/remotes/%s", rename->old);
584 if (!prefixcmp(refname, buf.buf)) {
585 item = string_list_append(rename->remote_branches, xstrdup(refname));
586 symref = resolve_ref(refname, orig_sha1, 1, &flag);
587 if (flag & REF_ISSYMREF)
588 item->util = xstrdup(symref);
596 static int migrate_file(struct remote *remote)
598 struct strbuf buf = STRBUF_INIT;
602 strbuf_addf(&buf, "remote.%s.url", remote->name);
603 for (i = 0; i < remote->url_nr; i++)
604 if (git_config_set_multivar(buf.buf, remote->url[i], "^$", 0))
605 return error("Could not append '%s' to '%s'",
606 remote->url[i], buf.buf);
608 strbuf_addf(&buf, "remote.%s.push", remote->name);
609 for (i = 0; i < remote->push_refspec_nr; i++)
610 if (git_config_set_multivar(buf.buf, remote->push_refspec[i], "^$", 0))
611 return error("Could not append '%s' to '%s'",
612 remote->push_refspec[i], buf.buf);
614 strbuf_addf(&buf, "remote.%s.fetch", remote->name);
615 for (i = 0; i < remote->fetch_refspec_nr; i++)
616 if (git_config_set_multivar(buf.buf, remote->fetch_refspec[i], "^$", 0))
617 return error("Could not append '%s' to '%s'",
618 remote->fetch_refspec[i], buf.buf);
619 if (remote->origin == REMOTE_REMOTES)
620 path = git_path("remotes/%s", remote->name);
621 else if (remote->origin == REMOTE_BRANCHES)
622 path = git_path("branches/%s", remote->name);
624 unlink_or_warn(path);
628 static int mv(int argc, const char **argv)
630 struct option options[] = {
633 struct remote *oldremote, *newremote;
634 struct strbuf buf = STRBUF_INIT, buf2 = STRBUF_INIT, buf3 = STRBUF_INIT;
635 struct string_list remote_branches = STRING_LIST_INIT_NODUP;
636 struct rename_info rename;
640 usage_with_options(builtin_remote_rename_usage, options);
642 rename.old = argv[1];
643 rename.new = argv[2];
644 rename.remote_branches = &remote_branches;
646 oldremote = remote_get(rename.old);
648 die("No such remote: %s", rename.old);
650 if (!strcmp(rename.old, rename.new) && oldremote->origin != REMOTE_CONFIG)
651 return migrate_file(oldremote);
653 newremote = remote_get(rename.new);
654 if (newremote && (newremote->url_nr > 1 || newremote->fetch_refspec_nr))
655 die("remote %s already exists.", rename.new);
657 strbuf_addf(&buf, "refs/heads/test:refs/remotes/%s/test", rename.new);
658 if (!valid_fetch_refspec(buf.buf))
659 die("'%s' is not a valid remote name", rename.new);
662 strbuf_addf(&buf, "remote.%s", rename.old);
663 strbuf_addf(&buf2, "remote.%s", rename.new);
664 if (git_config_rename_section(buf.buf, buf2.buf) < 1)
665 return error("Could not rename config section '%s' to '%s'",
669 strbuf_addf(&buf, "remote.%s.fetch", rename.new);
670 if (git_config_set_multivar(buf.buf, NULL, NULL, 1))
671 return error("Could not remove config section '%s'", buf.buf);
672 for (i = 0; i < oldremote->fetch_refspec_nr; i++) {
676 strbuf_addstr(&buf2, oldremote->fetch_refspec[i]);
677 ptr = strstr(buf2.buf, rename.old);
679 strbuf_splice(&buf2, ptr-buf2.buf, strlen(rename.old),
680 rename.new, strlen(rename.new));
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);
699 * First remove symrefs, then rename the rest, finally create
702 for_each_ref(read_remote_branches, &rename);
703 for (i = 0; i < remote_branches.nr; i++) {
704 struct string_list_item *item = remote_branches.items + i;
706 unsigned char sha1[20];
708 resolve_ref(item->string, sha1, 1, &flag);
709 if (!(flag & REF_ISSYMREF))
711 if (delete_ref(item->string, NULL, REF_NODEREF))
712 die("deleting '%s' failed", item->string);
714 for (i = 0; i < remote_branches.nr; i++) {
715 struct string_list_item *item = remote_branches.items + i;
720 strbuf_addstr(&buf, item->string);
721 strbuf_splice(&buf, strlen("refs/remotes/"), strlen(rename.old),
722 rename.new, strlen(rename.new));
724 strbuf_addf(&buf2, "remote: renamed %s to %s",
725 item->string, buf.buf);
726 if (rename_ref(item->string, buf.buf, buf2.buf))
727 die("renaming '%s' failed", item->string);
729 for (i = 0; i < remote_branches.nr; i++) {
730 struct string_list_item *item = remote_branches.items + i;
735 strbuf_addstr(&buf, item->string);
736 strbuf_splice(&buf, strlen("refs/remotes/"), strlen(rename.old),
737 rename.new, strlen(rename.new));
739 strbuf_addstr(&buf2, item->util);
740 strbuf_splice(&buf2, strlen("refs/remotes/"), strlen(rename.old),
741 rename.new, strlen(rename.new));
743 strbuf_addf(&buf3, "remote: renamed %s to %s",
744 item->string, buf.buf);
745 if (create_symref(buf.buf, buf2.buf, buf3.buf))
746 die("creating '%s' failed", buf.buf);
751 static int remove_branches(struct string_list *branches)
754 for (i = 0; i < branches->nr; i++) {
755 struct string_list_item *item = branches->items + i;
756 const char *refname = item->string;
757 unsigned char *sha1 = item->util;
759 if (delete_ref(refname, sha1, 0))
760 result |= error("Could not remove branch %s", refname);
765 static int rm(int argc, const char **argv)
767 struct option options[] = {
770 struct remote *remote;
771 struct strbuf buf = STRBUF_INIT;
772 struct known_remotes known_remotes = { NULL, NULL };
773 struct string_list branches = STRING_LIST_INIT_DUP;
774 struct string_list skipped = STRING_LIST_INIT_DUP;
775 struct branches_for_remote cb_data;
778 memset(&cb_data, 0, sizeof(cb_data));
779 cb_data.branches = &branches;
780 cb_data.skipped = &skipped;
781 cb_data.keep = &known_remotes;
784 usage_with_options(builtin_remote_rm_usage, options);
786 remote = remote_get(argv[1]);
788 die("No such remote: %s", argv[1]);
790 known_remotes.to_delete = remote;
791 for_each_remote(add_known_remote, &known_remotes);
793 strbuf_addf(&buf, "remote.%s", remote->name);
794 if (git_config_rename_section(buf.buf, NULL) < 1)
795 return error("Could not remove config section '%s'", buf.buf);
798 for (i = 0; i < branch_list.nr; i++) {
799 struct string_list_item *item = branch_list.items + i;
800 struct branch_info *info = item->util;
801 if (info->remote_name && !strcmp(info->remote_name, remote->name)) {
802 const char *keys[] = { "remote", "merge", NULL }, **k;
803 for (k = keys; *k; k++) {
805 strbuf_addf(&buf, "branch.%s.%s",
807 if (git_config_set(buf.buf, NULL)) {
808 strbuf_release(&buf);
816 * We cannot just pass a function to for_each_ref() which deletes
817 * the branches one by one, since for_each_ref() relies on cached
818 * refs, which are invalidated when deleting a branch.
820 cb_data.remote = remote;
821 result = for_each_ref(add_branch_for_removal, &cb_data);
822 strbuf_release(&buf);
825 result = remove_branches(&branches);
826 string_list_clear(&branches, 1);
829 fprintf(stderr, skipped.nr == 1 ?
830 "Note: A branch outside the refs/remotes/ hierarchy was not removed;\n"
831 "to delete it, use:\n" :
832 "Note: Some branches outside the refs/remotes/ hierarchy were not removed;\n"
833 "to delete them, use:\n");
834 for (i = 0; i < skipped.nr; i++)
835 fprintf(stderr, " git branch -d %s\n",
836 skipped.items[i].string);
838 string_list_clear(&skipped, 0);
843 static void clear_push_info(void *util, const char *string)
845 struct push_info *info = util;
850 static void free_remote_ref_states(struct ref_states *states)
852 string_list_clear(&states->new, 0);
853 string_list_clear(&states->stale, 1);
854 string_list_clear(&states->tracked, 0);
855 string_list_clear(&states->heads, 0);
856 string_list_clear_func(&states->push, clear_push_info);
859 static int append_ref_to_tracked_list(const char *refname,
860 const unsigned char *sha1, int flags, void *cb_data)
862 struct ref_states *states = cb_data;
863 struct refspec refspec;
865 if (flags & REF_ISSYMREF)
868 memset(&refspec, 0, sizeof(refspec));
869 refspec.dst = (char *)refname;
870 if (!remote_find_tracking(states->remote, &refspec))
871 string_list_append(&states->tracked, abbrev_branch(refspec.src));
876 static int get_remote_ref_states(const char *name,
877 struct ref_states *states,
880 struct transport *transport;
881 const struct ref *remote_refs;
883 states->remote = remote_get(name);
885 return error("No such remote: %s", name);
890 transport = transport_get(states->remote, states->remote->url_nr > 0 ?
891 states->remote->url[0] : NULL);
892 remote_refs = transport_get_remote_refs(transport);
893 transport_disconnect(transport);
896 if (query & GET_REF_STATES)
897 get_ref_states(remote_refs, states);
898 if (query & GET_HEAD_NAMES)
899 get_head_names(remote_refs, states);
900 if (query & GET_PUSH_REF_STATES)
901 get_push_ref_states(remote_refs, states);
903 for_each_ref(append_ref_to_tracked_list, states);
904 sort_string_list(&states->tracked);
905 get_push_ref_states_noquery(states);
912 struct string_list *list;
913 struct ref_states *states;
918 static int add_remote_to_show_info(struct string_list_item *item, void *cb_data)
920 struct show_info *info = cb_data;
921 int n = strlen(item->string);
924 string_list_insert(info->list, item->string);
928 static int show_remote_info_item(struct string_list_item *item, void *cb_data)
930 struct show_info *info = cb_data;
931 struct ref_states *states = info->states;
932 const char *name = item->string;
934 if (states->queried) {
935 const char *fmt = "%s";
936 const char *arg = "";
937 if (string_list_has_string(&states->new, name)) {
938 fmt = " new (next fetch will store in remotes/%s)";
939 arg = states->remote->name;
940 } else if (string_list_has_string(&states->tracked, name))
942 else if (string_list_has_string(&states->stale, name))
943 arg = " stale (use 'git remote prune' to remove)";
946 printf(" %-*s", info->width, name);
950 printf(" %s\n", name);
955 static int add_local_to_show_info(struct string_list_item *branch_item, void *cb_data)
957 struct show_info *show_info = cb_data;
958 struct ref_states *states = show_info->states;
959 struct branch_info *branch_info = branch_item->util;
960 struct string_list_item *item;
963 if (!branch_info->merge.nr || !branch_info->remote_name ||
964 strcmp(states->remote->name, branch_info->remote_name))
966 if ((n = strlen(branch_item->string)) > show_info->width)
967 show_info->width = n;
968 if (branch_info->rebase)
969 show_info->any_rebase = 1;
971 item = string_list_insert(show_info->list, branch_item->string);
972 item->util = branch_info;
977 static int show_local_info_item(struct string_list_item *item, void *cb_data)
979 struct show_info *show_info = cb_data;
980 struct branch_info *branch_info = item->util;
981 struct string_list *merge = &branch_info->merge;
985 if (branch_info->rebase && branch_info->merge.nr > 1) {
986 error("invalid branch.%s.merge; cannot rebase onto > 1 branch",
991 printf(" %-*s ", show_info->width, item->string);
992 if (branch_info->rebase) {
993 printf("rebases onto remote %s\n", merge->items[0].string);
995 } else if (show_info->any_rebase) {
996 printf(" merges with remote %s\n", merge->items[0].string);
997 also = " and with remote";
999 printf("merges with remote %s\n", merge->items[0].string);
1000 also = " and with remote";
1002 for (i = 1; i < merge->nr; i++)
1003 printf(" %-*s %s %s\n", show_info->width, "", also,
1004 merge->items[i].string);
1009 static int add_push_to_show_info(struct string_list_item *push_item, void *cb_data)
1011 struct show_info *show_info = cb_data;
1012 struct push_info *push_info = push_item->util;
1013 struct string_list_item *item;
1015 if ((n = strlen(push_item->string)) > show_info->width)
1016 show_info->width = n;
1017 if ((n = strlen(push_info->dest)) > show_info->width2)
1018 show_info->width2 = n;
1019 item = string_list_append(show_info->list, push_item->string);
1020 item->util = push_item->util;
1025 * Sorting comparison for a string list that has push_info
1026 * structs in its util field
1028 static int cmp_string_with_push(const void *va, const void *vb)
1030 const struct string_list_item *a = va;
1031 const struct string_list_item *b = vb;
1032 const struct push_info *a_push = a->util;
1033 const struct push_info *b_push = b->util;
1034 int cmp = strcmp(a->string, b->string);
1035 return cmp ? cmp : strcmp(a_push->dest, b_push->dest);
1038 static int show_push_info_item(struct string_list_item *item, void *cb_data)
1040 struct show_info *show_info = cb_data;
1041 struct push_info *push_info = item->util;
1042 char *src = item->string, *status = NULL;
1044 switch (push_info->status) {
1045 case PUSH_STATUS_CREATE:
1048 case PUSH_STATUS_DELETE:
1052 case PUSH_STATUS_UPTODATE:
1053 status = "up to date";
1055 case PUSH_STATUS_FASTFORWARD:
1056 status = "fast-forwardable";
1058 case PUSH_STATUS_OUTOFDATE:
1059 status = "local out of date";
1061 case PUSH_STATUS_NOTQUERIED:
1065 printf(" %-*s %s to %-*s (%s)\n", show_info->width, src,
1066 push_info->forced ? "forces" : "pushes",
1067 show_info->width2, push_info->dest, status);
1069 printf(" %-*s %s to %s\n", show_info->width, src,
1070 push_info->forced ? "forces" : "pushes",
1075 static int show(int argc, const char **argv)
1077 int no_query = 0, result = 0, query_flag = 0;
1078 struct option options[] = {
1079 OPT_BOOLEAN('n', NULL, &no_query, "do not query remotes"),
1082 struct ref_states states;
1083 struct string_list info_list = STRING_LIST_INIT_NODUP;
1084 struct show_info info;
1086 argc = parse_options(argc, argv, NULL, options, builtin_remote_show_usage,
1093 query_flag = (GET_REF_STATES | GET_HEAD_NAMES | GET_PUSH_REF_STATES);
1095 memset(&states, 0, sizeof(states));
1096 memset(&info, 0, sizeof(info));
1097 info.states = &states;
1098 info.list = &info_list;
1099 for (; argc; argc--, argv++) {
1104 get_remote_ref_states(*argv, &states, query_flag);
1106 printf("* remote %s\n", *argv);
1107 printf(" Fetch URL: %s\n", states.remote->url_nr > 0 ?
1108 states.remote->url[0] : "(no URL)");
1109 if (states.remote->pushurl_nr) {
1110 url = states.remote->pushurl;
1111 url_nr = states.remote->pushurl_nr;
1113 url = states.remote->url;
1114 url_nr = states.remote->url_nr;
1116 for (i=0; i < url_nr; i++)
1117 printf(" Push URL: %s\n", url[i]);
1119 printf(" Push URL: %s\n", "(no URL)");
1121 printf(" HEAD branch: (not queried)\n");
1122 else if (!states.heads.nr)
1123 printf(" HEAD branch: (unknown)\n");
1124 else if (states.heads.nr == 1)
1125 printf(" HEAD branch: %s\n", states.heads.items[0].string);
1127 printf(" HEAD branch (remote HEAD is ambiguous,"
1128 " may be one of the following):\n");
1129 for (i = 0; i < states.heads.nr; i++)
1130 printf(" %s\n", states.heads.items[i].string);
1133 /* remote branch info */
1135 for_each_string_list(&states.new, add_remote_to_show_info, &info);
1136 for_each_string_list(&states.tracked, add_remote_to_show_info, &info);
1137 for_each_string_list(&states.stale, add_remote_to_show_info, &info);
1139 printf(" Remote branch%s:%s\n",
1140 info.list->nr > 1 ? "es" : "",
1141 no_query ? " (status not queried)" : "");
1142 for_each_string_list(info.list, show_remote_info_item, &info);
1143 string_list_clear(info.list, 0);
1147 info.any_rebase = 0;
1148 for_each_string_list(&branch_list, add_local_to_show_info, &info);
1150 printf(" Local branch%s configured for 'git pull':\n",
1151 info.list->nr > 1 ? "es" : "");
1152 for_each_string_list(info.list, show_local_info_item, &info);
1153 string_list_clear(info.list, 0);
1156 if (states.remote->mirror)
1157 printf(" Local refs will be mirrored by 'git push'\n");
1159 info.width = info.width2 = 0;
1160 for_each_string_list(&states.push, add_push_to_show_info, &info);
1161 qsort(info.list->items, info.list->nr,
1162 sizeof(*info.list->items), cmp_string_with_push);
1164 printf(" Local ref%s configured for 'git push'%s:\n",
1165 info.list->nr > 1 ? "s" : "",
1166 no_query ? " (status not queried)" : "");
1167 for_each_string_list(info.list, show_push_info_item, &info);
1168 string_list_clear(info.list, 0);
1170 free_remote_ref_states(&states);
1176 static int set_head(int argc, const char **argv)
1178 int i, opt_a = 0, opt_d = 0, result = 0;
1179 struct strbuf buf = STRBUF_INIT, buf2 = STRBUF_INIT;
1180 char *head_name = NULL;
1182 struct option options[] = {
1183 OPT_BOOLEAN('a', "auto", &opt_a,
1184 "set refs/remotes/<name>/HEAD according to remote"),
1185 OPT_BOOLEAN('d', "delete", &opt_d,
1186 "delete refs/remotes/<name>/HEAD"),
1189 argc = parse_options(argc, argv, NULL, options, builtin_remote_sethead_usage,
1192 strbuf_addf(&buf, "refs/remotes/%s/HEAD", argv[0]);
1194 if (!opt_a && !opt_d && argc == 2) {
1195 head_name = xstrdup(argv[1]);
1196 } else if (opt_a && !opt_d && argc == 1) {
1197 struct ref_states states;
1198 memset(&states, 0, sizeof(states));
1199 get_remote_ref_states(argv[0], &states, GET_HEAD_NAMES);
1200 if (!states.heads.nr)
1201 result |= error("Cannot determine remote HEAD");
1202 else if (states.heads.nr > 1) {
1203 result |= error("Multiple remote HEAD branches. "
1204 "Please choose one explicitly with:");
1205 for (i = 0; i < states.heads.nr; i++)
1206 fprintf(stderr, " git remote set-head %s %s\n",
1207 argv[0], states.heads.items[i].string);
1209 head_name = xstrdup(states.heads.items[0].string);
1210 free_remote_ref_states(&states);
1211 } else if (opt_d && !opt_a && argc == 1) {
1212 if (delete_ref(buf.buf, NULL, REF_NODEREF))
1213 result |= error("Could not delete %s", buf.buf);
1215 usage_with_options(builtin_remote_sethead_usage, options);
1218 unsigned char sha1[20];
1219 strbuf_addf(&buf2, "refs/remotes/%s/%s", argv[0], head_name);
1220 /* make sure it's valid */
1221 if (!resolve_ref(buf2.buf, sha1, 1, NULL))
1222 result |= error("Not a valid ref: %s", buf2.buf);
1223 else if (create_symref(buf.buf, buf2.buf, "remote set-head"))
1224 result |= error("Could not setup %s", buf.buf);
1226 printf("%s/HEAD set to %s\n", argv[0], head_name);
1230 strbuf_release(&buf);
1231 strbuf_release(&buf2);
1235 static int prune(int argc, const char **argv)
1237 int dry_run = 0, result = 0;
1238 struct option options[] = {
1239 OPT__DRY_RUN(&dry_run, "dry run"),
1243 argc = parse_options(argc, argv, NULL, options, builtin_remote_prune_usage,
1247 usage_with_options(builtin_remote_prune_usage, options);
1249 for (; argc; argc--, argv++)
1250 result |= prune_remote(*argv, dry_run);
1255 static int prune_remote(const char *remote, int dry_run)
1258 struct ref_states states;
1259 const char *dangling_msg = dry_run
1260 ? " %s will become dangling!\n"
1261 : " %s has become dangling!\n";
1263 memset(&states, 0, sizeof(states));
1264 get_remote_ref_states(remote, &states, GET_REF_STATES);
1266 if (states.stale.nr) {
1267 printf("Pruning %s\n", remote);
1269 states.remote->url_nr
1270 ? states.remote->url[0]
1274 for (i = 0; i < states.stale.nr; i++) {
1275 const char *refname = states.stale.items[i].util;
1278 result |= delete_ref(refname, NULL, 0);
1280 printf(" * [%s] %s\n", dry_run ? "would prune" : "pruned",
1281 abbrev_ref(refname, "refs/remotes/"));
1282 warn_dangling_symref(stdout, dangling_msg, refname);
1285 free_remote_ref_states(&states);
1289 static int get_remote_default(const char *key, const char *value, void *priv)
1291 if (strcmp(key, "remotes.default") == 0) {
1298 static int update(int argc, const char **argv)
1301 struct option options[] = {
1302 OPT_BOOLEAN('p', "prune", &prune,
1303 "prune remotes after fetching"),
1306 const char **fetch_argv;
1308 int default_defined = 0;
1310 fetch_argv = xmalloc(sizeof(char *) * (argc+5));
1312 argc = parse_options(argc, argv, NULL, options, builtin_remote_update_usage,
1313 PARSE_OPT_KEEP_ARGV0);
1315 fetch_argv[fetch_argc++] = "fetch";
1318 fetch_argv[fetch_argc++] = "--prune";
1320 fetch_argv[fetch_argc++] = "-v";
1321 fetch_argv[fetch_argc++] = "--multiple";
1323 fetch_argv[fetch_argc++] = "default";
1324 for (i = 1; i < argc; i++)
1325 fetch_argv[fetch_argc++] = argv[i];
1327 if (strcmp(fetch_argv[fetch_argc-1], "default") == 0) {
1328 git_config(get_remote_default, &default_defined);
1329 if (!default_defined)
1330 fetch_argv[fetch_argc-1] = "--all";
1333 fetch_argv[fetch_argc] = NULL;
1335 return run_command_v_opt(fetch_argv, RUN_GIT_CMD);
1338 static int remove_all_fetch_refspecs(const char *remote, const char *key)
1340 return git_config_set_multivar(key, NULL, NULL, 1);
1343 static int add_branches(struct remote *remote, const char **branches,
1346 const char *remotename = remote->name;
1347 int mirror = remote->mirror;
1348 struct strbuf refspec = STRBUF_INIT;
1350 for (; *branches; branches++)
1351 if (add_branch(key, *branches, remotename, mirror, &refspec)) {
1352 strbuf_release(&refspec);
1356 strbuf_release(&refspec);
1360 static int set_remote_branches(const char *remotename, const char **branches,
1363 struct strbuf key = STRBUF_INIT;
1364 struct remote *remote;
1366 strbuf_addf(&key, "remote.%s.fetch", remotename);
1368 if (!remote_is_configured(remotename))
1369 die("No such remote '%s'", remotename);
1370 remote = remote_get(remotename);
1372 if (!add_mode && remove_all_fetch_refspecs(remotename, key.buf)) {
1373 strbuf_release(&key);
1376 if (add_branches(remote, branches, key.buf)) {
1377 strbuf_release(&key);
1381 strbuf_release(&key);
1385 static int set_branches(int argc, const char **argv)
1388 struct option options[] = {
1389 OPT_BOOLEAN('\0', "add", &add_mode, "add branch"),
1393 argc = parse_options(argc, argv, NULL, options,
1394 builtin_remote_setbranches_usage, 0);
1396 error("no remote specified");
1397 usage_with_options(builtin_remote_seturl_usage, options);
1401 return set_remote_branches(argv[0], argv + 1, add_mode);
1404 static int set_url(int argc, const char **argv)
1406 int i, push_mode = 0, add_mode = 0, delete_mode = 0;
1407 int matches = 0, negative_matches = 0;
1408 const char *remotename = NULL;
1409 const char *newurl = NULL;
1410 const char *oldurl = NULL;
1411 struct remote *remote;
1413 const char **urlset;
1415 struct strbuf name_buf = STRBUF_INIT;
1416 struct option options[] = {
1417 OPT_BOOLEAN('\0', "push", &push_mode,
1418 "manipulate push URLs"),
1419 OPT_BOOLEAN('\0', "add", &add_mode,
1421 OPT_BOOLEAN('\0', "delete", &delete_mode,
1425 argc = parse_options(argc, argv, NULL, options, builtin_remote_update_usage,
1426 PARSE_OPT_KEEP_ARGV0);
1428 if (add_mode && delete_mode)
1429 die("--add --delete doesn't make sense");
1431 if (argc < 3 || argc > 4 || ((add_mode || delete_mode) && argc != 3))
1432 usage_with_options(builtin_remote_seturl_usage, options);
1434 remotename = argv[1];
1442 if (!remote_is_configured(remotename))
1443 die("No such remote '%s'", remotename);
1444 remote = remote_get(remotename);
1447 strbuf_addf(&name_buf, "remote.%s.pushurl", remotename);
1448 urlset = remote->pushurl;
1449 urlset_nr = remote->pushurl_nr;
1451 strbuf_addf(&name_buf, "remote.%s.url", remotename);
1452 urlset = remote->url;
1453 urlset_nr = remote->url_nr;
1456 /* Special cases that add new entry. */
1457 if ((!oldurl && !delete_mode) || add_mode) {
1459 git_config_set_multivar(name_buf.buf, newurl,
1462 git_config_set(name_buf.buf, newurl);
1463 strbuf_release(&name_buf);
1467 /* Old URL specified. Demand that one matches. */
1468 if (regcomp(&old_regex, oldurl, REG_EXTENDED))
1469 die("Invalid old URL pattern: %s", oldurl);
1471 for (i = 0; i < urlset_nr; i++)
1472 if (!regexec(&old_regex, urlset[i], 0, NULL, 0))
1476 if (!delete_mode && !matches)
1477 die("No such URL found: %s", oldurl);
1478 if (delete_mode && !negative_matches && !push_mode)
1479 die("Will not delete all non-push URLs");
1481 regfree(&old_regex);
1484 git_config_set_multivar(name_buf.buf, newurl, oldurl, 0);
1486 git_config_set_multivar(name_buf.buf, NULL, oldurl, 1);
1490 static int get_one_entry(struct remote *remote, void *priv)
1492 struct string_list *list = priv;
1493 struct strbuf url_buf = STRBUF_INIT;
1497 if (remote->url_nr > 0) {
1498 strbuf_addf(&url_buf, "%s (fetch)", remote->url[0]);
1499 string_list_append(list, remote->name)->util =
1500 strbuf_detach(&url_buf, NULL);
1502 string_list_append(list, remote->name)->util = NULL;
1503 if (remote->pushurl_nr) {
1504 url = remote->pushurl;
1505 url_nr = remote->pushurl_nr;
1508 url_nr = remote->url_nr;
1510 for (i = 0; i < url_nr; i++)
1512 strbuf_addf(&url_buf, "%s (push)", url[i]);
1513 string_list_append(list, remote->name)->util =
1514 strbuf_detach(&url_buf, NULL);
1520 static int show_all(void)
1522 struct string_list list = STRING_LIST_INIT_NODUP;
1525 list.strdup_strings = 1;
1526 result = for_each_remote(get_one_entry, &list);
1531 sort_string_list(&list);
1532 for (i = 0; i < list.nr; i++) {
1533 struct string_list_item *item = list.items + i;
1535 printf("%s\t%s\n", item->string,
1536 item->util ? (const char *)item->util : "");
1538 if (i && !strcmp((item - 1)->string, item->string))
1540 printf("%s\n", item->string);
1544 string_list_clear(&list, 1);
1548 int cmd_remote(int argc, const char **argv, const char *prefix)
1550 struct option options[] = {
1551 OPT__VERBOSE(&verbose, "be verbose; must be placed before a subcommand"),
1556 argc = parse_options(argc, argv, prefix, options, builtin_remote_usage,
1557 PARSE_OPT_STOP_AT_NON_OPTION);
1560 result = show_all();
1561 else if (!strcmp(argv[0], "add"))
1562 result = add(argc, argv);
1563 else if (!strcmp(argv[0], "rename"))
1564 result = mv(argc, argv);
1565 else if (!strcmp(argv[0], "rm"))
1566 result = rm(argc, argv);
1567 else if (!strcmp(argv[0], "set-head"))
1568 result = set_head(argc, argv);
1569 else if (!strcmp(argv[0], "set-branches"))
1570 result = set_branches(argc, argv);
1571 else if (!strcmp(argv[0], "set-url"))
1572 result = set_url(argc, argv);
1573 else if (!strcmp(argv[0], "show"))
1574 result = show(argc, argv);
1575 else if (!strcmp(argv[0], "prune"))
1576 result = prune(argc, argv);
1577 else if (!strcmp(argv[0], "update"))
1578 result = update(argc, argv);
1580 error("Unknown subcommand: %s", argv[0]);
1581 usage_with_options(builtin_remote_usage, options);
1584 return result ? 1 : 0;