submodule--helper: use strbuf_release() to free strbufs
[git] / unpack-trees.h
1 #ifndef UNPACK_TREES_H
2 #define UNPACK_TREES_H
3
4 #include "cache.h"
5 #include "argv-array.h"
6 #include "string-list.h"
7 #include "tree-walk.h"
8
9 #define MAX_UNPACK_TREES MAX_TRAVERSE_TREES
10
11 struct cache_entry;
12 struct unpack_trees_options;
13 struct pattern_list;
14
15 typedef int (*merge_fn_t)(const struct cache_entry * const *src,
16                 struct unpack_trees_options *options);
17
18 enum unpack_trees_error_types {
19         ERROR_WOULD_OVERWRITE = 0,
20         ERROR_NOT_UPTODATE_FILE,
21         ERROR_NOT_UPTODATE_DIR,
22         ERROR_WOULD_LOSE_UNTRACKED_OVERWRITTEN,
23         ERROR_WOULD_LOSE_UNTRACKED_REMOVED,
24         ERROR_BIND_OVERLAP,
25         ERROR_WOULD_LOSE_SUBMODULE,
26
27         NB_UNPACK_TREES_ERROR_TYPES,
28
29         WARNING_SPARSE_NOT_UPTODATE_FILE,
30         WARNING_SPARSE_UNMERGED_FILE,
31         WARNING_SPARSE_ORPHANED_NOT_OVERWRITTEN,
32
33         NB_UNPACK_TREES_WARNING_TYPES,
34 };
35
36 /*
37  * Sets the list of user-friendly error messages to be used by the
38  * command "cmd" (either merge or checkout), and show_all_errors to 1.
39  */
40 void setup_unpack_trees_porcelain(struct unpack_trees_options *opts,
41                                   const char *cmd);
42
43 /*
44  * Frees resources allocated by setup_unpack_trees_porcelain().
45  */
46 void clear_unpack_trees_porcelain(struct unpack_trees_options *opts);
47
48 struct unpack_trees_options {
49         unsigned int reset,
50                      merge,
51                      update,
52                      clone,
53                      index_only,
54                      nontrivial_merge,
55                      trivial_merges_only,
56                      verbose_update,
57                      aggressive,
58                      skip_unmerged,
59                      initial_checkout,
60                      diff_index_cached,
61                      debug_unpack,
62                      skip_sparse_checkout,
63                      quiet,
64                      exiting_early,
65                      show_all_errors,
66                      dry_run;
67         const char *prefix;
68         int cache_bottom;
69         struct dir_struct *dir;
70         struct pathspec *pathspec;
71         merge_fn_t fn;
72         const char *msgs[NB_UNPACK_TREES_WARNING_TYPES];
73         struct argv_array msgs_to_free;
74         /*
75          * Store error messages in an array, each case
76          * corresponding to a error message type
77          */
78         struct string_list unpack_rejects[NB_UNPACK_TREES_WARNING_TYPES];
79
80         int head_idx;
81         int merge_size;
82
83         struct cache_entry *df_conflict_entry;
84         void *unpack_data;
85
86         struct index_state *dst_index;
87         struct index_state *src_index;
88         struct index_state result;
89
90         struct pattern_list *pl; /* for internal use */
91         struct checkout_metadata meta;
92 };
93
94 int unpack_trees(unsigned n, struct tree_desc *t,
95                  struct unpack_trees_options *options);
96
97 enum update_sparsity_result {
98         UPDATE_SPARSITY_SUCCESS = 0,
99         UPDATE_SPARSITY_WARNINGS = 1,
100         UPDATE_SPARSITY_INDEX_UPDATE_FAILURES = -1,
101         UPDATE_SPARSITY_WORKTREE_UPDATE_FAILURES = -2
102 };
103
104 enum update_sparsity_result update_sparsity(struct unpack_trees_options *options);
105
106 int verify_uptodate(const struct cache_entry *ce,
107                     struct unpack_trees_options *o);
108
109 int threeway_merge(const struct cache_entry * const *stages,
110                    struct unpack_trees_options *o);
111 int twoway_merge(const struct cache_entry * const *src,
112                  struct unpack_trees_options *o);
113 int bind_merge(const struct cache_entry * const *src,
114                struct unpack_trees_options *o);
115 int oneway_merge(const struct cache_entry * const *src,
116                  struct unpack_trees_options *o);
117
118 #endif