4 * Based on git-am.sh by Junio C Hamano.
9 #include "parse-options.h"
11 #include "run-command.h"
15 #include "cache-tree.h"
20 #include "unpack-trees.h"
22 #include "sequencer.h"
24 #include "merge-recursive.h"
27 #include "notes-utils.h"
33 * Returns 1 if the file is empty or does not exist, 0 otherwise.
35 static int is_empty_file(const char *filename)
39 if (stat(filename, &st) < 0) {
42 die_errno(_("could not stat %s"), filename);
49 * Returns the length of the first line of msg.
51 static int linelen(const char *msg)
53 return strchrnul(msg, '\n') - msg;
57 * Returns true if `str` consists of only whitespace, false otherwise.
59 static int str_isspace(const char *str)
69 PATCH_FORMAT_UNKNOWN = 0,
72 PATCH_FORMAT_STGIT_SERIES,
79 KEEP_TRUE, /* pass -k flag to git-mailinfo */
80 KEEP_NON_PATCH /* pass -b flag to git-mailinfo */
85 SCISSORS_FALSE = 0, /* pass --no-scissors to git-mailinfo */
86 SCISSORS_TRUE /* pass --scissors to git-mailinfo */
92 SIGNOFF_EXPLICIT /* --signoff was set on the command-line */
96 /* state directory path */
99 /* current and last patch numbers, 1-indexed */
103 /* commit metadata and message */
110 /* when --rebasing, records the original commit the patch came from */
111 unsigned char orig_commit[GIT_SHA1_RAWSZ];
113 /* number of digits in patch filename */
116 /* various operating modes and command line options */
120 int signoff; /* enum signoff_type */
122 int keep; /* enum keep_type */
124 int scissors; /* enum scissors_type */
125 struct argv_array git_apply_opts;
126 const char *resolvemsg;
127 int committer_date_is_author_date;
129 int allow_rerere_autoupdate;
130 const char *sign_commit;
135 * Initializes am_state with the default values. The state directory is set to
138 static void am_state_init(struct am_state *state, const char *dir)
142 memset(state, 0, sizeof(*state));
145 state->dir = xstrdup(dir);
149 git_config_get_bool("am.threeway", &state->threeway);
153 git_config_get_bool("am.messageid", &state->message_id);
155 state->scissors = SCISSORS_UNSET;
157 argv_array_init(&state->git_apply_opts);
159 if (!git_config_get_bool("commit.gpgsign", &gpgsign))
160 state->sign_commit = gpgsign ? "" : NULL;
164 * Releases memory allocated by an am_state.
166 static void am_state_release(struct am_state *state)
169 free(state->author_name);
170 free(state->author_email);
171 free(state->author_date);
173 argv_array_clear(&state->git_apply_opts);
177 * Returns path relative to the am_state directory.
179 static inline const char *am_path(const struct am_state *state, const char *path)
181 return mkpath("%s/%s", state->dir, path);
185 * For convenience to call write_file()
187 static void write_state_text(const struct am_state *state,
188 const char *name, const char *string)
190 write_file(am_path(state, name), "%s", string);
193 static void write_state_count(const struct am_state *state,
194 const char *name, int value)
196 write_file(am_path(state, name), "%d", value);
199 static void write_state_bool(const struct am_state *state,
200 const char *name, int value)
202 write_state_text(state, name, value ? "t" : "f");
206 * If state->quiet is false, calls fprintf(fp, fmt, ...), and appends a newline
209 static void say(const struct am_state *state, FILE *fp, const char *fmt, ...)
215 vfprintf(fp, fmt, ap);
222 * Returns 1 if there is an am session in progress, 0 otherwise.
224 static int am_in_progress(const struct am_state *state)
228 if (lstat(state->dir, &st) < 0 || !S_ISDIR(st.st_mode))
230 if (lstat(am_path(state, "last"), &st) || !S_ISREG(st.st_mode))
232 if (lstat(am_path(state, "next"), &st) || !S_ISREG(st.st_mode))
238 * Reads the contents of `file` in the `state` directory into `sb`. Returns the
239 * number of bytes read on success, -1 if the file does not exist. If `trim` is
240 * set, trailing whitespace will be removed.
242 static int read_state_file(struct strbuf *sb, const struct am_state *state,
243 const char *file, int trim)
247 if (strbuf_read_file(sb, am_path(state, file), 0) >= 0) {
257 die_errno(_("could not read '%s'"), am_path(state, file));
261 * Reads a KEY=VALUE shell variable assignment from `fp`, returning the VALUE
262 * as a newly-allocated string. VALUE must be a quoted string, and the KEY must
263 * match `key`. Returns NULL on failure.
265 * This is used by read_author_script() to read the GIT_AUTHOR_* variables from
268 static char *read_shell_var(FILE *fp, const char *key)
270 struct strbuf sb = STRBUF_INIT;
273 if (strbuf_getline_lf(&sb, fp))
276 if (!skip_prefix(sb.buf, key, &str))
279 if (!skip_prefix(str, "=", &str))
282 strbuf_remove(&sb, 0, str - sb.buf);
284 str = sq_dequote(sb.buf);
288 return strbuf_detach(&sb, NULL);
296 * Reads and parses the state directory's "author-script" file, and sets
297 * state->author_name, state->author_email and state->author_date accordingly.
298 * Returns 0 on success, -1 if the file could not be parsed.
300 * The author script is of the format:
302 * GIT_AUTHOR_NAME='$author_name'
303 * GIT_AUTHOR_EMAIL='$author_email'
304 * GIT_AUTHOR_DATE='$author_date'
306 * where $author_name, $author_email and $author_date are quoted. We are strict
307 * with our parsing, as the file was meant to be eval'd in the old git-am.sh
308 * script, and thus if the file differs from what this function expects, it is
309 * better to bail out than to do something that the user does not expect.
311 static int read_author_script(struct am_state *state)
313 const char *filename = am_path(state, "author-script");
316 assert(!state->author_name);
317 assert(!state->author_email);
318 assert(!state->author_date);
320 fp = fopen(filename, "r");
324 die_errno(_("could not open '%s' for reading"), filename);
327 state->author_name = read_shell_var(fp, "GIT_AUTHOR_NAME");
328 if (!state->author_name) {
333 state->author_email = read_shell_var(fp, "GIT_AUTHOR_EMAIL");
334 if (!state->author_email) {
339 state->author_date = read_shell_var(fp, "GIT_AUTHOR_DATE");
340 if (!state->author_date) {
345 if (fgetc(fp) != EOF) {
355 * Saves state->author_name, state->author_email and state->author_date in the
356 * state directory's "author-script" file.
358 static void write_author_script(const struct am_state *state)
360 struct strbuf sb = STRBUF_INIT;
362 strbuf_addstr(&sb, "GIT_AUTHOR_NAME=");
363 sq_quote_buf(&sb, state->author_name);
364 strbuf_addch(&sb, '\n');
366 strbuf_addstr(&sb, "GIT_AUTHOR_EMAIL=");
367 sq_quote_buf(&sb, state->author_email);
368 strbuf_addch(&sb, '\n');
370 strbuf_addstr(&sb, "GIT_AUTHOR_DATE=");
371 sq_quote_buf(&sb, state->author_date);
372 strbuf_addch(&sb, '\n');
374 write_state_text(state, "author-script", sb.buf);
380 * Reads the commit message from the state directory's "final-commit" file,
381 * setting state->msg to its contents and state->msg_len to the length of its
384 * Returns 0 on success, -1 if the file does not exist.
386 static int read_commit_msg(struct am_state *state)
388 struct strbuf sb = STRBUF_INIT;
392 if (read_state_file(&sb, state, "final-commit", 0) < 0) {
397 state->msg = strbuf_detach(&sb, &state->msg_len);
402 * Saves state->msg in the state directory's "final-commit" file.
404 static void write_commit_msg(const struct am_state *state)
406 const char *filename = am_path(state, "final-commit");
407 write_file_buf(filename, state->msg, state->msg_len);
411 * Loads state from disk.
413 static void am_load(struct am_state *state)
415 struct strbuf sb = STRBUF_INIT;
417 if (read_state_file(&sb, state, "next", 1) < 0)
418 die("BUG: state file 'next' does not exist");
419 state->cur = strtol(sb.buf, NULL, 10);
421 if (read_state_file(&sb, state, "last", 1) < 0)
422 die("BUG: state file 'last' does not exist");
423 state->last = strtol(sb.buf, NULL, 10);
425 if (read_author_script(state) < 0)
426 die(_("could not parse author script"));
428 read_commit_msg(state);
430 if (read_state_file(&sb, state, "original-commit", 1) < 0)
431 hashclr(state->orig_commit);
432 else if (get_sha1_hex(sb.buf, state->orig_commit) < 0)
433 die(_("could not parse %s"), am_path(state, "original-commit"));
435 read_state_file(&sb, state, "threeway", 1);
436 state->threeway = !strcmp(sb.buf, "t");
438 read_state_file(&sb, state, "quiet", 1);
439 state->quiet = !strcmp(sb.buf, "t");
441 read_state_file(&sb, state, "sign", 1);
442 state->signoff = !strcmp(sb.buf, "t");
444 read_state_file(&sb, state, "utf8", 1);
445 state->utf8 = !strcmp(sb.buf, "t");
447 read_state_file(&sb, state, "keep", 1);
448 if (!strcmp(sb.buf, "t"))
449 state->keep = KEEP_TRUE;
450 else if (!strcmp(sb.buf, "b"))
451 state->keep = KEEP_NON_PATCH;
453 state->keep = KEEP_FALSE;
455 read_state_file(&sb, state, "messageid", 1);
456 state->message_id = !strcmp(sb.buf, "t");
458 read_state_file(&sb, state, "scissors", 1);
459 if (!strcmp(sb.buf, "t"))
460 state->scissors = SCISSORS_TRUE;
461 else if (!strcmp(sb.buf, "f"))
462 state->scissors = SCISSORS_FALSE;
464 state->scissors = SCISSORS_UNSET;
466 read_state_file(&sb, state, "apply-opt", 1);
467 argv_array_clear(&state->git_apply_opts);
468 if (sq_dequote_to_argv_array(sb.buf, &state->git_apply_opts) < 0)
469 die(_("could not parse %s"), am_path(state, "apply-opt"));
471 state->rebasing = !!file_exists(am_path(state, "rebasing"));
477 * Removes the am_state directory, forcefully terminating the current am
480 static void am_destroy(const struct am_state *state)
482 struct strbuf sb = STRBUF_INIT;
484 strbuf_addstr(&sb, state->dir);
485 remove_dir_recursively(&sb, 0);
490 * Runs applypatch-msg hook. Returns its exit code.
492 static int run_applypatch_msg_hook(struct am_state *state)
497 ret = run_hook_le(NULL, "applypatch-msg", am_path(state, "final-commit"), NULL);
502 if (read_commit_msg(state) < 0)
503 die(_("'%s' was deleted by the applypatch-msg hook"),
504 am_path(state, "final-commit"));
511 * Runs post-rewrite hook. Returns it exit code.
513 static int run_post_rewrite_hook(const struct am_state *state)
515 struct child_process cp = CHILD_PROCESS_INIT;
516 const char *hook = find_hook("post-rewrite");
522 argv_array_push(&cp.args, hook);
523 argv_array_push(&cp.args, "rebase");
525 cp.in = xopen(am_path(state, "rewritten"), O_RDONLY);
526 cp.stdout_to_stderr = 1;
528 ret = run_command(&cp);
535 * Reads the state directory's "rewritten" file, and copies notes from the old
536 * commits listed in the file to their rewritten commits.
538 * Returns 0 on success, -1 on failure.
540 static int copy_notes_for_rebase(const struct am_state *state)
542 struct notes_rewrite_cfg *c;
543 struct strbuf sb = STRBUF_INIT;
544 const char *invalid_line = _("Malformed input line: '%s'.");
545 const char *msg = "Notes added by 'git rebase'";
549 assert(state->rebasing);
551 c = init_copy_notes_for_rewrite("rebase");
555 fp = xfopen(am_path(state, "rewritten"), "r");
557 while (!strbuf_getline_lf(&sb, fp)) {
558 unsigned char from_obj[GIT_SHA1_RAWSZ], to_obj[GIT_SHA1_RAWSZ];
560 if (sb.len != GIT_SHA1_HEXSZ * 2 + 1) {
561 ret = error(invalid_line, sb.buf);
565 if (get_sha1_hex(sb.buf, from_obj)) {
566 ret = error(invalid_line, sb.buf);
570 if (sb.buf[GIT_SHA1_HEXSZ] != ' ') {
571 ret = error(invalid_line, sb.buf);
575 if (get_sha1_hex(sb.buf + GIT_SHA1_HEXSZ + 1, to_obj)) {
576 ret = error(invalid_line, sb.buf);
580 if (copy_note_for_rewrite(c, from_obj, to_obj))
581 ret = error(_("Failed to copy notes from '%s' to '%s'"),
582 sha1_to_hex(from_obj), sha1_to_hex(to_obj));
586 finish_copy_notes_for_rewrite(c, msg);
593 * Determines if the file looks like a piece of RFC2822 mail by grabbing all
594 * non-indented lines and checking if they look like they begin with valid
595 * header field names.
597 * Returns 1 if the file looks like a piece of mail, 0 otherwise.
599 static int is_mail(FILE *fp)
601 const char *header_regex = "^[!-9;-~]+:";
602 struct strbuf sb = STRBUF_INIT;
606 if (fseek(fp, 0L, SEEK_SET))
607 die_errno(_("fseek failed"));
609 if (regcomp(®ex, header_regex, REG_NOSUB | REG_EXTENDED))
610 die("invalid pattern: %s", header_regex);
612 while (!strbuf_getline(&sb, fp)) {
614 break; /* End of header */
616 /* Ignore indented folded lines */
617 if (*sb.buf == '\t' || *sb.buf == ' ')
620 /* It's a header if it matches header_regex */
621 if (regexec(®ex, sb.buf, 0, NULL, 0)) {
634 * Attempts to detect the patch_format of the patches contained in `paths`,
635 * returning the PATCH_FORMAT_* enum value. Returns PATCH_FORMAT_UNKNOWN if
638 static int detect_patch_format(const char **paths)
640 enum patch_format ret = PATCH_FORMAT_UNKNOWN;
641 struct strbuf l1 = STRBUF_INIT;
642 struct strbuf l2 = STRBUF_INIT;
643 struct strbuf l3 = STRBUF_INIT;
647 * We default to mbox format if input is from stdin and for directories
649 if (!*paths || !strcmp(*paths, "-") || is_directory(*paths))
650 return PATCH_FORMAT_MBOX;
653 * Otherwise, check the first few lines of the first patch, starting
654 * from the first non-blank line, to try to detect its format.
657 fp = xfopen(*paths, "r");
659 while (!strbuf_getline(&l1, fp)) {
664 if (starts_with(l1.buf, "From ") || starts_with(l1.buf, "From: ")) {
665 ret = PATCH_FORMAT_MBOX;
669 if (starts_with(l1.buf, "# This series applies on GIT commit")) {
670 ret = PATCH_FORMAT_STGIT_SERIES;
674 if (!strcmp(l1.buf, "# HG changeset patch")) {
675 ret = PATCH_FORMAT_HG;
680 strbuf_getline(&l2, fp);
682 strbuf_getline(&l3, fp);
685 * If the second line is empty and the third is a From, Author or Date
686 * entry, this is likely an StGit patch.
688 if (l1.len && !l2.len &&
689 (starts_with(l3.buf, "From:") ||
690 starts_with(l3.buf, "Author:") ||
691 starts_with(l3.buf, "Date:"))) {
692 ret = PATCH_FORMAT_STGIT;
696 if (l1.len && is_mail(fp)) {
697 ret = PATCH_FORMAT_MBOX;
708 * Splits out individual email patches from `paths`, where each path is either
709 * a mbox file or a Maildir. Returns 0 on success, -1 on failure.
711 static int split_mail_mbox(struct am_state *state, const char **paths,
712 int keep_cr, int mboxrd)
714 struct child_process cp = CHILD_PROCESS_INIT;
715 struct strbuf last = STRBUF_INIT;
718 argv_array_push(&cp.args, "mailsplit");
719 argv_array_pushf(&cp.args, "-d%d", state->prec);
720 argv_array_pushf(&cp.args, "-o%s", state->dir);
721 argv_array_push(&cp.args, "-b");
723 argv_array_push(&cp.args, "--keep-cr");
725 argv_array_push(&cp.args, "--mboxrd");
726 argv_array_push(&cp.args, "--");
727 argv_array_pushv(&cp.args, paths);
729 if (capture_command(&cp, &last, 8))
733 state->last = strtol(last.buf, NULL, 10);
739 * Callback signature for split_mail_conv(). The foreign patch should be
740 * read from `in`, and the converted patch (in RFC2822 mail format) should be
741 * written to `out`. Return 0 on success, or -1 on failure.
743 typedef int (*mail_conv_fn)(FILE *out, FILE *in, int keep_cr);
746 * Calls `fn` for each file in `paths` to convert the foreign patch to the
747 * RFC2822 mail format suitable for parsing with git-mailinfo.
749 * Returns 0 on success, -1 on failure.
751 static int split_mail_conv(mail_conv_fn fn, struct am_state *state,
752 const char **paths, int keep_cr)
754 static const char *stdin_only[] = {"-", NULL};
760 for (i = 0; *paths; paths++, i++) {
765 if (!strcmp(*paths, "-"))
768 in = fopen(*paths, "r");
771 return error_errno(_("could not open '%s' for reading"),
774 mail = mkpath("%s/%0*d", state->dir, state->prec, i + 1);
776 out = fopen(mail, "w");
778 return error_errno(_("could not open '%s' for writing"),
781 ret = fn(out, in, keep_cr);
787 return error(_("could not parse patch '%s'"), *paths);
796 * A split_mail_conv() callback that converts an StGit patch to an RFC2822
797 * message suitable for parsing with git-mailinfo.
799 static int stgit_patch_to_mail(FILE *out, FILE *in, int keep_cr)
801 struct strbuf sb = STRBUF_INIT;
802 int subject_printed = 0;
804 while (!strbuf_getline_lf(&sb, in)) {
807 if (str_isspace(sb.buf))
809 else if (skip_prefix(sb.buf, "Author:", &str))
810 fprintf(out, "From:%s\n", str);
811 else if (starts_with(sb.buf, "From") || starts_with(sb.buf, "Date"))
812 fprintf(out, "%s\n", sb.buf);
813 else if (!subject_printed) {
814 fprintf(out, "Subject: %s\n", sb.buf);
817 fprintf(out, "\n%s\n", sb.buf);
823 while (strbuf_fread(&sb, 8192, in) > 0) {
824 fwrite(sb.buf, 1, sb.len, out);
833 * This function only supports a single StGit series file in `paths`.
835 * Given an StGit series file, converts the StGit patches in the series into
836 * RFC2822 messages suitable for parsing with git-mailinfo, and queues them in
837 * the state directory.
839 * Returns 0 on success, -1 on failure.
841 static int split_mail_stgit_series(struct am_state *state, const char **paths,
844 const char *series_dir;
845 char *series_dir_buf;
847 struct argv_array patches = ARGV_ARRAY_INIT;
848 struct strbuf sb = STRBUF_INIT;
851 if (!paths[0] || paths[1])
852 return error(_("Only one StGIT patch series can be applied at once"));
854 series_dir_buf = xstrdup(*paths);
855 series_dir = dirname(series_dir_buf);
857 fp = fopen(*paths, "r");
859 return error_errno(_("could not open '%s' for reading"), *paths);
861 while (!strbuf_getline_lf(&sb, fp)) {
863 continue; /* skip comment lines */
865 argv_array_push(&patches, mkpath("%s/%s", series_dir, sb.buf));
870 free(series_dir_buf);
872 ret = split_mail_conv(stgit_patch_to_mail, state, patches.argv, keep_cr);
874 argv_array_clear(&patches);
879 * A split_patches_conv() callback that converts a mercurial patch to a RFC2822
880 * message suitable for parsing with git-mailinfo.
882 static int hg_patch_to_mail(FILE *out, FILE *in, int keep_cr)
884 struct strbuf sb = STRBUF_INIT;
886 while (!strbuf_getline_lf(&sb, in)) {
889 if (skip_prefix(sb.buf, "# User ", &str))
890 fprintf(out, "From: %s\n", str);
891 else if (skip_prefix(sb.buf, "# Date ", &str)) {
892 unsigned long timestamp;
897 timestamp = strtoul(str, &end, 10);
899 return error(_("invalid timestamp"));
901 if (!skip_prefix(end, " ", &str))
902 return error(_("invalid Date line"));
905 tz = strtol(str, &end, 10);
907 return error(_("invalid timezone offset"));
910 return error(_("invalid Date line"));
913 * mercurial's timezone is in seconds west of UTC,
914 * however git's timezone is in hours + minutes east of
917 tz2 = labs(tz) / 3600 * 100 + labs(tz) % 3600 / 60;
921 fprintf(out, "Date: %s\n", show_date(timestamp, tz2, DATE_MODE(RFC2822)));
922 } else if (starts_with(sb.buf, "# ")) {
925 fprintf(out, "\n%s\n", sb.buf);
931 while (strbuf_fread(&sb, 8192, in) > 0) {
932 fwrite(sb.buf, 1, sb.len, out);
941 * Splits a list of files/directories into individual email patches. Each path
942 * in `paths` must be a file/directory that is formatted according to
945 * Once split out, the individual email patches will be stored in the state
946 * directory, with each patch's filename being its index, padded to state->prec
949 * state->cur will be set to the index of the first mail, and state->last will
950 * be set to the index of the last mail.
952 * Set keep_cr to 0 to convert all lines ending with \r\n to end with \n, 1
953 * to disable this behavior, -1 to use the default configured setting.
955 * Returns 0 on success, -1 on failure.
957 static int split_mail(struct am_state *state, enum patch_format patch_format,
958 const char **paths, int keep_cr)
962 git_config_get_bool("am.keepcr", &keep_cr);
965 switch (patch_format) {
966 case PATCH_FORMAT_MBOX:
967 return split_mail_mbox(state, paths, keep_cr, 0);
968 case PATCH_FORMAT_STGIT:
969 return split_mail_conv(stgit_patch_to_mail, state, paths, keep_cr);
970 case PATCH_FORMAT_STGIT_SERIES:
971 return split_mail_stgit_series(state, paths, keep_cr);
972 case PATCH_FORMAT_HG:
973 return split_mail_conv(hg_patch_to_mail, state, paths, keep_cr);
974 case PATCH_FORMAT_MBOXRD:
975 return split_mail_mbox(state, paths, keep_cr, 1);
977 die("BUG: invalid patch_format");
983 * Setup a new am session for applying patches
985 static void am_setup(struct am_state *state, enum patch_format patch_format,
986 const char **paths, int keep_cr)
988 unsigned char curr_head[GIT_SHA1_RAWSZ];
990 struct strbuf sb = STRBUF_INIT;
993 patch_format = detect_patch_format(paths);
996 fprintf_ln(stderr, _("Patch format detection failed."));
1000 if (mkdir(state->dir, 0777) < 0 && errno != EEXIST)
1001 die_errno(_("failed to create directory '%s'"), state->dir);
1003 if (split_mail(state, patch_format, paths, keep_cr) < 0) {
1005 die(_("Failed to split patches."));
1008 if (state->rebasing)
1009 state->threeway = 1;
1011 write_state_bool(state, "threeway", state->threeway);
1012 write_state_bool(state, "quiet", state->quiet);
1013 write_state_bool(state, "sign", state->signoff);
1014 write_state_bool(state, "utf8", state->utf8);
1016 switch (state->keep) {
1023 case KEEP_NON_PATCH:
1027 die("BUG: invalid value for state->keep");
1030 write_state_text(state, "keep", str);
1031 write_state_bool(state, "messageid", state->message_id);
1033 switch (state->scissors) {
1034 case SCISSORS_UNSET:
1037 case SCISSORS_FALSE:
1044 die("BUG: invalid value for state->scissors");
1046 write_state_text(state, "scissors", str);
1048 sq_quote_argv(&sb, state->git_apply_opts.argv, 0);
1049 write_state_text(state, "apply-opt", sb.buf);
1051 if (state->rebasing)
1052 write_state_text(state, "rebasing", "");
1054 write_state_text(state, "applying", "");
1056 if (!get_sha1("HEAD", curr_head)) {
1057 write_state_text(state, "abort-safety", sha1_to_hex(curr_head));
1058 if (!state->rebasing)
1059 update_ref("am", "ORIG_HEAD", curr_head, NULL, 0,
1060 UPDATE_REFS_DIE_ON_ERR);
1062 write_state_text(state, "abort-safety", "");
1063 if (!state->rebasing)
1064 delete_ref("ORIG_HEAD", NULL, 0);
1068 * NOTE: Since the "next" and "last" files determine if an am_state
1069 * session is in progress, they should be written last.
1072 write_state_count(state, "next", state->cur);
1073 write_state_count(state, "last", state->last);
1075 strbuf_release(&sb);
1079 * Increments the patch pointer, and cleans am_state for the application of the
1082 static void am_next(struct am_state *state)
1084 unsigned char head[GIT_SHA1_RAWSZ];
1086 free(state->author_name);
1087 state->author_name = NULL;
1089 free(state->author_email);
1090 state->author_email = NULL;
1092 free(state->author_date);
1093 state->author_date = NULL;
1099 unlink(am_path(state, "author-script"));
1100 unlink(am_path(state, "final-commit"));
1102 hashclr(state->orig_commit);
1103 unlink(am_path(state, "original-commit"));
1105 if (!get_sha1("HEAD", head))
1106 write_state_text(state, "abort-safety", sha1_to_hex(head));
1108 write_state_text(state, "abort-safety", "");
1111 write_state_count(state, "next", state->cur);
1115 * Returns the filename of the current patch email.
1117 static const char *msgnum(const struct am_state *state)
1119 static struct strbuf sb = STRBUF_INIT;
1122 strbuf_addf(&sb, "%0*d", state->prec, state->cur);
1128 * Refresh and write index.
1130 static void refresh_and_write_cache(void)
1132 struct lock_file *lock_file = xcalloc(1, sizeof(struct lock_file));
1134 hold_locked_index(lock_file, 1);
1135 refresh_cache(REFRESH_QUIET);
1136 if (write_locked_index(&the_index, lock_file, COMMIT_LOCK))
1137 die(_("unable to write index file"));
1141 * Returns 1 if the index differs from HEAD, 0 otherwise. When on an unborn
1142 * branch, returns 1 if there are entries in the index, 0 otherwise. If an
1143 * strbuf is provided, the space-separated list of files that differ will be
1146 static int index_has_changes(struct strbuf *sb)
1148 unsigned char head[GIT_SHA1_RAWSZ];
1151 if (!get_sha1_tree("HEAD", head)) {
1152 struct diff_options opt;
1155 DIFF_OPT_SET(&opt, EXIT_WITH_STATUS);
1157 DIFF_OPT_SET(&opt, QUICK);
1158 do_diff_cache(head, &opt);
1160 for (i = 0; sb && i < diff_queued_diff.nr; i++) {
1162 strbuf_addch(sb, ' ');
1163 strbuf_addstr(sb, diff_queued_diff.queue[i]->two->path);
1166 return DIFF_OPT_TST(&opt, HAS_CHANGES) != 0;
1168 for (i = 0; sb && i < active_nr; i++) {
1170 strbuf_addch(sb, ' ');
1171 strbuf_addstr(sb, active_cache[i]->name);
1178 * Dies with a user-friendly message on how to proceed after resolving the
1179 * problem. This message can be overridden with state->resolvemsg.
1181 static void NORETURN die_user_resolve(const struct am_state *state)
1183 if (state->resolvemsg) {
1184 printf_ln("%s", state->resolvemsg);
1186 const char *cmdline = state->interactive ? "git am -i" : "git am";
1188 printf_ln(_("When you have resolved this problem, run \"%s --continue\"."), cmdline);
1189 printf_ln(_("If you prefer to skip this patch, run \"%s --skip\" instead."), cmdline);
1190 printf_ln(_("To restore the original branch and stop patching, run \"%s --abort\"."), cmdline);
1196 static void am_signoff(struct strbuf *sb)
1199 struct strbuf mine = STRBUF_INIT;
1201 /* Does it end with our own sign-off? */
1202 strbuf_addf(&mine, "\n%s%s\n",
1204 fmt_name(getenv("GIT_COMMITTER_NAME"),
1205 getenv("GIT_COMMITTER_EMAIL")));
1206 if (mine.len < sb->len &&
1207 !strcmp(mine.buf, sb->buf + sb->len - mine.len))
1208 goto exit; /* no need to duplicate */
1210 /* Does it have any Signed-off-by: in the text */
1212 cp && *cp && (cp = strstr(cp, sign_off_header)) != NULL;
1213 cp = strchr(cp, '\n')) {
1214 if (sb->buf == cp || cp[-1] == '\n')
1218 strbuf_addstr(sb, mine.buf + !!cp);
1220 strbuf_release(&mine);
1224 * Appends signoff to the "msg" field of the am_state.
1226 static void am_append_signoff(struct am_state *state)
1228 struct strbuf sb = STRBUF_INIT;
1230 strbuf_attach(&sb, state->msg, state->msg_len, state->msg_len);
1232 state->msg = strbuf_detach(&sb, &state->msg_len);
1236 * Parses `mail` using git-mailinfo, extracting its patch and authorship info.
1237 * state->msg will be set to the patch message. state->author_name,
1238 * state->author_email and state->author_date will be set to the patch author's
1239 * name, email and date respectively. The patch body will be written to the
1240 * state directory's "patch" file.
1242 * Returns 1 if the patch should be skipped, 0 otherwise.
1244 static int parse_mail(struct am_state *state, const char *mail)
1247 struct strbuf sb = STRBUF_INIT;
1248 struct strbuf msg = STRBUF_INIT;
1249 struct strbuf author_name = STRBUF_INIT;
1250 struct strbuf author_date = STRBUF_INIT;
1251 struct strbuf author_email = STRBUF_INIT;
1255 setup_mailinfo(&mi);
1258 mi.metainfo_charset = get_commit_output_encoding();
1260 mi.metainfo_charset = NULL;
1262 switch (state->keep) {
1266 mi.keep_subject = 1;
1268 case KEEP_NON_PATCH:
1269 mi.keep_non_patch_brackets_in_subject = 1;
1272 die("BUG: invalid value for state->keep");
1275 if (state->message_id)
1276 mi.add_message_id = 1;
1278 switch (state->scissors) {
1279 case SCISSORS_UNSET:
1281 case SCISSORS_FALSE:
1282 mi.use_scissors = 0;
1285 mi.use_scissors = 1;
1288 die("BUG: invalid value for state->scissors");
1291 mi.input = fopen(mail, "r");
1293 die("could not open input");
1294 mi.output = fopen(am_path(state, "info"), "w");
1296 die("could not open output 'info'");
1297 if (mailinfo(&mi, am_path(state, "msg"), am_path(state, "patch")))
1298 die("could not parse patch");
1303 /* Extract message and author information */
1304 fp = xfopen(am_path(state, "info"), "r");
1305 while (!strbuf_getline_lf(&sb, fp)) {
1308 if (skip_prefix(sb.buf, "Subject: ", &x)) {
1310 strbuf_addch(&msg, '\n');
1311 strbuf_addstr(&msg, x);
1312 } else if (skip_prefix(sb.buf, "Author: ", &x))
1313 strbuf_addstr(&author_name, x);
1314 else if (skip_prefix(sb.buf, "Email: ", &x))
1315 strbuf_addstr(&author_email, x);
1316 else if (skip_prefix(sb.buf, "Date: ", &x))
1317 strbuf_addstr(&author_date, x);
1321 /* Skip pine's internal folder data */
1322 if (!strcmp(author_name.buf, "Mail System Internal Data")) {
1327 if (is_empty_file(am_path(state, "patch"))) {
1328 printf_ln(_("Patch is empty. Was it split wrong?"));
1329 die_user_resolve(state);
1332 strbuf_addstr(&msg, "\n\n");
1333 strbuf_addbuf(&msg, &mi.log_message);
1334 strbuf_stripspace(&msg, 0);
1339 assert(!state->author_name);
1340 state->author_name = strbuf_detach(&author_name, NULL);
1342 assert(!state->author_email);
1343 state->author_email = strbuf_detach(&author_email, NULL);
1345 assert(!state->author_date);
1346 state->author_date = strbuf_detach(&author_date, NULL);
1348 assert(!state->msg);
1349 state->msg = strbuf_detach(&msg, &state->msg_len);
1352 strbuf_release(&msg);
1353 strbuf_release(&author_date);
1354 strbuf_release(&author_email);
1355 strbuf_release(&author_name);
1356 strbuf_release(&sb);
1357 clear_mailinfo(&mi);
1362 * Sets commit_id to the commit hash where the mail was generated from.
1363 * Returns 0 on success, -1 on failure.
1365 static int get_mail_commit_sha1(unsigned char *commit_id, const char *mail)
1367 struct strbuf sb = STRBUF_INIT;
1368 FILE *fp = xfopen(mail, "r");
1371 if (strbuf_getline_lf(&sb, fp))
1374 if (!skip_prefix(sb.buf, "From ", &x))
1377 if (get_sha1_hex(x, commit_id) < 0)
1380 strbuf_release(&sb);
1386 * Sets state->msg, state->author_name, state->author_email, state->author_date
1387 * to the commit's respective info.
1389 static void get_commit_info(struct am_state *state, struct commit *commit)
1391 const char *buffer, *ident_line, *author_date, *msg;
1393 struct ident_split ident_split;
1394 struct strbuf sb = STRBUF_INIT;
1396 buffer = logmsg_reencode(commit, NULL, get_commit_output_encoding());
1398 ident_line = find_commit_header(buffer, "author", &ident_len);
1400 if (split_ident_line(&ident_split, ident_line, ident_len) < 0) {
1401 strbuf_add(&sb, ident_line, ident_len);
1402 die(_("invalid ident line: %s"), sb.buf);
1405 assert(!state->author_name);
1406 if (ident_split.name_begin) {
1407 strbuf_add(&sb, ident_split.name_begin,
1408 ident_split.name_end - ident_split.name_begin);
1409 state->author_name = strbuf_detach(&sb, NULL);
1411 state->author_name = xstrdup("");
1413 assert(!state->author_email);
1414 if (ident_split.mail_begin) {
1415 strbuf_add(&sb, ident_split.mail_begin,
1416 ident_split.mail_end - ident_split.mail_begin);
1417 state->author_email = strbuf_detach(&sb, NULL);
1419 state->author_email = xstrdup("");
1421 author_date = show_ident_date(&ident_split, DATE_MODE(NORMAL));
1422 strbuf_addstr(&sb, author_date);
1423 assert(!state->author_date);
1424 state->author_date = strbuf_detach(&sb, NULL);
1426 assert(!state->msg);
1427 msg = strstr(buffer, "\n\n");
1429 die(_("unable to parse commit %s"), oid_to_hex(&commit->object.oid));
1430 state->msg = xstrdup(msg + 2);
1431 state->msg_len = strlen(state->msg);
1435 * Writes `commit` as a patch to the state directory's "patch" file.
1437 static void write_commit_patch(const struct am_state *state, struct commit *commit)
1439 struct rev_info rev_info;
1442 fp = xfopen(am_path(state, "patch"), "w");
1443 init_revisions(&rev_info, NULL);
1445 rev_info.abbrev = 0;
1446 rev_info.disable_stdin = 1;
1447 rev_info.show_root_diff = 1;
1448 rev_info.diffopt.output_format = DIFF_FORMAT_PATCH;
1449 rev_info.no_commit_id = 1;
1450 DIFF_OPT_SET(&rev_info.diffopt, BINARY);
1451 DIFF_OPT_SET(&rev_info.diffopt, FULL_INDEX);
1452 rev_info.diffopt.use_color = 0;
1453 rev_info.diffopt.file = fp;
1454 rev_info.diffopt.close_file = 1;
1455 add_pending_object(&rev_info, &commit->object, "");
1456 diff_setup_done(&rev_info.diffopt);
1457 log_tree_commit(&rev_info, commit);
1461 * Writes the diff of the index against HEAD as a patch to the state
1462 * directory's "patch" file.
1464 static void write_index_patch(const struct am_state *state)
1467 unsigned char head[GIT_SHA1_RAWSZ];
1468 struct rev_info rev_info;
1471 if (!get_sha1_tree("HEAD", head))
1472 tree = lookup_tree(head);
1474 tree = lookup_tree(EMPTY_TREE_SHA1_BIN);
1476 fp = xfopen(am_path(state, "patch"), "w");
1477 init_revisions(&rev_info, NULL);
1479 rev_info.disable_stdin = 1;
1480 rev_info.no_commit_id = 1;
1481 rev_info.diffopt.output_format = DIFF_FORMAT_PATCH;
1482 rev_info.diffopt.use_color = 0;
1483 rev_info.diffopt.file = fp;
1484 rev_info.diffopt.close_file = 1;
1485 add_pending_object(&rev_info, &tree->object, "");
1486 diff_setup_done(&rev_info.diffopt);
1487 run_diff_index(&rev_info, 1);
1491 * Like parse_mail(), but parses the mail by looking up its commit ID
1492 * directly. This is used in --rebasing mode to bypass git-mailinfo's munging
1495 * state->orig_commit will be set to the original commit ID.
1497 * Will always return 0 as the patch should never be skipped.
1499 static int parse_mail_rebase(struct am_state *state, const char *mail)
1501 struct commit *commit;
1502 unsigned char commit_sha1[GIT_SHA1_RAWSZ];
1504 if (get_mail_commit_sha1(commit_sha1, mail) < 0)
1505 die(_("could not parse %s"), mail);
1507 commit = lookup_commit_or_die(commit_sha1, mail);
1509 get_commit_info(state, commit);
1511 write_commit_patch(state, commit);
1513 hashcpy(state->orig_commit, commit_sha1);
1514 write_state_text(state, "original-commit", sha1_to_hex(commit_sha1));
1520 * Applies current patch with git-apply. Returns 0 on success, -1 otherwise. If
1521 * `index_file` is not NULL, the patch will be applied to that index.
1523 static int run_apply(const struct am_state *state, const char *index_file)
1525 struct child_process cp = CHILD_PROCESS_INIT;
1530 argv_array_pushf(&cp.env_array, "GIT_INDEX_FILE=%s", index_file);
1533 * If we are allowed to fall back on 3-way merge, don't give false
1534 * errors during the initial attempt.
1536 if (state->threeway && !index_file) {
1541 argv_array_push(&cp.args, "apply");
1543 argv_array_pushv(&cp.args, state->git_apply_opts.argv);
1546 argv_array_push(&cp.args, "--cached");
1548 argv_array_push(&cp.args, "--index");
1550 argv_array_push(&cp.args, am_path(state, "patch"));
1552 if (run_command(&cp))
1555 /* Reload index as git-apply will have modified it. */
1557 read_cache_from(index_file ? index_file : get_index_file());
1563 * Builds an index that contains just the blobs needed for a 3way merge.
1565 static int build_fake_ancestor(const struct am_state *state, const char *index_file)
1567 struct child_process cp = CHILD_PROCESS_INIT;
1570 argv_array_push(&cp.args, "apply");
1571 argv_array_pushv(&cp.args, state->git_apply_opts.argv);
1572 argv_array_pushf(&cp.args, "--build-fake-ancestor=%s", index_file);
1573 argv_array_push(&cp.args, am_path(state, "patch"));
1575 if (run_command(&cp))
1582 * Attempt a threeway merge, using index_path as the temporary index.
1584 static int fall_back_threeway(const struct am_state *state, const char *index_path)
1586 struct object_id orig_tree, their_tree, our_tree;
1587 const struct object_id *bases[1] = { &orig_tree };
1588 struct merge_options o;
1589 struct commit *result;
1590 char *their_tree_name;
1592 if (get_oid("HEAD", &our_tree) < 0)
1593 hashcpy(our_tree.hash, EMPTY_TREE_SHA1_BIN);
1595 if (build_fake_ancestor(state, index_path))
1596 return error("could not build fake ancestor");
1599 read_cache_from(index_path);
1601 if (write_index_as_tree(orig_tree.hash, &the_index, index_path, 0, NULL))
1602 return error(_("Repository lacks necessary blobs to fall back on 3-way merge."));
1604 say(state, stdout, _("Using index info to reconstruct a base tree..."));
1606 if (!state->quiet) {
1608 * List paths that needed 3-way fallback, so that the user can
1609 * review them with extra care to spot mismerges.
1611 struct rev_info rev_info;
1612 const char *diff_filter_str = "--diff-filter=AM";
1614 init_revisions(&rev_info, NULL);
1615 rev_info.diffopt.output_format = DIFF_FORMAT_NAME_STATUS;
1616 diff_opt_parse(&rev_info.diffopt, &diff_filter_str, 1, rev_info.prefix);
1617 add_pending_sha1(&rev_info, "HEAD", our_tree.hash, 0);
1618 diff_setup_done(&rev_info.diffopt);
1619 run_diff_index(&rev_info, 1);
1622 if (run_apply(state, index_path))
1623 return error(_("Did you hand edit your patch?\n"
1624 "It does not apply to blobs recorded in its index."));
1626 if (write_index_as_tree(their_tree.hash, &the_index, index_path, 0, NULL))
1627 return error("could not write tree");
1629 say(state, stdout, _("Falling back to patching base and 3-way merge..."));
1635 * This is not so wrong. Depending on which base we picked, orig_tree
1636 * may be wildly different from ours, but their_tree has the same set of
1637 * wildly different changes in parts the patch did not touch, so
1638 * recursive ends up canceling them, saying that we reverted all those
1642 init_merge_options(&o);
1645 their_tree_name = xstrfmt("%.*s", linelen(state->msg), state->msg);
1646 o.branch2 = their_tree_name;
1651 if (merge_recursive_generic(&o, &our_tree, &their_tree, 1, bases, &result)) {
1652 rerere(state->allow_rerere_autoupdate);
1653 free(their_tree_name);
1654 return error(_("Failed to merge in the changes."));
1657 free(their_tree_name);
1662 * Commits the current index with state->msg as the commit message and
1663 * state->author_name, state->author_email and state->author_date as the author
1666 static void do_commit(const struct am_state *state)
1668 unsigned char tree[GIT_SHA1_RAWSZ], parent[GIT_SHA1_RAWSZ],
1669 commit[GIT_SHA1_RAWSZ];
1671 struct commit_list *parents = NULL;
1672 const char *reflog_msg, *author;
1673 struct strbuf sb = STRBUF_INIT;
1675 if (run_hook_le(NULL, "pre-applypatch", NULL))
1678 if (write_cache_as_tree(tree, 0, NULL))
1679 die(_("git write-tree failed to write a tree"));
1681 if (!get_sha1_commit("HEAD", parent)) {
1683 commit_list_insert(lookup_commit(parent), &parents);
1686 say(state, stderr, _("applying to an empty history"));
1689 author = fmt_ident(state->author_name, state->author_email,
1690 state->ignore_date ? NULL : state->author_date,
1693 if (state->committer_date_is_author_date)
1694 setenv("GIT_COMMITTER_DATE",
1695 state->ignore_date ? "" : state->author_date, 1);
1697 if (commit_tree(state->msg, state->msg_len, tree, parents, commit,
1698 author, state->sign_commit))
1699 die(_("failed to write commit object"));
1701 reflog_msg = getenv("GIT_REFLOG_ACTION");
1705 strbuf_addf(&sb, "%s: %.*s", reflog_msg, linelen(state->msg),
1708 update_ref(sb.buf, "HEAD", commit, ptr, 0, UPDATE_REFS_DIE_ON_ERR);
1710 if (state->rebasing) {
1711 FILE *fp = xfopen(am_path(state, "rewritten"), "a");
1713 assert(!is_null_sha1(state->orig_commit));
1714 fprintf(fp, "%s ", sha1_to_hex(state->orig_commit));
1715 fprintf(fp, "%s\n", sha1_to_hex(commit));
1719 run_hook_le(NULL, "post-applypatch", NULL);
1721 strbuf_release(&sb);
1725 * Validates the am_state for resuming -- the "msg" and authorship fields must
1728 static void validate_resume_state(const struct am_state *state)
1731 die(_("cannot resume: %s does not exist."),
1732 am_path(state, "final-commit"));
1734 if (!state->author_name || !state->author_email || !state->author_date)
1735 die(_("cannot resume: %s does not exist."),
1736 am_path(state, "author-script"));
1740 * Interactively prompt the user on whether the current patch should be
1743 * Returns 0 if the user chooses to apply the patch, 1 if the user chooses to
1746 static int do_interactive(struct am_state *state)
1751 die(_("cannot be interactive without stdin connected to a terminal."));
1756 puts(_("Commit Body is:"));
1757 puts("--------------------------");
1758 printf("%s", state->msg);
1759 puts("--------------------------");
1762 * TRANSLATORS: Make sure to include [y], [n], [e], [v] and [a]
1763 * in your translation. The program will only accept English
1764 * input at this point.
1766 reply = git_prompt(_("Apply? [y]es/[n]o/[e]dit/[v]iew patch/[a]ccept all: "), PROMPT_ECHO);
1770 } else if (*reply == 'y' || *reply == 'Y') {
1772 } else if (*reply == 'a' || *reply == 'A') {
1773 state->interactive = 0;
1775 } else if (*reply == 'n' || *reply == 'N') {
1777 } else if (*reply == 'e' || *reply == 'E') {
1778 struct strbuf msg = STRBUF_INIT;
1780 if (!launch_editor(am_path(state, "final-commit"), &msg, NULL)) {
1782 state->msg = strbuf_detach(&msg, &state->msg_len);
1784 strbuf_release(&msg);
1785 } else if (*reply == 'v' || *reply == 'V') {
1786 const char *pager = git_pager(1);
1787 struct child_process cp = CHILD_PROCESS_INIT;
1791 prepare_pager_args(&cp, pager);
1792 argv_array_push(&cp.args, am_path(state, "patch"));
1799 * Applies all queued mail.
1801 * If `resume` is true, we are "resuming". The "msg" and authorship fields, as
1802 * well as the state directory's "patch" file is used as-is for applying the
1803 * patch and committing it.
1805 static void am_run(struct am_state *state, int resume)
1807 const char *argv_gc_auto[] = {"gc", "--auto", NULL};
1808 struct strbuf sb = STRBUF_INIT;
1810 unlink(am_path(state, "dirtyindex"));
1812 refresh_and_write_cache();
1814 if (index_has_changes(&sb)) {
1815 write_state_bool(state, "dirtyindex", 1);
1816 die(_("Dirty index: cannot apply patches (dirty: %s)"), sb.buf);
1819 strbuf_release(&sb);
1821 while (state->cur <= state->last) {
1822 const char *mail = am_path(state, msgnum(state));
1827 if (!file_exists(mail))
1831 validate_resume_state(state);
1835 if (state->rebasing)
1836 skip = parse_mail_rebase(state, mail);
1838 skip = parse_mail(state, mail);
1841 goto next; /* mail should be skipped */
1843 write_author_script(state);
1844 write_commit_msg(state);
1847 if (state->interactive && do_interactive(state))
1850 if (run_applypatch_msg_hook(state))
1853 say(state, stdout, _("Applying: %.*s"), linelen(state->msg), state->msg);
1855 apply_status = run_apply(state, NULL);
1857 if (apply_status && state->threeway) {
1858 struct strbuf sb = STRBUF_INIT;
1860 strbuf_addstr(&sb, am_path(state, "patch-merge-index"));
1861 apply_status = fall_back_threeway(state, sb.buf);
1862 strbuf_release(&sb);
1865 * Applying the patch to an earlier tree and merging
1866 * the result may have produced the same tree as ours.
1868 if (!apply_status && !index_has_changes(NULL)) {
1869 say(state, stdout, _("No changes -- Patch already applied."));
1875 int advice_amworkdir = 1;
1877 printf_ln(_("Patch failed at %s %.*s"), msgnum(state),
1878 linelen(state->msg), state->msg);
1880 git_config_get_bool("advice.amworkdir", &advice_amworkdir);
1882 if (advice_amworkdir)
1883 printf_ln(_("The copy of the patch that failed is found in: %s"),
1884 am_path(state, "patch"));
1886 die_user_resolve(state);
1899 if (!is_empty_file(am_path(state, "rewritten"))) {
1900 assert(state->rebasing);
1901 copy_notes_for_rebase(state);
1902 run_post_rewrite_hook(state);
1906 * In rebasing mode, it's up to the caller to take care of
1909 if (!state->rebasing) {
1912 run_command_v_opt(argv_gc_auto, RUN_GIT_CMD);
1917 * Resume the current am session after patch application failure. The user did
1918 * all the hard work, and we do not have to do any patch application. Just
1919 * trust and commit what the user has in the index and working tree.
1921 static void am_resolve(struct am_state *state)
1923 validate_resume_state(state);
1925 say(state, stdout, _("Applying: %.*s"), linelen(state->msg), state->msg);
1927 if (!index_has_changes(NULL)) {
1928 printf_ln(_("No changes - did you forget to use 'git add'?\n"
1929 "If there is nothing left to stage, chances are that something else\n"
1930 "already introduced the same changes; you might want to skip this patch."));
1931 die_user_resolve(state);
1934 if (unmerged_cache()) {
1935 printf_ln(_("You still have unmerged paths in your index.\n"
1936 "Did you forget to use 'git add'?"));
1937 die_user_resolve(state);
1940 if (state->interactive) {
1941 write_index_patch(state);
1942 if (do_interactive(state))
1957 * Performs a checkout fast-forward from `head` to `remote`. If `reset` is
1958 * true, any unmerged entries will be discarded. Returns 0 on success, -1 on
1961 static int fast_forward_to(struct tree *head, struct tree *remote, int reset)
1963 struct lock_file *lock_file;
1964 struct unpack_trees_options opts;
1965 struct tree_desc t[2];
1967 if (parse_tree(head) || parse_tree(remote))
1970 lock_file = xcalloc(1, sizeof(struct lock_file));
1971 hold_locked_index(lock_file, 1);
1973 refresh_cache(REFRESH_QUIET);
1975 memset(&opts, 0, sizeof(opts));
1977 opts.src_index = &the_index;
1978 opts.dst_index = &the_index;
1982 opts.fn = twoway_merge;
1983 init_tree_desc(&t[0], head->buffer, head->size);
1984 init_tree_desc(&t[1], remote->buffer, remote->size);
1986 if (unpack_trees(2, t, &opts)) {
1987 rollback_lock_file(lock_file);
1991 if (write_locked_index(&the_index, lock_file, COMMIT_LOCK))
1992 die(_("unable to write new index file"));
1998 * Merges a tree into the index. The index's stat info will take precedence
1999 * over the merged tree's. Returns 0 on success, -1 on failure.
2001 static int merge_tree(struct tree *tree)
2003 struct lock_file *lock_file;
2004 struct unpack_trees_options opts;
2005 struct tree_desc t[1];
2007 if (parse_tree(tree))
2010 lock_file = xcalloc(1, sizeof(struct lock_file));
2011 hold_locked_index(lock_file, 1);
2013 memset(&opts, 0, sizeof(opts));
2015 opts.src_index = &the_index;
2016 opts.dst_index = &the_index;
2018 opts.fn = oneway_merge;
2019 init_tree_desc(&t[0], tree->buffer, tree->size);
2021 if (unpack_trees(1, t, &opts)) {
2022 rollback_lock_file(lock_file);
2026 if (write_locked_index(&the_index, lock_file, COMMIT_LOCK))
2027 die(_("unable to write new index file"));
2033 * Clean the index without touching entries that are not modified between
2034 * `head` and `remote`.
2036 static int clean_index(const unsigned char *head, const unsigned char *remote)
2038 struct tree *head_tree, *remote_tree, *index_tree;
2039 unsigned char index[GIT_SHA1_RAWSZ];
2041 head_tree = parse_tree_indirect(head);
2043 return error(_("Could not parse object '%s'."), sha1_to_hex(head));
2045 remote_tree = parse_tree_indirect(remote);
2047 return error(_("Could not parse object '%s'."), sha1_to_hex(remote));
2049 read_cache_unmerged();
2051 if (fast_forward_to(head_tree, head_tree, 1))
2054 if (write_cache_as_tree(index, 0, NULL))
2057 index_tree = parse_tree_indirect(index);
2059 return error(_("Could not parse object '%s'."), sha1_to_hex(index));
2061 if (fast_forward_to(index_tree, remote_tree, 0))
2064 if (merge_tree(remote_tree))
2067 remove_branch_state();
2073 * Resets rerere's merge resolution metadata.
2075 static void am_rerere_clear(void)
2077 struct string_list merge_rr = STRING_LIST_INIT_DUP;
2078 rerere_clear(&merge_rr);
2079 string_list_clear(&merge_rr, 1);
2083 * Resume the current am session by skipping the current patch.
2085 static void am_skip(struct am_state *state)
2087 unsigned char head[GIT_SHA1_RAWSZ];
2091 if (get_sha1("HEAD", head))
2092 hashcpy(head, EMPTY_TREE_SHA1_BIN);
2094 if (clean_index(head, head))
2095 die(_("failed to clean index"));
2103 * Returns true if it is safe to reset HEAD to the ORIG_HEAD, false otherwise.
2105 * It is not safe to reset HEAD when:
2106 * 1. git-am previously failed because the index was dirty.
2107 * 2. HEAD has moved since git-am previously failed.
2109 static int safe_to_abort(const struct am_state *state)
2111 struct strbuf sb = STRBUF_INIT;
2112 unsigned char abort_safety[GIT_SHA1_RAWSZ], head[GIT_SHA1_RAWSZ];
2114 if (file_exists(am_path(state, "dirtyindex")))
2117 if (read_state_file(&sb, state, "abort-safety", 1) > 0) {
2118 if (get_sha1_hex(sb.buf, abort_safety))
2119 die(_("could not parse %s"), am_path(state, "abort_safety"));
2121 hashclr(abort_safety);
2123 if (get_sha1("HEAD", head))
2126 if (!hashcmp(head, abort_safety))
2129 error(_("You seem to have moved HEAD since the last 'am' failure.\n"
2130 "Not rewinding to ORIG_HEAD"));
2136 * Aborts the current am session if it is safe to do so.
2138 static void am_abort(struct am_state *state)
2140 unsigned char curr_head[GIT_SHA1_RAWSZ], orig_head[GIT_SHA1_RAWSZ];
2141 int has_curr_head, has_orig_head;
2144 if (!safe_to_abort(state)) {
2151 curr_branch = resolve_refdup("HEAD", 0, curr_head, NULL);
2152 has_curr_head = !is_null_sha1(curr_head);
2154 hashcpy(curr_head, EMPTY_TREE_SHA1_BIN);
2156 has_orig_head = !get_sha1("ORIG_HEAD", orig_head);
2158 hashcpy(orig_head, EMPTY_TREE_SHA1_BIN);
2160 clean_index(curr_head, orig_head);
2163 update_ref("am --abort", "HEAD", orig_head,
2164 has_curr_head ? curr_head : NULL, 0,
2165 UPDATE_REFS_DIE_ON_ERR);
2166 else if (curr_branch)
2167 delete_ref(curr_branch, NULL, REF_NODEREF);
2174 * parse_options() callback that validates and sets opt->value to the
2175 * PATCH_FORMAT_* enum value corresponding to `arg`.
2177 static int parse_opt_patchformat(const struct option *opt, const char *arg, int unset)
2179 int *opt_value = opt->value;
2181 if (!strcmp(arg, "mbox"))
2182 *opt_value = PATCH_FORMAT_MBOX;
2183 else if (!strcmp(arg, "stgit"))
2184 *opt_value = PATCH_FORMAT_STGIT;
2185 else if (!strcmp(arg, "stgit-series"))
2186 *opt_value = PATCH_FORMAT_STGIT_SERIES;
2187 else if (!strcmp(arg, "hg"))
2188 *opt_value = PATCH_FORMAT_HG;
2189 else if (!strcmp(arg, "mboxrd"))
2190 *opt_value = PATCH_FORMAT_MBOXRD;
2192 return error(_("Invalid value for --patch-format: %s"), arg);
2204 static int git_am_config(const char *k, const char *v, void *cb)
2208 status = git_gpg_config(k, v, NULL);
2212 return git_default_config(k, v, NULL);
2215 int cmd_am(int argc, const char **argv, const char *prefix)
2217 struct am_state state;
2220 int patch_format = PATCH_FORMAT_UNKNOWN;
2221 enum resume_mode resume = RESUME_FALSE;
2224 const char * const usage[] = {
2225 N_("git am [<options>] [(<mbox>|<Maildir>)...]"),
2226 N_("git am [<options>] (--continue | --skip | --abort)"),
2230 struct option options[] = {
2231 OPT_BOOL('i', "interactive", &state.interactive,
2232 N_("run interactively")),
2233 OPT_HIDDEN_BOOL('b', "binary", &binary,
2234 N_("historical option -- no-op")),
2235 OPT_BOOL('3', "3way", &state.threeway,
2236 N_("allow fall back on 3way merging if needed")),
2237 OPT__QUIET(&state.quiet, N_("be quiet")),
2238 OPT_SET_INT('s', "signoff", &state.signoff,
2239 N_("add a Signed-off-by line to the commit message"),
2241 OPT_BOOL('u', "utf8", &state.utf8,
2242 N_("recode into utf8 (default)")),
2243 OPT_SET_INT('k', "keep", &state.keep,
2244 N_("pass -k flag to git-mailinfo"), KEEP_TRUE),
2245 OPT_SET_INT(0, "keep-non-patch", &state.keep,
2246 N_("pass -b flag to git-mailinfo"), KEEP_NON_PATCH),
2247 OPT_BOOL('m', "message-id", &state.message_id,
2248 N_("pass -m flag to git-mailinfo")),
2249 { OPTION_SET_INT, 0, "keep-cr", &keep_cr, NULL,
2250 N_("pass --keep-cr flag to git-mailsplit for mbox format"),
2251 PARSE_OPT_NOARG | PARSE_OPT_NONEG, NULL, 1},
2252 { OPTION_SET_INT, 0, "no-keep-cr", &keep_cr, NULL,
2253 N_("do not pass --keep-cr flag to git-mailsplit independent of am.keepcr"),
2254 PARSE_OPT_NOARG | PARSE_OPT_NONEG, NULL, 0},
2255 OPT_BOOL('c', "scissors", &state.scissors,
2256 N_("strip everything before a scissors line")),
2257 OPT_PASSTHRU_ARGV(0, "whitespace", &state.git_apply_opts, N_("action"),
2258 N_("pass it through git-apply"),
2260 OPT_PASSTHRU_ARGV(0, "ignore-space-change", &state.git_apply_opts, NULL,
2261 N_("pass it through git-apply"),
2263 OPT_PASSTHRU_ARGV(0, "ignore-whitespace", &state.git_apply_opts, NULL,
2264 N_("pass it through git-apply"),
2266 OPT_PASSTHRU_ARGV(0, "directory", &state.git_apply_opts, N_("root"),
2267 N_("pass it through git-apply"),
2269 OPT_PASSTHRU_ARGV(0, "exclude", &state.git_apply_opts, N_("path"),
2270 N_("pass it through git-apply"),
2272 OPT_PASSTHRU_ARGV(0, "include", &state.git_apply_opts, N_("path"),
2273 N_("pass it through git-apply"),
2275 OPT_PASSTHRU_ARGV('C', NULL, &state.git_apply_opts, N_("n"),
2276 N_("pass it through git-apply"),
2278 OPT_PASSTHRU_ARGV('p', NULL, &state.git_apply_opts, N_("num"),
2279 N_("pass it through git-apply"),
2281 OPT_CALLBACK(0, "patch-format", &patch_format, N_("format"),
2282 N_("format the patch(es) are in"),
2283 parse_opt_patchformat),
2284 OPT_PASSTHRU_ARGV(0, "reject", &state.git_apply_opts, NULL,
2285 N_("pass it through git-apply"),
2287 OPT_STRING(0, "resolvemsg", &state.resolvemsg, NULL,
2288 N_("override error message when patch failure occurs")),
2289 OPT_CMDMODE(0, "continue", &resume,
2290 N_("continue applying patches after resolving a conflict"),
2292 OPT_CMDMODE('r', "resolved", &resume,
2293 N_("synonyms for --continue"),
2295 OPT_CMDMODE(0, "skip", &resume,
2296 N_("skip the current patch"),
2298 OPT_CMDMODE(0, "abort", &resume,
2299 N_("restore the original branch and abort the patching operation."),
2301 OPT_BOOL(0, "committer-date-is-author-date",
2302 &state.committer_date_is_author_date,
2303 N_("lie about committer date")),
2304 OPT_BOOL(0, "ignore-date", &state.ignore_date,
2305 N_("use current timestamp for author date")),
2306 OPT_RERERE_AUTOUPDATE(&state.allow_rerere_autoupdate),
2307 { OPTION_STRING, 'S', "gpg-sign", &state.sign_commit, N_("key-id"),
2308 N_("GPG-sign commits"),
2309 PARSE_OPT_OPTARG, NULL, (intptr_t) "" },
2310 OPT_HIDDEN_BOOL(0, "rebasing", &state.rebasing,
2311 N_("(internal use for git-rebase)")),
2315 git_config(git_am_config, NULL);
2317 am_state_init(&state, git_path("rebase-apply"));
2319 in_progress = am_in_progress(&state);
2323 argc = parse_options(argc, argv, prefix, options, usage, 0);
2326 fprintf_ln(stderr, _("The -b/--binary option has been a no-op for long time, and\n"
2327 "it will be removed. Please do not use it anymore."));
2329 /* Ensure a valid committer ident can be constructed */
2330 git_committer_info(IDENT_STRICT);
2332 if (read_index_preload(&the_index, NULL) < 0)
2333 die(_("failed to read the index"));
2337 * Catch user error to feed us patches when there is a session
2340 * 1. mbox path(s) are provided on the command-line.
2341 * 2. stdin is not a tty: the user is trying to feed us a patch
2342 * from standard input. This is somewhat unreliable -- stdin
2343 * could be /dev/null for example and the caller did not
2344 * intend to feed us a patch but wanted to continue
2347 if (argc || (resume == RESUME_FALSE && !isatty(0)))
2348 die(_("previous rebase directory %s still exists but mbox given."),
2351 if (resume == RESUME_FALSE)
2352 resume = RESUME_APPLY;
2354 if (state.signoff == SIGNOFF_EXPLICIT)
2355 am_append_signoff(&state);
2357 struct argv_array paths = ARGV_ARRAY_INIT;
2361 * Handle stray state directory in the independent-run case. In
2362 * the --rebasing case, it is up to the caller to take care of
2363 * stray directories.
2365 if (file_exists(state.dir) && !state.rebasing) {
2366 if (resume == RESUME_ABORT) {
2368 am_state_release(&state);
2372 die(_("Stray %s directory found.\n"
2373 "Use \"git am --abort\" to remove it."),
2378 die(_("Resolve operation not in progress, we are not resuming."));
2380 for (i = 0; i < argc; i++) {
2381 if (is_absolute_path(argv[i]) || !prefix)
2382 argv_array_push(&paths, argv[i]);
2384 argv_array_push(&paths, mkpath("%s/%s", prefix, argv[i]));
2387 am_setup(&state, patch_format, paths.argv, keep_cr);
2389 argv_array_clear(&paths);
2399 case RESUME_RESOLVED:
2409 die("BUG: invalid resume value");
2412 am_state_release(&state);