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>|<range>)...]
13 mark <rev>... untestable revisions.
15 find next bisection to test and check it out.
16 git bisect reset [<commit>]
17 finish bisection search and go back to commit.
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.'
34 _x40
='[0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f]'
35 _x40
="$_x40$_x40$_x40$_x40$_x40$_x40$_x40$_x40"
38 test -s "$GIT_DIR/BISECT_START" ||
{
39 echo >&2 'You need to start by "git bisect start"'
42 echo >&2 -n 'Do you want me to do it for you [Y/n]? '
59 head=$
(GIT_DIR
="$GIT_DIR" git symbolic-ref
-q HEAD
) ||
60 head=$
(GIT_DIR
="$GIT_DIR" git rev-parse
--verify HEAD
) ||
61 die
"Bad HEAD - I need a HEAD"
64 # Check if we are bisecting.
67 if test -s "$GIT_DIR/BISECT_START"
69 # Reset to the rev from where we started.
70 start_head
=$
(cat "$GIT_DIR/BISECT_START")
71 git checkout
"$start_head" -- ||
exit
73 # Get rev from where we start.
76 # This error message should only be triggered by
77 # cogito usage, and cogito users should understand
78 # it relates to cg-seek.
79 [ -s "$GIT_DIR/head-name" ] &&
80 die
"won't bisect on seeked tree"
81 start_head
="${head#refs/heads/}"
84 die
"Bad HEAD - strange symbolic ref"
90 # Get rid of any old bisect state.
92 bisect_clean_state ||
exit
95 # Check for one bad and then some good revisions.
99 case "$arg" in --) has_double_dash
=1; break ;; esac
101 orig_args
=$
(git rev-parse
--sq-quote "$@")
104 while [ $# -gt 0 ]; do
112 rev=$
(git rev-parse
-q --verify "$arg^{commit}") ||
{
113 test $has_double_dash -eq 1 &&
114 die
"'$arg' does not appear to be a valid revision"
118 0) state
='bad' ; bad_seen
=1 ;;
121 eval="$eval bisect_write '$state' '$rev' 'nolog'; "
129 # In case of mistaken revs or checkout error, or signals received,
130 # "bisect_auto_next" below may exit or misbehave.
131 # We have to trap this to be able to clean up using
132 # "bisect_clean_state".
134 trap 'bisect_clean_state' 0
135 trap 'exit 255' 1 2 3 15
138 # Write new start state.
140 echo "$start_head" >"$GIT_DIR/BISECT_START" &&
141 git rev-parse
--sq-quote "$@" >"$GIT_DIR/BISECT_NAMES" &&
143 echo "git bisect start$orig_args" >>"$GIT_DIR/BISECT_LOG" ||
exit
145 # Check if we can proceed to the next bisect state.
158 good|skip
) tag
="$state"-"$rev" ;;
159 *) die
"Bad bisect_write argument: $state" ;;
161 git update-ref
"refs/bisect/$tag" "$rev" ||
exit
162 echo "# $state: $(git show-branch $rev)" >>"$GIT_DIR/BISECT_LOG"
163 test -n "$nolog" ||
echo "git bisect $state $rev" >>"$GIT_DIR/BISECT_LOG"
167 test -f "$GIT_DIR/BISECT_EXPECTED_REV" &&
168 test "$1" = $
(cat "$GIT_DIR/BISECT_EXPECTED_REV")
171 check_expected_revs
() {
173 if ! is_expected_rev
"$_rev"; then
174 rm -f "$GIT_DIR/BISECT_ANCESTORS_OK"
175 rm -f "$GIT_DIR/BISECT_EXPECTED_REV"
187 revs
=$
(git rev-list
"$arg") || die
"Bad rev input: $arg" ;;
189 revs
=$
(git rev-parse
--sq-quote "$arg") ;;
193 eval bisect_state
'skip' $all
201 die
"Please call 'bisect_state' with at least one argument." ;;
203 rev=$
(git rev-parse
--verify HEAD
) ||
204 die
"Bad rev input: HEAD"
205 bisect_write
"$state" "$rev"
206 check_expected_revs
"$rev" ;;
212 sha
=$
(git rev-parse
--verify "$rev^{commit}") ||
213 die
"Bad rev input: $rev"
214 eval="$eval bisect_write '$state' '$sha'; "
217 check_expected_revs
"$@" ;;
219 die
"'git bisect bad' can take only one argument." ;;
226 bisect_next_check
() {
227 missing_good
= missing_bad
=
228 git show-ref
-q --verify refs
/bisect
/bad || missing_bad
=t
229 test -n "$(git for-each-ref "refs
/bisect
/good-
*")" || missing_good
=t
231 case "$missing_good,$missing_bad,$1" in
233 : have both good and bad
- ok
236 # do not have both but not asked to fail - just report.
240 # have bad but not good. we could bisect although
241 # this is less optimum.
242 echo >&2 'Warning: bisecting only with a bad commit.'
245 printf >&2 'Are you sure [Y/n]? '
247 case "$yesno" in [Nn
]*) exit 1 ;; esac
249 : bisect without good...
253 test -s "$GIT_DIR/BISECT_START" ||
{
254 echo >&2 'You need to start by "git bisect start".'
257 echo >&2 'You '$THEN'need to give me at least one good' \
258 'and one bad revisions.'
259 echo >&2 '(You can use "git bisect bad" and' \
260 '"git bisect good" for that.)'
266 bisect_next_check
&& bisect_next ||
:
270 case "$#" in 0) ;; *) usage
;; esac
272 bisect_next_check good
274 # Perform all bisection computation, display and checkout
275 git bisect--helper
--next-all
278 # Check if we should exit because bisection is finished
279 test $res -eq 10 && exit 0
281 # Check for an error in the bisection process
282 test $res -ne 0 && exit $res
288 bisect_next_check fail
292 if test -n "${DISPLAY+set}${SESSIONNAME+set}${MSYSTEM+set}${SECURITYSESSIONID+set}" &&
293 type gitk
>/dev
/null
2>&1; then
301 -*) set git log
"$@" ;;
306 eval '"$@"' --bisect -- $
(cat "$GIT_DIR/BISECT_NAMES")
310 test -s "$GIT_DIR/BISECT_START" ||
{
311 echo "We are not bisecting."
315 0) branch
=$
(cat "$GIT_DIR/BISECT_START") ;;
316 1) git rev-parse
--quiet --verify "$1^{commit}" > /dev
/null ||
317 die
"'$1' is not a valid commit"
322 if git checkout
"$branch" -- ; then
325 die
"Could not check out original HEAD '$branch'." \
326 "Try 'git bisect reset <commit>'."
330 bisect_clean_state
() {
331 # There may be some refs packed during bisection.
332 git for-each-ref
--format='%(refname) %(objectname)' refs
/bisect
/\
* |
335 git update-ref
-d $ref $hash ||
exit
337 rm -f "$GIT_DIR/BISECT_EXPECTED_REV" &&
338 rm -f "$GIT_DIR/BISECT_ANCESTORS_OK" &&
339 rm -f "$GIT_DIR/BISECT_LOG" &&
340 rm -f "$GIT_DIR/BISECT_NAMES" &&
341 rm -f "$GIT_DIR/BISECT_RUN" &&
342 # Cleanup head-name if it got left by an old version of git-bisect
343 rm -f "$GIT_DIR/head-name" &&
345 rm -f "$GIT_DIR/BISECT_START"
349 test "$#" -eq 1 || die
"No logfile given"
350 test -r "$1" || die
"cannot read $1 for replaying"
352 while read git bisect
command rev
354 test "$git $bisect" = "git bisect" -o "$git" = "git-bisect" ||
continue
355 if test "$git" = "git-bisect"; then
361 cmd
="bisect_start $rev"
364 bisect_write
"$command" "$rev" ;;
366 die
"?? what are you talking about?" ;;
373 bisect_next_check fail
381 # Check for really bad run error.
382 if [ $res -lt 0 -o $res -ge 128 ]; then
383 echo >&2 "bisect run failed:"
384 echo >&2 "exit code $res from '$@' is < 0 or >= 128"
388 # Find current state depending on run success or failure.
389 # A special exit code of 125 means cannot test.
390 if [ $res -eq 125 ]; then
392 elif [ $res -gt 0 ]; then
398 # We have to use a subshell because "bisect_state" can exit.
399 ( bisect_state
$state > "$GIT_DIR/BISECT_RUN" )
402 cat "$GIT_DIR/BISECT_RUN"
404 if sane_grep
"first bad commit could be any of" "$GIT_DIR/BISECT_RUN" \
406 echo >&2 "bisect run cannot continue any more"
410 if [ $res -ne 0 ]; then
411 echo >&2 "bisect run failed:"
412 echo >&2 "'bisect_state $state' exited with error code $res"
416 if sane_grep
"is the first bad commit" "$GIT_DIR/BISECT_RUN" > /dev
/null
; then
417 echo "bisect run success"
425 test -s "$GIT_DIR/BISECT_LOG" || die
"We are not bisecting."
426 cat "$GIT_DIR/BISECT_LOG"
441 bisect_state
"$cmd" "$@" ;;
445 # Not sure we want "next" at the UI level anymore.
448 bisect_visualize
"$@" ;;
452 bisect_replay
"$@" ;;