4 * Copyright (c) 2008 Miklos Vajna <vmiklos@frugalware.org>
6 * Based on git-merge.sh by Junio C Hamano.
10 #include "parse-options.h"
12 #include "run-command.h"
18 #include "unpack-trees.h"
19 #include "cache-tree.h"
26 #include "merge-recursive.h"
27 #include "resolve-undo.h"
29 #include "fmt-merge-msg.h"
30 #include "gpg-interface.h"
32 #define DEFAULT_TWOHEAD (1<<0)
33 #define DEFAULT_OCTOPUS (1<<1)
34 #define NO_FAST_FORWARD (1<<2)
35 #define NO_TRIVIAL (1<<3)
42 static const char * const builtin_merge_usage
[] = {
43 N_("git merge [options] [<commit>...]"),
44 N_("git merge [options] <msg> HEAD <commit>"),
45 N_("git merge --abort"),
49 static int show_diffstat
= 1, shortlog_len
= -1, squash
;
50 static int option_commit
= 1;
51 static int option_edit
= -1;
52 static int allow_trivial
= 1, have_message
, verify_signatures
;
53 static int overwrite_ignore
= 1;
54 static struct strbuf merge_msg
= STRBUF_INIT
;
55 static struct strategy
**use_strategies
;
56 static size_t use_strategies_nr
, use_strategies_alloc
;
57 static const char **xopts
;
58 static size_t xopts_nr
, xopts_alloc
;
59 static const char *branch
;
60 static char *branch_mergeoptions
;
61 static int option_renormalize
;
63 static int allow_rerere_auto
;
64 static int abort_current_merge
;
65 static int show_progress
= -1;
66 static int default_to_upstream
;
67 static const char *sign_commit
;
69 static struct strategy all_strategy
[] = {
70 { "recursive", DEFAULT_TWOHEAD
| NO_TRIVIAL
},
71 { "octopus", DEFAULT_OCTOPUS
},
73 { "ours", NO_FAST_FORWARD
| NO_TRIVIAL
},
74 { "subtree", NO_FAST_FORWARD
| NO_TRIVIAL
},
77 static const char *pull_twohead
, *pull_octopus
;
85 static enum ff_type fast_forward
= FF_ALLOW
;
87 static int option_parse_message(const struct option
*opt
,
88 const char *arg
, int unset
)
90 struct strbuf
*buf
= opt
->value
;
93 strbuf_setlen(buf
, 0);
95 strbuf_addf(buf
, "%s%s", buf
->len
? "\n\n" : "", arg
);
98 return error(_("switch `m' requires a value"));
102 static struct strategy
*get_strategy(const char *name
)
105 struct strategy
*ret
;
106 static struct cmdnames main_cmds
, other_cmds
;
112 for (i
= 0; i
< ARRAY_SIZE(all_strategy
); i
++)
113 if (!strcmp(name
, all_strategy
[i
].name
))
114 return &all_strategy
[i
];
117 struct cmdnames not_strategies
;
120 memset(¬_strategies
, 0, sizeof(struct cmdnames
));
121 load_command_list("git-merge-", &main_cmds
, &other_cmds
);
122 for (i
= 0; i
< main_cmds
.cnt
; i
++) {
124 struct cmdname
*ent
= main_cmds
.names
[i
];
125 for (j
= 0; j
< ARRAY_SIZE(all_strategy
); j
++)
126 if (!strncmp(ent
->name
, all_strategy
[j
].name
, ent
->len
)
127 && !all_strategy
[j
].name
[ent
->len
])
130 add_cmdname(¬_strategies
, ent
->name
, ent
->len
);
132 exclude_cmds(&main_cmds
, ¬_strategies
);
134 if (!is_in_cmdlist(&main_cmds
, name
) && !is_in_cmdlist(&other_cmds
, name
)) {
135 fprintf(stderr
, _("Could not find merge strategy '%s'.\n"), name
);
136 fprintf(stderr
, _("Available strategies are:"));
137 for (i
= 0; i
< main_cmds
.cnt
; i
++)
138 fprintf(stderr
, " %s", main_cmds
.names
[i
]->name
);
139 fprintf(stderr
, ".\n");
140 if (other_cmds
.cnt
) {
141 fprintf(stderr
, _("Available custom strategies are:"));
142 for (i
= 0; i
< other_cmds
.cnt
; i
++)
143 fprintf(stderr
, " %s", other_cmds
.names
[i
]->name
);
144 fprintf(stderr
, ".\n");
149 ret
= xcalloc(1, sizeof(struct strategy
));
150 ret
->name
= xstrdup(name
);
151 ret
->attr
= NO_TRIVIAL
;
155 static void append_strategy(struct strategy
*s
)
157 ALLOC_GROW(use_strategies
, use_strategies_nr
+ 1, use_strategies_alloc
);
158 use_strategies
[use_strategies_nr
++] = s
;
161 static int option_parse_strategy(const struct option
*opt
,
162 const char *name
, int unset
)
167 append_strategy(get_strategy(name
));
171 static int option_parse_x(const struct option
*opt
,
172 const char *arg
, int unset
)
177 ALLOC_GROW(xopts
, xopts_nr
+ 1, xopts_alloc
);
178 xopts
[xopts_nr
++] = xstrdup(arg
);
182 static int option_parse_n(const struct option
*opt
,
183 const char *arg
, int unset
)
185 show_diffstat
= unset
;
189 static struct option builtin_merge_options
[] = {
190 { OPTION_CALLBACK
, 'n', NULL
, NULL
, NULL
,
191 N_("do not show a diffstat at the end of the merge"),
192 PARSE_OPT_NOARG
, option_parse_n
},
193 OPT_BOOL(0, "stat", &show_diffstat
,
194 N_("show a diffstat at the end of the merge")),
195 OPT_BOOL(0, "summary", &show_diffstat
, N_("(synonym to --stat)")),
196 { OPTION_INTEGER
, 0, "log", &shortlog_len
, N_("n"),
197 N_("add (at most <n>) entries from shortlog to merge commit message"),
198 PARSE_OPT_OPTARG
, NULL
, DEFAULT_MERGE_LOG_LEN
},
199 OPT_BOOL(0, "squash", &squash
,
200 N_("create a single commit instead of doing a merge")),
201 OPT_BOOL(0, "commit", &option_commit
,
202 N_("perform a commit if the merge succeeds (default)")),
203 OPT_BOOL('e', "edit", &option_edit
,
204 N_("edit message before committing")),
205 OPT_SET_INT(0, "ff", &fast_forward
, N_("allow fast-forward (default)"), FF_ALLOW
),
206 { OPTION_SET_INT
, 0, "ff-only", &fast_forward
, NULL
,
207 N_("abort if fast-forward is not possible"),
208 PARSE_OPT_NOARG
| PARSE_OPT_NONEG
, NULL
, FF_ONLY
},
209 OPT_RERERE_AUTOUPDATE(&allow_rerere_auto
),
210 OPT_BOOL(0, "verify-signatures", &verify_signatures
,
211 N_("Verify that the named commit has a valid GPG signature")),
212 OPT_CALLBACK('s', "strategy", &use_strategies
, N_("strategy"),
213 N_("merge strategy to use"), option_parse_strategy
),
214 OPT_CALLBACK('X', "strategy-option", &xopts
, N_("option=value"),
215 N_("option for selected merge strategy"), option_parse_x
),
216 OPT_CALLBACK('m', "message", &merge_msg
, N_("message"),
217 N_("merge commit message (for a non-fast-forward merge)"),
218 option_parse_message
),
219 OPT__VERBOSITY(&verbosity
),
220 OPT_BOOL(0, "abort", &abort_current_merge
,
221 N_("abort the current in-progress merge")),
222 OPT_SET_INT(0, "progress", &show_progress
, N_("force progress reporting"), 1),
223 { OPTION_STRING
, 'S', "gpg-sign", &sign_commit
, N_("key id"),
224 N_("GPG sign commit"), PARSE_OPT_OPTARG
, NULL
, (intptr_t) "" },
225 OPT_BOOL(0, "overwrite-ignore", &overwrite_ignore
, N_("update ignored files (default)")),
229 /* Cleans up metadata that is uninteresting after a succeeded merge. */
230 static void drop_save(void)
232 unlink(git_path("MERGE_HEAD"));
233 unlink(git_path("MERGE_MSG"));
234 unlink(git_path("MERGE_MODE"));
237 static int save_state(unsigned char *stash
)
240 struct child_process cp
;
241 struct strbuf buffer
= STRBUF_INIT
;
242 const char *argv
[] = {"stash", "create", NULL
};
244 memset(&cp
, 0, sizeof(cp
));
249 if (start_command(&cp
))
250 die(_("could not run stash."));
251 len
= strbuf_read(&buffer
, cp
.out
, 1024);
254 if (finish_command(&cp
) || len
< 0)
255 die(_("stash failed"));
256 else if (!len
) /* no changes */
258 strbuf_setlen(&buffer
, buffer
.len
-1);
259 if (get_sha1(buffer
.buf
, stash
))
260 die(_("not a valid object: %s"), buffer
.buf
);
264 static void read_empty(unsigned const char *sha1
, int verbose
)
269 args
[i
++] = "read-tree";
274 args
[i
++] = EMPTY_TREE_SHA1_HEX
;
275 args
[i
++] = sha1_to_hex(sha1
);
278 if (run_command_v_opt(args
, RUN_GIT_CMD
))
279 die(_("read-tree failed"));
282 static void reset_hard(unsigned const char *sha1
, int verbose
)
287 args
[i
++] = "read-tree";
290 args
[i
++] = "--reset";
292 args
[i
++] = sha1_to_hex(sha1
);
295 if (run_command_v_opt(args
, RUN_GIT_CMD
))
296 die(_("read-tree failed"));
299 static void restore_state(const unsigned char *head
,
300 const unsigned char *stash
)
302 struct strbuf sb
= STRBUF_INIT
;
303 const char *args
[] = { "stash", "apply", NULL
, NULL
};
305 if (is_null_sha1(stash
))
310 args
[2] = sha1_to_hex(stash
);
313 * It is OK to ignore error here, for example when there was
314 * nothing to restore.
316 run_command_v_opt(args
, RUN_GIT_CMD
);
319 refresh_cache(REFRESH_QUIET
);
322 /* This is called when no merge was necessary. */
323 static void finish_up_to_date(const char *msg
)
326 printf("%s%s\n", squash
? _(" (nothing to squash)") : "", msg
);
330 static void squash_message(struct commit
*commit
, struct commit_list
*remoteheads
)
333 struct strbuf out
= STRBUF_INIT
;
334 struct commit_list
*j
;
335 const char *filename
;
337 struct pretty_print_context ctx
= {0};
339 printf(_("Squash commit -- not updating HEAD\n"));
340 filename
= git_path("SQUASH_MSG");
341 fd
= open(filename
, O_WRONLY
| O_CREAT
, 0666);
343 die_errno(_("Could not write to '%s'"), filename
);
345 init_revisions(&rev
, NULL
);
346 rev
.ignore_merges
= 1;
347 rev
.commit_format
= CMIT_FMT_MEDIUM
;
349 commit
->object
.flags
|= UNINTERESTING
;
350 add_pending_object(&rev
, &commit
->object
, NULL
);
352 for (j
= remoteheads
; j
; j
= j
->next
)
353 add_pending_object(&rev
, &j
->item
->object
, NULL
);
355 setup_revisions(0, NULL
, &rev
, NULL
);
356 if (prepare_revision_walk(&rev
))
357 die(_("revision walk setup failed"));
359 ctx
.abbrev
= rev
.abbrev
;
360 ctx
.date_mode
= rev
.date_mode
;
361 ctx
.fmt
= rev
.commit_format
;
363 strbuf_addstr(&out
, "Squashed commit of the following:\n");
364 while ((commit
= get_revision(&rev
)) != NULL
) {
365 strbuf_addch(&out
, '\n');
366 strbuf_addf(&out
, "commit %s\n",
367 sha1_to_hex(commit
->object
.sha1
));
368 pretty_print_commit(&ctx
, commit
, &out
);
370 if (write(fd
, out
.buf
, out
.len
) < 0)
371 die_errno(_("Writing SQUASH_MSG"));
373 die_errno(_("Finishing SQUASH_MSG"));
374 strbuf_release(&out
);
377 static void finish(struct commit
*head_commit
,
378 struct commit_list
*remoteheads
,
379 const unsigned char *new_head
, const char *msg
)
381 struct strbuf reflog_message
= STRBUF_INIT
;
382 const unsigned char *head
= head_commit
->object
.sha1
;
385 strbuf_addstr(&reflog_message
, getenv("GIT_REFLOG_ACTION"));
389 strbuf_addf(&reflog_message
, "%s: %s",
390 getenv("GIT_REFLOG_ACTION"), msg
);
393 squash_message(head_commit
, remoteheads
);
395 if (verbosity
>= 0 && !merge_msg
.len
)
396 printf(_("No merge message -- not updating HEAD\n"));
398 const char *argv_gc_auto
[] = { "gc", "--auto", NULL
};
399 update_ref(reflog_message
.buf
, "HEAD",
403 * We ignore errors in 'gc --auto', since the
404 * user should see them.
406 run_command_v_opt(argv_gc_auto
, RUN_GIT_CMD
);
409 if (new_head
&& show_diffstat
) {
410 struct diff_options opts
;
412 opts
.stat_width
= -1; /* use full terminal width */
413 opts
.stat_graph_width
= -1; /* respect statGraphWidth config */
414 opts
.output_format
|=
415 DIFF_FORMAT_SUMMARY
| DIFF_FORMAT_DIFFSTAT
;
416 opts
.detect_rename
= DIFF_DETECT_RENAME
;
417 diff_setup_done(&opts
);
418 diff_tree_sha1(head
, new_head
, "", &opts
);
423 /* Run a post-merge hook */
424 run_hook(NULL
, "post-merge", squash
? "1" : "0", NULL
);
426 strbuf_release(&reflog_message
);
429 /* Get the name for the merge commit's message. */
430 static void merge_name(const char *remote
, struct strbuf
*msg
)
432 struct commit
*remote_head
;
433 unsigned char branch_head
[20];
434 struct strbuf buf
= STRBUF_INIT
;
435 struct strbuf bname
= STRBUF_INIT
;
440 strbuf_branchname(&bname
, remote
);
443 memset(branch_head
, 0, sizeof(branch_head
));
444 remote_head
= get_merge_parent(remote
);
446 die(_("'%s' does not point to a commit"), remote
);
448 if (dwim_ref(remote
, strlen(remote
), branch_head
, &found_ref
) > 0) {
449 if (!prefixcmp(found_ref
, "refs/heads/")) {
450 strbuf_addf(msg
, "%s\t\tbranch '%s' of .\n",
451 sha1_to_hex(branch_head
), remote
);
454 if (!prefixcmp(found_ref
, "refs/tags/")) {
455 strbuf_addf(msg
, "%s\t\ttag '%s' of .\n",
456 sha1_to_hex(branch_head
), remote
);
459 if (!prefixcmp(found_ref
, "refs/remotes/")) {
460 strbuf_addf(msg
, "%s\t\tremote-tracking branch '%s' of .\n",
461 sha1_to_hex(branch_head
), remote
);
466 /* See if remote matches <name>^^^.. or <name>~<number> */
467 for (len
= 0, ptr
= remote
+ strlen(remote
);
468 remote
< ptr
&& ptr
[-1] == '^';
475 ptr
= strrchr(remote
, '~');
477 int seen_nonzero
= 0;
480 while (*++ptr
&& isdigit(*ptr
)) {
481 seen_nonzero
|= (*ptr
!= '0');
485 len
= 0; /* not ...~<number> */
486 else if (seen_nonzero
)
489 early
= 1; /* "name~" is "name~1"! */
493 struct strbuf truname
= STRBUF_INIT
;
494 strbuf_addstr(&truname
, "refs/heads/");
495 strbuf_addstr(&truname
, remote
);
496 strbuf_setlen(&truname
, truname
.len
- len
);
497 if (ref_exists(truname
.buf
)) {
499 "%s\t\tbranch '%s'%s of .\n",
500 sha1_to_hex(remote_head
->object
.sha1
),
502 (early
? " (early part)" : ""));
503 strbuf_release(&truname
);
508 if (!strcmp(remote
, "FETCH_HEAD") &&
509 !access(git_path("FETCH_HEAD"), R_OK
)) {
510 const char *filename
;
512 struct strbuf line
= STRBUF_INIT
;
515 filename
= git_path("FETCH_HEAD");
516 fp
= fopen(filename
, "r");
518 die_errno(_("could not open '%s' for reading"),
520 strbuf_getline(&line
, fp
, '\n');
522 ptr
= strstr(line
.buf
, "\tnot-for-merge\t");
524 strbuf_remove(&line
, ptr
-line
.buf
+1, 13);
525 strbuf_addbuf(msg
, &line
);
526 strbuf_release(&line
);
530 if (remote_head
->util
) {
531 struct merge_remote_desc
*desc
;
532 desc
= merge_remote_util(remote_head
);
533 if (desc
&& desc
->obj
&& desc
->obj
->type
== OBJ_TAG
) {
534 strbuf_addf(msg
, "%s\t\t%s '%s'\n",
535 sha1_to_hex(desc
->obj
->sha1
),
536 typename(desc
->obj
->type
),
542 strbuf_addf(msg
, "%s\t\tcommit '%s'\n",
543 sha1_to_hex(remote_head
->object
.sha1
), remote
);
545 strbuf_release(&buf
);
546 strbuf_release(&bname
);
549 static void parse_branch_merge_options(char *bmo
)
556 argc
= split_cmdline(bmo
, &argv
);
558 die(_("Bad branch.%s.mergeoptions string: %s"), branch
,
559 split_cmdline_strerror(argc
));
560 argv
= xrealloc(argv
, sizeof(*argv
) * (argc
+ 2));
561 memmove(argv
+ 1, argv
, sizeof(*argv
) * (argc
+ 1));
563 argv
[0] = "branch.*.mergeoptions";
564 parse_options(argc
, argv
, NULL
, builtin_merge_options
,
565 builtin_merge_usage
, 0);
569 static int git_merge_config(const char *k
, const char *v
, void *cb
)
573 if (branch
&& !prefixcmp(k
, "branch.") &&
574 !prefixcmp(k
+ 7, branch
) &&
575 !strcmp(k
+ 7 + strlen(branch
), ".mergeoptions")) {
576 free(branch_mergeoptions
);
577 branch_mergeoptions
= xstrdup(v
);
581 if (!strcmp(k
, "merge.diffstat") || !strcmp(k
, "merge.stat"))
582 show_diffstat
= git_config_bool(k
, v
);
583 else if (!strcmp(k
, "pull.twohead"))
584 return git_config_string(&pull_twohead
, k
, v
);
585 else if (!strcmp(k
, "pull.octopus"))
586 return git_config_string(&pull_octopus
, k
, v
);
587 else if (!strcmp(k
, "merge.renormalize"))
588 option_renormalize
= git_config_bool(k
, v
);
589 else if (!strcmp(k
, "merge.ff")) {
590 int boolval
= git_config_maybe_bool(k
, v
);
592 fast_forward
= boolval
? FF_ALLOW
: FF_NO
;
593 } else if (v
&& !strcmp(v
, "only")) {
594 fast_forward
= FF_ONLY
;
595 } /* do not barf on values from future versions of git */
597 } else if (!strcmp(k
, "merge.defaulttoupstream")) {
598 default_to_upstream
= git_config_bool(k
, v
);
602 status
= fmt_merge_msg_config(k
, v
, cb
);
605 status
= git_gpg_config(k
, v
, NULL
);
608 return git_diff_ui_config(k
, v
, cb
);
611 static int read_tree_trivial(unsigned char *common
, unsigned char *head
,
615 struct tree
*trees
[MAX_UNPACK_TREES
];
616 struct tree_desc t
[MAX_UNPACK_TREES
];
617 struct unpack_trees_options opts
;
619 memset(&opts
, 0, sizeof(opts
));
621 opts
.src_index
= &the_index
;
622 opts
.dst_index
= &the_index
;
624 opts
.verbose_update
= 1;
625 opts
.trivial_merges_only
= 1;
627 trees
[nr_trees
] = parse_tree_indirect(common
);
628 if (!trees
[nr_trees
++])
630 trees
[nr_trees
] = parse_tree_indirect(head
);
631 if (!trees
[nr_trees
++])
633 trees
[nr_trees
] = parse_tree_indirect(one
);
634 if (!trees
[nr_trees
++])
636 opts
.fn
= threeway_merge
;
637 cache_tree_free(&active_cache_tree
);
638 for (i
= 0; i
< nr_trees
; i
++) {
639 parse_tree(trees
[i
]);
640 init_tree_desc(t
+i
, trees
[i
]->buffer
, trees
[i
]->size
);
642 if (unpack_trees(nr_trees
, t
, &opts
))
647 static void write_tree_trivial(unsigned char *sha1
)
649 if (write_cache_as_tree(sha1
, 0, NULL
))
650 die(_("git write-tree failed to write a tree"));
653 static int try_merge_strategy(const char *strategy
, struct commit_list
*common
,
654 struct commit_list
*remoteheads
,
655 struct commit
*head
, const char *head_arg
)
658 struct lock_file
*lock
= xcalloc(1, sizeof(struct lock_file
));
660 index_fd
= hold_locked_index(lock
, 1);
661 refresh_cache(REFRESH_QUIET
);
662 if (active_cache_changed
&&
663 (write_cache(index_fd
, active_cache
, active_nr
) ||
664 commit_locked_index(lock
)))
665 return error(_("Unable to write index."));
666 rollback_lock_file(lock
);
668 if (!strcmp(strategy
, "recursive") || !strcmp(strategy
, "subtree")) {
670 struct commit
*result
;
671 struct lock_file
*lock
= xcalloc(1, sizeof(struct lock_file
));
673 struct commit_list
*reversed
= NULL
;
674 struct merge_options o
;
675 struct commit_list
*j
;
677 if (remoteheads
->next
) {
678 error(_("Not handling anything other than two heads merge."));
682 init_merge_options(&o
);
683 if (!strcmp(strategy
, "subtree"))
684 o
.subtree_shift
= "";
686 o
.renormalize
= option_renormalize
;
687 o
.show_rename_progress
=
688 show_progress
== -1 ? isatty(2) : show_progress
;
690 for (x
= 0; x
< xopts_nr
; x
++)
691 if (parse_merge_opt(&o
, xopts
[x
]))
692 die(_("Unknown option for merge-recursive: -X%s"), xopts
[x
]);
694 o
.branch1
= head_arg
;
695 o
.branch2
= merge_remote_util(remoteheads
->item
)->name
;
697 for (j
= common
; j
; j
= j
->next
)
698 commit_list_insert(j
->item
, &reversed
);
700 index_fd
= hold_locked_index(lock
, 1);
701 clean
= merge_recursive(&o
, head
,
702 remoteheads
->item
, reversed
, &result
);
703 if (active_cache_changed
&&
704 (write_cache(index_fd
, active_cache
, active_nr
) ||
705 commit_locked_index(lock
)))
706 die (_("unable to write %s"), get_index_file());
707 rollback_lock_file(lock
);
708 return clean
? 0 : 1;
710 return try_merge_command(strategy
, xopts_nr
, xopts
,
711 common
, head_arg
, remoteheads
);
715 static void count_diff_files(struct diff_queue_struct
*q
,
716 struct diff_options
*opt
, void *data
)
723 static int count_unmerged_entries(void)
727 for (i
= 0; i
< active_nr
; i
++)
728 if (ce_stage(active_cache
[i
]))
734 static void split_merge_strategies(const char *string
, struct strategy
**list
,
742 buf
= xstrdup(string
);
747 ALLOC_GROW(*list
, *nr
+ 1, *alloc
);
748 (*list
)[(*nr
)++].name
= xstrdup(q
);
753 ALLOC_GROW(*list
, *nr
+ 1, *alloc
);
754 (*list
)[(*nr
)++].name
= xstrdup(q
);
760 static void add_strategies(const char *string
, unsigned attr
)
762 struct strategy
*list
= NULL
;
763 int list_alloc
= 0, list_nr
= 0, i
;
765 memset(&list
, 0, sizeof(list
));
766 split_merge_strategies(string
, &list
, &list_nr
, &list_alloc
);
768 for (i
= 0; i
< list_nr
; i
++)
769 append_strategy(get_strategy(list
[i
].name
));
772 for (i
= 0; i
< ARRAY_SIZE(all_strategy
); i
++)
773 if (all_strategy
[i
].attr
& attr
)
774 append_strategy(&all_strategy
[i
]);
778 static void write_merge_msg(struct strbuf
*msg
)
780 const char *filename
= git_path("MERGE_MSG");
781 int fd
= open(filename
, O_WRONLY
| O_CREAT
, 0666);
783 die_errno(_("Could not open '%s' for writing"),
785 if (write_in_full(fd
, msg
->buf
, msg
->len
) != msg
->len
)
786 die_errno(_("Could not write to '%s'"), filename
);
790 static void read_merge_msg(struct strbuf
*msg
)
792 const char *filename
= git_path("MERGE_MSG");
794 if (strbuf_read_file(msg
, filename
, 0) < 0)
795 die_errno(_("Could not read from '%s'"), filename
);
798 static void write_merge_state(struct commit_list
*);
799 static void abort_commit(struct commit_list
*remoteheads
, const char *err_msg
)
802 error("%s", err_msg
);
804 _("Not committing merge; use 'git commit' to complete the merge.\n"));
805 write_merge_state(remoteheads
);
809 static const char merge_editor_comment
[] =
810 N_("Please enter a commit message to explain why this merge is necessary,\n"
811 "especially if it merges an updated upstream into a topic branch.\n"
813 "Lines starting with '%c' will be ignored, and an empty message aborts\n"
816 static void prepare_to_commit(struct commit_list
*remoteheads
)
818 struct strbuf msg
= STRBUF_INIT
;
819 strbuf_addbuf(&msg
, &merge_msg
);
820 strbuf_addch(&msg
, '\n');
822 strbuf_commented_addf(&msg
, _(merge_editor_comment
), comment_line_char
);
823 write_merge_msg(&msg
);
824 if (run_hook(get_index_file(), "prepare-commit-msg",
825 git_path("MERGE_MSG"), "merge", NULL
, NULL
))
826 abort_commit(remoteheads
, NULL
);
827 if (0 < option_edit
) {
828 if (launch_editor(git_path("MERGE_MSG"), NULL
, NULL
))
829 abort_commit(remoteheads
, NULL
);
831 read_merge_msg(&msg
);
832 stripspace(&msg
, 0 < option_edit
);
834 abort_commit(remoteheads
, _("Empty commit message."));
835 strbuf_release(&merge_msg
);
836 strbuf_addbuf(&merge_msg
, &msg
);
837 strbuf_release(&msg
);
840 static int merge_trivial(struct commit
*head
, struct commit_list
*remoteheads
)
842 unsigned char result_tree
[20], result_commit
[20];
843 struct commit_list
*parent
= xmalloc(sizeof(*parent
));
845 write_tree_trivial(result_tree
);
846 printf(_("Wonderful.\n"));
848 parent
->next
= xmalloc(sizeof(*parent
->next
));
849 parent
->next
->item
= remoteheads
->item
;
850 parent
->next
->next
= NULL
;
851 prepare_to_commit(remoteheads
);
852 if (commit_tree(&merge_msg
, result_tree
, parent
, result_commit
, NULL
,
854 die(_("failed to write commit object"));
855 finish(head
, remoteheads
, result_commit
, "In-index merge");
860 static int finish_automerge(struct commit
*head
,
862 struct commit_list
*common
,
863 struct commit_list
*remoteheads
,
864 unsigned char *result_tree
,
865 const char *wt_strategy
)
867 struct commit_list
*parents
= NULL
;
868 struct strbuf buf
= STRBUF_INIT
;
869 unsigned char result_commit
[20];
871 free_commit_list(common
);
872 parents
= remoteheads
;
873 if (!head_subsumed
|| fast_forward
== FF_NO
)
874 commit_list_insert(head
, &parents
);
875 strbuf_addch(&merge_msg
, '\n');
876 prepare_to_commit(remoteheads
);
877 if (commit_tree(&merge_msg
, result_tree
, parents
, result_commit
,
879 die(_("failed to write commit object"));
880 strbuf_addf(&buf
, "Merge made by the '%s' strategy.", wt_strategy
);
881 finish(head
, remoteheads
, result_commit
, buf
.buf
);
882 strbuf_release(&buf
);
887 static int suggest_conflicts(int renormalizing
)
889 const char *filename
;
893 filename
= git_path("MERGE_MSG");
894 fp
= fopen(filename
, "a");
896 die_errno(_("Could not open '%s' for writing"), filename
);
897 fprintf(fp
, "\nConflicts:\n");
898 for (pos
= 0; pos
< active_nr
; pos
++) {
899 const struct cache_entry
*ce
= active_cache
[pos
];
902 fprintf(fp
, "\t%s\n", ce
->name
);
903 while (pos
+ 1 < active_nr
&&
905 active_cache
[pos
+ 1]->name
))
910 rerere(allow_rerere_auto
);
911 printf(_("Automatic merge failed; "
912 "fix conflicts and then commit the result.\n"));
916 static struct commit
*is_old_style_invocation(int argc
, const char **argv
,
917 const unsigned char *head
)
919 struct commit
*second_token
= NULL
;
921 unsigned char second_sha1
[20];
923 if (get_sha1(argv
[1], second_sha1
))
925 second_token
= lookup_commit_reference_gently(second_sha1
, 0);
927 die(_("'%s' is not a commit"), argv
[1]);
928 if (hashcmp(second_token
->object
.sha1
, head
))
934 static int evaluate_result(void)
939 /* Check how many files differ. */
940 init_revisions(&rev
, "");
941 setup_revisions(0, NULL
, &rev
, NULL
);
942 rev
.diffopt
.output_format
|=
943 DIFF_FORMAT_CALLBACK
;
944 rev
.diffopt
.format_callback
= count_diff_files
;
945 rev
.diffopt
.format_callback_data
= &cnt
;
946 run_diff_files(&rev
, 0);
949 * Check how many unmerged entries are
952 cnt
+= count_unmerged_entries();
958 * Pretend as if the user told us to merge with the remote-tracking
959 * branch we have for the upstream of the current branch
961 static int setup_with_upstream(const char ***argv
)
963 struct branch
*branch
= branch_get(NULL
);
968 die(_("No current branch."));
970 die(_("No remote for the current branch."));
971 if (!branch
->merge_nr
)
972 die(_("No default upstream defined for the current branch."));
974 args
= xcalloc(branch
->merge_nr
+ 1, sizeof(char *));
975 for (i
= 0; i
< branch
->merge_nr
; i
++) {
976 if (!branch
->merge
[i
]->dst
)
977 die(_("No remote-tracking branch for %s from %s"),
978 branch
->merge
[i
]->src
, branch
->remote_name
);
979 args
[i
] = branch
->merge
[i
]->dst
;
986 static void write_merge_state(struct commit_list
*remoteheads
)
988 const char *filename
;
990 struct commit_list
*j
;
991 struct strbuf buf
= STRBUF_INIT
;
993 for (j
= remoteheads
; j
; j
= j
->next
) {
994 unsigned const char *sha1
;
995 struct commit
*c
= j
->item
;
996 if (c
->util
&& merge_remote_util(c
)->obj
) {
997 sha1
= merge_remote_util(c
)->obj
->sha1
;
999 sha1
= c
->object
.sha1
;
1001 strbuf_addf(&buf
, "%s\n", sha1_to_hex(sha1
));
1003 filename
= git_path("MERGE_HEAD");
1004 fd
= open(filename
, O_WRONLY
| O_CREAT
, 0666);
1006 die_errno(_("Could not open '%s' for writing"), filename
);
1007 if (write_in_full(fd
, buf
.buf
, buf
.len
) != buf
.len
)
1008 die_errno(_("Could not write to '%s'"), filename
);
1010 strbuf_addch(&merge_msg
, '\n');
1011 write_merge_msg(&merge_msg
);
1013 filename
= git_path("MERGE_MODE");
1014 fd
= open(filename
, O_WRONLY
| O_CREAT
| O_TRUNC
, 0666);
1016 die_errno(_("Could not open '%s' for writing"), filename
);
1018 if (fast_forward
== FF_NO
)
1019 strbuf_addf(&buf
, "no-ff");
1020 if (write_in_full(fd
, buf
.buf
, buf
.len
) != buf
.len
)
1021 die_errno(_("Could not write to '%s'"), filename
);
1025 static int default_edit_option(void)
1027 static const char name
[] = "GIT_MERGE_AUTOEDIT";
1028 const char *e
= getenv(name
);
1029 struct stat st_stdin
, st_stdout
;
1032 /* an explicit -m msg without --[no-]edit */
1036 int v
= git_config_maybe_bool(name
, e
);
1038 die("Bad value '%s' in environment '%s'", e
, name
);
1042 /* Use editor if stdin and stdout are the same and is a tty */
1043 return (!fstat(0, &st_stdin
) &&
1044 !fstat(1, &st_stdout
) &&
1045 isatty(0) && isatty(1) &&
1046 st_stdin
.st_dev
== st_stdout
.st_dev
&&
1047 st_stdin
.st_ino
== st_stdout
.st_ino
&&
1048 st_stdin
.st_mode
== st_stdout
.st_mode
);
1051 static struct commit_list
*collect_parents(struct commit
*head_commit
,
1053 int argc
, const char **argv
)
1056 struct commit_list
*remoteheads
= NULL
, *parents
, *next
;
1057 struct commit_list
**remotes
= &remoteheads
;
1060 remotes
= &commit_list_insert(head_commit
, remotes
)->next
;
1061 for (i
= 0; i
< argc
; i
++) {
1062 struct commit
*commit
= get_merge_parent(argv
[i
]);
1064 help_unknown_ref(argv
[i
], "merge",
1065 "not something we can merge");
1066 remotes
= &commit_list_insert(commit
, remotes
)->next
;
1070 parents
= reduce_heads(remoteheads
);
1072 *head_subsumed
= 1; /* we will flip this to 0 when we find it */
1073 for (remoteheads
= NULL
, remotes
= &remoteheads
;
1076 struct commit
*commit
= parents
->item
;
1077 next
= parents
->next
;
1078 if (commit
== head_commit
)
1081 remotes
= &commit_list_insert(commit
, remotes
)->next
;
1086 int cmd_merge(int argc
, const char **argv
, const char *prefix
)
1088 unsigned char result_tree
[20];
1089 unsigned char stash
[20];
1090 unsigned char head_sha1
[20];
1091 struct commit
*head_commit
;
1092 struct strbuf buf
= STRBUF_INIT
;
1093 const char *head_arg
;
1094 int flag
, i
, ret
= 0, head_subsumed
;
1095 int best_cnt
= -1, merge_was_ok
= 0, automerge_was_ok
= 0;
1096 struct commit_list
*common
= NULL
;
1097 const char *best_strategy
= NULL
, *wt_strategy
= NULL
;
1098 struct commit_list
*remoteheads
, *p
;
1099 void *branch_to_free
;
1101 if (argc
== 2 && !strcmp(argv
[1], "-h"))
1102 usage_with_options(builtin_merge_usage
, builtin_merge_options
);
1105 * Check if we are _not_ on a detached HEAD, i.e. if there is a
1108 branch
= branch_to_free
= resolve_refdup("HEAD", head_sha1
, 0, &flag
);
1109 if (branch
&& !prefixcmp(branch
, "refs/heads/"))
1111 if (!branch
|| is_null_sha1(head_sha1
))
1114 head_commit
= lookup_commit_or_die(head_sha1
, "HEAD");
1116 git_config(git_merge_config
, NULL
);
1118 if (branch_mergeoptions
)
1119 parse_branch_merge_options(branch_mergeoptions
);
1120 argc
= parse_options(argc
, argv
, prefix
, builtin_merge_options
,
1121 builtin_merge_usage
, 0);
1122 if (shortlog_len
< 0)
1123 shortlog_len
= (merge_log_config
> 0) ? merge_log_config
: 0;
1125 if (verbosity
< 0 && show_progress
== -1)
1128 if (abort_current_merge
) {
1130 const char *nargv
[] = {"reset", "--merge", NULL
};
1132 if (!file_exists(git_path("MERGE_HEAD")))
1133 die(_("There is no merge to abort (MERGE_HEAD missing)."));
1135 /* Invoke 'git reset --merge' */
1136 ret
= cmd_reset(nargc
, nargv
, prefix
);
1140 if (read_cache_unmerged())
1141 die_resolve_conflict("merge");
1143 if (file_exists(git_path("MERGE_HEAD"))) {
1145 * There is no unmerged entry, don't advise 'git
1146 * add/rm <file>', just 'git commit'.
1148 if (advice_resolve_conflict
)
1149 die(_("You have not concluded your merge (MERGE_HEAD exists).\n"
1150 "Please, commit your changes before you can merge."));
1152 die(_("You have not concluded your merge (MERGE_HEAD exists)."));
1154 if (file_exists(git_path("CHERRY_PICK_HEAD"))) {
1155 if (advice_resolve_conflict
)
1156 die(_("You have not concluded your cherry-pick (CHERRY_PICK_HEAD exists).\n"
1157 "Please, commit your changes before you can merge."));
1159 die(_("You have not concluded your cherry-pick (CHERRY_PICK_HEAD exists)."));
1161 resolve_undo_clear();
1167 if (fast_forward
== FF_NO
)
1168 die(_("You cannot combine --squash with --no-ff."));
1172 if (!abort_current_merge
) {
1174 if (default_to_upstream
)
1175 argc
= setup_with_upstream(&argv
);
1177 die(_("No commit specified and merge.defaultToUpstream not set."));
1178 } else if (argc
== 1 && !strcmp(argv
[0], "-"))
1182 usage_with_options(builtin_merge_usage
,
1183 builtin_merge_options
);
1186 * This could be traditional "merge <msg> HEAD <commit>..." and
1187 * the way we can tell it is to see if the second token is HEAD,
1188 * but some people might have misused the interface and used a
1189 * commit-ish that is the same as HEAD there instead.
1190 * Traditional format never would have "-m" so it is an
1191 * additional safety measure to check for it.
1194 if (!have_message
&& head_commit
&&
1195 is_old_style_invocation(argc
, argv
, head_commit
->object
.sha1
)) {
1196 strbuf_addstr(&merge_msg
, argv
[0]);
1200 remoteheads
= collect_parents(head_commit
, &head_subsumed
, argc
, argv
);
1201 } else if (!head_commit
) {
1202 struct commit
*remote_head
;
1204 * If the merged head is a valid one there is no reason
1205 * to forbid "git merge" into a branch yet to be born.
1206 * We do the same for "git pull".
1209 die(_("Can merge only exactly one commit into "
1212 die(_("Squash commit into empty head not supported yet"));
1213 if (fast_forward
== FF_NO
)
1214 die(_("Non-fast-forward commit does not make sense into "
1216 remoteheads
= collect_parents(head_commit
, &head_subsumed
, argc
, argv
);
1217 remote_head
= remoteheads
->item
;
1219 die(_("%s - not something we can merge"), argv
[0]);
1220 read_empty(remote_head
->object
.sha1
, 0);
1221 update_ref("initial pull", "HEAD", remote_head
->object
.sha1
,
1222 NULL
, 0, DIE_ON_ERR
);
1225 struct strbuf merge_names
= STRBUF_INIT
;
1227 /* We are invoked directly as the first-class UI. */
1231 * All the rest are the commits being merged; prepare
1232 * the standard merge summary message to be appended
1233 * to the given message.
1235 remoteheads
= collect_parents(head_commit
, &head_subsumed
, argc
, argv
);
1236 for (p
= remoteheads
; p
; p
= p
->next
)
1237 merge_name(merge_remote_util(p
->item
)->name
, &merge_names
);
1239 if (!have_message
|| shortlog_len
) {
1240 struct fmt_merge_msg_opts opts
;
1241 memset(&opts
, 0, sizeof(opts
));
1242 opts
.add_title
= !have_message
;
1243 opts
.shortlog_len
= shortlog_len
;
1244 opts
.credit_people
= (0 < option_edit
);
1246 fmt_merge_msg(&merge_names
, &merge_msg
, &opts
);
1248 strbuf_setlen(&merge_msg
, merge_msg
.len
- 1);
1252 if (!head_commit
|| !argc
)
1253 usage_with_options(builtin_merge_usage
,
1254 builtin_merge_options
);
1256 if (verify_signatures
) {
1257 for (p
= remoteheads
; p
; p
= p
->next
) {
1258 struct commit
*commit
= p
->item
;
1260 struct signature_check signature_check
;
1261 memset(&signature_check
, 0, sizeof(signature_check
));
1263 check_commit_signature(commit
, &signature_check
);
1265 strcpy(hex
, find_unique_abbrev(commit
->object
.sha1
, DEFAULT_ABBREV
));
1266 switch (signature_check
.result
) {
1270 die(_("Commit %s has an untrusted GPG signature, "
1271 "allegedly by %s."), hex
, signature_check
.signer
);
1273 die(_("Commit %s has a bad GPG signature "
1274 "allegedly by %s."), hex
, signature_check
.signer
);
1276 die(_("Commit %s does not have a GPG signature."), hex
);
1278 if (verbosity
>= 0 && signature_check
.result
== 'G')
1279 printf(_("Commit %s has a good GPG signature by %s\n"),
1280 hex
, signature_check
.signer
);
1282 free(signature_check
.gpg_output
);
1283 free(signature_check
.gpg_status
);
1284 free(signature_check
.signer
);
1285 free(signature_check
.key
);
1289 strbuf_addstr(&buf
, "merge");
1290 for (p
= remoteheads
; p
; p
= p
->next
)
1291 strbuf_addf(&buf
, " %s", merge_remote_util(p
->item
)->name
);
1292 setenv("GIT_REFLOG_ACTION", buf
.buf
, 0);
1295 for (p
= remoteheads
; p
; p
= p
->next
) {
1296 struct commit
*commit
= p
->item
;
1297 strbuf_addf(&buf
, "GITHEAD_%s",
1298 sha1_to_hex(commit
->object
.sha1
));
1299 setenv(buf
.buf
, merge_remote_util(commit
)->name
, 1);
1301 if (fast_forward
!= FF_ONLY
&&
1302 merge_remote_util(commit
) &&
1303 merge_remote_util(commit
)->obj
&&
1304 merge_remote_util(commit
)->obj
->type
== OBJ_TAG
)
1305 fast_forward
= FF_NO
;
1308 if (option_edit
< 0)
1309 option_edit
= default_edit_option();
1311 if (!use_strategies
) {
1313 ; /* already up-to-date */
1314 else if (!remoteheads
->next
)
1315 add_strategies(pull_twohead
, DEFAULT_TWOHEAD
);
1317 add_strategies(pull_octopus
, DEFAULT_OCTOPUS
);
1320 for (i
= 0; i
< use_strategies_nr
; i
++) {
1321 if (use_strategies
[i
]->attr
& NO_FAST_FORWARD
)
1322 fast_forward
= FF_NO
;
1323 if (use_strategies
[i
]->attr
& NO_TRIVIAL
)
1328 ; /* already up-to-date */
1329 else if (!remoteheads
->next
)
1330 common
= get_merge_bases(head_commit
, remoteheads
->item
, 1);
1332 struct commit_list
*list
= remoteheads
;
1333 commit_list_insert(head_commit
, &list
);
1334 common
= get_octopus_merge_bases(list
);
1338 update_ref("updating ORIG_HEAD", "ORIG_HEAD", head_commit
->object
.sha1
,
1339 NULL
, 0, DIE_ON_ERR
);
1341 if (remoteheads
&& !common
)
1342 ; /* No common ancestors found. We need a real merge. */
1343 else if (!remoteheads
||
1344 (!remoteheads
->next
&& !common
->next
&&
1345 common
->item
== remoteheads
->item
)) {
1347 * If head can reach all the merge then we are up to date.
1348 * but first the most common case of merging one remote.
1350 finish_up_to_date("Already up-to-date.");
1352 } else if (fast_forward
!= FF_NO
&& !remoteheads
->next
&&
1354 !hashcmp(common
->item
->object
.sha1
, head_commit
->object
.sha1
)) {
1355 /* Again the most common case of merging one remote. */
1356 struct strbuf msg
= STRBUF_INIT
;
1357 struct commit
*commit
;
1360 strcpy(hex
, find_unique_abbrev(head_commit
->object
.sha1
, DEFAULT_ABBREV
));
1363 printf(_("Updating %s..%s\n"),
1365 find_unique_abbrev(remoteheads
->item
->object
.sha1
,
1367 strbuf_addstr(&msg
, "Fast-forward");
1370 " (no commit created; -m option ignored)");
1371 commit
= remoteheads
->item
;
1377 if (checkout_fast_forward(head_commit
->object
.sha1
,
1378 commit
->object
.sha1
,
1379 overwrite_ignore
)) {
1384 finish(head_commit
, remoteheads
, commit
->object
.sha1
, msg
.buf
);
1387 } else if (!remoteheads
->next
&& common
->next
)
1390 * We are not doing octopus and not fast-forward. Need
1393 else if (!remoteheads
->next
&& !common
->next
&& option_commit
) {
1395 * We are not doing octopus, not fast-forward, and have
1398 refresh_cache(REFRESH_QUIET
);
1399 if (allow_trivial
&& fast_forward
!= FF_ONLY
) {
1400 /* See if it is really trivial. */
1401 git_committer_info(IDENT_STRICT
);
1402 printf(_("Trying really trivial in-index merge...\n"));
1403 if (!read_tree_trivial(common
->item
->object
.sha1
,
1404 head_commit
->object
.sha1
,
1405 remoteheads
->item
->object
.sha1
)) {
1406 ret
= merge_trivial(head_commit
, remoteheads
);
1409 printf(_("Nope.\n"));
1413 * An octopus. If we can reach all the remote we are up
1417 struct commit_list
*j
;
1419 for (j
= remoteheads
; j
; j
= j
->next
) {
1420 struct commit_list
*common_one
;
1423 * Here we *have* to calculate the individual
1424 * merge_bases again, otherwise "git merge HEAD^
1425 * HEAD^^" would be missed.
1427 common_one
= get_merge_bases(head_commit
, j
->item
, 1);
1428 if (hashcmp(common_one
->item
->object
.sha1
,
1429 j
->item
->object
.sha1
)) {
1435 finish_up_to_date("Already up-to-date. Yeeah!");
1440 if (fast_forward
== FF_ONLY
)
1441 die(_("Not possible to fast-forward, aborting."));
1443 /* We are going to make a new commit. */
1444 git_committer_info(IDENT_STRICT
);
1447 * At this point, we need a real merge. No matter what strategy
1448 * we use, it would operate on the index, possibly affecting the
1449 * working tree, and when resolved cleanly, have the desired
1450 * tree in the index -- this means that the index must be in
1451 * sync with the head commit. The strategies are responsible
1454 if (use_strategies_nr
== 1 ||
1456 * Stash away the local changes so that we can try more than one.
1459 hashcpy(stash
, null_sha1
);
1461 for (i
= 0; i
< use_strategies_nr
; i
++) {
1464 printf(_("Rewinding the tree to pristine...\n"));
1465 restore_state(head_commit
->object
.sha1
, stash
);
1467 if (use_strategies_nr
!= 1)
1468 printf(_("Trying merge strategy %s...\n"),
1469 use_strategies
[i
]->name
);
1471 * Remember which strategy left the state in the working
1474 wt_strategy
= use_strategies
[i
]->name
;
1476 ret
= try_merge_strategy(use_strategies
[i
]->name
,
1477 common
, remoteheads
,
1478 head_commit
, head_arg
);
1479 if (!option_commit
&& !ret
) {
1482 * This is necessary here just to avoid writing
1483 * the tree, but later we will *not* exit with
1484 * status code 1 because merge_was_ok is set.
1491 * The backend exits with 1 when conflicts are
1492 * left to be resolved, with 2 when it does not
1493 * handle the given merge at all.
1496 int cnt
= evaluate_result();
1498 if (best_cnt
<= 0 || cnt
<= best_cnt
) {
1499 best_strategy
= use_strategies
[i
]->name
;
1509 /* Automerge succeeded. */
1510 write_tree_trivial(result_tree
);
1511 automerge_was_ok
= 1;
1516 * If we have a resulting tree, that means the strategy module
1517 * auto resolved the merge cleanly.
1519 if (automerge_was_ok
) {
1520 ret
= finish_automerge(head_commit
, head_subsumed
,
1521 common
, remoteheads
,
1522 result_tree
, wt_strategy
);
1527 * Pick the result from the best strategy and have the user fix
1530 if (!best_strategy
) {
1531 restore_state(head_commit
->object
.sha1
, stash
);
1532 if (use_strategies_nr
> 1)
1534 _("No merge strategy handled the merge.\n"));
1536 fprintf(stderr
, _("Merge with strategy %s failed.\n"),
1537 use_strategies
[0]->name
);
1540 } else if (best_strategy
== wt_strategy
)
1541 ; /* We already have its result in the working tree. */
1543 printf(_("Rewinding the tree to pristine...\n"));
1544 restore_state(head_commit
->object
.sha1
, stash
);
1545 printf(_("Using the %s to prepare resolving by hand.\n"),
1547 try_merge_strategy(best_strategy
, common
, remoteheads
,
1548 head_commit
, head_arg
);
1552 finish(head_commit
, remoteheads
, NULL
, NULL
);
1554 write_merge_state(remoteheads
);
1557 fprintf(stderr
, _("Automatic merge went well; "
1558 "stopped before committing as requested\n"));
1560 ret
= suggest_conflicts(option_renormalize
);
1563 free(branch_to_free
);