6 #include "parse-options.h"
8 static const char* show_branch_usage
[] = {
9 "git show-branch [-a|--all] [-r|--remotes] [--topo-order | --date-order] [--current] [--color[=<when>] | --no-color] [--sparse] [--more=<n> | --list | --independent | --merge-base] [--no-name | --sha1-name] [--topics] [(<rev> | <glob>)...]",
10 "git show-branch (-g|--reflog)[=<n>[,<base>]] [--list] [<ref>]",
14 static int showbranch_use_color
= -1;
15 static char column_colors
[][COLOR_MAXLEN
] = {
24 #define COLUMN_COLORS_MAX (ARRAY_SIZE(column_colors))
26 static int default_num
;
27 static int default_alloc
;
28 static const char **default_arg
;
30 #define UNINTERESTING 01
33 #define MAX_REVS (FLAG_BITS - REV_SHIFT) /* should not exceed bits_per_int - REV_SHIFT */
35 #define DEFAULT_REFLOG 4
37 static const char *get_color_code(int idx
)
39 if (showbranch_use_color
)
40 return column_colors
[idx
];
44 static const char *get_color_reset_code(void)
46 if (showbranch_use_color
)
47 return GIT_COLOR_RESET
;
51 static struct commit
*interesting(struct commit_list
*list
)
54 struct commit
*commit
= list
->item
;
56 if (commit
->object
.flags
& UNINTERESTING
)
63 static struct commit
*pop_one_commit(struct commit_list
**list_p
)
65 struct commit
*commit
;
66 struct commit_list
*list
;
75 const char *head_name
; /* which head's ancestor? */
76 int generation
; /* how many parents away from head_name */
79 /* Name the commit as nth generation ancestor of head_name;
80 * we count only the first-parent relationship for naming purposes.
82 static void name_commit(struct commit
*commit
, const char *head_name
, int nth
)
84 struct commit_name
*name
;
86 commit
->util
= xmalloc(sizeof(struct commit_name
));
88 name
->head_name
= head_name
;
89 name
->generation
= nth
;
92 /* Parent is the first parent of the commit. We may name it
93 * as (n+1)th generation ancestor of the same head_name as
94 * commit is nth generation ancestor of, if that generation
95 * number is better than the name it already has.
97 static void name_parent(struct commit
*commit
, struct commit
*parent
)
99 struct commit_name
*commit_name
= commit
->util
;
100 struct commit_name
*parent_name
= parent
->util
;
104 commit_name
->generation
+ 1 < parent_name
->generation
)
105 name_commit(parent
, commit_name
->head_name
,
106 commit_name
->generation
+ 1);
109 static int name_first_parent_chain(struct commit
*c
)
118 p
= c
->parents
->item
;
130 static void name_commits(struct commit_list
*list
,
135 struct commit_list
*cl
;
139 /* First give names to the given heads */
140 for (cl
= list
; cl
; cl
= cl
->next
) {
144 for (i
= 0; i
< num_rev
; i
++) {
146 name_commit(c
, ref_name
[i
], 0);
152 /* Then commits on the first parent ancestry chain */
155 for (cl
= list
; cl
; cl
= cl
->next
) {
156 i
+= name_first_parent_chain(cl
->item
);
160 /* Finally, any unnamed commits */
163 for (cl
= list
; cl
; cl
= cl
->next
) {
164 struct commit_list
*parents
;
165 struct commit_name
*n
;
171 parents
= c
->parents
;
174 struct commit
*p
= parents
->item
;
175 char newname
[1000], *en
;
176 parents
= parents
->next
;
181 switch (n
->generation
) {
183 en
+= sprintf(en
, "%s", n
->head_name
);
186 en
+= sprintf(en
, "%s^", n
->head_name
);
189 en
+= sprintf(en
, "%s~%d",
190 n
->head_name
, n
->generation
);
194 en
+= sprintf(en
, "^");
196 en
+= sprintf(en
, "^%d", nth
);
197 name_commit(p
, xstrdup(newname
), 0);
199 name_first_parent_chain(p
);
205 static int mark_seen(struct commit
*commit
, struct commit_list
**seen_p
)
207 if (!commit
->object
.flags
) {
208 commit_list_insert(commit
, seen_p
);
214 static void join_revs(struct commit_list
**list_p
,
215 struct commit_list
**seen_p
,
216 int num_rev
, int extra
)
218 int all_mask
= ((1u << (REV_SHIFT
+ num_rev
)) - 1);
219 int all_revs
= all_mask
& ~((1u << REV_SHIFT
) - 1);
222 struct commit_list
*parents
;
223 int still_interesting
= !!interesting(*list_p
);
224 struct commit
*commit
= pop_one_commit(list_p
);
225 int flags
= commit
->object
.flags
& all_mask
;
227 if (!still_interesting
&& extra
<= 0)
230 mark_seen(commit
, seen_p
);
231 if ((flags
& all_revs
) == all_revs
)
232 flags
|= UNINTERESTING
;
233 parents
= commit
->parents
;
236 struct commit
*p
= parents
->item
;
237 int this_flag
= p
->object
.flags
;
238 parents
= parents
->next
;
239 if ((this_flag
& flags
) == flags
)
241 if (!p
->object
.parsed
)
243 if (mark_seen(p
, seen_p
) && !still_interesting
)
245 p
->object
.flags
|= flags
;
246 insert_by_date(p
, list_p
);
251 * Postprocess to complete well-poisoning.
253 * At this point we have all the commits we have seen in
254 * seen_p list. Mark anything that can be reached from
255 * uninteresting commits not interesting.
259 struct commit_list
*s
;
260 for (s
= *seen_p
; s
; s
= s
->next
) {
261 struct commit
*c
= s
->item
;
262 struct commit_list
*parents
;
264 if (((c
->object
.flags
& all_revs
) != all_revs
) &&
265 !(c
->object
.flags
& UNINTERESTING
))
268 /* The current commit is either a merge base or
269 * already uninteresting one. Mark its parents
270 * as uninteresting commits _only_ if they are
271 * already parsed. No reason to find new ones
274 parents
= c
->parents
;
276 struct commit
*p
= parents
->item
;
277 parents
= parents
->next
;
278 if (!(p
->object
.flags
& UNINTERESTING
)) {
279 p
->object
.flags
|= UNINTERESTING
;
289 static void show_one_commit(struct commit
*commit
, int no_name
)
291 struct strbuf pretty
= STRBUF_INIT
;
292 const char *pretty_str
= "(unavailable)";
293 struct commit_name
*name
= commit
->util
;
295 if (commit
->object
.parsed
) {
296 struct pretty_print_context ctx
= {0};
297 pretty_print_commit(CMIT_FMT_ONELINE
, commit
, &pretty
, &ctx
);
298 pretty_str
= pretty
.buf
;
300 if (!prefixcmp(pretty_str
, "[PATCH] "))
304 if (name
&& name
->head_name
) {
305 printf("[%s", name
->head_name
);
306 if (name
->generation
) {
307 if (name
->generation
== 1)
310 printf("~%d", name
->generation
);
316 find_unique_abbrev(commit
->object
.sha1
,
320 strbuf_release(&pretty
);
323 static char *ref_name
[MAX_REVS
+ 1];
324 static int ref_name_cnt
;
326 static const char *find_digit_prefix(const char *s
, int *v
)
333 '0' <= (ch
= *p
) && ch
<= '9';
335 ver
= ver
* 10 + ch
- '0';
341 static int version_cmp(const char *a
, const char *b
)
346 a
= find_digit_prefix(a
, &va
);
347 b
= find_digit_prefix(b
, &vb
);
354 if ('0' <= ca
&& ca
<= '9')
356 if ('0' <= cb
&& cb
<= '9')
370 static int compare_ref_name(const void *a_
, const void *b_
)
372 const char * const*a
= a_
, * const*b
= b_
;
373 return version_cmp(*a
, *b
);
376 static void sort_ref_range(int bottom
, int top
)
378 qsort(ref_name
+ bottom
, top
- bottom
, sizeof(ref_name
[0]),
382 static int append_ref(const char *refname
, const unsigned char *sha1
,
385 struct commit
*commit
= lookup_commit_reference_gently(sha1
, 1);
392 /* Avoid adding the same thing twice */
393 for (i
= 0; i
< ref_name_cnt
; i
++)
394 if (!strcmp(refname
, ref_name
[i
]))
397 if (MAX_REVS
<= ref_name_cnt
) {
398 warning("ignoring %s; cannot handle more than %d refs",
402 ref_name
[ref_name_cnt
++] = xstrdup(refname
);
403 ref_name
[ref_name_cnt
] = NULL
;
407 static int append_head_ref(const char *refname
, const unsigned char *sha1
, int flag
, void *cb_data
)
409 unsigned char tmp
[20];
411 if (prefixcmp(refname
, "refs/heads/"))
413 /* If both heads/foo and tags/foo exists, get_sha1 would
416 if (get_sha1(refname
+ ofs
, tmp
) || hashcmp(tmp
, sha1
))
418 return append_ref(refname
+ ofs
, sha1
, 0);
421 static int append_remote_ref(const char *refname
, const unsigned char *sha1
, int flag
, void *cb_data
)
423 unsigned char tmp
[20];
425 if (prefixcmp(refname
, "refs/remotes/"))
427 /* If both heads/foo and tags/foo exists, get_sha1 would
430 if (get_sha1(refname
+ ofs
, tmp
) || hashcmp(tmp
, sha1
))
432 return append_ref(refname
+ ofs
, sha1
, 0);
435 static int append_tag_ref(const char *refname
, const unsigned char *sha1
, int flag
, void *cb_data
)
437 if (prefixcmp(refname
, "refs/tags/"))
439 return append_ref(refname
+ 5, sha1
, 0);
442 static const char *match_ref_pattern
= NULL
;
443 static int match_ref_slash
= 0;
444 static int count_slash(const char *s
)
453 static int append_matching_ref(const char *refname
, const unsigned char *sha1
, int flag
, void *cb_data
)
455 /* we want to allow pattern hold/<asterisk> to show all
456 * branches under refs/heads/hold/, and v0.99.9? to show
457 * refs/tags/v0.99.9a and friends.
460 int slash
= count_slash(refname
);
461 for (tail
= refname
; *tail
&& match_ref_slash
< slash
; )
466 if (fnmatch(match_ref_pattern
, tail
, 0))
468 if (!prefixcmp(refname
, "refs/heads/"))
469 return append_head_ref(refname
, sha1
, flag
, cb_data
);
470 if (!prefixcmp(refname
, "refs/tags/"))
471 return append_tag_ref(refname
, sha1
, flag
, cb_data
);
472 return append_ref(refname
, sha1
, 0);
475 static void snarf_refs(int head
, int remotes
)
478 int orig_cnt
= ref_name_cnt
;
479 for_each_ref(append_head_ref
, NULL
);
480 sort_ref_range(orig_cnt
, ref_name_cnt
);
483 int orig_cnt
= ref_name_cnt
;
484 for_each_ref(append_remote_ref
, NULL
);
485 sort_ref_range(orig_cnt
, ref_name_cnt
);
489 static int rev_is_head(char *head
, int headlen
, char *name
,
490 unsigned char *head_sha1
, unsigned char *sha1
)
493 (head_sha1
&& sha1
&& hashcmp(head_sha1
, sha1
)))
495 if (!prefixcmp(head
, "refs/heads/"))
497 if (!prefixcmp(name
, "refs/heads/"))
499 else if (!prefixcmp(name
, "heads/"))
501 return !strcmp(head
, name
);
504 static int show_merge_base(struct commit_list
*seen
, int num_rev
)
506 int all_mask
= ((1u << (REV_SHIFT
+ num_rev
)) - 1);
507 int all_revs
= all_mask
& ~((1u << REV_SHIFT
) - 1);
511 struct commit
*commit
= pop_one_commit(&seen
);
512 int flags
= commit
->object
.flags
& all_mask
;
513 if (!(flags
& UNINTERESTING
) &&
514 ((flags
& all_revs
) == all_revs
)) {
515 puts(sha1_to_hex(commit
->object
.sha1
));
517 commit
->object
.flags
|= UNINTERESTING
;
523 static int show_independent(struct commit
**rev
,
526 unsigned int *rev_mask
)
530 for (i
= 0; i
< num_rev
; i
++) {
531 struct commit
*commit
= rev
[i
];
532 unsigned int flag
= rev_mask
[i
];
534 if (commit
->object
.flags
== flag
)
535 puts(sha1_to_hex(commit
->object
.sha1
));
536 commit
->object
.flags
|= UNINTERESTING
;
541 static void append_one_rev(const char *av
)
543 unsigned char revkey
[20];
544 if (!get_sha1(av
, revkey
)) {
545 append_ref(av
, revkey
, 0);
548 if (strchr(av
, '*') || strchr(av
, '?') || strchr(av
, '[')) {
549 /* glob style match */
550 int saved_matches
= ref_name_cnt
;
551 match_ref_pattern
= av
;
552 match_ref_slash
= count_slash(av
);
553 for_each_ref(append_matching_ref
, NULL
);
554 if (saved_matches
== ref_name_cnt
&&
555 ref_name_cnt
< MAX_REVS
)
556 error("no matching refs with %s", av
);
557 if (saved_matches
+ 1 < ref_name_cnt
)
558 sort_ref_range(saved_matches
, ref_name_cnt
);
561 die("bad sha1 reference %s", av
);
564 static int git_show_branch_config(const char *var
, const char *value
, void *cb
)
566 if (!strcmp(var
, "showbranch.default")) {
568 return config_error_nonbool(var
);
570 * default_arg is now passed to parse_options(), so we need to
571 * mimic the real argv a bit better.
575 default_arg
= xcalloc(default_alloc
, sizeof(*default_arg
));
576 default_arg
[default_num
++] = "show-branch";
577 } else if (default_alloc
<= default_num
+ 1) {
578 default_alloc
= default_alloc
* 3 / 2 + 20;
579 default_arg
= xrealloc(default_arg
, sizeof *default_arg
* default_alloc
);
581 default_arg
[default_num
++] = xstrdup(value
);
582 default_arg
[default_num
] = NULL
;
586 if (!strcmp(var
, "color.showbranch")) {
587 showbranch_use_color
= git_config_colorbool(var
, value
, -1);
591 return git_color_default_config(var
, value
, cb
);
594 static int omit_in_dense(struct commit
*commit
, struct commit
**rev
, int n
)
596 /* If the commit is tip of the named branches, do not
598 * Otherwise, if it is a merge that is reachable from only one
599 * tip, it is not that interesting.
602 for (i
= 0; i
< n
; i
++)
603 if (rev
[i
] == commit
)
605 flag
= commit
->object
.flags
;
606 for (i
= count
= 0; i
< n
; i
++) {
607 if (flag
& (1u << (i
+ REV_SHIFT
)))
615 static int reflog
= 0;
617 static int parse_reflog_param(const struct option
*opt
, const char *arg
,
621 const char **base
= (const char **)opt
->value
;
624 reflog
= strtoul(arg
, &ep
, 10);
628 return error("unrecognized reflog param '%s'", arg
);
632 reflog
= DEFAULT_REFLOG
;
636 int cmd_show_branch(int ac
, const char **av
, const char *prefix
)
638 struct commit
*rev
[MAX_REVS
], *commit
;
639 char *reflog_msg
[MAX_REVS
];
640 struct commit_list
*list
= NULL
, *seen
= NULL
;
641 unsigned int rev_mask
[MAX_REVS
];
642 int num_rev
, i
, extra
= 0;
643 int all_heads
= 0, all_remotes
= 0;
644 int all_mask
, all_revs
;
649 unsigned char head_sha1
[20];
654 int shown_merge_point
= 0;
655 int with_current_branch
= 0;
659 const char *reflog_base
= NULL
;
660 struct option builtin_show_branch_options
[] = {
661 OPT_BOOLEAN('a', "all", &all_heads
,
662 "show remote-tracking and local branches"),
663 OPT_BOOLEAN('r', "remotes", &all_remotes
,
664 "show remote-tracking branches"),
665 OPT__COLOR(&showbranch_use_color
,
666 "color '*!+-' corresponding to the branch"),
667 { OPTION_INTEGER
, 0, "more", &extra
, "n",
668 "show <n> more commits after the common ancestor",
669 PARSE_OPT_OPTARG
, NULL
, (intptr_t)1 },
670 OPT_SET_INT(0, "list", &extra
, "synonym to more=-1", -1),
671 OPT_BOOLEAN(0, "no-name", &no_name
, "suppress naming strings"),
672 OPT_BOOLEAN(0, "current", &with_current_branch
,
673 "include the current branch"),
674 OPT_BOOLEAN(0, "sha1-name", &sha1_name
,
675 "name commits with their object names"),
676 OPT_BOOLEAN(0, "merge-base", &merge_base
,
677 "show possible merge bases"),
678 OPT_BOOLEAN(0, "independent", &independent
,
679 "show refs unreachable from any other ref"),
680 OPT_BOOLEAN(0, "topo-order", &lifo
,
681 "show commits in topological order"),
682 OPT_BOOLEAN(0, "topics", &topics
,
683 "show only commits not on the first branch"),
684 OPT_SET_INT(0, "sparse", &dense
,
685 "show merges reachable from only one tip", 0),
686 OPT_SET_INT(0, "date-order", &lifo
,
687 "show commits where no parent comes before its "
689 { OPTION_CALLBACK
, 'g', "reflog", &reflog_base
, "<n>[,<base>]",
690 "show <n> most recent ref-log entries starting at "
692 PARSE_OPT_OPTARG
| PARSE_OPT_LITERAL_ARGHELP
,
693 parse_reflog_param
},
697 git_config(git_show_branch_config
, NULL
);
699 if (showbranch_use_color
== -1)
700 showbranch_use_color
= git_use_color_default
;
702 /* If nothing is specified, try the default first */
703 if (ac
== 1 && default_num
) {
708 ac
= parse_options(ac
, av
, prefix
, builtin_show_branch_options
,
709 show_branch_usage
, PARSE_OPT_STOP_AT_NON_OPTION
);
713 if (extra
|| reflog
) {
714 /* "listing" mode is incompatible with
715 * independent nor merge-base modes.
717 if (independent
|| merge_base
)
718 usage_with_options(show_branch_usage
,
719 builtin_show_branch_options
);
720 if (reflog
&& ((0 < extra
) || all_heads
|| all_remotes
))
722 * Asking for --more in reflog mode does not
723 * make sense. --list is Ok.
725 * Also --all and --remotes do not make sense either.
727 die("--reflog is incompatible with --all, --remotes, "
728 "--independent or --merge-base");
731 /* If nothing is specified, show all branches by default */
732 if (ac
+ all_heads
+ all_remotes
== 0)
736 unsigned char sha1
[20];
742 static const char *fake_av
[2];
745 refname
= resolve_ref("HEAD", sha1
, 1, NULL
);
746 fake_av
[0] = xstrdup(refname
);
752 die("--reflog option needs one branch name");
754 if (MAX_REVS
< reflog
)
755 die("Only %d entries can be shown at one time.",
757 if (!dwim_ref(*av
, strlen(*av
), sha1
, &ref
))
758 die("No such ref %s", *av
);
760 /* Has the base been specified? */
763 base
= strtoul(reflog_base
, &ep
, 10);
765 /* Ah, that is a date spec... */
767 at
= approxidate(reflog_base
);
768 read_ref_at(ref
, at
, -1, sha1
, NULL
,
773 for (i
= 0; i
< reflog
; i
++) {
776 unsigned long timestamp
;
779 if (read_ref_at(ref
, 0, base
+i
, sha1
, &logmsg
,
780 ×tamp
, &tz
, NULL
)) {
784 msg
= strchr(logmsg
, '\t');
789 m
= xmalloc(strlen(msg
) + 200);
790 sprintf(m
, "(%s) %s",
791 show_date(timestamp
, tz
, 1),
795 sprintf(nth_desc
, "%s@{%d}", *av
, base
+i
);
796 append_ref(nth_desc
, sha1
, 1);
799 else if (all_heads
+ all_remotes
)
800 snarf_refs(all_heads
, all_remotes
);
808 head_p
= resolve_ref("HEAD", head_sha1
, 1, NULL
);
810 head_len
= strlen(head_p
);
811 memcpy(head
, head_p
, head_len
+ 1);
818 if (with_current_branch
&& head_p
) {
820 for (i
= 0; !has_head
&& i
< ref_name_cnt
; i
++) {
821 /* We are only interested in adding the branch
824 if (rev_is_head(head
,
831 int offset
= !prefixcmp(head
, "refs/heads/") ? 11 : 0;
832 append_one_rev(head
+ offset
);
837 fprintf(stderr
, "No revs to be shown.\n");
841 for (num_rev
= 0; ref_name
[num_rev
]; num_rev
++) {
842 unsigned char revkey
[20];
843 unsigned int flag
= 1u << (num_rev
+ REV_SHIFT
);
845 if (MAX_REVS
<= num_rev
)
846 die("cannot handle more than %d revs.", MAX_REVS
);
847 if (get_sha1(ref_name
[num_rev
], revkey
))
848 die("'%s' is not a valid ref.", ref_name
[num_rev
]);
849 commit
= lookup_commit_reference(revkey
);
851 die("cannot find commit %s (%s)",
852 ref_name
[num_rev
], revkey
);
853 parse_commit(commit
);
854 mark_seen(commit
, &seen
);
856 /* rev#0 uses bit REV_SHIFT, rev#1 uses bit REV_SHIFT+1,
857 * and so on. REV_SHIFT bits from bit 0 are used for
858 * internal bookkeeping.
860 commit
->object
.flags
|= flag
;
861 if (commit
->object
.flags
== flag
)
862 insert_by_date(commit
, &list
);
863 rev
[num_rev
] = commit
;
865 for (i
= 0; i
< num_rev
; i
++)
866 rev_mask
[i
] = rev
[i
]->object
.flags
;
869 join_revs(&list
, &seen
, num_rev
, extra
);
874 return show_merge_base(seen
, num_rev
);
877 return show_independent(rev
, num_rev
, ref_name
, rev_mask
);
879 /* Show list; --more=-1 means list-only */
880 if (1 < num_rev
|| extra
< 0) {
881 for (i
= 0; i
< num_rev
; i
++) {
883 int is_head
= rev_is_head(head
,
887 rev
[i
]->object
.sha1
);
890 is_head
? '*' : ' ', ref_name
[i
]);
892 for (j
= 0; j
< i
; j
++)
894 printf("%s%c%s [%s] ",
895 get_color_code(i
% COLUMN_COLORS_MAX
),
897 get_color_reset_code(), ref_name
[i
]);
901 /* header lines never need name */
902 show_one_commit(rev
[i
], 1);
911 for (i
= 0; i
< num_rev
; i
++)
919 /* Sort topologically */
920 sort_in_topological_order(&seen
, lifo
);
922 /* Give names to commits */
923 if (!sha1_name
&& !no_name
)
924 name_commits(seen
, rev
, ref_name
, num_rev
);
926 all_mask
= ((1u << (REV_SHIFT
+ num_rev
)) - 1);
927 all_revs
= all_mask
& ~((1u << REV_SHIFT
) - 1);
930 struct commit
*commit
= pop_one_commit(&seen
);
931 int this_flag
= commit
->object
.flags
;
932 int is_merge_point
= ((this_flag
& all_revs
) == all_revs
);
934 shown_merge_point
|= is_merge_point
;
937 int is_merge
= !!(commit
->parents
&&
938 commit
->parents
->next
);
941 (this_flag
& (1u << REV_SHIFT
)))
943 if (dense
&& is_merge
&&
944 omit_in_dense(commit
, rev
, num_rev
))
946 for (i
= 0; i
< num_rev
; i
++) {
948 if (!(this_flag
& (1u << (i
+ REV_SHIFT
))))
952 else if (i
== head_at
)
957 get_color_code(i
% COLUMN_COLORS_MAX
),
958 mark
, get_color_reset_code());
962 show_one_commit(commit
, no_name
);
964 if (shown_merge_point
&& --extra
< 0)