3 # Copyright (c) 2005 Junio C Hamano.
9 git rebase [-i] [options] [--exec <cmd>] [--onto <newbase>] [<upstream>] [<branch>]
10 git rebase [-i] [options] [--exec <cmd>] [--onto <newbase>] --root [<branch>]
11 git-rebase --continue | --abort | --skip | --edit-todo
14 v,verbose! display a diffstat of what changed upstream
15 q,quiet! be quiet. implies --no-stat
16 autostash! automatically stash/stash pop before and after
17 onto=! rebase onto given branch instead of upstream
18 p,preserve-merges! try to recreate merges instead of ignoring them
19 s,strategy=! use the given merge strategy
20 no-ff! cherry-pick all commits, even if unchanged
21 m,merge! use merging strategies to rebase
22 i,interactive! let the user edit the list of commits to rebase
23 x,exec=! add exec lines after each commit of the editable list
24 k,keep-empty preserve empty commits during rebase
25 f,force-rebase! force rebase even if branch is up to date
26 X,strategy-option=! pass the argument through to the merge strategy
27 stat! display a diffstat of what changed upstream
28 n,no-stat! do not show diffstat of what changed upstream
29 verify allow pre-rebase hook to run
30 rerere-autoupdate allow rerere to update index with resolved conflicts
31 root! rebase all reachable commits up to the root(s)
32 autosquash move commits that begin with squash!/fixup! under -i
33 committer-date-is-author-date! passed to 'git am'
34 ignore-date! passed to 'git am'
35 whitespace=! passed to 'git apply'
36 ignore-whitespace! passed to 'git apply'
37 C=! passed to 'git apply'
40 abort! abort and check out the original branch
41 skip! skip current patch and continue
42 edit-todo! edit the todo list during an interactive rebase
46 set_reflog_action rebase
47 require_work_tree_exists
52 ok_to_skip_pre_rebase=
54 $(gettext 'When you have resolved this problem, run "git rebase --continue".
55 If you prefer to skip this patch, run "git rebase --skip" instead.
56 To check out the original branch and stop rebasing, run "git rebase --abort".')
63 merge_dir="$GIT_DIR"/rebase-merge
64 apply_dir="$GIT_DIR"/rebase-apply
67 test "$(git config --bool rebase.stat)" = true && diffstat=t
68 autostash="$(git config --bool rebase.autostash || echo false)"
72 allow_rerere_autoupdate=
73 # Non-empty if a rebase was in progress when 'git rebase' was invoked
75 # One of {am, merge, interactive}
77 # One of {"$GIT_DIR"/rebase-apply, "$GIT_DIR"/rebase-merge}
79 # One of {'', continue, skip, abort}, as parsed from command line
84 test "$(git config --bool rebase.autosquash)" = "true" && autosquash=t
87 head_name=$(cat "$state_dir"/head-name) &&
88 onto=$(cat "$state_dir"/onto) &&
89 # We always write to orig-head, but interactive rebase used to write to
90 # head. Fall back to reading from head to cover for the case that the
91 # user upgraded git with an ongoing interactive rebase.
92 if test -f "$state_dir"/orig-head
94 orig_head=$(cat "$state_dir"/orig-head)
96 orig_head=$(cat "$state_dir"/head)
98 GIT_QUIET=$(cat "$state_dir"/quiet) &&
99 test -f "$state_dir"/verbose && verbose=t
100 test -f "$state_dir"/strategy && strategy="$(cat "$state_dir"/strategy)"
101 test -f "$state_dir"/strategy_opts &&
102 strategy_opts="$(cat "$state_dir"/strategy_opts)"
103 test -f "$state_dir"/allow_rerere_autoupdate &&
104 allow_rerere_autoupdate="$(cat "$state_dir"/allow_rerere_autoupdate)"
107 write_basic_state () {
108 echo "$head_name" > "$state_dir"/head-name &&
109 echo "$onto" > "$state_dir"/onto &&
110 echo "$orig_head" > "$state_dir"/orig-head &&
111 echo "$GIT_QUIET" > "$state_dir"/quiet &&
112 test t = "$verbose" && : > "$state_dir"/verbose
113 test -n "$strategy" && echo "$strategy" > "$state_dir"/strategy
114 test -n "$strategy_opts" && echo "$strategy_opts" > \
115 "$state_dir"/strategy_opts
116 test -n "$allow_rerere_autoupdate" && echo "$allow_rerere_autoupdate" > \
117 "$state_dir"/allow_rerere_autoupdate
125 test $status != 0 && printf "%s\n" "$output"
134 move_to_original_branch () {
137 message="rebase finished: $head_name onto $onto"
138 git update-ref -m "$message" \
139 $head_name $(git rev-parse HEAD) $orig_head &&
141 -m "rebase finished: returning to $head_name" \
143 die "$(gettext "Could not move back to $head_name")"
149 if test -f "$state_dir/autostash"
151 stash_sha1=$(cat "$state_dir/autostash")
152 if git stash apply $stash_sha1 2>&1 >/dev/null
154 echo "$(gettext 'Applied autostash.')"
156 ref_stash=refs/stash &&
157 >>"$GIT_DIR/logs/$ref_stash" &&
158 git update-ref -m "autostash" $ref_stash $stash_sha1 ||
159 die "$(eval_gettext 'Cannot store $stash_sha1')"
161 gettext 'Applying autostash resulted in conflicts.
162 Your changes are safe in the stash.
163 You can run "git stash pop" or "git stash drop" it at any time.
171 run_specific_rebase () {
172 if [ "$interactive_rebase" = implied ]; then
186 run_pre_rebase_hook () {
187 if test -z "$ok_to_skip_pre_rebase" &&
188 test -x "$GIT_DIR/hooks/pre-rebase"
190 "$GIT_DIR/hooks/pre-rebase" ${1+"$@"} ||
191 die "$(gettext "The pre-rebase hook refused to rebase.")"
195 test -f "$apply_dir"/applying &&
196 die "$(gettext "It looks like git-am is in progress. Cannot rebase.")"
198 if test -d "$apply_dir"
201 state_dir="$apply_dir"
202 elif test -d "$merge_dir"
204 if test -f "$merge_dir"/interactive
207 interactive_rebase=explicit
211 state_dir="$merge_dir"
213 test -n "$type" && in_progress=t
220 ok_to_skip_pre_rebase=yes
223 ok_to_skip_pre_rebase=
225 --continue|--skip|--abort|--edit-todo)
226 test $total_argc -eq 2 || usage
230 test 2 -le "$#" || usage
235 test 2 -le "$#" || usage
236 cmd="${cmd}exec $2${LF}"
240 interactive_rebase=explicit
247 test -z "$interactive_rebase" && interactive_rebase=implied
260 strategy_opts="$strategy_opts $(git rev-parse --sq-quote "--$1")"
262 test -z "$strategy" && strategy=recursive
285 git_am_opt="$git_am_opt -q"
291 git_am_opt="$git_am_opt --whitespace=$1"
299 git_am_opt="$git_am_opt $1"
301 --committer-date-is-author-date|--ignore-date)
302 git_am_opt="$git_am_opt $1"
307 git_am_opt="$git_am_opt -C$1"
315 --rerere-autoupdate|--no-rerere-autoupdate)
316 allow_rerere_autoupdate="$1"
325 test $# -gt 2 && usage
328 test "$interactive_rebase" != explicit
330 die "$(gettext "The --exec option must be used with the --interactive option")"
335 test -z "$in_progress" && die "$(gettext "No rebase in progress?")"
336 # Only interactive rebase uses detailed reflog messages
337 if test "$type" = interactive && test "$GIT_REFLOG_ACTION" = rebase
339 GIT_REFLOG_ACTION="rebase -i ($action)"
340 export GIT_REFLOG_ACTION
344 if test "$action" = "edit-todo" && test "$type" != "interactive"
346 die "$(gettext "The --edit-todo action can only be used during interactive rebase.")"
352 git rev-parse --verify HEAD >/dev/null ||
353 die "$(gettext "Cannot read HEAD")"
354 git update-index --ignore-submodules --refresh &&
355 git diff-files --quiet --ignore-submodules || {
356 echo "$(gettext "You must edit all merge conflicts and then
357 mark them as resolved using git add")"
364 output git reset --hard HEAD || exit $?
373 git symbolic-ref -m "rebase: aborting" HEAD $head_name ||
374 die "$(eval_gettext "Could not move back to \$head_name")"
377 output git reset --hard $orig_head
386 # Make sure no rebase is in progress
387 if test -n "$in_progress"
389 state_dir_base=${state_dir##*/}
390 cmd_live_rebase="git rebase (--continue | --abort | --skip)"
391 cmd_clear_stale_rebase="rm -fr \"$state_dir\""
393 $(eval_gettext 'It seems that there is already a $state_dir_base directory, and
394 I wonder if you are in the middle of another rebase. If that is the
397 If that is not the case, please
398 $cmd_clear_stale_rebase
399 and run me again. I am stopping in case you still have something
403 if test -n "$rebase_root" && test -z "$onto"
405 test -z "$interactive_rebase" && interactive_rebase=implied
408 if test -n "$interactive_rebase"
411 state_dir="$merge_dir"
412 elif test -n "$do_merge"
415 state_dir="$merge_dir"
418 state_dir="$apply_dir"
421 if test -z "$rebase_root"
425 if ! upstream_name=$(git rev-parse --symbolic-full-name \
426 --verify -q @{upstream} 2>/dev/null)
429 error_on_missing_default_upstream "rebase" "rebase" \
430 "against" "git rebase <branch>"
433 *) upstream_name="$1"
437 upstream=`git rev-parse --verify "${upstream_name}^0"` ||
438 die "$(eval_gettext "invalid upstream \$upstream_name")"
439 upstream_arg="$upstream_name"
443 empty_tree=`git hash-object -t tree /dev/null`
444 onto=`git commit-tree $empty_tree </dev/null`
449 test $# -gt 1 && usage
453 # Make sure the branch to rebase onto is valid.
454 onto_name=${onto-"$upstream_name"}
457 if left=${onto_name%...*} right=${onto_name#*...} &&
458 onto=$(git merge-base --all ${left:-HEAD} ${right:-HEAD})
462 die "$(eval_gettext "\$onto_name: there are more than one merge bases")"
465 die "$(eval_gettext "\$onto_name: there is no merge base")"
469 die "$(eval_gettext "\$onto_name: there is no merge base")"
473 onto=$(git rev-parse --verify "${onto_name}^0") ||
474 die "$(eval_gettext "Does not point to a valid commit: \$onto_name")"
478 # If the branch to rebase is given, that is the branch we will rebase
479 # $branch_name -- branch being rebased, or HEAD (already detached)
480 # $orig_head -- commit object name of tip of the branch before rebasing
481 # $head_name -- refs/heads/<that-branch> or "detached HEAD"
485 # Is it "rebase other $branchname" or "rebase other $commit"?
489 if git show-ref --verify --quiet -- "refs/heads/$1" &&
490 orig_head=$(git rev-parse -q --verify "refs/heads/$1")
492 head_name="refs/heads/$1"
493 elif orig_head=$(git rev-parse -q --verify "$1")
495 head_name="detached HEAD"
497 die "$(eval_gettext "fatal: no such branch: \$branch_name")"
501 # Do not need to switch branches, we are already on it.
502 if branch_name=`git symbolic-ref -q HEAD`
504 head_name=$branch_name
505 branch_name=`expr "z$branch_name" : 'zrefs/heads/\(.*\)'`
507 head_name="detached HEAD"
508 branch_name=HEAD ;# detached
510 orig_head=$(git rev-parse --verify HEAD) || exit
513 die "BUG: unexpected number of arguments left to parse"
517 if test "$autostash" = true && ! (require_clean_work_tree) 2>/dev/null
519 stash_sha1=$(git stash create "autostash") ||
520 die "$(gettext 'Cannot autostash')"
522 mkdir -p "$state_dir" &&
523 echo $stash_sha1 >"$state_dir/autostash" &&
524 stash_abbrev=$(git rev-parse --short $stash_sha1) &&
525 echo "$(eval_gettext 'Created autostash: $stash_abbrev')" &&
529 require_clean_work_tree "rebase" "$(gettext "Please commit or stash them.")"
531 # Now we are rebasing commits $upstream..$orig_head (or with --root,
532 # everything leading up to $orig_head) on top of $onto
534 # Check if we are already based on $onto with linear history,
535 # but this should be done only when upstream and onto are the same
536 # and if this is not an interactive rebase.
537 mb=$(git merge-base "$onto" "$orig_head")
538 if test "$type" != interactive && test "$upstream" = "$onto" &&
539 test "$mb" = "$onto" &&
541 ! (git rev-list --parents "$onto".."$orig_head" | sane_grep " .* ") > /dev/null
543 if test -z "$force_rebase"
545 # Lazily switch to the target branch if needed...
546 test -z "$switch_to" || git checkout "$switch_to" --
547 say "$(eval_gettext "Current branch \$branch_name is up to date.")"
550 say "$(eval_gettext "Current branch \$branch_name is up to date, rebase forced.")"
554 # If a hook exists, give it a chance to interrupt
555 run_pre_rebase_hook "$upstream_arg" "$@"
557 if test -n "$diffstat"
559 if test -n "$verbose"
561 echo "$(eval_gettext "Changes from \$mb to \$onto:")"
563 # We want color (if set), but no pager
564 GIT_PAGER='' git diff --stat --summary "$mb" "$onto"
567 test "$type" = interactive && run_specific_rebase
569 # Detach HEAD and reset the tree
570 say "$(gettext "First, rewinding head to replay your work on top of it...")"
571 git checkout -q "$onto^0" || die "could not detach HEAD"
572 git update-ref ORIG_HEAD $orig_head
574 # If the $onto is a proper descendant of the tip of the branch, then
575 # we just fast-forwarded.
576 if test "$mb" = "$orig_head"
578 say "$(eval_gettext "Fast-forwarded \$branch_name to \$onto_name.")"
579 move_to_original_branch
583 if test -n "$rebase_root"
585 revisions="$onto..$orig_head"
587 revisions="$upstream..$orig_head"