1#ifndef REMOTE_H 2#define REMOTE_H 3 4enum { 5 REMOTE_CONFIG, 6 REMOTE_REMOTES, 7 REMOTE_BRANCHES 8}; 9 10struct remote { 11 const char *name; 12 int origin; 13 14 const char *foreign_vcs; 15 16 const char **url; 17 int url_nr; 18 int url_alloc; 19 20 const char **pushurl; 21 int pushurl_nr; 22 int pushurl_alloc; 23 24 const char **push_refspec; 25 struct refspec *push; 26 int push_refspec_nr; 27 int push_refspec_alloc; 28 29 const char **fetch_refspec; 30 struct refspec *fetch; 31 int fetch_refspec_nr; 32 int fetch_refspec_alloc; 33 34 /* 35 * -1 to never fetch tags 36 * 0 to auto-follow tags on heuristic (default) 37 * 1 to always auto-follow tags 38 * 2 to always fetch tags 39 */ 40 int fetch_tags; 41 int skip_default_update; 42 int mirror; 43 44 const char *receivepack; 45 const char *uploadpack; 46 47 /* 48 * for curl remotes only 49 */ 50 char *http_proxy; 51}; 52 53struct remote *remote_get(const char *name); 54int remote_is_configured(const char *name); 55 56typedef int each_remote_fn(struct remote *remote, void *priv); 57int for_each_remote(each_remote_fn fn, void *priv); 58 59int remote_has_url(struct remote *remote, const char *url); 60 61struct refspec { 62 unsigned force : 1; 63 unsigned pattern : 1; 64 unsigned matching : 1; 65 66 char *src; 67 char *dst; 68}; 69 70extern const struct refspec *tag_refspec; 71 72struct ref *alloc_ref(const char *name); 73 74struct ref *copy_ref_list(const struct ref *ref); 75 76int check_ref_type(const struct ref *ref, int flags); 77 78/* 79 * Frees the entire list and peers of elements. 80 */ 81void free_refs(struct ref *ref); 82 83int resolve_remote_symref(struct ref *ref, struct ref *list); 84int ref_newer(const unsigned char *new_sha1, const unsigned char *old_sha1); 85 86/* 87 * Removes and frees any duplicate refs in the map. 88 */ 89void ref_remove_duplicates(struct ref *ref_map); 90 91int valid_fetch_refspec(const char *refspec); 92struct refspec *parse_fetch_refspec(int nr_refspec, const char **refspec); 93 94void free_refspec(int nr_refspec, struct refspec *refspec); 95 96char *apply_refspecs(struct refspec *refspecs, int nr_refspec, 97 const char *name); 98 99int match_refs(struct ref *src, struct ref **dst, 100 int nr_refspec, const char **refspec, int all); 101 102/* 103 * Given a list of the remote refs and the specification of things to 104 * fetch, makes a (separate) list of the refs to fetch and the local 105 * refs to store into. 106 * 107 * *tail is the pointer to the tail pointer of the list of results 108 * beforehand, and will be set to the tail pointer of the list of 109 * results afterward. 110 * 111 * missing_ok is usually false, but when we are adding branch.$name.merge 112 * it is Ok if the branch is not at the remote anymore. 113 */ 114int get_fetch_map(const struct ref *remote_refs, const struct refspec *refspec, 115 struct ref ***tail, int missing_ok); 116 117struct ref *get_remote_ref(const struct ref *remote_refs, const char *name); 118 119/* 120 * For the given remote, reads the refspec's src and sets the other fields. 121 */ 122int remote_find_tracking(struct remote *remote, struct refspec *refspec); 123 124struct branch { 125 const char *name; 126 const char *refname; 127 128 const char *remote_name; 129 struct remote *remote; 130 131 const char **merge_name; 132 struct refspec **merge; 133 int merge_nr; 134 int merge_alloc; 135}; 136 137struct branch *branch_get(const char *name); 138 139int branch_has_merge_config(struct branch *branch); 140int branch_merge_matches(struct branch *, int n, const char *); 141 142/* Flags to match_refs. */ 143enum match_refs_flags { 144 MATCH_REFS_NONE = 0, 145 MATCH_REFS_ALL = (1 << 0), 146 MATCH_REFS_MIRROR = (1 << 1), 147}; 148 149/* Reporting of tracking info */ 150int stat_tracking_info(struct branch *branch, int *num_ours, int *num_theirs); 151int format_tracking_info(struct branch *branch, struct strbuf *sb); 152 153struct ref *get_local_heads(void); 154/* 155 * Find refs from a list which are likely to be pointed to by the given HEAD 156 * ref. If 'all' is false, returns the most likely ref; otherwise, returns a 157 * list of all candidate refs. If no match is found (or 'head' is NULL), 158 * returns NULL. All returns are newly allocated and should be freed. 159 */ 160struct ref *guess_remote_head(const struct ref *head, 161 const struct ref *refs, 162 int all); 163 164/* Return refs which no longer exist on remote */ 165struct ref *get_stale_heads(struct remote *remote, struct ref *fetch_map); 166 167#endif