git-remote: reject adding remotes with invalid names
[git/git.git] / remote.h
1 #ifndef REMOTE_H
2 #define REMOTE_H
3
4 struct remote {
5 const char *name;
6
7 const char **url;
8 int url_nr;
9 int url_alloc;
10
11 const char **push_refspec;
12 struct refspec *push;
13 int push_refspec_nr;
14 int push_refspec_alloc;
15
16 const char **fetch_refspec;
17 struct refspec *fetch;
18 int fetch_refspec_nr;
19 int fetch_refspec_alloc;
20
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;
28 int skip_default_update;
29
30 const char *receivepack;
31 const char *uploadpack;
32
33 /*
34 * for curl remotes only
35 */
36 char *http_proxy;
37 };
38
39 struct remote *remote_get(const char *name);
40
41 typedef int each_remote_fn(struct remote *remote, void *priv);
42 int for_each_remote(each_remote_fn fn, void *priv);
43
44 int remote_has_url(struct remote *remote, const char *url);
45
46 struct refspec {
47 unsigned force : 1;
48 unsigned pattern : 1;
49
50 char *src;
51 char *dst;
52 };
53
54 struct ref *alloc_ref(unsigned namelen);
55
56 struct ref *copy_ref_list(const struct ref *ref);
57
58 int check_ref_type(const struct ref *ref, int flags);
59
60 /*
61 * Frees the entire list and peers of elements.
62 */
63 void free_refs(struct ref *ref);
64
65 /*
66 * Removes and frees any duplicate refs in the map.
67 */
68 void ref_remove_duplicates(struct ref *ref_map);
69
70 int valid_fetch_refspec(const char *refspec);
71 struct refspec *parse_fetch_refspec(int nr_refspec, const char **refspec);
72 struct refspec *parse_push_refspec(int nr_refspec, const char **refspec);
73
74 int match_refs(struct ref *src, struct ref *dst, struct ref ***dst_tail,
75 int nr_refspec, const char **refspec, int all);
76
77 /*
78 * Given a list of the remote refs and the specification of things to
79 * fetch, makes a (separate) list of the refs to fetch and the local
80 * refs to store into.
81 *
82 * *tail is the pointer to the tail pointer of the list of results
83 * beforehand, and will be set to the tail pointer of the list of
84 * results afterward.
85 *
86 * missing_ok is usually false, but when we are adding branch.$name.merge
87 * it is Ok if the branch is not at the remote anymore.
88 */
89 int get_fetch_map(const struct ref *remote_refs, const struct refspec *refspec,
90 struct ref ***tail, int missing_ok);
91
92 struct ref *get_remote_ref(const struct ref *remote_refs, const char *name);
93
94 /*
95 * For the given remote, reads the refspec's src and sets the other fields.
96 */
97 int remote_find_tracking(struct remote *remote, struct refspec *refspec);
98
99 struct branch {
100 const char *name;
101 const char *refname;
102
103 const char *remote_name;
104 struct remote *remote;
105
106 const char **merge_name;
107 struct refspec **merge;
108 int merge_nr;
109 int merge_alloc;
110 };
111
112 struct branch *branch_get(const char *name);
113
114 int branch_has_merge_config(struct branch *branch);
115 int branch_merge_matches(struct branch *, int n, const char *);
116
117 /* Flags to match_refs. */
118 enum match_refs_flags {
119 MATCH_REFS_NONE = 0,
120 MATCH_REFS_ALL = (1 << 0),
121 MATCH_REFS_MIRROR = (1 << 1),
122 };
123
124 #endif