push doc: document the DWYM behavior pushing to unqualified <dst>
[git.git] / builtin / ls-remote.c
blob1d7f1f5ce27834cafcf934db2085b36d4301e3c0
1 #include "builtin.h"
2 #include "cache.h"
3 #include "transport.h"
4 #include "ref-filter.h"
5 #include "remote.h"
6 #include "refs.h"
8 static const char * const ls_remote_usage[] = {
9 N_("git ls-remote [--heads] [--tags] [--refs] [--upload-pack=<exec>]\n"
10 " [-q | --quiet] [--exit-code] [--get-url]\n"
11 " [--symref] [<repository> [<refs>...]]"),
12 NULL
16 * Is there one among the list of patterns that match the tail part
17 * of the path?
19 static int tail_match(const char **pattern, const char *path)
21 const char *p;
22 char *pathbuf;
24 if (!pattern)
25 return 1; /* no restriction */
27 pathbuf = xstrfmt("/%s", path);
28 while ((p = *(pattern++)) != NULL) {
29 if (!wildmatch(p, pathbuf, 0)) {
30 free(pathbuf);
31 return 1;
34 free(pathbuf);
35 return 0;
38 int cmd_ls_remote(int argc, const char **argv, const char *prefix)
40 const char *dest = NULL;
41 unsigned flags = 0;
42 int get_url = 0;
43 int quiet = 0;
44 int status = 0;
45 int show_symref_target = 0;
46 const char *uploadpack = NULL;
47 const char **pattern = NULL;
48 struct argv_array ref_prefixes = ARGV_ARRAY_INIT;
49 int i;
50 struct string_list server_options = STRING_LIST_INIT_DUP;
52 struct remote *remote;
53 struct transport *transport;
54 const struct ref *ref;
55 struct ref_array ref_array;
56 static struct ref_sorting *sorting = NULL, **sorting_tail = &sorting;
58 struct option options[] = {
59 OPT__QUIET(&quiet, N_("do not print remote URL")),
60 OPT_STRING(0, "upload-pack", &uploadpack, N_("exec"),
61 N_("path of git-upload-pack on the remote host")),
62 { OPTION_STRING, 0, "exec", &uploadpack, N_("exec"),
63 N_("path of git-upload-pack on the remote host"),
64 PARSE_OPT_HIDDEN },
65 OPT_BIT('t', "tags", &flags, N_("limit to tags"), REF_TAGS),
66 OPT_BIT('h', "heads", &flags, N_("limit to heads"), REF_HEADS),
67 OPT_BIT(0, "refs", &flags, N_("do not show peeled tags"), REF_NORMAL),
68 OPT_BOOL(0, "get-url", &get_url,
69 N_("take url.<base>.insteadOf into account")),
70 OPT_CALLBACK(0 , "sort", sorting_tail, N_("key"),
71 N_("field name to sort on"), &parse_opt_ref_sorting),
72 OPT_SET_INT_F(0, "exit-code", &status,
73 N_("exit with exit code 2 if no matching refs are found"),
74 2, PARSE_OPT_NOCOMPLETE),
75 OPT_BOOL(0, "symref", &show_symref_target,
76 N_("show underlying ref in addition to the object pointed by it")),
77 OPT_STRING_LIST('o', "server-option", &server_options, N_("server-specific"), N_("option to transmit")),
78 OPT_END()
81 memset(&ref_array, 0, sizeof(ref_array));
83 argc = parse_options(argc, argv, prefix, options, ls_remote_usage,
84 PARSE_OPT_STOP_AT_NON_OPTION);
85 dest = argv[0];
87 if (argc > 1) {
88 int i;
89 pattern = xcalloc(argc, sizeof(const char *));
90 for (i = 1; i < argc; i++) {
91 pattern[i - 1] = xstrfmt("*/%s", argv[i]);
95 if (flags & REF_TAGS)
96 argv_array_push(&ref_prefixes, "refs/tags/");
97 if (flags & REF_HEADS)
98 argv_array_push(&ref_prefixes, "refs/heads/");
100 remote = remote_get(dest);
101 if (!remote) {
102 if (dest)
103 die("bad repository '%s'", dest);
104 die("No remote configured to list refs from.");
106 if (!remote->url_nr)
107 die("remote %s has no configured URL", dest);
109 if (get_url) {
110 printf("%s\n", *remote->url);
111 UNLEAK(sorting);
112 return 0;
115 transport = transport_get(remote, NULL);
116 if (uploadpack != NULL)
117 transport_set_option(transport, TRANS_OPT_UPLOADPACK, uploadpack);
118 if (server_options.nr)
119 transport->server_options = &server_options;
121 ref = transport_get_remote_refs(transport, &ref_prefixes);
122 if (transport_disconnect(transport)) {
123 UNLEAK(sorting);
124 return 1;
127 if (!dest && !quiet)
128 fprintf(stderr, "From %s\n", *remote->url);
129 for ( ; ref; ref = ref->next) {
130 struct ref_array_item *item;
131 if (!check_ref_type(ref, flags))
132 continue;
133 if (!tail_match(pattern, ref->name))
134 continue;
135 item = ref_array_push(&ref_array, ref->name, &ref->old_oid);
136 item->symref = xstrdup_or_null(ref->symref);
139 if (sorting)
140 ref_array_sort(sorting, &ref_array);
142 for (i = 0; i < ref_array.nr; i++) {
143 const struct ref_array_item *ref = ref_array.items[i];
144 if (show_symref_target && ref->symref)
145 printf("ref: %s\t%s\n", ref->symref, ref->refname);
146 printf("%s\t%s\n", oid_to_hex(&ref->objectname), ref->refname);
147 status = 0; /* we found something */
150 UNLEAK(sorting);
151 ref_array_clear(&ref_array);
152 return status;