1#!/bin/sh 2# 3# Copyright (c) 2005 Junio C Hamano. 4# 5 6USAGE='[--interactive | -i] [-v] [--force-rebase | -f] [--no-ff] [--onto <newbase>] [<upstream>|--root] [<branch>] [--quiet | -q]' 7LONG_USAGE='git-rebase replaces <branch> with a new branch of the 8same name. When the --onto option is provided the new branch starts 9out with a HEAD equal to <newbase>, otherwise it is equal to <upstream> 10It then attempts to create a new commit for each commit from the original 11<branch> that does not exist in the <upstream> branch. 12 13It is possible that a merge failure will prevent this process from being 14completely automatic. You will have to resolve any such merge failure 15and run git rebase --continue. Another option is to bypass the commit 16that caused the merge failure with git rebase --skip. To restore the 17original <branch> and remove the .git/rebase-apply working files, use the 18command git rebase --abort instead. 19 20Note that if <branch> is not specified on the command line, the 21currently checked out branch is used. 22 23Example: git-rebase master~1 topic 24 25 A---B---C topic A'\''--B'\''--C'\'' topic 26 / --> / 27 D---E---F---G master D---E---F---G master 28' 29 30SUBDIRECTORY_OK=Yes 31OPTIONS_KEEPDASHDASH= 32OPTIONS_SPEC="\ 33git rebase [-i] [options] [--onto <newbase>] [<upstream>] [<branch>] 34git rebase [-i] [options] --onto <newbase> --root [<branch>] 35git-rebase [-i] --continue | --abort | --skip 36-- 37 Available options are 38v,verbose! display a diffstat of what changed upstream 39q,quiet! be quiet. implies --no-stat 40onto=! rebase onto given branch instead of upstream 41p,preserve-merges! try to recreate merges instead of ignoring them 42s,strategy=! use the given merge strategy 43no-ff! cherry-pick all commits, even if unchanged 44m,merge! use merging strategies to rebase 45i,interactive! let the user edit the list of commits to rebase 46f,force-rebase! force rebase even if branch is up to date 47X,strategy-option=! pass the argument through to the merge strategy 48stat! display a diffstat of what changed upstream 49n,no-stat! do not show diffstat of what changed upstream 50verify allow pre-rebase hook to run 51rerere-autoupdate allow rerere to update index with resolved conflicts 52root! rebase all reachable commits up to the root(s) 53autosquash move commits that begin with squash!/fixup! under -i 54committer-date-is-author-date! passed to 'git am' 55ignore-date! passed to 'git am' 56whitespace=! passed to 'git apply' 57ignore-whitespace! passed to 'git apply' 58C=! passed to 'git apply' 59 Actions: 60continue! continue rebasing process 61abort! abort rebasing process and restore original branch 62skip! skip current patch and continue rebasing process 63" 64. git-sh-setup 65set_reflog_action rebase 66require_work_tree 67cd_to_toplevel 68 69LF=' 70' 71ok_to_skip_pre_rebase= 72resolvemsg=" 73When you have resolved this problem run\"git rebase --continue\". 74If you would prefer to skip this patch, instead run\"git rebase --skip\". 75To restore the original branch and stop rebasing run\"git rebase --abort\". 76" 77unset onto 78strategy= 79strategy_opts= 80do_merge= 81merge_dir="$GIT_DIR"/rebase-merge 82apply_dir="$GIT_DIR"/rebase-apply 83verbose= 84diffstat= 85test"$(git config --bool rebase.stat)"= true && diffstat=t 86git_am_opt= 87rebase_root= 88force_rebase= 89allow_rerere_autoupdate= 90# Non-empty if a rebase was in progress when 'git rebase' was invoked 91in_progress= 92# One of {am, merge, interactive} 93type= 94# One of {"$GIT_DIR"/rebase-apply, "$GIT_DIR"/rebase-merge} 95state_dir= 96# One of {'', continue, skip, abort}, as parsed from command line 97action= 98preserve_merges= 99autosquash= 100test"$(git config --bool rebase.autosquash)"="true"&& autosquash=t 101 102read_basic_state () { 103 head_name=$(cat "$state_dir"/head-name)&& 104 onto=$(cat "$state_dir"/onto)&& 105# We always write to orig-head, but interactive rebase used to write to 106# head. Fall back to reading from head to cover for the case that the 107# user upgraded git with an ongoing interactive rebase. 108iftest -f"$state_dir"/orig-head 109then 110 orig_head=$(cat "$state_dir"/orig-head) 111else 112 orig_head=$(cat "$state_dir"/head) 113fi&& 114 GIT_QUIET=$(cat "$state_dir"/quiet)&& 115test -f"$state_dir"/verbose && verbose=t 116test -f"$state_dir"/strategy && strategy="$(cat "$state_dir"/strategy)" 117test -f"$state_dir"/strategy_opts && 118 strategy_opts="$(cat "$state_dir"/strategy_opts)" 119test -f"$state_dir"/allow_rerere_autoupdate && 120 allow_rerere_autoupdate="$(cat "$state_dir"/allow_rerere_autoupdate)" 121} 122 123write_basic_state () { 124echo"$head_name">"$state_dir"/head-name&& 125echo"$onto">"$state_dir"/onto && 126echo"$orig_head">"$state_dir"/orig-head&& 127echo"$GIT_QUIET">"$state_dir"/quiet && 128test t ="$verbose"&& : >"$state_dir"/verbose 129test -n"$strategy"&&echo"$strategy">"$state_dir"/strategy 130test -n"$strategy_opts"&&echo"$strategy_opts"> \ 131"$state_dir"/strategy_opts 132test -n"$allow_rerere_autoupdate"&&echo"$allow_rerere_autoupdate"> \ 133"$state_dir"/allow_rerere_autoupdate 134} 135 136output () { 137case"$verbose"in 138'') 139 output=$("$@" 2>&1 ) 140 status=$? 141test$status!=0&&printf"%s\n""$output" 142return$status 143;; 144*) 145"$@" 146;; 147esac 148} 149 150move_to_original_branch () { 151case"$head_name"in 152 refs/*) 153 message="rebase finished:$head_nameonto$onto" 154 git update-ref -m"$message" \ 155$head_name $(git rev-parse HEAD) $orig_head&& 156 git symbolic-ref \ 157-m"rebase finished: returning to$head_name" \ 158 HEAD $head_name|| 159 die "Could not move back to$head_name" 160;; 161esac 162} 163 164run_specific_rebase () { 165if["$interactive_rebase"= implied ];then 166 GIT_EDITOR=: 167export GIT_EDITOR 168fi 169 . git-rebase--$type 170} 171 172run_pre_rebase_hook () { 173iftest -z"$ok_to_skip_pre_rebase"&& 174test -x"$GIT_DIR/hooks/pre-rebase" 175then 176"$GIT_DIR/hooks/pre-rebase"${1+"$@"}|| 177 die "The pre-rebase hook refused to rebase." 178fi 179} 180 181test -f"$apply_dir"/applying && 182 die 'It looks like git-am is in progress. Cannot rebase.' 183 184iftest -d"$apply_dir" 185then 186type=am 187 state_dir="$apply_dir" 188eliftest -d"$merge_dir" 189then 190iftest -f"$merge_dir"/interactive 191then 192type=interactive 193 interactive_rebase=explicit 194else 195type=merge 196fi 197 state_dir="$merge_dir" 198fi 199test -n"$type"&& in_progress=t 200 201total_argc=$# 202whiletest$#!=0 203do 204case"$1"in 205--no-verify) 206 ok_to_skip_pre_rebase=yes 207;; 208--verify) 209 ok_to_skip_pre_rebase= 210;; 211--continue|--skip|--abort) 212test$total_argc-eq2|| usage 213 action=${1##--} 214;; 215--onto) 216test2-le"$#"|| usage 217 onto="$2" 218shift 219;; 220-i) 221 interactive_rebase=explicit 222;; 223-p) 224 preserve_merges=t 225test -z"$interactive_rebase"&& interactive_rebase=implied 226;; 227--autosquash) 228 autosquash=t 229;; 230--no-autosquash) 231 autosquash= 232;; 233-M|-m) 234 do_merge=t 235;; 236-X) 237shift 238 strategy_opts="$strategy_opts$(git rev-parse --sq-quote "--$1")" 239 do_merge=t 240test -z"$strategy"&& strategy=recursive 241;; 242-s) 243shift 244 strategy="$1" 245 do_merge=t 246;; 247-n) 248 diffstat= 249;; 250--stat) 251 diffstat=t 252;; 253-v) 254 verbose=t 255 diffstat=t 256 GIT_QUIET= 257;; 258-q) 259 GIT_QUIET=t 260 git_am_opt="$git_am_opt-q" 261 verbose= 262 diffstat= 263;; 264--whitespace) 265shift 266 git_am_opt="$git_am_opt--whitespace=$1" 267case"$1"in 268 fix|strip) 269 force_rebase=t 270;; 271esac 272;; 273--ignore-whitespace) 274 git_am_opt="$git_am_opt$1" 275;; 276--committer-date-is-author-date|--ignore-date) 277 git_am_opt="$git_am_opt$1" 278 force_rebase=t 279;; 280-C) 281shift 282 git_am_opt="$git_am_opt-C$1" 283;; 284--root) 285 rebase_root=t 286;; 287-f|--no-ff) 288 force_rebase=t 289;; 290--rerere-autoupdate|--no-rerere-autoupdate) 291 allow_rerere_autoupdate="$1" 292;; 293--) 294shift 295break 296;; 297esac 298shift 299done 300test$#-gt2&& usage 301 302iftest -n"$action" 303then 304test -z"$in_progress"&& die "No rebase in progress?" 305# Only interactive rebase uses detailed reflog messages 306iftest"$type"= interactive &&test"$GIT_REFLOG_ACTION"= rebase 307then 308 GIT_REFLOG_ACTION="rebase -i ($action)" 309export GIT_REFLOG_ACTION 310fi 311fi 312 313case"$action"in 314continue) 315# Sanity check 316 git rev-parse --verify HEAD >/dev/null || 317 die "Cannot read HEAD" 318 git update-index --ignore-submodules --refresh&& 319 git diff-files --quiet --ignore-submodules|| { 320echo"You must edit all merge conflicts and then" 321echo"mark them as resolved using git add" 322exit1 323} 324 read_basic_state 325 run_specific_rebase 326;; 327skip) 328 output git reset--hard HEAD ||exit $? 329 read_basic_state 330 run_specific_rebase 331;; 332abort) 333 git rerere clear 334 read_basic_state 335case"$head_name"in 336 refs/*) 337 git symbolic-ref -m"rebase: aborting" HEAD $head_name|| 338 die "Could not move back to$head_name" 339;; 340esac 341 output git reset--hard$orig_head 342rm-r"$state_dir" 343exit 344;; 345esac 346 347# Make sure no rebase is in progress 348iftest -n"$in_progress" 349then 350 die ' 351It seems that there is already a '"${state_dir##*/}"' directory, and 352I wonder if you are in the middle of another rebase. If that is the 353case, please try 354 git rebase (--continue | --abort | --skip) 355If that is not the case, please 356 rm -fr '"$state_dir"' 357and run me again. I am stopping in case you still have something 358valuable there.' 359fi 360 361iftest -n"$interactive_rebase" 362then 363type=interactive 364 state_dir="$merge_dir" 365eliftest -n"$do_merge" 366then 367type=merge 368 state_dir="$merge_dir" 369else 370type=am 371 state_dir="$apply_dir" 372fi 373 374iftest -z"$rebase_root" 375then 376case"$#"in 3770) 378if! upstream_name=$(git rev-parse --symbolic-full-name \ 379--verify -q @{upstream}2>/dev/null) 380then 381 . git-parse-remote 382 error_on_missing_default_upstream "rebase""rebase" \ 383"against""git rebase <upstream branch>" 384fi 385;; 386*) upstream_name="$1" 387shift 388;; 389esac 390 upstream=`git rev-parse --verify "${upstream_name}^0"`|| 391 die "invalid upstream$upstream_name" 392 upstream_arg="$upstream_name" 393else 394test -z"$onto"&& die "You must specify --onto when using --root" 395unset upstream_name 396unset upstream 397 upstream_arg=--root 398fi 399 400# Make sure the branch to rebase onto is valid. 401onto_name=${onto-"$upstream_name"} 402case"$onto_name"in 403*...*) 404if left=${onto_name%...*} right=${onto_name#*...}&& 405 onto=$(git merge-base --all ${left:-HEAD} ${right:-HEAD}) 406then 407case"$onto"in 408 ?*"$LF"?*) 409 die "$onto_name: there are more than one merge bases" 410;; 411'') 412 die "$onto_name: there is no merge base" 413;; 414esac 415else 416 die "$onto_name: there is no merge base" 417fi 418;; 419*) 420 onto=$(git rev-parse --verify "${onto_name}^0")|| 421 die "Does not point to a valid commit:$1" 422;; 423esac 424 425# If the branch to rebase is given, that is the branch we will rebase 426# $branch_name -- branch being rebased, or HEAD (already detached) 427# $orig_head -- commit object name of tip of the branch before rebasing 428# $head_name -- refs/heads/<that-branch> or "detached HEAD" 429switch_to= 430case"$#"in 4311) 432# Is it "rebase other $branchname" or "rebase other $commit"? 433 branch_name="$1" 434 switch_to="$1" 435 436if git show-ref --verify --quiet --"refs/heads/$1"&& 437 orig_head=$(git rev-parse -q --verify "refs/heads/$1") 438then 439 head_name="refs/heads/$1" 440elif orig_head=$(git rev-parse -q --verify "$1") 441then 442 head_name="detached HEAD" 443else 444echo>&2"fatal: no such branch:$1" 445 usage 446fi 447;; 448*) 449# Do not need to switch branches, we are already on it. 450if branch_name=`git symbolic-ref -q HEAD` 451then 452 head_name=$branch_name 453 branch_name=`expr "z$branch_name" : 'zrefs/heads/\(.*\)'` 454else 455 head_name="detached HEAD" 456 branch_name=HEAD ;# detached 457fi 458 orig_head=$(git rev-parse --verify "${branch_name}^0")||exit 459;; 460esac 461 462require_clean_work_tree "rebase""Please commit or stash them." 463 464# Now we are rebasing commits $upstream..$orig_head (or with --root, 465# everything leading up to $orig_head) on top of $onto 466 467# Check if we are already based on $onto with linear history, 468# but this should be done only when upstream and onto are the same 469# and if this is not an interactive rebase. 470mb=$(git merge-base "$onto" "$orig_head") 471iftest"$type"!= interactive &&test"$upstream"="$onto"&& 472test"$mb"="$onto"&& 473# linear history? 474! (git rev-list --parents"$onto".."$orig_head"| sane_grep " .* ") > /dev/null 475then 476iftest -z"$force_rebase" 477then 478# Lazily switch to the target branch if needed... 479test -z"$switch_to"|| git checkout "$switch_to"-- 480 say "Current branch$branch_nameis up to date." 481exit0 482else 483 say "Current branch$branch_nameis up to date, rebase forced." 484fi 485fi 486 487# If a hook exists, give it a chance to interrupt 488run_pre_rebase_hook "$upstream_arg""$@" 489 490iftest -n"$diffstat" 491then 492iftest -n"$verbose" 493then 494echo"Changes from$mbto$onto:" 495fi 496# We want color (if set), but no pager 497 GIT_PAGER='' git diff--stat --summary"$mb""$onto" 498fi 499 500test"$type"= interactive && run_specific_rebase 501 502# Detach HEAD and reset the tree 503say "First, rewinding head to replay your work on top of it..." 504git checkout -q"$onto^0"|| die "could not detach HEAD" 505git update-ref ORIG_HEAD $orig_head 506 507# If the $onto is a proper descendant of the tip of the branch, then 508# we just fast-forwarded. 509iftest"$mb"="$orig_head" 510then 511 say "Fast-forwarded$branch_nameto$onto_name." 512 move_to_original_branch 513exit0 514fi 515 516iftest -n"$rebase_root" 517then 518 revisions="$onto..$orig_head" 519else 520 revisions="$upstream..$orig_head" 521fi 522 523run_specific_rebase