t4014: do not use "slave branch" nomenclature
[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_SPARSE_NOT_UPTODATE_FILE,
26         ERROR_WOULD_LOSE_ORPHANED_OVERWRITTEN,
27         ERROR_WOULD_LOSE_ORPHANED_REMOVED,
28         ERROR_WOULD_LOSE_SUBMODULE,
29         NB_UNPACK_TREES_ERROR_TYPES
30 };
31
32 /*
33  * Sets the list of user-friendly error messages to be used by the
34  * command "cmd" (either merge or checkout), and show_all_errors to 1.
35  */
36 void setup_unpack_trees_porcelain(struct unpack_trees_options *opts,
37                                   const char *cmd);
38
39 /*
40  * Frees resources allocated by setup_unpack_trees_porcelain().
41  */
42 void clear_unpack_trees_porcelain(struct unpack_trees_options *opts);
43
44 struct unpack_trees_options {
45         unsigned int reset,
46                      merge,
47                      update,
48                      clone,
49                      index_only,
50                      nontrivial_merge,
51                      trivial_merges_only,
52                      verbose_update,
53                      aggressive,
54                      skip_unmerged,
55                      initial_checkout,
56                      diff_index_cached,
57                      debug_unpack,
58                      skip_sparse_checkout,
59                      quiet,
60                      exiting_early,
61                      show_all_errors,
62                      dry_run,
63                      keep_pattern_list;
64         const char *prefix;
65         int cache_bottom;
66         struct dir_struct *dir;
67         struct pathspec *pathspec;
68         merge_fn_t fn;
69         const char *msgs[NB_UNPACK_TREES_ERROR_TYPES];
70         struct argv_array msgs_to_free;
71         /*
72          * Store error messages in an array, each case
73          * corresponding to a error message type
74          */
75         struct string_list unpack_rejects[NB_UNPACK_TREES_ERROR_TYPES];
76
77         int head_idx;
78         int merge_size;
79
80         struct cache_entry *df_conflict_entry;
81         void *unpack_data;
82
83         struct index_state *dst_index;
84         struct index_state *src_index;
85         struct index_state result;
86
87         struct pattern_list *pl; /* for internal use */
88 };
89
90 int unpack_trees(unsigned n, struct tree_desc *t,
91                  struct unpack_trees_options *options);
92
93 int verify_uptodate(const struct cache_entry *ce,
94                     struct unpack_trees_options *o);
95
96 int threeway_merge(const struct cache_entry * const *stages,
97                    struct unpack_trees_options *o);
98 int twoway_merge(const struct cache_entry * const *src,
99                  struct unpack_trees_options *o);
100 int bind_merge(const struct cache_entry * const *src,
101                struct unpack_trees_options *o);
102 int oneway_merge(const struct cache_entry * const *src,
103                  struct unpack_trees_options *o);
104
105 #endif