commit-reach.h

   1 #ifndef __COMMIT_REACH_H__
   2 #define __COMMIT_REACH_H__
   3
   4 #include "commit-slab.h"
   5
   6 struct commit;
   7 struct commit_list;
   8 struct contains_cache;
   9 struct ref_filter;
  10
  11 struct commit_list *repo_get_merge_bases(struct repository *r,
  12                                          struct commit *rev1,
  13                                          struct commit *rev2);
  14 struct commit_list *repo_get_merge_bases_many(struct repository *r,
  15                                               struct commit *one, int n,
  16                                               struct commit **twos);
  17 /* To be used only when object flags after this call no longer matter */
  18 struct commit_list *repo_get_merge_bases_many_dirty(struct repository *r,
  19                                                     struct commit *one, int n,
  20                                                     struct commit **twos);
  21 #ifndef NO_THE_REPOSITORY_COMPATIBILITY_MACROS
  22 #define get_merge_bases(r1, r2)           repo_get_merge_bases(the_repository, r1, r2)
  23 #define get_merge_bases_many(one, n, two) repo_get_merge_bases_many(the_repository, one, n, two)
  24 #define get_merge_bases_many_dirty(one, n, twos) repo_get_merge_bases_many_dirty(the_repository, one, n, twos)
  25 #endif
  26
  27 struct commit_list *get_octopus_merge_bases(struct commit_list *in);
  28
  29 int is_descendant_of(struct commit *commit, struct commit_list *with_commit);
  30 int repo_in_merge_bases(struct repository *r,
  31                         struct commit *commit,
  32                         struct commit *reference);
  33 int repo_in_merge_bases_many(struct repository *r,
  34                              struct commit *commit,
  35                              int nr_reference, struct commit **reference);
  36 #ifndef NO_THE_REPOSITORY_COMPATIBILITY_MACROS
  37 #define in_merge_bases(c1, c2) repo_in_merge_bases(the_repository, c1, c2)
  38 #define in_merge_bases_many(c1, n, cs) repo_in_merge_bases_many(the_repository, c1, n, cs)
  39 #endif
  40
  41 /*
  42  * Takes a list of commits and returns a new list where those
  43  * have been removed that can be reached from other commits in
  44  * the list. It is useful for, e.g., reducing the commits
  45  * randomly thrown at the git-merge command and removing
  46  * redundant commits that the user shouldn't have given to it.
  47  *
  48  * This function destroys the STALE bit of the commit objects'
  49  * flags.
  50  */
  51 struct commit_list *reduce_heads(struct commit_list *heads);
  52
  53 /*
  54  * Like `reduce_heads()`, except it replaces the list. Use this
  55  * instead of `foo = reduce_heads(foo);` to avoid memory leaks.
  56  */
  57 void reduce_heads_replace(struct commit_list **heads);
  58
  59 int ref_newer(const struct object_id *new_oid, const struct object_id *old_oid);
  60
  61 /*
  62  * Unknown has to be "0" here, because that's the default value for
  63  * contains_cache slab entries that have not yet been assigned.
  64  */
  65 enum contains_result {
  66         CONTAINS_UNKNOWN = 0,
  67         CONTAINS_NO,
  68         CONTAINS_YES
  69 };
  70
  71 define_commit_slab(contains_cache, enum contains_result);
  72
  73 int commit_contains(struct ref_filter *filter, struct commit *commit,
  74                     struct commit_list *list, struct contains_cache *cache);
  75
  76 /*
  77  * Determine if every commit in 'from' can reach at least one commit
  78  * that is marked with 'with_flag'. As we traverse, use 'assign_flag'
  79  * as a marker for commits that are already visited. Do not walk
  80  * commits with date below 'min_commit_date' or generation below
  81  * 'min_generation'.
  82  */
  83 int can_all_from_reach_with_flag(struct object_array *from,
  84                                  unsigned int with_flag,
  85                                  unsigned int assign_flag,
  86                                  time_t min_commit_date,
  87                                  uint32_t min_generation);
  88 int can_all_from_reach(struct commit_list *from, struct commit_list *to,
  89                        int commit_date_cutoff);
  90
  91 #endif