6 #include "string-list.h"
7 #include "parse-options.h"
9 static const char * const show_ref_usage[] = {
10 N_("git show-ref [-q | --quiet] [--verify] [--head] [-d | --dereference] [-s | --hash[=<n>]] [--abbrev[=<n>]] [--tags] [--heads] [--] [<pattern>...]"),
11 N_("git show-ref --exclude-existing[=pattern] < ref-list"),
15 static int deref_tags, show_head, tags_only, heads_only, found_match, verify,
16 quiet, hash_only, abbrev, exclude_arg;
17 static const char **pattern;
18 static const char *exclude_existing_arg;
20 static void show_one(const char *refname, const struct object_id *oid)
22 const char *hex = find_unique_abbrev(oid->hash, abbrev);
26 printf("%s %s\n", hex, refname);
29 static int show_ref(const char *refname, const struct object_id *oid,
30 int flag, void *cbdata)
33 struct object_id peeled;
35 if (show_head && !strcmp(refname, "HEAD"))
38 if (tags_only || heads_only) {
41 match = heads_only && starts_with(refname, "refs/heads/");
42 match |= tags_only && starts_with(refname, "refs/tags/");
47 int reflen = strlen(refname);
48 const char **p = pattern, *m;
49 while ((m = *p++) != NULL) {
53 if (memcmp(m, refname + reflen - len, len))
57 /* "--verify" requires an exact match */
60 if (refname[reflen - len - 1] == '/')
69 /* This changes the semantics slightly that even under quiet we
70 * detect and return error if the repository is corrupt and
71 * ref points at a nonexistent object.
73 if (!has_sha1_file(oid->hash))
74 die("git show-ref: bad ref %s (%s)", refname,
80 show_one(refname, oid);
85 if (!peel_ref(refname, peeled.hash)) {
86 hex = find_unique_abbrev(peeled.hash, abbrev);
87 printf("%s %s^{}\n", hex, refname);
92 static int add_existing(const char *refname, const struct object_id *oid,
93 int flag, void *cbdata)
95 struct string_list *list = (struct string_list *)cbdata;
96 string_list_insert(list, refname);
101 * read "^(?:<anything>\s)?<refname>(?:\^\{\})?$" from the standard input,
103 * (1) strip "^{}" at the end of line if any;
104 * (2) ignore if match is provided and does not head-match refname;
105 * (3) warn if refname is not a well-formed refname and skip;
106 * (4) ignore if refname is a ref that exists in the local repository;
107 * (5) otherwise output the line.
109 static int exclude_existing(const char *match)
111 static struct string_list existing_refs = STRING_LIST_INIT_DUP;
113 int matchlen = match ? strlen(match) : 0;
115 for_each_ref(add_existing, &existing_refs);
116 while (fgets(buf, sizeof(buf), stdin)) {
118 int len = strlen(buf);
120 if (len > 0 && buf[len - 1] == '\n')
122 if (3 <= len && !strcmp(buf + len - 3, "^{}")) {
126 for (ref = buf + len; buf < ref; ref--)
127 if (isspace(ref[-1]))
130 int reflen = buf + len - ref;
131 if (reflen < matchlen)
133 if (strncmp(ref, match, matchlen))
136 if (check_refname_format(ref, 0)) {
137 warning("ref '%s' ignored", ref);
140 if (!string_list_has_string(&existing_refs, ref)) {
147 static int hash_callback(const struct option *opt, const char *arg, int unset)
150 /* Use full length SHA1 if no argument */
153 return parse_opt_abbrev_cb(opt, arg, unset);
156 static int exclude_existing_callback(const struct option *opt, const char *arg,
160 *(const char **)opt->value = arg;
164 static int help_callback(const struct option *opt, const char *arg, int unset)
169 static const struct option show_ref_options[] = {
170 OPT_BOOL(0, "tags", &tags_only, N_("only show tags (can be combined with heads)")),
171 OPT_BOOL(0, "heads", &heads_only, N_("only show heads (can be combined with tags)")),
172 OPT_BOOL(0, "verify", &verify, N_("stricter reference checking, "
173 "requires exact ref path")),
174 OPT_HIDDEN_BOOL('h', NULL, &show_head,
175 N_("show the HEAD reference, even if it would be filtered out")),
176 OPT_BOOL(0, "head", &show_head,
177 N_("show the HEAD reference, even if it would be filtered out")),
178 OPT_BOOL('d', "dereference", &deref_tags,
179 N_("dereference tags into object IDs")),
180 { OPTION_CALLBACK, 's', "hash", &abbrev, N_("n"),
181 N_("only show SHA1 hash using <n> digits"),
182 PARSE_OPT_OPTARG, &hash_callback },
183 OPT__ABBREV(&abbrev),
185 N_("do not print results to stdout (useful with --verify)")),
186 { OPTION_CALLBACK, 0, "exclude-existing", &exclude_existing_arg,
187 N_("pattern"), N_("show refs from stdin that aren't in local repository"),
188 PARSE_OPT_OPTARG | PARSE_OPT_NONEG, exclude_existing_callback },
189 { OPTION_CALLBACK, 0, "help-all", NULL, NULL, N_("show usage"),
190 PARSE_OPT_HIDDEN | PARSE_OPT_NOARG, help_callback },
194 int cmd_show_ref(int argc, const char **argv, const char *prefix)
196 if (argc == 2 && !strcmp(argv[1], "-h"))
197 usage_with_options(show_ref_usage, show_ref_options);
199 argc = parse_options(argc, argv, prefix, show_ref_options,
200 show_ref_usage, PARSE_OPT_NO_INTERNAL_HELP);
203 return exclude_existing(exclude_existing_arg);
211 die("--verify requires a reference");
213 struct object_id oid;
215 if (starts_with(*pattern, "refs/") &&
216 !read_ref(*pattern, oid.hash)) {
218 show_one(*pattern, &oid);
221 die("'%s' - not a valid ref", *pattern);
230 head_ref(show_ref, NULL);
231 for_each_ref(show_ref, NULL);
233 if (verify && !quiet)