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