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 check out 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 61abort! abort and check out the original branch 62skip! skip current patch and continue 63" 64. git-sh-setup 65set_reflog_action rebase 66require_work_tree_exists 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 check out 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 168 autosquash= 169fi 170 . git-rebase--$type 171} 172 173run_pre_rebase_hook () { 174iftest -z"$ok_to_skip_pre_rebase"&& 175test -x"$GIT_DIR/hooks/pre-rebase" 176then 177"$GIT_DIR/hooks/pre-rebase"${1+"$@"}|| 178 die "The pre-rebase hook refused to rebase." 179fi 180} 181 182test -f"$apply_dir"/applying && 183 die 'It looks like git-am is in progress. Cannot rebase.' 184 185iftest -d"$apply_dir" 186then 187type=am 188 state_dir="$apply_dir" 189eliftest -d"$merge_dir" 190then 191iftest -f"$merge_dir"/interactive 192then 193type=interactive 194 interactive_rebase=explicit 195else 196type=merge 197fi 198 state_dir="$merge_dir" 199fi 200test -n"$type"&& in_progress=t 201 202total_argc=$# 203whiletest$#!=0 204do 205case"$1"in 206--no-verify) 207 ok_to_skip_pre_rebase=yes 208;; 209--verify) 210 ok_to_skip_pre_rebase= 211;; 212--continue|--skip|--abort) 213test$total_argc-eq2|| usage 214 action=${1##--} 215;; 216--onto) 217test2-le"$#"|| usage 218 onto="$2" 219shift 220;; 221-i) 222 interactive_rebase=explicit 223;; 224-p) 225 preserve_merges=t 226test -z"$interactive_rebase"&& interactive_rebase=implied 227;; 228--autosquash) 229 autosquash=t 230;; 231--no-autosquash) 232 autosquash= 233;; 234-M|-m) 235 do_merge=t 236;; 237-X) 238shift 239 strategy_opts="$strategy_opts$(git rev-parse --sq-quote "--$1")" 240 do_merge=t 241test -z"$strategy"&& strategy=recursive 242;; 243-s) 244shift 245 strategy="$1" 246 do_merge=t 247;; 248-n) 249 diffstat= 250;; 251--stat) 252 diffstat=t 253;; 254-v) 255 verbose=t 256 diffstat=t 257 GIT_QUIET= 258;; 259-q) 260 GIT_QUIET=t 261 git_am_opt="$git_am_opt-q" 262 verbose= 263 diffstat= 264;; 265--whitespace) 266shift 267 git_am_opt="$git_am_opt--whitespace=$1" 268case"$1"in 269 fix|strip) 270 force_rebase=t 271;; 272esac 273;; 274--ignore-whitespace) 275 git_am_opt="$git_am_opt$1" 276;; 277--committer-date-is-author-date|--ignore-date) 278 git_am_opt="$git_am_opt$1" 279 force_rebase=t 280;; 281-C) 282shift 283 git_am_opt="$git_am_opt-C$1" 284;; 285--root) 286 rebase_root=t 287;; 288-f|--no-ff) 289 force_rebase=t 290;; 291--rerere-autoupdate|--no-rerere-autoupdate) 292 allow_rerere_autoupdate="$1" 293;; 294--) 295shift 296break 297;; 298esac 299shift 300done 301test$#-gt2&& usage 302 303iftest -n"$action" 304then 305test -z"$in_progress"&& die "No rebase in progress?" 306# Only interactive rebase uses detailed reflog messages 307iftest"$type"= interactive &&test"$GIT_REFLOG_ACTION"= rebase 308then 309 GIT_REFLOG_ACTION="rebase -i ($action)" 310export GIT_REFLOG_ACTION 311fi 312fi 313 314case"$action"in 315continue) 316# Sanity check 317 git rev-parse --verify HEAD >/dev/null || 318 die "Cannot read HEAD" 319 git update-index --ignore-submodules --refresh&& 320 git diff-files --quiet --ignore-submodules|| { 321echo"You must edit all merge conflicts and then" 322echo"mark them as resolved using git add" 323exit1 324} 325 read_basic_state 326 run_specific_rebase 327;; 328skip) 329 output git reset--hard HEAD ||exit $? 330 read_basic_state 331 run_specific_rebase 332;; 333abort) 334 git rerere clear 335 read_basic_state 336case"$head_name"in 337 refs/*) 338 git symbolic-ref -m"rebase: aborting" HEAD $head_name|| 339 die "Could not move back to$head_name" 340;; 341esac 342 output git reset--hard$orig_head 343rm-r"$state_dir" 344exit 345;; 346esac 347 348# Make sure no rebase is in progress 349iftest -n"$in_progress" 350then 351 die ' 352It seems that there is already a '"${state_dir##*/}"' directory, and 353I wonder if you are in the middle of another rebase. If that is the 354case, please try 355 git rebase (--continue | --abort | --skip) 356If that is not the case, please 357 rm -fr '"$state_dir"' 358and run me again. I am stopping in case you still have something 359valuable there.' 360fi 361 362iftest -n"$interactive_rebase" 363then 364type=interactive 365 state_dir="$merge_dir" 366eliftest -n"$do_merge" 367then 368type=merge 369 state_dir="$merge_dir" 370else 371type=am 372 state_dir="$apply_dir" 373fi 374 375iftest -z"$rebase_root" 376then 377case"$#"in 3780) 379if! upstream_name=$(git rev-parse --symbolic-full-name \ 380--verify -q @{upstream}2>/dev/null) 381then 382 . git-parse-remote 383 error_on_missing_default_upstream "rebase""rebase" \ 384"against""git rebase <branch>" 385fi 386;; 387*) upstream_name="$1" 388shift 389;; 390esac 391 upstream=`git rev-parse --verify "${upstream_name}^0"`|| 392 die "invalid upstream$upstream_name" 393 upstream_arg="$upstream_name" 394else 395test -z"$onto"&& die "You must specify --onto when using --root" 396unset upstream_name 397unset upstream 398 upstream_arg=--root 399fi 400 401# Make sure the branch to rebase onto is valid. 402onto_name=${onto-"$upstream_name"} 403case"$onto_name"in 404*...*) 405if left=${onto_name%...*} right=${onto_name#*...}&& 406 onto=$(git merge-base --all ${left:-HEAD} ${right:-HEAD}) 407then 408case"$onto"in 409 ?*"$LF"?*) 410 die "$onto_name: there are more than one merge bases" 411;; 412'') 413 die "$onto_name: there is no merge base" 414;; 415esac 416else 417 die "$onto_name: there is no merge base" 418fi 419;; 420*) 421 onto=$(git rev-parse --verify "${onto_name}^0")|| 422 die "Does not point to a valid commit:$onto_name" 423;; 424esac 425 426# If the branch to rebase is given, that is the branch we will rebase 427# $branch_name -- branch being rebased, or HEAD (already detached) 428# $orig_head -- commit object name of tip of the branch before rebasing 429# $head_name -- refs/heads/<that-branch> or "detached HEAD" 430switch_to= 431case"$#"in 4321) 433# Is it "rebase other $branchname" or "rebase other $commit"? 434 branch_name="$1" 435 switch_to="$1" 436 437if git show-ref --verify --quiet --"refs/heads/$1"&& 438 orig_head=$(git rev-parse -q --verify "refs/heads/$1") 439then 440 head_name="refs/heads/$1" 441elif orig_head=$(git rev-parse -q --verify "$1") 442then 443 head_name="detached HEAD" 444else 445 die "fatal: no such branch:$1" 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