1#ifndef REMOTE_H 2#define REMOTE_H 3 4#include"cache.h" 5#include"parse-options.h" 6#include"hashmap.h" 7#include"refspec.h" 8 9enum{ 10 REMOTE_UNCONFIGURED =0, 11 REMOTE_CONFIG, 12 REMOTE_REMOTES, 13 REMOTE_BRANCHES 14}; 15 16struct remote { 17struct hashmap_entry ent;/* must be first */ 18 19const char*name; 20int origin, configured_in_repo; 21 22const char*foreign_vcs; 23 24const char**url; 25int url_nr; 26int url_alloc; 27 28const char**pushurl; 29int pushurl_nr; 30int pushurl_alloc; 31 32struct refspec push; 33 34struct refspec fetch; 35 36/* 37 * -1 to never fetch tags 38 * 0 to auto-follow tags on heuristic (default) 39 * 1 to always auto-follow tags 40 * 2 to always fetch tags 41 */ 42int fetch_tags; 43int skip_default_update; 44int mirror; 45int prune; 46int prune_tags; 47 48const char*receivepack; 49const char*uploadpack; 50 51/* 52 * for curl remotes only 53 */ 54char*http_proxy; 55char*http_proxy_authmethod; 56}; 57 58struct remote *remote_get(const char*name); 59struct remote *pushremote_get(const char*name); 60intremote_is_configured(struct remote *remote,int in_repo); 61 62typedefinteach_remote_fn(struct remote *remote,void*priv); 63intfor_each_remote(each_remote_fn fn,void*priv); 64 65intremote_has_url(struct remote *remote,const char*url); 66 67struct ref { 68struct ref *next; 69struct object_id old_oid; 70struct object_id new_oid; 71struct object_id old_oid_expect;/* used by expect-old */ 72char*symref; 73unsigned int 74 force:1, 75 forced_update:1, 76 expect_old_sha1:1, 77 exact_oid:1, 78 deletion:1; 79 80enum{ 81 REF_NOT_MATCHED =0,/* initial value */ 82 REF_MATCHED, 83 REF_UNADVERTISED_NOT_ALLOWED 84} match_status; 85 86/* 87 * Order is important here, as we write to FETCH_HEAD 88 * in numeric order. And the default NOT_FOR_MERGE 89 * should be 0, so that xcalloc'd structures get it 90 * by default. 91 */ 92enum{ 93 FETCH_HEAD_MERGE = -1, 94 FETCH_HEAD_NOT_FOR_MERGE =0, 95 FETCH_HEAD_IGNORE =1 96} fetch_head_status; 97 98enum{ 99 REF_STATUS_NONE =0, 100 REF_STATUS_OK, 101 REF_STATUS_REJECT_NONFASTFORWARD, 102 REF_STATUS_REJECT_ALREADY_EXISTS, 103 REF_STATUS_REJECT_NODELETE, 104 REF_STATUS_REJECT_FETCH_FIRST, 105 REF_STATUS_REJECT_NEEDS_FORCE, 106 REF_STATUS_REJECT_STALE, 107 REF_STATUS_REJECT_SHALLOW, 108 REF_STATUS_UPTODATE, 109 REF_STATUS_REMOTE_REJECT, 110 REF_STATUS_EXPECTING_REPORT, 111 REF_STATUS_ATOMIC_PUSH_FAILED 112} status; 113char*remote_status; 114struct ref *peer_ref;/* when renaming */ 115char name[FLEX_ARRAY];/* more */ 116}; 117 118#define REF_NORMAL (1u << 0) 119#define REF_HEADS (1u << 1) 120#define REF_TAGS (1u << 2) 121 122struct ref *find_ref_by_name(const struct ref *list,const char*name); 123 124struct ref *alloc_ref(const char*name); 125struct ref *copy_ref(const struct ref *ref); 126struct ref *copy_ref_list(const struct ref *ref); 127voidsort_ref_list(struct ref **,int(*cmp)(const void*,const void*)); 128intcount_refspec_match(const char*,struct ref *refs,struct ref **matched_ref); 129intref_compare_name(const void*,const void*); 130 131intcheck_ref_type(const struct ref *ref,int flags); 132 133/* 134 * Free a single ref and its peer, or an entire list of refs and their peers, 135 * respectively. 136 */ 137voidfree_one_ref(struct ref *ref); 138voidfree_refs(struct ref *ref); 139 140struct oid_array; 141struct packet_reader; 142struct argv_array; 143struct string_list; 144struct ref **get_remote_heads(struct packet_reader *reader, 145struct ref **list,unsigned int flags, 146struct oid_array *extra_have, 147struct oid_array *shallow_points); 148 149/* Used for protocol v2 in order to retrieve refs from a remote */ 150struct ref **get_remote_refs(int fd_out,struct packet_reader *reader, 151struct ref **list,int for_push, 152const struct argv_array *ref_prefixes, 153const struct string_list *server_options); 154 155intresolve_remote_symref(struct ref *ref,struct ref *list); 156 157/* 158 * Remove and free all but the first of any entries in the input list 159 * that map the same remote reference to the same local reference. If 160 * there are two entries that map different remote references to the 161 * same local reference, emit an error message and die. Return a 162 * pointer to the head of the resulting list. 163 */ 164struct ref *ref_remove_duplicates(struct ref *ref_map); 165 166intquery_refspecs(struct refspec *rs,struct refspec_item *query); 167char*apply_refspecs(struct refspec *rs,const char*name); 168 169intcheck_push_refs(struct ref *src,struct refspec *rs); 170intmatch_push_refs(struct ref *src,struct ref **dst, 171struct refspec *rs,int flags); 172voidset_ref_status_for_push(struct ref *remote_refs,int send_mirror, 173int force_update); 174 175/* 176 * Given a list of the remote refs and the specification of things to 177 * fetch, makes a (separate) list of the refs to fetch and the local 178 * refs to store into. 179 * 180 * *tail is the pointer to the tail pointer of the list of results 181 * beforehand, and will be set to the tail pointer of the list of 182 * results afterward. 183 * 184 * missing_ok is usually false, but when we are adding branch.$name.merge 185 * it is Ok if the branch is not at the remote anymore. 186 */ 187intget_fetch_map(const struct ref *remote_refs,const struct refspec_item *refspec, 188struct ref ***tail,int missing_ok); 189 190struct ref *get_remote_ref(const struct ref *remote_refs,const char*name); 191 192/* 193 * For the given remote, reads the refspec's src and sets the other fields. 194 */ 195intremote_find_tracking(struct remote *remote,struct refspec_item *refspec); 196 197struct branch { 198const char*name; 199const char*refname; 200 201const char*remote_name; 202const char*pushremote_name; 203 204const char**merge_name; 205struct refspec_item **merge; 206int merge_nr; 207int merge_alloc; 208 209const char*push_tracking_ref; 210}; 211 212struct branch *branch_get(const char*name); 213const char*remote_for_branch(struct branch *branch,int*explicit); 214const char*pushremote_for_branch(struct branch *branch,int*explicit); 215const char*remote_ref_for_branch(struct branch *branch,int for_push, 216int*explicit); 217 218intbranch_has_merge_config(struct branch *branch); 219intbranch_merge_matches(struct branch *,int n,const char*); 220 221/** 222 * Return the fully-qualified refname of the tracking branch for `branch`. 223 * I.e., what "branch@{upstream}" would give you. Returns NULL if no 224 * upstream is defined. 225 * 226 * If `err` is not NULL and no upstream is defined, a more specific error 227 * message is recorded there (if the function does not return NULL, then 228 * `err` is not touched). 229 */ 230const char*branch_get_upstream(struct branch *branch,struct strbuf *err); 231 232/** 233 * Return the tracking branch that corresponds to the ref we would push to 234 * given a bare `git push` while `branch` is checked out. 235 * 236 * The return value and `err` conventions match those of `branch_get_upstream`. 237 */ 238const char*branch_get_push(struct branch *branch,struct strbuf *err); 239 240/* Flags to match_refs. */ 241enum match_refs_flags { 242 MATCH_REFS_NONE =0, 243 MATCH_REFS_ALL = (1<<0), 244 MATCH_REFS_MIRROR = (1<<1), 245 MATCH_REFS_PRUNE = (1<<2), 246 MATCH_REFS_FOLLOW_TAGS = (1<<3) 247}; 248 249/* Flags for --ahead-behind option. */ 250enum ahead_behind_flags { 251 AHEAD_BEHIND_UNSPECIFIED = -1, 252 AHEAD_BEHIND_QUICK =0,/* just eq/neq reporting */ 253 AHEAD_BEHIND_FULL =1,/* traditional a/b reporting */ 254}; 255 256/* Reporting of tracking info */ 257intstat_tracking_info(struct branch *branch,int*num_ours,int*num_theirs, 258const char**upstream_name,int for_push, 259enum ahead_behind_flags abf); 260intformat_tracking_info(struct branch *branch,struct strbuf *sb, 261enum ahead_behind_flags abf); 262 263struct ref *get_local_heads(void); 264/* 265 * Find refs from a list which are likely to be pointed to by the given HEAD 266 * ref. If 'all' is false, returns the most likely ref; otherwise, returns a 267 * list of all candidate refs. If no match is found (or 'head' is NULL), 268 * returns NULL. All returns are newly allocated and should be freed. 269 */ 270struct ref *guess_remote_head(const struct ref *head, 271const struct ref *refs, 272int all); 273 274/* Return refs which no longer exist on remote */ 275struct ref *get_stale_heads(struct refspec *rs,struct ref *fetch_map); 276 277/* 278 * Compare-and-swap 279 */ 280#define CAS_OPT_NAME"force-with-lease" 281 282struct push_cas_option { 283unsigned use_tracking_for_rest:1; 284struct push_cas { 285struct object_id expect; 286unsigned use_tracking:1; 287char*refname; 288} *entry; 289int nr; 290int alloc; 291}; 292 293intparseopt_push_cas_option(const struct option *,const char*arg,int unset); 294 295intis_empty_cas(const struct push_cas_option *); 296voidapply_push_cas(struct push_cas_option *,struct remote *,struct ref *); 297 298#endif