1 #ifndef REMOTE_H
2 #define REMOTE_H
4 struct remote {
5 const char *name;
7 const char **url;
8 int url_nr;
9 int url_alloc;
11 const char **push_refspec;
12 struct refspec *push;
13 int push_refspec_nr;
14 int push_refspec_alloc;
16 const char **fetch_refspec;
17 struct refspec *fetch;
18 int fetch_refspec_nr;
19 int fetch_refspec_alloc;
21 /*
22 * -1 to never fetch tags
23 * 0 to auto-follow tags on heuristic (default)
24 * 1 to always auto-follow tags
25 * 2 to always fetch tags
26 */
27 int fetch_tags;
29 const char *receivepack;
30 const char *uploadpack;
32 /*
33 * for curl remotes only
34 */
35 char *http_proxy;
36 };
38 struct remote *remote_get(const char *name);
40 typedef int each_remote_fn(struct remote *remote, void *priv);
41 int for_each_remote(each_remote_fn fn, void *priv);
43 int remote_has_url(struct remote *remote, const char *url);
45 struct refspec {
46 unsigned force : 1;
47 unsigned pattern : 1;
49 char *src;
50 char *dst;
51 };
53 struct ref *alloc_ref(unsigned namelen);
55 struct ref *copy_ref_list(const struct ref *ref);
57 int check_ref_type(const struct ref *ref, int flags);
59 /*
60 * Frees the entire list and peers of elements.
61 */
62 void free_refs(struct ref *ref);
64 /*
65 * Removes and frees any duplicate refs in the map.
66 */
67 void ref_remove_duplicates(struct ref *ref_map);
69 struct refspec *parse_ref_spec(int nr_refspec, const char **refspec);
71 int match_refs(struct ref *src, struct ref *dst, struct ref ***dst_tail,
72 int nr_refspec, const char **refspec, int all);
74 /*
75 * Given a list of the remote refs and the specification of things to
76 * fetch, makes a (separate) list of the refs to fetch and the local
77 * refs to store into.
78 *
79 * *tail is the pointer to the tail pointer of the list of results
80 * beforehand, and will be set to the tail pointer of the list of
81 * results afterward.
82 *
83 * missing_ok is usually false, but when we are adding branch.$name.merge
84 * it is Ok if the branch is not at the remote anymore.
85 */
86 int get_fetch_map(const struct ref *remote_refs, const struct refspec *refspec,
87 struct ref ***tail, int missing_ok);
89 struct ref *get_remote_ref(const struct ref *remote_refs, const char *name);
91 /*
92 * For the given remote, reads the refspec's src and sets the other fields.
93 */
94 int remote_find_tracking(struct remote *remote, struct refspec *refspec);
96 struct branch {
97 const char *name;
98 const char *refname;
100 const char *remote_name;
101 struct remote *remote;
103 const char **merge_name;
104 struct refspec **merge;
105 int merge_nr;
106 int merge_alloc;
107 };
109 struct branch *branch_get(const char *name);
111 int branch_has_merge_config(struct branch *branch);
112 int branch_merge_matches(struct branch *, int n, const char *);
114 /* Flags to match_refs. */
115 enum match_refs_flags {
116 MATCH_REFS_NONE = 0,
117 MATCH_REFS_ALL = (1 << 0),
118 MATCH_REFS_MIRROR = (1 << 1),
119 };
121 #endif