8 #define MAX_TAGS (FLAG_BITS - 1)
10 static const char describe_usage
[] =
11 "git-describe [--all] [--tags] [--abbrev=<n>] <committish>*";
13 static int debug
; /* Display lots of verbose info */
14 static int all
; /* Default to annotated tags only */
15 static int tags
; /* But allow any tags if --tags is specified */
16 static int abbrev
= DEFAULT_ABBREV
;
17 static int max_candidates
= 10;
19 static unsigned int names
[256], allocs
[256];
20 static struct commit_name
{
21 struct commit
*commit
;
22 int prio
; /* annotated tag = 2, tag = 1, head = 0 */
23 char path
[FLEX_ARRAY
]; /* more */
26 static struct commit_name
*match(struct commit
*cmit
)
28 unsigned char level0
= cmit
->object
.sha1
[0];
29 struct commit_name
**p
= name_array
[level0
];
30 unsigned int hi
= names
[level0
];
34 unsigned int mi
= (lo
+ hi
) / 2;
35 int cmp
= hashcmp(p
[mi
]->commit
->object
.sha1
,
38 while (mi
&& p
[mi
- 1]->commit
== cmit
)
50 static void add_to_known_names(const char *path
,
51 struct commit
*commit
,
55 int len
= strlen(path
)+1;
56 struct commit_name
*name
= xmalloc(sizeof(struct commit_name
) + len
);
57 unsigned char m
= commit
->object
.sha1
[0];
59 name
->commit
= commit
;
61 memcpy(name
->path
, path
, len
);
63 if (idx
>= allocs
[m
]) {
64 allocs
[m
] = (idx
+ 50) * 3 / 2;
65 name_array
[m
] = xrealloc(name_array
[m
],
66 allocs
[m
] * sizeof(*name_array
));
68 name_array
[m
][idx
] = name
;
72 static int get_name(const char *path
, const unsigned char *sha1
, int flag
, void *cb_data
)
74 struct commit
*commit
= lookup_commit_reference_gently(sha1
, 1);
75 struct object
*object
;
80 object
= parse_object(sha1
);
81 /* If --all, then any refs are used.
82 * If --tags, then any tags are used.
83 * Otherwise only annotated tags are used.
85 if (!strncmp(path
, "refs/tags/", 10)) {
86 if (object
->type
== OBJ_TAG
)
97 if (!tags
&& prio
< 2)
100 add_to_known_names(all
? path
+ 5 : path
+ 10, commit
, prio
);
104 static int compare_names(const void *_a
, const void *_b
)
106 struct commit_name
*a
= *(struct commit_name
**)_a
;
107 struct commit_name
*b
= *(struct commit_name
**)_b
;
108 unsigned long a_date
= a
->commit
->date
;
109 unsigned long b_date
= b
->commit
->date
;
110 int cmp
= hashcmp(a
->commit
->object
.sha1
, b
->commit
->object
.sha1
);
114 if (a
->prio
!= b
->prio
)
115 return b
->prio
- a
->prio
;
116 return (a_date
> b_date
) ? -1 : (a_date
== b_date
) ? 0 : 1;
119 struct possible_tag
{
120 struct commit_name
*name
;
122 unsigned flag_within
;
125 static void describe(const char *arg
, int last_one
)
127 unsigned char sha1
[20];
128 struct commit
*cmit
, *gave_up_on
= NULL
;
129 struct commit_list
*list
;
130 static int initialized
= 0;
131 struct commit_name
*n
;
132 struct possible_tag all_matches
[MAX_TAGS
], *min_match
;
133 unsigned int match_cnt
= 0, annotated_cnt
= 0, cur_match
;
134 unsigned long seen_commits
= 0;
136 if (get_sha1(arg
, sha1
))
137 die("Not a valid object name %s", arg
);
138 cmit
= lookup_commit_reference(sha1
);
140 die("%s is not a valid '%s' object", arg
, commit_type
);
145 for_each_ref(get_name
, NULL
);
146 for (m
= 0; m
< ARRAY_SIZE(name_array
); m
++)
147 qsort(name_array
[m
], names
[m
],
148 sizeof(*name_array
[m
]), compare_names
);
153 printf("%s\n", n
->path
);
158 fprintf(stderr
, "searching to describe %s\n", arg
);
161 cmit
->object
.flags
= SEEN
;
162 commit_list_insert(cmit
, &list
);
164 struct commit
*c
= pop_commit(&list
);
165 struct commit_list
*parents
= c
->parents
;
169 if (match_cnt
< max_candidates
) {
170 struct possible_tag
*t
= &all_matches
[match_cnt
++];
172 t
->depth
= seen_commits
- 1;
173 t
->flag_within
= 1u << match_cnt
;
174 c
->object
.flags
|= t
->flag_within
;
183 for (cur_match
= 0; cur_match
< match_cnt
; cur_match
++) {
184 struct possible_tag
*t
= &all_matches
[cur_match
];
185 if (!(c
->object
.flags
& t
->flag_within
))
188 if (annotated_cnt
&& !list
) {
190 fprintf(stderr
, "finished search at %s\n",
191 sha1_to_hex(c
->object
.sha1
));
195 struct commit
*p
= parents
->item
;
197 if (!(p
->object
.flags
& SEEN
))
198 insert_by_date(p
, &list
);
199 p
->object
.flags
|= c
->object
.flags
;
200 parents
= parents
->next
;
203 free_commit_list(list
);
206 die("cannot describe '%s'", sha1_to_hex(cmit
->object
.sha1
));
208 min_match
= &all_matches
[0];
209 for (cur_match
= 1; cur_match
< match_cnt
; cur_match
++) {
210 struct possible_tag
*t
= &all_matches
[cur_match
];
211 if (t
->depth
< min_match
->depth
212 && t
->name
->prio
>= min_match
->name
->prio
)
216 for (cur_match
= 0; cur_match
< match_cnt
; cur_match
++) {
217 struct possible_tag
*t
= &all_matches
[cur_match
];
218 fprintf(stderr
, " %c %8lu %s\n",
219 min_match
== t
? '*' : ' ',
220 t
->depth
, t
->name
->path
);
222 fprintf(stderr
, "traversed %lu commits\n", seen_commits
);
225 "more than %i tags found; listed %i most recent\n"
226 "gave up search at %s\n",
227 max_candidates
, max_candidates
,
228 sha1_to_hex(gave_up_on
->object
.sha1
));
231 printf("%s-g%s\n", min_match
->name
->path
,
232 find_unique_abbrev(cmit
->object
.sha1
, abbrev
));
235 clear_commit_marks(cmit
, -1);
238 int cmd_describe(int argc
, const char **argv
, const char *prefix
)
242 for (i
= 1; i
< argc
; i
++) {
243 const char *arg
= argv
[i
];
247 else if (!strcmp(arg
, "--debug"))
249 else if (!strcmp(arg
, "--all"))
251 else if (!strcmp(arg
, "--tags"))
253 else if (!strncmp(arg
, "--abbrev=", 9)) {
254 abbrev
= strtoul(arg
+ 9, NULL
, 10);
255 if (abbrev
< MINIMUM_ABBREV
|| 40 < abbrev
)
256 abbrev
= DEFAULT_ABBREV
;
258 else if (!strncmp(arg
, "--candidates=", 13)) {
259 max_candidates
= strtoul(arg
+ 13, NULL
, 10);
260 if (max_candidates
< 1)
262 else if (max_candidates
> MAX_TAGS
)
263 max_candidates
= MAX_TAGS
;
266 usage(describe_usage
);
269 save_commit_buffer
= 0;
275 describe(argv
[i
], (i
== argc
- 1));