4 * Based on git-am.sh by Junio C Hamano.
10 #include "parse-options.h"
12 #include "run-command.h"
16 #include "cache-tree.h"
21 #include "unpack-trees.h"
23 #include "sequencer.h"
25 #include "merge-recursive.h"
28 #include "notes-utils.h"
33 #include "string-list.h"
37 * Returns 1 if the file is empty or does not exist, 0 otherwise.
39 static int is_empty_file(const char *filename)
43 if (stat(filename, &st) < 0) {
46 die_errno(_("could not stat %s"), filename);
53 * Returns the length of the first line of msg.
55 static int linelen(const char *msg)
57 return strchrnul(msg, '\n') - msg;
61 * Returns true if `str` consists of only whitespace, false otherwise.
63 static int str_isspace(const char *str)
73 PATCH_FORMAT_UNKNOWN = 0,
76 PATCH_FORMAT_STGIT_SERIES,
83 KEEP_TRUE, /* pass -k flag to git-mailinfo */
84 KEEP_NON_PATCH /* pass -b flag to git-mailinfo */
89 SCISSORS_FALSE = 0, /* pass --no-scissors to git-mailinfo */
90 SCISSORS_TRUE /* pass --scissors to git-mailinfo */
96 SIGNOFF_EXPLICIT /* --signoff was set on the command-line */
100 /* state directory path */
103 /* current and last patch numbers, 1-indexed */
107 /* commit metadata and message */
114 /* when --rebasing, records the original commit the patch came from */
115 struct object_id orig_commit;
117 /* number of digits in patch filename */
120 /* various operating modes and command line options */
124 int signoff; /* enum signoff_type */
126 int keep; /* enum keep_type */
128 int scissors; /* enum scissors_type */
129 struct argv_array git_apply_opts;
130 const char *resolvemsg;
131 int committer_date_is_author_date;
133 int allow_rerere_autoupdate;
134 const char *sign_commit;
139 * Initializes am_state with the default values.
141 static void am_state_init(struct am_state *state)
145 memset(state, 0, sizeof(*state));
147 state->dir = git_pathdup("rebase-apply");
151 git_config_get_bool("am.threeway", &state->threeway);
155 git_config_get_bool("am.messageid", &state->message_id);
157 state->scissors = SCISSORS_UNSET;
159 argv_array_init(&state->git_apply_opts);
161 if (!git_config_get_bool("commit.gpgsign", &gpgsign))
162 state->sign_commit = gpgsign ? "" : NULL;
166 * Releases memory allocated by an am_state.
168 static void am_state_release(struct am_state *state)
171 free(state->author_name);
172 free(state->author_email);
173 free(state->author_date);
175 argv_array_clear(&state->git_apply_opts);
179 * Returns path relative to the am_state directory.
181 static inline const char *am_path(const struct am_state *state, const char *path)
183 return mkpath("%s/%s", state->dir, path);
187 * For convenience to call write_file()
189 static void write_state_text(const struct am_state *state,
190 const char *name, const char *string)
192 write_file(am_path(state, name), "%s", string);
195 static void write_state_count(const struct am_state *state,
196 const char *name, int value)
198 write_file(am_path(state, name), "%d", value);
201 static void write_state_bool(const struct am_state *state,
202 const char *name, int value)
204 write_state_text(state, name, value ? "t" : "f");
208 * If state->quiet is false, calls fprintf(fp, fmt, ...), and appends a newline
211 static void say(const struct am_state *state, FILE *fp, const char *fmt, ...)
217 vfprintf(fp, fmt, ap);
224 * Returns 1 if there is an am session in progress, 0 otherwise.
226 static int am_in_progress(const struct am_state *state)
230 if (lstat(state->dir, &st) < 0 || !S_ISDIR(st.st_mode))
232 if (lstat(am_path(state, "last"), &st) || !S_ISREG(st.st_mode))
234 if (lstat(am_path(state, "next"), &st) || !S_ISREG(st.st_mode))
240 * Reads the contents of `file` in the `state` directory into `sb`. Returns the
241 * number of bytes read on success, -1 if the file does not exist. If `trim` is
242 * set, trailing whitespace will be removed.
244 static int read_state_file(struct strbuf *sb, const struct am_state *state,
245 const char *file, int trim)
249 if (strbuf_read_file(sb, am_path(state, file), 0) >= 0) {
259 die_errno(_("could not read '%s'"), am_path(state, file));
263 * Take a series of KEY='VALUE' lines where VALUE part is
264 * sq-quoted, and append <KEY, VALUE> at the end of the string list
266 static int parse_key_value_squoted(char *buf, struct string_list *list)
269 struct string_list_item *item;
271 char *cp = strchr(buf, '=');
274 np = strchrnul(cp, '\n');
276 item = string_list_append(list, buf);
278 buf = np + (*np == '\n');
283 item->util = xstrdup(cp);
289 * Reads and parses the state directory's "author-script" file, and sets
290 * state->author_name, state->author_email and state->author_date accordingly.
291 * Returns 0 on success, -1 if the file could not be parsed.
293 * The author script is of the format:
295 * GIT_AUTHOR_NAME='$author_name'
296 * GIT_AUTHOR_EMAIL='$author_email'
297 * GIT_AUTHOR_DATE='$author_date'
299 * where $author_name, $author_email and $author_date are quoted. We are strict
300 * with our parsing, as the file was meant to be eval'd in the old git-am.sh
301 * script, and thus if the file differs from what this function expects, it is
302 * better to bail out than to do something that the user does not expect.
304 static int read_author_script(struct am_state *state)
306 const char *filename = am_path(state, "author-script");
307 struct strbuf buf = STRBUF_INIT;
308 struct string_list kv = STRING_LIST_INIT_DUP;
309 int retval = -1; /* assume failure */
312 assert(!state->author_name);
313 assert(!state->author_email);
314 assert(!state->author_date);
316 fd = open(filename, O_RDONLY);
320 die_errno(_("could not open '%s' for reading"), filename);
322 strbuf_read(&buf, fd, 0);
324 if (parse_key_value_squoted(buf.buf, &kv))
328 strcmp(kv.items[0].string, "GIT_AUTHOR_NAME") ||
329 strcmp(kv.items[1].string, "GIT_AUTHOR_EMAIL") ||
330 strcmp(kv.items[2].string, "GIT_AUTHOR_DATE"))
332 state->author_name = kv.items[0].util;
333 state->author_email = kv.items[1].util;
334 state->author_date = kv.items[2].util;
337 string_list_clear(&kv, !!retval);
338 strbuf_release(&buf);
343 * Saves state->author_name, state->author_email and state->author_date in the
344 * state directory's "author-script" file.
346 static void write_author_script(const struct am_state *state)
348 struct strbuf sb = STRBUF_INIT;
350 strbuf_addstr(&sb, "GIT_AUTHOR_NAME=");
351 sq_quote_buf(&sb, state->author_name);
352 strbuf_addch(&sb, '\n');
354 strbuf_addstr(&sb, "GIT_AUTHOR_EMAIL=");
355 sq_quote_buf(&sb, state->author_email);
356 strbuf_addch(&sb, '\n');
358 strbuf_addstr(&sb, "GIT_AUTHOR_DATE=");
359 sq_quote_buf(&sb, state->author_date);
360 strbuf_addch(&sb, '\n');
362 write_state_text(state, "author-script", sb.buf);
368 * Reads the commit message from the state directory's "final-commit" file,
369 * setting state->msg to its contents and state->msg_len to the length of its
372 * Returns 0 on success, -1 if the file does not exist.
374 static int read_commit_msg(struct am_state *state)
376 struct strbuf sb = STRBUF_INIT;
380 if (read_state_file(&sb, state, "final-commit", 0) < 0) {
385 state->msg = strbuf_detach(&sb, &state->msg_len);
390 * Saves state->msg in the state directory's "final-commit" file.
392 static void write_commit_msg(const struct am_state *state)
394 const char *filename = am_path(state, "final-commit");
395 write_file_buf(filename, state->msg, state->msg_len);
399 * Loads state from disk.
401 static void am_load(struct am_state *state)
403 struct strbuf sb = STRBUF_INIT;
405 if (read_state_file(&sb, state, "next", 1) < 0)
406 die("BUG: state file 'next' does not exist");
407 state->cur = strtol(sb.buf, NULL, 10);
409 if (read_state_file(&sb, state, "last", 1) < 0)
410 die("BUG: state file 'last' does not exist");
411 state->last = strtol(sb.buf, NULL, 10);
413 if (read_author_script(state) < 0)
414 die(_("could not parse author script"));
416 read_commit_msg(state);
418 if (read_state_file(&sb, state, "original-commit", 1) < 0)
419 oidclr(&state->orig_commit);
420 else if (get_oid_hex(sb.buf, &state->orig_commit) < 0)
421 die(_("could not parse %s"), am_path(state, "original-commit"));
423 read_state_file(&sb, state, "threeway", 1);
424 state->threeway = !strcmp(sb.buf, "t");
426 read_state_file(&sb, state, "quiet", 1);
427 state->quiet = !strcmp(sb.buf, "t");
429 read_state_file(&sb, state, "sign", 1);
430 state->signoff = !strcmp(sb.buf, "t");
432 read_state_file(&sb, state, "utf8", 1);
433 state->utf8 = !strcmp(sb.buf, "t");
435 if (file_exists(am_path(state, "rerere-autoupdate"))) {
436 read_state_file(&sb, state, "rerere-autoupdate", 1);
437 state->allow_rerere_autoupdate = strcmp(sb.buf, "t") ?
438 RERERE_NOAUTOUPDATE : RERERE_AUTOUPDATE;
440 state->allow_rerere_autoupdate = 0;
443 read_state_file(&sb, state, "keep", 1);
444 if (!strcmp(sb.buf, "t"))
445 state->keep = KEEP_TRUE;
446 else if (!strcmp(sb.buf, "b"))
447 state->keep = KEEP_NON_PATCH;
449 state->keep = KEEP_FALSE;
451 read_state_file(&sb, state, "messageid", 1);
452 state->message_id = !strcmp(sb.buf, "t");
454 read_state_file(&sb, state, "scissors", 1);
455 if (!strcmp(sb.buf, "t"))
456 state->scissors = SCISSORS_TRUE;
457 else if (!strcmp(sb.buf, "f"))
458 state->scissors = SCISSORS_FALSE;
460 state->scissors = SCISSORS_UNSET;
462 read_state_file(&sb, state, "apply-opt", 1);
463 argv_array_clear(&state->git_apply_opts);
464 if (sq_dequote_to_argv_array(sb.buf, &state->git_apply_opts) < 0)
465 die(_("could not parse %s"), am_path(state, "apply-opt"));
467 state->rebasing = !!file_exists(am_path(state, "rebasing"));
473 * Removes the am_state directory, forcefully terminating the current am
476 static void am_destroy(const struct am_state *state)
478 struct strbuf sb = STRBUF_INIT;
480 strbuf_addstr(&sb, state->dir);
481 remove_dir_recursively(&sb, 0);
486 * Runs applypatch-msg hook. Returns its exit code.
488 static int run_applypatch_msg_hook(struct am_state *state)
493 ret = run_hook_le(NULL, "applypatch-msg", am_path(state, "final-commit"), NULL);
496 FREE_AND_NULL(state->msg);
497 if (read_commit_msg(state) < 0)
498 die(_("'%s' was deleted by the applypatch-msg hook"),
499 am_path(state, "final-commit"));
506 * Runs post-rewrite hook. Returns it exit code.
508 static int run_post_rewrite_hook(const struct am_state *state)
510 struct child_process cp = CHILD_PROCESS_INIT;
511 const char *hook = find_hook("post-rewrite");
517 argv_array_push(&cp.args, hook);
518 argv_array_push(&cp.args, "rebase");
520 cp.in = xopen(am_path(state, "rewritten"), O_RDONLY);
521 cp.stdout_to_stderr = 1;
523 ret = run_command(&cp);
530 * Reads the state directory's "rewritten" file, and copies notes from the old
531 * commits listed in the file to their rewritten commits.
533 * Returns 0 on success, -1 on failure.
535 static int copy_notes_for_rebase(const struct am_state *state)
537 struct notes_rewrite_cfg *c;
538 struct strbuf sb = STRBUF_INIT;
539 const char *invalid_line = _("Malformed input line: '%s'.");
540 const char *msg = "Notes added by 'git rebase'";
544 assert(state->rebasing);
546 c = init_copy_notes_for_rewrite("rebase");
550 fp = xfopen(am_path(state, "rewritten"), "r");
552 while (!strbuf_getline_lf(&sb, fp)) {
553 struct object_id from_obj, to_obj;
555 if (sb.len != GIT_SHA1_HEXSZ * 2 + 1) {
556 ret = error(invalid_line, sb.buf);
560 if (get_oid_hex(sb.buf, &from_obj)) {
561 ret = error(invalid_line, sb.buf);
565 if (sb.buf[GIT_SHA1_HEXSZ] != ' ') {
566 ret = error(invalid_line, sb.buf);
570 if (get_oid_hex(sb.buf + GIT_SHA1_HEXSZ + 1, &to_obj)) {
571 ret = error(invalid_line, sb.buf);
575 if (copy_note_for_rewrite(c, &from_obj, &to_obj))
576 ret = error(_("Failed to copy notes from '%s' to '%s'"),
577 oid_to_hex(&from_obj), oid_to_hex(&to_obj));
581 finish_copy_notes_for_rewrite(c, msg);
588 * Determines if the file looks like a piece of RFC2822 mail by grabbing all
589 * non-indented lines and checking if they look like they begin with valid
590 * header field names.
592 * Returns 1 if the file looks like a piece of mail, 0 otherwise.
594 static int is_mail(FILE *fp)
596 const char *header_regex = "^[!-9;-~]+:";
597 struct strbuf sb = STRBUF_INIT;
601 if (fseek(fp, 0L, SEEK_SET))
602 die_errno(_("fseek failed"));
604 if (regcomp(®ex, header_regex, REG_NOSUB | REG_EXTENDED))
605 die("invalid pattern: %s", header_regex);
607 while (!strbuf_getline(&sb, fp)) {
609 break; /* End of header */
611 /* Ignore indented folded lines */
612 if (*sb.buf == '\t' || *sb.buf == ' ')
615 /* It's a header if it matches header_regex */
616 if (regexec(®ex, sb.buf, 0, NULL, 0)) {
629 * Attempts to detect the patch_format of the patches contained in `paths`,
630 * returning the PATCH_FORMAT_* enum value. Returns PATCH_FORMAT_UNKNOWN if
633 static int detect_patch_format(const char **paths)
635 enum patch_format ret = PATCH_FORMAT_UNKNOWN;
636 struct strbuf l1 = STRBUF_INIT;
637 struct strbuf l2 = STRBUF_INIT;
638 struct strbuf l3 = STRBUF_INIT;
642 * We default to mbox format if input is from stdin and for directories
644 if (!*paths || !strcmp(*paths, "-") || is_directory(*paths))
645 return PATCH_FORMAT_MBOX;
648 * Otherwise, check the first few lines of the first patch, starting
649 * from the first non-blank line, to try to detect its format.
652 fp = xfopen(*paths, "r");
654 while (!strbuf_getline(&l1, fp)) {
659 if (starts_with(l1.buf, "From ") || starts_with(l1.buf, "From: ")) {
660 ret = PATCH_FORMAT_MBOX;
664 if (starts_with(l1.buf, "# This series applies on GIT commit")) {
665 ret = PATCH_FORMAT_STGIT_SERIES;
669 if (!strcmp(l1.buf, "# HG changeset patch")) {
670 ret = PATCH_FORMAT_HG;
675 strbuf_getline(&l2, fp);
677 strbuf_getline(&l3, fp);
680 * If the second line is empty and the third is a From, Author or Date
681 * entry, this is likely an StGit patch.
683 if (l1.len && !l2.len &&
684 (starts_with(l3.buf, "From:") ||
685 starts_with(l3.buf, "Author:") ||
686 starts_with(l3.buf, "Date:"))) {
687 ret = PATCH_FORMAT_STGIT;
691 if (l1.len && is_mail(fp)) {
692 ret = PATCH_FORMAT_MBOX;
703 * Splits out individual email patches from `paths`, where each path is either
704 * a mbox file or a Maildir. Returns 0 on success, -1 on failure.
706 static int split_mail_mbox(struct am_state *state, const char **paths,
707 int keep_cr, int mboxrd)
709 struct child_process cp = CHILD_PROCESS_INIT;
710 struct strbuf last = STRBUF_INIT;
713 argv_array_push(&cp.args, "mailsplit");
714 argv_array_pushf(&cp.args, "-d%d", state->prec);
715 argv_array_pushf(&cp.args, "-o%s", state->dir);
716 argv_array_push(&cp.args, "-b");
718 argv_array_push(&cp.args, "--keep-cr");
720 argv_array_push(&cp.args, "--mboxrd");
721 argv_array_push(&cp.args, "--");
722 argv_array_pushv(&cp.args, paths);
724 if (capture_command(&cp, &last, 8))
728 state->last = strtol(last.buf, NULL, 10);
734 * Callback signature for split_mail_conv(). The foreign patch should be
735 * read from `in`, and the converted patch (in RFC2822 mail format) should be
736 * written to `out`. Return 0 on success, or -1 on failure.
738 typedef int (*mail_conv_fn)(FILE *out, FILE *in, int keep_cr);
741 * Calls `fn` for each file in `paths` to convert the foreign patch to the
742 * RFC2822 mail format suitable for parsing with git-mailinfo.
744 * Returns 0 on success, -1 on failure.
746 static int split_mail_conv(mail_conv_fn fn, struct am_state *state,
747 const char **paths, int keep_cr)
749 static const char *stdin_only[] = {"-", NULL};
755 for (i = 0; *paths; paths++, i++) {
760 if (!strcmp(*paths, "-"))
763 in = fopen(*paths, "r");
766 return error_errno(_("could not open '%s' for reading"),
769 mail = mkpath("%s/%0*d", state->dir, state->prec, i + 1);
771 out = fopen(mail, "w");
775 return error_errno(_("could not open '%s' for writing"),
779 ret = fn(out, in, keep_cr);
786 return error(_("could not parse patch '%s'"), *paths);
795 * A split_mail_conv() callback that converts an StGit patch to an RFC2822
796 * message suitable for parsing with git-mailinfo.
798 static int stgit_patch_to_mail(FILE *out, FILE *in, int keep_cr)
800 struct strbuf sb = STRBUF_INIT;
801 int subject_printed = 0;
803 while (!strbuf_getline_lf(&sb, in)) {
806 if (str_isspace(sb.buf))
808 else if (skip_prefix(sb.buf, "Author:", &str))
809 fprintf(out, "From:%s\n", str);
810 else if (starts_with(sb.buf, "From") || starts_with(sb.buf, "Date"))
811 fprintf(out, "%s\n", sb.buf);
812 else if (!subject_printed) {
813 fprintf(out, "Subject: %s\n", sb.buf);
816 fprintf(out, "\n%s\n", sb.buf);
822 while (strbuf_fread(&sb, 8192, in) > 0) {
823 fwrite(sb.buf, 1, sb.len, out);
832 * This function only supports a single StGit series file in `paths`.
834 * Given an StGit series file, converts the StGit patches in the series into
835 * RFC2822 messages suitable for parsing with git-mailinfo, and queues them in
836 * the state directory.
838 * Returns 0 on success, -1 on failure.
840 static int split_mail_stgit_series(struct am_state *state, const char **paths,
843 const char *series_dir;
844 char *series_dir_buf;
846 struct argv_array patches = ARGV_ARRAY_INIT;
847 struct strbuf sb = STRBUF_INIT;
850 if (!paths[0] || paths[1])
851 return error(_("Only one StGIT patch series can be applied at once"));
853 series_dir_buf = xstrdup(*paths);
854 series_dir = dirname(series_dir_buf);
856 fp = fopen(*paths, "r");
858 return error_errno(_("could not open '%s' for reading"), *paths);
860 while (!strbuf_getline_lf(&sb, fp)) {
862 continue; /* skip comment lines */
864 argv_array_push(&patches, mkpath("%s/%s", series_dir, sb.buf));
869 free(series_dir_buf);
871 ret = split_mail_conv(stgit_patch_to_mail, state, patches.argv, keep_cr);
873 argv_array_clear(&patches);
878 * A split_patches_conv() callback that converts a mercurial patch to a RFC2822
879 * message suitable for parsing with git-mailinfo.
881 static int hg_patch_to_mail(FILE *out, FILE *in, int keep_cr)
883 struct strbuf sb = STRBUF_INIT;
885 while (!strbuf_getline_lf(&sb, in)) {
888 if (skip_prefix(sb.buf, "# User ", &str))
889 fprintf(out, "From: %s\n", str);
890 else if (skip_prefix(sb.buf, "# Date ", &str)) {
891 timestamp_t timestamp;
896 timestamp = parse_timestamp(str, &end, 10);
898 return error(_("invalid timestamp"));
900 if (!skip_prefix(end, " ", &str))
901 return error(_("invalid Date line"));
904 tz = strtol(str, &end, 10);
906 return error(_("invalid timezone offset"));
909 return error(_("invalid Date line"));
912 * mercurial's timezone is in seconds west of UTC,
913 * however git's timezone is in hours + minutes east of
916 tz2 = labs(tz) / 3600 * 100 + labs(tz) % 3600 / 60;
920 fprintf(out, "Date: %s\n", show_date(timestamp, tz2, DATE_MODE(RFC2822)));
921 } else if (starts_with(sb.buf, "# ")) {
924 fprintf(out, "\n%s\n", sb.buf);
930 while (strbuf_fread(&sb, 8192, in) > 0) {
931 fwrite(sb.buf, 1, sb.len, out);
940 * Splits a list of files/directories into individual email patches. Each path
941 * in `paths` must be a file/directory that is formatted according to
944 * Once split out, the individual email patches will be stored in the state
945 * directory, with each patch's filename being its index, padded to state->prec
948 * state->cur will be set to the index of the first mail, and state->last will
949 * be set to the index of the last mail.
951 * Set keep_cr to 0 to convert all lines ending with \r\n to end with \n, 1
952 * to disable this behavior, -1 to use the default configured setting.
954 * Returns 0 on success, -1 on failure.
956 static int split_mail(struct am_state *state, enum patch_format patch_format,
957 const char **paths, int keep_cr)
961 git_config_get_bool("am.keepcr", &keep_cr);
964 switch (patch_format) {
965 case PATCH_FORMAT_MBOX:
966 return split_mail_mbox(state, paths, keep_cr, 0);
967 case PATCH_FORMAT_STGIT:
968 return split_mail_conv(stgit_patch_to_mail, state, paths, keep_cr);
969 case PATCH_FORMAT_STGIT_SERIES:
970 return split_mail_stgit_series(state, paths, keep_cr);
971 case PATCH_FORMAT_HG:
972 return split_mail_conv(hg_patch_to_mail, state, paths, keep_cr);
973 case PATCH_FORMAT_MBOXRD:
974 return split_mail_mbox(state, paths, keep_cr, 1);
976 die("BUG: invalid patch_format");
982 * Setup a new am session for applying patches
984 static void am_setup(struct am_state *state, enum patch_format patch_format,
985 const char **paths, int keep_cr)
987 struct object_id curr_head;
989 struct strbuf sb = STRBUF_INIT;
992 patch_format = detect_patch_format(paths);
995 fprintf_ln(stderr, _("Patch format detection failed."));
999 if (mkdir(state->dir, 0777) < 0 && errno != EEXIST)
1000 die_errno(_("failed to create directory '%s'"), state->dir);
1002 if (split_mail(state, patch_format, paths, keep_cr) < 0) {
1004 die(_("Failed to split patches."));
1007 if (state->rebasing)
1008 state->threeway = 1;
1010 write_state_bool(state, "threeway", state->threeway);
1011 write_state_bool(state, "quiet", state->quiet);
1012 write_state_bool(state, "sign", state->signoff);
1013 write_state_bool(state, "utf8", state->utf8);
1015 if (state->allow_rerere_autoupdate)
1016 write_state_bool(state, "rerere-autoupdate",
1017 state->allow_rerere_autoupdate == RERERE_AUTOUPDATE);
1019 switch (state->keep) {
1026 case KEEP_NON_PATCH:
1030 die("BUG: invalid value for state->keep");
1033 write_state_text(state, "keep", str);
1034 write_state_bool(state, "messageid", state->message_id);
1036 switch (state->scissors) {
1037 case SCISSORS_UNSET:
1040 case SCISSORS_FALSE:
1047 die("BUG: invalid value for state->scissors");
1049 write_state_text(state, "scissors", str);
1051 sq_quote_argv(&sb, state->git_apply_opts.argv, 0);
1052 write_state_text(state, "apply-opt", sb.buf);
1054 if (state->rebasing)
1055 write_state_text(state, "rebasing", "");
1057 write_state_text(state, "applying", "");
1059 if (!get_oid("HEAD", &curr_head)) {
1060 write_state_text(state, "abort-safety", oid_to_hex(&curr_head));
1061 if (!state->rebasing)
1062 update_ref_oid("am", "ORIG_HEAD", &curr_head, NULL, 0,
1063 UPDATE_REFS_DIE_ON_ERR);
1065 write_state_text(state, "abort-safety", "");
1066 if (!state->rebasing)
1067 delete_ref(NULL, "ORIG_HEAD", NULL, 0);
1071 * NOTE: Since the "next" and "last" files determine if an am_state
1072 * session is in progress, they should be written last.
1075 write_state_count(state, "next", state->cur);
1076 write_state_count(state, "last", state->last);
1078 strbuf_release(&sb);
1082 * Increments the patch pointer, and cleans am_state for the application of the
1085 static void am_next(struct am_state *state)
1087 struct object_id head;
1089 FREE_AND_NULL(state->author_name);
1090 FREE_AND_NULL(state->author_email);
1091 FREE_AND_NULL(state->author_date);
1092 FREE_AND_NULL(state->msg);
1095 unlink(am_path(state, "author-script"));
1096 unlink(am_path(state, "final-commit"));
1098 oidclr(&state->orig_commit);
1099 unlink(am_path(state, "original-commit"));
1101 if (!get_oid("HEAD", &head))
1102 write_state_text(state, "abort-safety", oid_to_hex(&head));
1104 write_state_text(state, "abort-safety", "");
1107 write_state_count(state, "next", state->cur);
1111 * Returns the filename of the current patch email.
1113 static const char *msgnum(const struct am_state *state)
1115 static struct strbuf sb = STRBUF_INIT;
1118 strbuf_addf(&sb, "%0*d", state->prec, state->cur);
1124 * Refresh and write index.
1126 static void refresh_and_write_cache(void)
1128 struct lock_file *lock_file = xcalloc(1, sizeof(struct lock_file));
1130 hold_locked_index(lock_file, LOCK_DIE_ON_ERROR);
1131 refresh_cache(REFRESH_QUIET);
1132 if (write_locked_index(&the_index, lock_file, COMMIT_LOCK))
1133 die(_("unable to write index file"));
1137 * Returns 1 if the index differs from HEAD, 0 otherwise. When on an unborn
1138 * branch, returns 1 if there are entries in the index, 0 otherwise. If an
1139 * strbuf is provided, the space-separated list of files that differ will be
1142 static int index_has_changes(struct strbuf *sb)
1144 struct object_id head;
1147 if (!get_oid_tree("HEAD", &head)) {
1148 struct diff_options opt;
1151 DIFF_OPT_SET(&opt, EXIT_WITH_STATUS);
1153 DIFF_OPT_SET(&opt, QUICK);
1154 do_diff_cache(&head, &opt);
1156 for (i = 0; sb && i < diff_queued_diff.nr; i++) {
1158 strbuf_addch(sb, ' ');
1159 strbuf_addstr(sb, diff_queued_diff.queue[i]->two->path);
1162 return DIFF_OPT_TST(&opt, HAS_CHANGES) != 0;
1164 for (i = 0; sb && i < active_nr; i++) {
1166 strbuf_addch(sb, ' ');
1167 strbuf_addstr(sb, active_cache[i]->name);
1174 * Dies with a user-friendly message on how to proceed after resolving the
1175 * problem. This message can be overridden with state->resolvemsg.
1177 static void NORETURN die_user_resolve(const struct am_state *state)
1179 if (state->resolvemsg) {
1180 printf_ln("%s", state->resolvemsg);
1182 const char *cmdline = state->interactive ? "git am -i" : "git am";
1184 printf_ln(_("When you have resolved this problem, run \"%s --continue\"."), cmdline);
1185 printf_ln(_("If you prefer to skip this patch, run \"%s --skip\" instead."), cmdline);
1186 printf_ln(_("To restore the original branch and stop patching, run \"%s --abort\"."), cmdline);
1193 * Appends signoff to the "msg" field of the am_state.
1195 static void am_append_signoff(struct am_state *state)
1197 struct strbuf sb = STRBUF_INIT;
1199 strbuf_attach(&sb, state->msg, state->msg_len, state->msg_len);
1200 append_signoff(&sb, 0, 0);
1201 state->msg = strbuf_detach(&sb, &state->msg_len);
1205 * Parses `mail` using git-mailinfo, extracting its patch and authorship info.
1206 * state->msg will be set to the patch message. state->author_name,
1207 * state->author_email and state->author_date will be set to the patch author's
1208 * name, email and date respectively. The patch body will be written to the
1209 * state directory's "patch" file.
1211 * Returns 1 if the patch should be skipped, 0 otherwise.
1213 static int parse_mail(struct am_state *state, const char *mail)
1216 struct strbuf sb = STRBUF_INIT;
1217 struct strbuf msg = STRBUF_INIT;
1218 struct strbuf author_name = STRBUF_INIT;
1219 struct strbuf author_date = STRBUF_INIT;
1220 struct strbuf author_email = STRBUF_INIT;
1224 setup_mailinfo(&mi);
1227 mi.metainfo_charset = get_commit_output_encoding();
1229 mi.metainfo_charset = NULL;
1231 switch (state->keep) {
1235 mi.keep_subject = 1;
1237 case KEEP_NON_PATCH:
1238 mi.keep_non_patch_brackets_in_subject = 1;
1241 die("BUG: invalid value for state->keep");
1244 if (state->message_id)
1245 mi.add_message_id = 1;
1247 switch (state->scissors) {
1248 case SCISSORS_UNSET:
1250 case SCISSORS_FALSE:
1251 mi.use_scissors = 0;
1254 mi.use_scissors = 1;
1257 die("BUG: invalid value for state->scissors");
1260 mi.input = xfopen(mail, "r");
1261 mi.output = xfopen(am_path(state, "info"), "w");
1262 if (mailinfo(&mi, am_path(state, "msg"), am_path(state, "patch")))
1263 die("could not parse patch");
1268 /* Extract message and author information */
1269 fp = xfopen(am_path(state, "info"), "r");
1270 while (!strbuf_getline_lf(&sb, fp)) {
1273 if (skip_prefix(sb.buf, "Subject: ", &x)) {
1275 strbuf_addch(&msg, '\n');
1276 strbuf_addstr(&msg, x);
1277 } else if (skip_prefix(sb.buf, "Author: ", &x))
1278 strbuf_addstr(&author_name, x);
1279 else if (skip_prefix(sb.buf, "Email: ", &x))
1280 strbuf_addstr(&author_email, x);
1281 else if (skip_prefix(sb.buf, "Date: ", &x))
1282 strbuf_addstr(&author_date, x);
1286 /* Skip pine's internal folder data */
1287 if (!strcmp(author_name.buf, "Mail System Internal Data")) {
1292 if (is_empty_file(am_path(state, "patch"))) {
1293 printf_ln(_("Patch is empty."));
1294 die_user_resolve(state);
1297 strbuf_addstr(&msg, "\n\n");
1298 strbuf_addbuf(&msg, &mi.log_message);
1299 strbuf_stripspace(&msg, 0);
1301 assert(!state->author_name);
1302 state->author_name = strbuf_detach(&author_name, NULL);
1304 assert(!state->author_email);
1305 state->author_email = strbuf_detach(&author_email, NULL);
1307 assert(!state->author_date);
1308 state->author_date = strbuf_detach(&author_date, NULL);
1310 assert(!state->msg);
1311 state->msg = strbuf_detach(&msg, &state->msg_len);
1314 strbuf_release(&msg);
1315 strbuf_release(&author_date);
1316 strbuf_release(&author_email);
1317 strbuf_release(&author_name);
1318 strbuf_release(&sb);
1319 clear_mailinfo(&mi);
1324 * Sets commit_id to the commit hash where the mail was generated from.
1325 * Returns 0 on success, -1 on failure.
1327 static int get_mail_commit_oid(struct object_id *commit_id, const char *mail)
1329 struct strbuf sb = STRBUF_INIT;
1330 FILE *fp = xfopen(mail, "r");
1334 if (strbuf_getline_lf(&sb, fp) ||
1335 !skip_prefix(sb.buf, "From ", &x) ||
1336 get_oid_hex(x, commit_id) < 0)
1339 strbuf_release(&sb);
1345 * Sets state->msg, state->author_name, state->author_email, state->author_date
1346 * to the commit's respective info.
1348 static void get_commit_info(struct am_state *state, struct commit *commit)
1350 const char *buffer, *ident_line, *msg;
1352 struct ident_split id;
1354 buffer = logmsg_reencode(commit, NULL, get_commit_output_encoding());
1356 ident_line = find_commit_header(buffer, "author", &ident_len);
1358 if (split_ident_line(&id, ident_line, ident_len) < 0)
1359 die(_("invalid ident line: %.*s"), (int)ident_len, ident_line);
1361 assert(!state->author_name);
1363 state->author_name =
1364 xmemdupz(id.name_begin, id.name_end - id.name_begin);
1366 state->author_name = xstrdup("");
1368 assert(!state->author_email);
1370 state->author_email =
1371 xmemdupz(id.mail_begin, id.mail_end - id.mail_begin);
1373 state->author_email = xstrdup("");
1375 assert(!state->author_date);
1376 state->author_date = xstrdup(show_ident_date(&id, DATE_MODE(NORMAL)));
1378 assert(!state->msg);
1379 msg = strstr(buffer, "\n\n");
1381 die(_("unable to parse commit %s"), oid_to_hex(&commit->object.oid));
1382 state->msg = xstrdup(msg + 2);
1383 state->msg_len = strlen(state->msg);
1384 unuse_commit_buffer(commit, buffer);
1388 * Writes `commit` as a patch to the state directory's "patch" file.
1390 static void write_commit_patch(const struct am_state *state, struct commit *commit)
1392 struct rev_info rev_info;
1395 fp = xfopen(am_path(state, "patch"), "w");
1396 init_revisions(&rev_info, NULL);
1398 rev_info.abbrev = 0;
1399 rev_info.disable_stdin = 1;
1400 rev_info.show_root_diff = 1;
1401 rev_info.diffopt.output_format = DIFF_FORMAT_PATCH;
1402 rev_info.no_commit_id = 1;
1403 DIFF_OPT_SET(&rev_info.diffopt, BINARY);
1404 DIFF_OPT_SET(&rev_info.diffopt, FULL_INDEX);
1405 rev_info.diffopt.use_color = 0;
1406 rev_info.diffopt.file = fp;
1407 rev_info.diffopt.close_file = 1;
1408 add_pending_object(&rev_info, &commit->object, "");
1409 diff_setup_done(&rev_info.diffopt);
1410 log_tree_commit(&rev_info, commit);
1414 * Writes the diff of the index against HEAD as a patch to the state
1415 * directory's "patch" file.
1417 static void write_index_patch(const struct am_state *state)
1420 struct object_id head;
1421 struct rev_info rev_info;
1424 if (!get_oid_tree("HEAD", &head))
1425 tree = lookup_tree(&head);
1427 tree = lookup_tree(&empty_tree_oid);
1429 fp = xfopen(am_path(state, "patch"), "w");
1430 init_revisions(&rev_info, NULL);
1432 rev_info.disable_stdin = 1;
1433 rev_info.no_commit_id = 1;
1434 rev_info.diffopt.output_format = DIFF_FORMAT_PATCH;
1435 rev_info.diffopt.use_color = 0;
1436 rev_info.diffopt.file = fp;
1437 rev_info.diffopt.close_file = 1;
1438 add_pending_object(&rev_info, &tree->object, "");
1439 diff_setup_done(&rev_info.diffopt);
1440 run_diff_index(&rev_info, 1);
1444 * Like parse_mail(), but parses the mail by looking up its commit ID
1445 * directly. This is used in --rebasing mode to bypass git-mailinfo's munging
1448 * state->orig_commit will be set to the original commit ID.
1450 * Will always return 0 as the patch should never be skipped.
1452 static int parse_mail_rebase(struct am_state *state, const char *mail)
1454 struct commit *commit;
1455 struct object_id commit_oid;
1457 if (get_mail_commit_oid(&commit_oid, mail) < 0)
1458 die(_("could not parse %s"), mail);
1460 commit = lookup_commit_or_die(&commit_oid, mail);
1462 get_commit_info(state, commit);
1464 write_commit_patch(state, commit);
1466 oidcpy(&state->orig_commit, &commit_oid);
1467 write_state_text(state, "original-commit", oid_to_hex(&commit_oid));
1473 * Applies current patch with git-apply. Returns 0 on success, -1 otherwise. If
1474 * `index_file` is not NULL, the patch will be applied to that index.
1476 static int run_apply(const struct am_state *state, const char *index_file)
1478 struct argv_array apply_paths = ARGV_ARRAY_INIT;
1479 struct argv_array apply_opts = ARGV_ARRAY_INIT;
1480 struct apply_state apply_state;
1482 static struct lock_file lock_file;
1483 int force_apply = 0;
1486 if (init_apply_state(&apply_state, NULL, &lock_file))
1487 die("BUG: init_apply_state() failed");
1489 argv_array_push(&apply_opts, "apply");
1490 argv_array_pushv(&apply_opts, state->git_apply_opts.argv);
1492 opts_left = apply_parse_options(apply_opts.argc, apply_opts.argv,
1493 &apply_state, &force_apply, &options,
1497 die("unknown option passed through to git apply");
1500 apply_state.index_file = index_file;
1501 apply_state.cached = 1;
1503 apply_state.check_index = 1;
1506 * If we are allowed to fall back on 3-way merge, don't give false
1507 * errors during the initial attempt.
1509 if (state->threeway && !index_file)
1510 apply_state.apply_verbosity = verbosity_silent;
1512 if (check_apply_state(&apply_state, force_apply))
1513 die("BUG: check_apply_state() failed");
1515 argv_array_push(&apply_paths, am_path(state, "patch"));
1517 res = apply_all_patches(&apply_state, apply_paths.argc, apply_paths.argv, options);
1519 argv_array_clear(&apply_paths);
1520 argv_array_clear(&apply_opts);
1521 clear_apply_state(&apply_state);
1527 /* Reload index as apply_all_patches() will have modified it. */
1529 read_cache_from(index_file);
1536 * Builds an index that contains just the blobs needed for a 3way merge.
1538 static int build_fake_ancestor(const struct am_state *state, const char *index_file)
1540 struct child_process cp = CHILD_PROCESS_INIT;
1543 argv_array_push(&cp.args, "apply");
1544 argv_array_pushv(&cp.args, state->git_apply_opts.argv);
1545 argv_array_pushf(&cp.args, "--build-fake-ancestor=%s", index_file);
1546 argv_array_push(&cp.args, am_path(state, "patch"));
1548 if (run_command(&cp))
1555 * Attempt a threeway merge, using index_path as the temporary index.
1557 static int fall_back_threeway(const struct am_state *state, const char *index_path)
1559 struct object_id orig_tree, their_tree, our_tree;
1560 const struct object_id *bases[1] = { &orig_tree };
1561 struct merge_options o;
1562 struct commit *result;
1563 char *their_tree_name;
1565 if (get_oid("HEAD", &our_tree) < 0)
1566 hashcpy(our_tree.hash, EMPTY_TREE_SHA1_BIN);
1568 if (build_fake_ancestor(state, index_path))
1569 return error("could not build fake ancestor");
1572 read_cache_from(index_path);
1574 if (write_index_as_tree(orig_tree.hash, &the_index, index_path, 0, NULL))
1575 return error(_("Repository lacks necessary blobs to fall back on 3-way merge."));
1577 say(state, stdout, _("Using index info to reconstruct a base tree..."));
1579 if (!state->quiet) {
1581 * List paths that needed 3-way fallback, so that the user can
1582 * review them with extra care to spot mismerges.
1584 struct rev_info rev_info;
1585 const char *diff_filter_str = "--diff-filter=AM";
1587 init_revisions(&rev_info, NULL);
1588 rev_info.diffopt.output_format = DIFF_FORMAT_NAME_STATUS;
1589 diff_opt_parse(&rev_info.diffopt, &diff_filter_str, 1, rev_info.prefix);
1590 add_pending_oid(&rev_info, "HEAD", &our_tree, 0);
1591 diff_setup_done(&rev_info.diffopt);
1592 run_diff_index(&rev_info, 1);
1595 if (run_apply(state, index_path))
1596 return error(_("Did you hand edit your patch?\n"
1597 "It does not apply to blobs recorded in its index."));
1599 if (write_index_as_tree(their_tree.hash, &the_index, index_path, 0, NULL))
1600 return error("could not write tree");
1602 say(state, stdout, _("Falling back to patching base and 3-way merge..."));
1608 * This is not so wrong. Depending on which base we picked, orig_tree
1609 * may be wildly different from ours, but their_tree has the same set of
1610 * wildly different changes in parts the patch did not touch, so
1611 * recursive ends up canceling them, saying that we reverted all those
1615 init_merge_options(&o);
1618 their_tree_name = xstrfmt("%.*s", linelen(state->msg), state->msg);
1619 o.branch2 = their_tree_name;
1624 if (merge_recursive_generic(&o, &our_tree, &their_tree, 1, bases, &result)) {
1625 rerere(state->allow_rerere_autoupdate);
1626 free(their_tree_name);
1627 return error(_("Failed to merge in the changes."));
1630 free(their_tree_name);
1635 * Commits the current index with state->msg as the commit message and
1636 * state->author_name, state->author_email and state->author_date as the author
1639 static void do_commit(const struct am_state *state)
1641 struct object_id tree, parent, commit;
1642 const struct object_id *old_oid;
1643 struct commit_list *parents = NULL;
1644 const char *reflog_msg, *author;
1645 struct strbuf sb = STRBUF_INIT;
1647 if (run_hook_le(NULL, "pre-applypatch", NULL))
1650 if (write_cache_as_tree(tree.hash, 0, NULL))
1651 die(_("git write-tree failed to write a tree"));
1653 if (!get_oid_commit("HEAD", &parent)) {
1655 commit_list_insert(lookup_commit(&parent), &parents);
1658 say(state, stderr, _("applying to an empty history"));
1661 author = fmt_ident(state->author_name, state->author_email,
1662 state->ignore_date ? NULL : state->author_date,
1665 if (state->committer_date_is_author_date)
1666 setenv("GIT_COMMITTER_DATE",
1667 state->ignore_date ? "" : state->author_date, 1);
1669 if (commit_tree(state->msg, state->msg_len, tree.hash, parents, commit.hash,
1670 author, state->sign_commit))
1671 die(_("failed to write commit object"));
1673 reflog_msg = getenv("GIT_REFLOG_ACTION");
1677 strbuf_addf(&sb, "%s: %.*s", reflog_msg, linelen(state->msg),
1680 update_ref_oid(sb.buf, "HEAD", &commit, old_oid, 0,
1681 UPDATE_REFS_DIE_ON_ERR);
1683 if (state->rebasing) {
1684 FILE *fp = xfopen(am_path(state, "rewritten"), "a");
1686 assert(!is_null_oid(&state->orig_commit));
1687 fprintf(fp, "%s ", oid_to_hex(&state->orig_commit));
1688 fprintf(fp, "%s\n", oid_to_hex(&commit));
1692 run_hook_le(NULL, "post-applypatch", NULL);
1694 strbuf_release(&sb);
1698 * Validates the am_state for resuming -- the "msg" and authorship fields must
1701 static void validate_resume_state(const struct am_state *state)
1704 die(_("cannot resume: %s does not exist."),
1705 am_path(state, "final-commit"));
1707 if (!state->author_name || !state->author_email || !state->author_date)
1708 die(_("cannot resume: %s does not exist."),
1709 am_path(state, "author-script"));
1713 * Interactively prompt the user on whether the current patch should be
1716 * Returns 0 if the user chooses to apply the patch, 1 if the user chooses to
1719 static int do_interactive(struct am_state *state)
1724 die(_("cannot be interactive without stdin connected to a terminal."));
1729 puts(_("Commit Body is:"));
1730 puts("--------------------------");
1731 printf("%s", state->msg);
1732 puts("--------------------------");
1735 * TRANSLATORS: Make sure to include [y], [n], [e], [v] and [a]
1736 * in your translation. The program will only accept English
1737 * input at this point.
1739 reply = git_prompt(_("Apply? [y]es/[n]o/[e]dit/[v]iew patch/[a]ccept all: "), PROMPT_ECHO);
1743 } else if (*reply == 'y' || *reply == 'Y') {
1745 } else if (*reply == 'a' || *reply == 'A') {
1746 state->interactive = 0;
1748 } else if (*reply == 'n' || *reply == 'N') {
1750 } else if (*reply == 'e' || *reply == 'E') {
1751 struct strbuf msg = STRBUF_INIT;
1753 if (!launch_editor(am_path(state, "final-commit"), &msg, NULL)) {
1755 state->msg = strbuf_detach(&msg, &state->msg_len);
1757 strbuf_release(&msg);
1758 } else if (*reply == 'v' || *reply == 'V') {
1759 const char *pager = git_pager(1);
1760 struct child_process cp = CHILD_PROCESS_INIT;
1764 prepare_pager_args(&cp, pager);
1765 argv_array_push(&cp.args, am_path(state, "patch"));
1772 * Applies all queued mail.
1774 * If `resume` is true, we are "resuming". The "msg" and authorship fields, as
1775 * well as the state directory's "patch" file is used as-is for applying the
1776 * patch and committing it.
1778 static void am_run(struct am_state *state, int resume)
1780 const char *argv_gc_auto[] = {"gc", "--auto", NULL};
1781 struct strbuf sb = STRBUF_INIT;
1783 unlink(am_path(state, "dirtyindex"));
1785 refresh_and_write_cache();
1787 if (index_has_changes(&sb)) {
1788 write_state_bool(state, "dirtyindex", 1);
1789 die(_("Dirty index: cannot apply patches (dirty: %s)"), sb.buf);
1792 strbuf_release(&sb);
1794 while (state->cur <= state->last) {
1795 const char *mail = am_path(state, msgnum(state));
1800 if (!file_exists(mail))
1804 validate_resume_state(state);
1808 if (state->rebasing)
1809 skip = parse_mail_rebase(state, mail);
1811 skip = parse_mail(state, mail);
1814 goto next; /* mail should be skipped */
1817 am_append_signoff(state);
1819 write_author_script(state);
1820 write_commit_msg(state);
1823 if (state->interactive && do_interactive(state))
1826 if (run_applypatch_msg_hook(state))
1829 say(state, stdout, _("Applying: %.*s"), linelen(state->msg), state->msg);
1831 apply_status = run_apply(state, NULL);
1833 if (apply_status && state->threeway) {
1834 struct strbuf sb = STRBUF_INIT;
1836 strbuf_addstr(&sb, am_path(state, "patch-merge-index"));
1837 apply_status = fall_back_threeway(state, sb.buf);
1838 strbuf_release(&sb);
1841 * Applying the patch to an earlier tree and merging
1842 * the result may have produced the same tree as ours.
1844 if (!apply_status && !index_has_changes(NULL)) {
1845 say(state, stdout, _("No changes -- Patch already applied."));
1851 int advice_amworkdir = 1;
1853 printf_ln(_("Patch failed at %s %.*s"), msgnum(state),
1854 linelen(state->msg), state->msg);
1856 git_config_get_bool("advice.amworkdir", &advice_amworkdir);
1858 if (advice_amworkdir)
1859 printf_ln(_("The copy of the patch that failed is found in: %s"),
1860 am_path(state, "patch"));
1862 die_user_resolve(state);
1875 if (!is_empty_file(am_path(state, "rewritten"))) {
1876 assert(state->rebasing);
1877 copy_notes_for_rebase(state);
1878 run_post_rewrite_hook(state);
1882 * In rebasing mode, it's up to the caller to take care of
1885 if (!state->rebasing) {
1888 run_command_v_opt(argv_gc_auto, RUN_GIT_CMD);
1893 * Resume the current am session after patch application failure. The user did
1894 * all the hard work, and we do not have to do any patch application. Just
1895 * trust and commit what the user has in the index and working tree.
1897 static void am_resolve(struct am_state *state)
1899 validate_resume_state(state);
1901 say(state, stdout, _("Applying: %.*s"), linelen(state->msg), state->msg);
1903 if (!index_has_changes(NULL)) {
1904 printf_ln(_("No changes - did you forget to use 'git add'?\n"
1905 "If there is nothing left to stage, chances are that something else\n"
1906 "already introduced the same changes; you might want to skip this patch."));
1907 die_user_resolve(state);
1910 if (unmerged_cache()) {
1911 printf_ln(_("You still have unmerged paths in your index.\n"
1912 "You should 'git add' each file with resolved conflicts to mark them as such.\n"
1913 "You might run `git rm` on a file to accept \"deleted by them\" for it."));
1914 die_user_resolve(state);
1917 if (state->interactive) {
1918 write_index_patch(state);
1919 if (do_interactive(state))
1934 * Performs a checkout fast-forward from `head` to `remote`. If `reset` is
1935 * true, any unmerged entries will be discarded. Returns 0 on success, -1 on
1938 static int fast_forward_to(struct tree *head, struct tree *remote, int reset)
1940 struct lock_file *lock_file;
1941 struct unpack_trees_options opts;
1942 struct tree_desc t[2];
1944 if (parse_tree(head) || parse_tree(remote))
1947 lock_file = xcalloc(1, sizeof(struct lock_file));
1948 hold_locked_index(lock_file, LOCK_DIE_ON_ERROR);
1950 refresh_cache(REFRESH_QUIET);
1952 memset(&opts, 0, sizeof(opts));
1954 opts.src_index = &the_index;
1955 opts.dst_index = &the_index;
1959 opts.fn = twoway_merge;
1960 init_tree_desc(&t[0], head->buffer, head->size);
1961 init_tree_desc(&t[1], remote->buffer, remote->size);
1963 if (unpack_trees(2, t, &opts)) {
1964 rollback_lock_file(lock_file);
1968 if (write_locked_index(&the_index, lock_file, COMMIT_LOCK))
1969 die(_("unable to write new index file"));
1975 * Merges a tree into the index. The index's stat info will take precedence
1976 * over the merged tree's. Returns 0 on success, -1 on failure.
1978 static int merge_tree(struct tree *tree)
1980 struct lock_file *lock_file;
1981 struct unpack_trees_options opts;
1982 struct tree_desc t[1];
1984 if (parse_tree(tree))
1987 lock_file = xcalloc(1, sizeof(struct lock_file));
1988 hold_locked_index(lock_file, LOCK_DIE_ON_ERROR);
1990 memset(&opts, 0, sizeof(opts));
1992 opts.src_index = &the_index;
1993 opts.dst_index = &the_index;
1995 opts.fn = oneway_merge;
1996 init_tree_desc(&t[0], tree->buffer, tree->size);
1998 if (unpack_trees(1, t, &opts)) {
1999 rollback_lock_file(lock_file);
2003 if (write_locked_index(&the_index, lock_file, COMMIT_LOCK))
2004 die(_("unable to write new index file"));
2010 * Clean the index without touching entries that are not modified between
2011 * `head` and `remote`.
2013 static int clean_index(const struct object_id *head, const struct object_id *remote)
2015 struct tree *head_tree, *remote_tree, *index_tree;
2016 struct object_id index;
2018 head_tree = parse_tree_indirect(head);
2020 return error(_("Could not parse object '%s'."), oid_to_hex(head));
2022 remote_tree = parse_tree_indirect(remote);
2024 return error(_("Could not parse object '%s'."), oid_to_hex(remote));
2026 read_cache_unmerged();
2028 if (fast_forward_to(head_tree, head_tree, 1))
2031 if (write_cache_as_tree(index.hash, 0, NULL))
2034 index_tree = parse_tree_indirect(&index);
2036 return error(_("Could not parse object '%s'."), oid_to_hex(&index));
2038 if (fast_forward_to(index_tree, remote_tree, 0))
2041 if (merge_tree(remote_tree))
2044 remove_branch_state();
2050 * Resets rerere's merge resolution metadata.
2052 static void am_rerere_clear(void)
2054 struct string_list merge_rr = STRING_LIST_INIT_DUP;
2055 rerere_clear(&merge_rr);
2056 string_list_clear(&merge_rr, 1);
2060 * Resume the current am session by skipping the current patch.
2062 static void am_skip(struct am_state *state)
2064 struct object_id head;
2068 if (get_oid("HEAD", &head))
2069 hashcpy(head.hash, EMPTY_TREE_SHA1_BIN);
2071 if (clean_index(&head, &head))
2072 die(_("failed to clean index"));
2080 * Returns true if it is safe to reset HEAD to the ORIG_HEAD, false otherwise.
2082 * It is not safe to reset HEAD when:
2083 * 1. git-am previously failed because the index was dirty.
2084 * 2. HEAD has moved since git-am previously failed.
2086 static int safe_to_abort(const struct am_state *state)
2088 struct strbuf sb = STRBUF_INIT;
2089 struct object_id abort_safety, head;
2091 if (file_exists(am_path(state, "dirtyindex")))
2094 if (read_state_file(&sb, state, "abort-safety", 1) > 0) {
2095 if (get_oid_hex(sb.buf, &abort_safety))
2096 die(_("could not parse %s"), am_path(state, "abort-safety"));
2098 oidclr(&abort_safety);
2100 if (get_oid("HEAD", &head))
2103 if (!oidcmp(&head, &abort_safety))
2106 warning(_("You seem to have moved HEAD since the last 'am' failure.\n"
2107 "Not rewinding to ORIG_HEAD"));
2113 * Aborts the current am session if it is safe to do so.
2115 static void am_abort(struct am_state *state)
2117 struct object_id curr_head, orig_head;
2118 int has_curr_head, has_orig_head;
2121 if (!safe_to_abort(state)) {
2128 curr_branch = resolve_refdup("HEAD", 0, curr_head.hash, NULL);
2129 has_curr_head = curr_branch && !is_null_oid(&curr_head);
2131 hashcpy(curr_head.hash, EMPTY_TREE_SHA1_BIN);
2133 has_orig_head = !get_oid("ORIG_HEAD", &orig_head);
2135 hashcpy(orig_head.hash, EMPTY_TREE_SHA1_BIN);
2137 clean_index(&curr_head, &orig_head);
2140 update_ref_oid("am --abort", "HEAD", &orig_head,
2141 has_curr_head ? &curr_head : NULL, 0,
2142 UPDATE_REFS_DIE_ON_ERR);
2143 else if (curr_branch)
2144 delete_ref(NULL, curr_branch, NULL, REF_NODEREF);
2151 * parse_options() callback that validates and sets opt->value to the
2152 * PATCH_FORMAT_* enum value corresponding to `arg`.
2154 static int parse_opt_patchformat(const struct option *opt, const char *arg, int unset)
2156 int *opt_value = opt->value;
2158 if (!strcmp(arg, "mbox"))
2159 *opt_value = PATCH_FORMAT_MBOX;
2160 else if (!strcmp(arg, "stgit"))
2161 *opt_value = PATCH_FORMAT_STGIT;
2162 else if (!strcmp(arg, "stgit-series"))
2163 *opt_value = PATCH_FORMAT_STGIT_SERIES;
2164 else if (!strcmp(arg, "hg"))
2165 *opt_value = PATCH_FORMAT_HG;
2166 else if (!strcmp(arg, "mboxrd"))
2167 *opt_value = PATCH_FORMAT_MBOXRD;
2169 return error(_("Invalid value for --patch-format: %s"), arg);
2181 static int git_am_config(const char *k, const char *v, void *cb)
2185 status = git_gpg_config(k, v, NULL);
2189 return git_default_config(k, v, NULL);
2192 int cmd_am(int argc, const char **argv, const char *prefix)
2194 struct am_state state;
2197 int patch_format = PATCH_FORMAT_UNKNOWN;
2198 enum resume_mode resume = RESUME_FALSE;
2201 const char * const usage[] = {
2202 N_("git am [<options>] [(<mbox> | <Maildir>)...]"),
2203 N_("git am [<options>] (--continue | --skip | --abort)"),
2207 struct option options[] = {
2208 OPT_BOOL('i', "interactive", &state.interactive,
2209 N_("run interactively")),
2210 OPT_HIDDEN_BOOL('b', "binary", &binary,
2211 N_("historical option -- no-op")),
2212 OPT_BOOL('3', "3way", &state.threeway,
2213 N_("allow fall back on 3way merging if needed")),
2214 OPT__QUIET(&state.quiet, N_("be quiet")),
2215 OPT_SET_INT('s', "signoff", &state.signoff,
2216 N_("add a Signed-off-by line to the commit message"),
2218 OPT_BOOL('u', "utf8", &state.utf8,
2219 N_("recode into utf8 (default)")),
2220 OPT_SET_INT('k', "keep", &state.keep,
2221 N_("pass -k flag to git-mailinfo"), KEEP_TRUE),
2222 OPT_SET_INT(0, "keep-non-patch", &state.keep,
2223 N_("pass -b flag to git-mailinfo"), KEEP_NON_PATCH),
2224 OPT_BOOL('m', "message-id", &state.message_id,
2225 N_("pass -m flag to git-mailinfo")),
2226 { OPTION_SET_INT, 0, "keep-cr", &keep_cr, NULL,
2227 N_("pass --keep-cr flag to git-mailsplit for mbox format"),
2228 PARSE_OPT_NOARG | PARSE_OPT_NONEG, NULL, 1},
2229 { OPTION_SET_INT, 0, "no-keep-cr", &keep_cr, NULL,
2230 N_("do not pass --keep-cr flag to git-mailsplit independent of am.keepcr"),
2231 PARSE_OPT_NOARG | PARSE_OPT_NONEG, NULL, 0},
2232 OPT_BOOL('c', "scissors", &state.scissors,
2233 N_("strip everything before a scissors line")),
2234 OPT_PASSTHRU_ARGV(0, "whitespace", &state.git_apply_opts, N_("action"),
2235 N_("pass it through git-apply"),
2237 OPT_PASSTHRU_ARGV(0, "ignore-space-change", &state.git_apply_opts, NULL,
2238 N_("pass it through git-apply"),
2240 OPT_PASSTHRU_ARGV(0, "ignore-whitespace", &state.git_apply_opts, NULL,
2241 N_("pass it through git-apply"),
2243 OPT_PASSTHRU_ARGV(0, "directory", &state.git_apply_opts, N_("root"),
2244 N_("pass it through git-apply"),
2246 OPT_PASSTHRU_ARGV(0, "exclude", &state.git_apply_opts, N_("path"),
2247 N_("pass it through git-apply"),
2249 OPT_PASSTHRU_ARGV(0, "include", &state.git_apply_opts, N_("path"),
2250 N_("pass it through git-apply"),
2252 OPT_PASSTHRU_ARGV('C', NULL, &state.git_apply_opts, N_("n"),
2253 N_("pass it through git-apply"),
2255 OPT_PASSTHRU_ARGV('p', NULL, &state.git_apply_opts, N_("num"),
2256 N_("pass it through git-apply"),
2258 OPT_CALLBACK(0, "patch-format", &patch_format, N_("format"),
2259 N_("format the patch(es) are in"),
2260 parse_opt_patchformat),
2261 OPT_PASSTHRU_ARGV(0, "reject", &state.git_apply_opts, NULL,
2262 N_("pass it through git-apply"),
2264 OPT_STRING(0, "resolvemsg", &state.resolvemsg, NULL,
2265 N_("override error message when patch failure occurs")),
2266 OPT_CMDMODE(0, "continue", &resume,
2267 N_("continue applying patches after resolving a conflict"),
2269 OPT_CMDMODE('r', "resolved", &resume,
2270 N_("synonyms for --continue"),
2272 OPT_CMDMODE(0, "skip", &resume,
2273 N_("skip the current patch"),
2275 OPT_CMDMODE(0, "abort", &resume,
2276 N_("restore the original branch and abort the patching operation."),
2278 OPT_BOOL(0, "committer-date-is-author-date",
2279 &state.committer_date_is_author_date,
2280 N_("lie about committer date")),
2281 OPT_BOOL(0, "ignore-date", &state.ignore_date,
2282 N_("use current timestamp for author date")),
2283 OPT_RERERE_AUTOUPDATE(&state.allow_rerere_autoupdate),
2284 { OPTION_STRING, 'S', "gpg-sign", &state.sign_commit, N_("key-id"),
2285 N_("GPG-sign commits"),
2286 PARSE_OPT_OPTARG, NULL, (intptr_t) "" },
2287 OPT_HIDDEN_BOOL(0, "rebasing", &state.rebasing,
2288 N_("(internal use for git-rebase)")),
2292 if (argc == 2 && !strcmp(argv[1], "-h"))
2293 usage_with_options(usage, options);
2295 git_config(git_am_config, NULL);
2297 am_state_init(&state);
2299 in_progress = am_in_progress(&state);
2303 argc = parse_options(argc, argv, prefix, options, usage, 0);
2306 fprintf_ln(stderr, _("The -b/--binary option has been a no-op for long time, and\n"
2307 "it will be removed. Please do not use it anymore."));
2309 /* Ensure a valid committer ident can be constructed */
2310 git_committer_info(IDENT_STRICT);
2312 if (read_index_preload(&the_index, NULL) < 0)
2313 die(_("failed to read the index"));
2317 * Catch user error to feed us patches when there is a session
2320 * 1. mbox path(s) are provided on the command-line.
2321 * 2. stdin is not a tty: the user is trying to feed us a patch
2322 * from standard input. This is somewhat unreliable -- stdin
2323 * could be /dev/null for example and the caller did not
2324 * intend to feed us a patch but wanted to continue
2327 if (argc || (resume == RESUME_FALSE && !isatty(0)))
2328 die(_("previous rebase directory %s still exists but mbox given."),
2331 if (resume == RESUME_FALSE)
2332 resume = RESUME_APPLY;
2334 if (state.signoff == SIGNOFF_EXPLICIT)
2335 am_append_signoff(&state);
2337 struct argv_array paths = ARGV_ARRAY_INIT;
2341 * Handle stray state directory in the independent-run case. In
2342 * the --rebasing case, it is up to the caller to take care of
2343 * stray directories.
2345 if (file_exists(state.dir) && !state.rebasing) {
2346 if (resume == RESUME_ABORT) {
2348 am_state_release(&state);
2352 die(_("Stray %s directory found.\n"
2353 "Use \"git am --abort\" to remove it."),
2358 die(_("Resolve operation not in progress, we are not resuming."));
2360 for (i = 0; i < argc; i++) {
2361 if (is_absolute_path(argv[i]) || !prefix)
2362 argv_array_push(&paths, argv[i]);
2364 argv_array_push(&paths, mkpath("%s/%s", prefix, argv[i]));
2367 am_setup(&state, patch_format, paths.argv, keep_cr);
2369 argv_array_clear(&paths);
2379 case RESUME_RESOLVED:
2389 die("BUG: invalid resume value");
2392 am_state_release(&state);