3 USAGE
='[help|start|bad|good|skip|next|reset|visualize|replay|log|run]'
4 LONG_USAGE
='git bisect help
5 print this long help message.
6 git bisect start [<bad> [<good>...]] [--] [<pathspec>...]
7 reset bisect state and start bisection.
9 mark <rev> a known-bad revision.
10 git bisect good [<rev>...]
11 mark <rev>... known-good revisions.
12 git bisect skip [<rev>...]
13 mark <rev>... untestable revisions.
15 find next bisection to test and check it out.
16 git bisect reset [<branch>]
17 finish bisection search and go back to branch.
19 show bisect status in gitk.
20 git bisect replay <logfile>
24 git bisect run <cmd>...
25 use <cmd>... to automatically bisect.
27 Please use "git help bisect" to get the full man page.'
33 _x40
='[0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f]'
34 _x40
="$_x40$_x40$_x40$_x40$_x40$_x40$_x40$_x40"
39 s/'\''/'\'\\\\\'\''/g;
47 test -s "$GIT_DIR/BISECT_START" ||
{
48 echo >&2 'You need to start by "git bisect start"'
51 echo >&2 -n 'Do you want me to do it for you [Y/n]? '
68 head=$
(GIT_DIR
="$GIT_DIR" git symbolic-ref
-q HEAD
) ||
69 head=$
(GIT_DIR
="$GIT_DIR" git rev-parse
--verify HEAD
) ||
70 die
"Bad HEAD - I need a HEAD"
73 # Check if we are bisecting.
76 if test -s "$GIT_DIR/BISECT_START"
78 # Reset to the rev from where we started.
79 start_head
=$
(cat "$GIT_DIR/BISECT_START")
80 git checkout
"$start_head" ||
exit
82 # Get rev from where we start.
85 # This error message should only be triggered by
86 # cogito usage, and cogito users should understand
87 # it relates to cg-seek.
88 [ -s "$GIT_DIR/head-name" ] &&
89 die
"won't bisect on seeked tree"
90 start_head
="${head#refs/heads/}"
93 die
"Bad HEAD - strange symbolic ref"
99 # Get rid of any old bisect state.
101 bisect_clean_state ||
exit
104 # Check for one bad and then some good revisions.
108 case "$arg" in --) has_double_dash
=1; break ;; esac
113 while [ $# -gt 0 ]; do
121 rev=$
(git rev-parse
-q --verify "$arg^{commit}") ||
{
122 test $has_double_dash -eq 1 &&
123 die
"'$arg' does not appear to be a valid revision"
127 0) state
='bad' ; bad_seen
=1 ;;
130 eval="$eval bisect_write '$state' '$rev' 'nolog'; "
138 # In case of mistaken revs or checkout error, or signals received,
139 # "bisect_auto_next" below may exit or misbehave.
140 # We have to trap this to be able to clean up using
141 # "bisect_clean_state".
143 trap 'bisect_clean_state' 0
144 trap 'exit 255' 1 2 3 15
147 # Write new start state.
149 echo "$start_head" >"$GIT_DIR/BISECT_START" &&
150 sq "$@" >"$GIT_DIR/BISECT_NAMES" &&
152 echo "git bisect start$orig_args" >>"$GIT_DIR/BISECT_LOG" ||
exit
154 # Check if we can proceed to the next bisect state.
167 good|skip
) tag
="$state"-"$rev" ;;
168 *) die
"Bad bisect_write argument: $state" ;;
170 git update-ref
"refs/bisect/$tag" "$rev" ||
exit
171 echo "# $state: $(git show-branch $rev)" >>"$GIT_DIR/BISECT_LOG"
172 test -n "$nolog" ||
echo "git bisect $state $rev" >>"$GIT_DIR/BISECT_LOG"
176 test -f "$GIT_DIR/BISECT_EXPECTED_REV" &&
177 test "$1" = $
(cat "$GIT_DIR/BISECT_EXPECTED_REV")
180 mark_expected_rev
() {
181 echo "$1" > "$GIT_DIR/BISECT_EXPECTED_REV"
184 check_expected_revs
() {
186 if ! is_expected_rev
"$_rev"; then
187 rm -f "$GIT_DIR/BISECT_ANCESTORS_OK"
188 rm -f "$GIT_DIR/BISECT_EXPECTED_REV"
199 die
"Please call 'bisect_state' with at least one argument." ;;
201 rev=$
(git rev-parse
--verify HEAD
) ||
202 die
"Bad rev input: HEAD"
203 bisect_write
"$state" "$rev"
204 check_expected_revs
"$rev" ;;
210 sha
=$
(git rev-parse
--verify "$rev^{commit}") ||
211 die
"Bad rev input: $rev"
212 eval="$eval bisect_write '$state' '$sha'; "
215 check_expected_revs
"$@" ;;
217 die
"'git bisect bad' can take only one argument." ;;
224 bisect_next_check
() {
225 missing_good
= missing_bad
=
226 git show-ref
-q --verify refs
/bisect
/bad || missing_bad
=t
227 test -n "$(git for-each-ref "refs
/bisect
/good-
*")" || missing_good
=t
229 case "$missing_good,$missing_bad,$1" in
231 : have both good and bad
- ok
234 # do not have both but not asked to fail - just report.
238 # have bad but not good. we could bisect although
239 # this is less optimum.
240 echo >&2 'Warning: bisecting only with a bad commit.'
243 printf >&2 'Are you sure [Y/n]? '
245 case "$yesno" in [Nn
]*) exit 1 ;; esac
247 : bisect without good...
251 test -s "$GIT_DIR/BISECT_START" ||
{
252 echo >&2 'You need to start by "git bisect start".'
255 echo >&2 'You '$THEN'need to give me at least one good' \
256 'and one bad revisions.'
257 echo >&2 '(You can use "git bisect bad" and' \
258 '"git bisect good" for that.)'
264 bisect_next_check
&& bisect_next ||
:
271 if [ -z "$_skip" ]; then
276 # Let's parse the output of:
277 # "git rev-list --bisect-vars --bisect-all ..."
278 eval "$_eval" |
while read hash line
280 case "$VARS,$FOUND,$TRIED,$hash" in
281 # We display some vars.
282 1,*,*,*) echo "$hash $line" ;;
287 # We had nothing to search.
293 # We did not find a good bisect rev.
294 # This should happen only if the "bad"
295 # commit is also a "skip" commit.
297 echo "bisect_rev=$TRIED"
303 TRIED
="${TRIED:+$TRIED|}$hash"
307 echo "bisect_rev=$hash"
308 echo "bisect_tried=\"$TRIED\""
314 # We have already found a rev to be tested.
315 ,1,*,bisect_rev
*) VARS
=1 ;;
319 *) die
"filter_skipped error " \
330 exit_if_skipped_commits
() {
332 if expr "$_tried" : ".*[|].*" > /dev
/null
; then
333 echo "There are only 'skip'ped commit left to test."
334 echo "The first bad commit could be any of:"
335 echo "$_tried" |
tr '[|]' '[\012]'
336 echo "We cannot bisect more!"
344 echo "Bisecting: $_msg"
345 mark_expected_rev
"$_rev"
346 git checkout
-q "$_rev" ||
exit
347 git show-branch
"$_rev"
353 case "$_list" in *$_rev*) return 0 ;; esac
357 handle_bad_merge_base
() {
360 if is_expected_rev
"$_badmb"; then
362 The merge base $_badmb is bad.
363 This means the bug has been fixed between $_badmb and [$_good].
368 Some good revs are not ancestor of the bad rev.
369 git bisect cannot work properly in this case.
370 Maybe you mistake good and bad revs?
376 handle_skipped_merge_base
() {
381 Warning: the merge base between $_bad and [$_good] must be skipped.
382 So we cannot be sure the first bad commit is between $_mb and $_bad.
387 check_merge_bases
() {
391 for _mb
in $
(git merge-base
--all $_bad $_good)
393 if is_among
"$_mb" "$_good"; then
395 elif test "$_mb" = "$_bad"; then
396 handle_bad_merge_base
"$_bad" "$_good"
397 elif is_among
"$_mb" "$_skip"; then
398 handle_skipped_merge_base
"$_mb" "$_bad" "$_good"
400 bisect_checkout
"$_mb" "a merge base must be tested"
407 check_good_are_ancestors_of_bad
() {
408 test -f "$GIT_DIR/BISECT_ANCESTORS_OK" &&
412 _good
=$
(echo $2 |
sed -e 's/\^//g')
415 # Bisecting with no good rev is ok
416 test -z "$_good" && return
418 _side
=$
(git rev-list
$_good ^
$_bad)
419 if test -n "$_side"; then
420 check_merge_bases
"$_bad" "$_good" "$_skip" ||
return
421 test "$checkout_done" -eq "1" && return
424 : > "$GIT_DIR/BISECT_ANCESTORS_OK"
428 case "$#" in 0) ;; *) usage
;; esac
430 bisect_next_check good
432 # Get bad, good and skipped revs
433 bad
=$
(git rev-parse
--verify refs
/bisect
/bad
) &&
434 good
=$
(git for-each-ref
--format='^%(objectname)' \
435 "refs/bisect/good-*" |
tr '\012' ' ') &&
436 skip
=$
(git for-each-ref
--format='%(objectname)' \
437 "refs/bisect/skip-*" |
tr '\012' ' ') &&
439 # Maybe some merge bases must be tested first
440 check_good_are_ancestors_of_bad
"$bad" "$good" "$skip" ||
exit
441 test "$checkout_done" -eq "1" && checkout_done
='' && return
443 # Get bisection information
445 test -n "$skip" && BISECT_OPT
='--bisect-all'
446 eval="git rev-list --bisect-vars $BISECT_OPT $good $bad --" &&
447 eval="$eval $(cat "$GIT_DIR/BISECT_NAMES
")" &&
448 eval=$
(filter_skipped
"$eval" "$skip") &&
451 if [ -z "$bisect_rev" ]; then
452 echo "$bad was both good and bad"
455 if [ "$bisect_rev" = "$bad" ]; then
456 exit_if_skipped_commits
"$bisect_tried"
457 echo "$bisect_rev is first bad commit"
458 git diff-tree
--pretty $bisect_rev
462 # We should exit here only if the "bad"
463 # commit is also a "skip" commit (see above).
464 exit_if_skipped_commits
"$bisect_rev"
466 bisect_checkout
"$bisect_rev" "$bisect_nr revisions left to test after this"
470 bisect_next_check fail
474 case "${DISPLAY+set}${MSYSTEM+set}${SECURITYSESSIONID+set}" in
481 -*) set git log
"$@" ;;
486 not
=$
(git for-each-ref
--format='%(refname)' "refs/bisect/good-*")
487 eval '"$@"' refs
/bisect
/bad
--not $not -- $
(cat "$GIT_DIR/BISECT_NAMES")
491 test -s "$GIT_DIR/BISECT_START" ||
{
492 echo "We are not bisecting."
496 0) branch
=$
(cat "$GIT_DIR/BISECT_START") ;;
497 1) git show-ref
--verify --quiet -- "refs/heads/$1" ||
498 die
"$1 does not seem to be a valid branch"
503 git checkout
"$branch" && bisect_clean_state
506 bisect_clean_state
() {
507 # There may be some refs packed during bisection.
508 git for-each-ref
--format='%(refname) %(objectname)' refs
/bisect
/\
* |
511 git update-ref
-d $ref $hash ||
exit
513 rm -f "$GIT_DIR/BISECT_EXPECTED_REV" &&
514 rm -f "$GIT_DIR/BISECT_ANCESTORS_OK" &&
515 rm -f "$GIT_DIR/BISECT_LOG" &&
516 rm -f "$GIT_DIR/BISECT_NAMES" &&
517 rm -f "$GIT_DIR/BISECT_RUN" &&
518 # Cleanup head-name if it got left by an old version of git-bisect
519 rm -f "$GIT_DIR/head-name" &&
521 rm -f "$GIT_DIR/BISECT_START"
525 test -r "$1" || die
"cannot read $1 for replaying"
527 while read git bisect
command rev
529 test "$git $bisect" = "git bisect" -o "$git" = "git-bisect" ||
continue
530 if test "$git" = "git-bisect"; then
536 cmd
="bisect_start $rev"
539 bisect_write
"$command" "$rev" ;;
541 die
"?? what are you talking about?" ;;
548 bisect_next_check fail
556 # Check for really bad run error.
557 if [ $res -lt 0 -o $res -ge 128 ]; then
558 echo >&2 "bisect run failed:"
559 echo >&2 "exit code $res from '$@' is < 0 or >= 128"
563 # Find current state depending on run success or failure.
564 # A special exit code of 125 means cannot test.
565 if [ $res -eq 125 ]; then
567 elif [ $res -gt 0 ]; then
573 # We have to use a subshell because "bisect_state" can exit.
574 ( bisect_state
$state > "$GIT_DIR/BISECT_RUN" )
577 cat "$GIT_DIR/BISECT_RUN"
579 if grep "first bad commit could be any of" "$GIT_DIR/BISECT_RUN" \
581 echo >&2 "bisect run cannot continue any more"
585 if [ $res -ne 0 ]; then
586 echo >&2 "bisect run failed:"
587 echo >&2 "'bisect_state $state' exited with error code $res"
591 if grep "is first bad commit" "$GIT_DIR/BISECT_RUN" > /dev
/null
; then
592 echo "bisect run success"
612 bisect_state
"$cmd" "$@" ;;
614 # Not sure we want "next" at the UI level anymore.
617 bisect_visualize
"$@" ;;
621 bisect_replay
"$@" ;;
623 cat "$GIT_DIR/BISECT_LOG" ;;