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 *get_merge_bases_many(struct commit *one,
  12                                          int n,
  13                                          struct commit **twos);
  14 struct commit_list *get_merge_bases_many_dirty(struct commit *one,
  15                                                int n,
  16                                                struct commit **twos);
  17 struct commit_list *get_merge_bases(struct commit *one, struct commit *two);
  18 struct commit_list *get_octopus_merge_bases(struct commit_list *in);
  19
  20 /* To be used only when object flags after this call no longer matter */
  21 struct commit_list *get_merge_bases_many_dirty(struct commit *one, int n, struct commit **twos);
  22
  23 int is_descendant_of(struct commit *commit, struct commit_list *with_commit);
  24 int in_merge_bases_many(struct commit *commit, int nr_reference, struct commit **reference);
  25 int in_merge_bases(struct commit *commit, struct commit *reference);
  26
  27 /*
  28  * Takes a list of commits and returns a new list where those
  29  * have been removed that can be reached from other commits in
  30  * the list. It is useful for, e.g., reducing the commits
  31  * randomly thrown at the git-merge command and removing
  32  * redundant commits that the user shouldn't have given to it.
  33  *
  34  * This function destroys the STALE bit of the commit objects'
  35  * flags.
  36  */
  37 struct commit_list *reduce_heads(struct commit_list *heads);
  38
  39 /*
  40  * Like `reduce_heads()`, except it replaces the list. Use this
  41  * instead of `foo = reduce_heads(foo);` to avoid memory leaks.
  42  */
  43 void reduce_heads_replace(struct commit_list **heads);
  44
  45 int ref_newer(const struct object_id *new_oid, const struct object_id *old_oid);
  46
  47 /*
  48  * Unknown has to be "0" here, because that's the default value for
  49  * contains_cache slab entries that have not yet been assigned.
  50  */
  51 enum contains_result {
  52         CONTAINS_UNKNOWN = 0,
  53         CONTAINS_NO,
  54         CONTAINS_YES
  55 };
  56
  57 define_commit_slab(contains_cache, enum contains_result);
  58
  59 int commit_contains(struct ref_filter *filter, struct commit *commit,
  60                     struct commit_list *list, struct contains_cache *cache);
  61
  62 /*
  63  * Determine if every commit in 'from' can reach at least one commit
  64  * that is marked with 'with_flag'. As we traverse, use 'assign_flag'
  65  * as a marker for commits that are already visited. Do not walk
  66  * commits with date below 'min_commit_date' or generation below
  67  * 'min_generation'.
  68  */
  69 int can_all_from_reach_with_flag(struct object_array *from,
  70                                  unsigned int with_flag,
  71                                  unsigned int assign_flag,
  72                                  time_t min_commit_date,
  73                                  uint32_t min_generation);
  74 int can_all_from_reach(struct commit_list *from, struct commit_list *to,
  75                        int commit_date_cutoff);
  76
  77
  78 /*
  79  * Return a list of commits containing the commits in the 'to' array
  80  * that are reachable from at least one commit in the 'from' array.
  81  * Also add the given 'flag' to each of the commits in the returned list.
  82  *
  83  * This method uses the PARENT1 and PARENT2 flags during its operation,
  84  * so be sure these flags are not set before calling the method.
  85  */
  86 struct commit_list *get_reachable_subset(struct commit **from, int nr_from,
  87                                          struct commit **to, int nr_to,
  88                                          unsigned int reachable_flag);
  89
  90 #endif