14 static int find_tracked_branch(struct remote *remote, void *priv)
16 struct tracking *tracking = priv;
18 if (!remote_find_tracking(remote, &tracking->spec)) {
19 if (++tracking->matches == 1) {
20 tracking->src = tracking->spec.src;
21 tracking->remote = remote->name;
23 free(tracking->spec.src);
29 tracking->spec.src = NULL;
35 static int should_setup_rebase(const char *origin)
38 case AUTOREBASE_NEVER:
40 case AUTOREBASE_LOCAL:
41 return origin == NULL;
42 case AUTOREBASE_REMOTE:
43 return origin != NULL;
44 case AUTOREBASE_ALWAYS:
50 void install_branch_config(int flag, const char *local, const char *origin, const char *remote)
52 const char *shortname = remote + 11;
53 int remote_is_branch = !prefixcmp(remote, "refs/heads/");
54 struct strbuf key = STRBUF_INIT;
55 int rebasing = should_setup_rebase(origin);
58 && !strcmp(local, shortname)
60 warning(_("Not setting branch %s as its own upstream."),
65 strbuf_addf(&key, "branch.%s.remote", local);
66 git_config_set(key.buf, origin ? origin : ".");
69 strbuf_addf(&key, "branch.%s.merge", local);
70 git_config_set(key.buf, remote);
74 strbuf_addf(&key, "branch.%s.rebase", local);
75 git_config_set(key.buf, "true");
79 if (flag & BRANCH_CONFIG_VERBOSE) {
80 if (remote_is_branch && origin)
82 _("Branch %s set up to track remote branch %s from %s by rebasing.") :
83 _("Branch %s set up to track remote branch %s from %s."),
84 local, shortname, origin);
85 else if (remote_is_branch && !origin)
87 _("Branch %s set up to track local branch %s by rebasing.") :
88 _("Branch %s set up to track local branch %s."),
90 else if (!remote_is_branch && origin)
92 _("Branch %s set up to track remote ref %s by rebasing.") :
93 _("Branch %s set up to track remote ref %s."),
95 else if (!remote_is_branch && !origin)
97 _("Branch %s set up to track local ref %s by rebasing.") :
98 _("Branch %s set up to track local ref %s."),
101 die("BUG: impossible combination of %d and %p",
102 remote_is_branch, origin);
107 * This is called when new_ref is branched off of orig_ref, and tries
108 * to infer the settings for branch.<new_ref>.{remote,merge} from the
111 static int setup_tracking(const char *new_ref, const char *orig_ref,
112 enum branch_track track, int quiet)
114 struct tracking tracking;
115 int config_flags = quiet ? 0 : BRANCH_CONFIG_VERBOSE;
117 if (strlen(new_ref) > 1024 - 7 - 7 - 1)
118 return error(_("Tracking not set up: name too long: %s"),
121 memset(&tracking, 0, sizeof(tracking));
122 tracking.spec.dst = (char *)orig_ref;
123 if (for_each_remote(find_tracked_branch, &tracking))
126 if (!tracking.matches)
128 case BRANCH_TRACK_ALWAYS:
129 case BRANCH_TRACK_EXPLICIT:
130 case BRANCH_TRACK_OVERRIDE:
136 if (tracking.matches > 1)
137 return error(_("Not tracking: ambiguous information for ref %s"),
140 install_branch_config(config_flags, new_ref, tracking.remote,
141 tracking.src ? tracking.src : orig_ref);
147 struct branch_desc_cb {
148 const char *config_name;
152 static int read_branch_desc_cb(const char *var, const char *value, void *cb)
154 struct branch_desc_cb *desc = cb;
155 if (strcmp(desc->config_name, var))
157 free((char *)desc->value);
158 return git_config_string(&desc->value, var, value);
161 int read_branch_desc(struct strbuf *buf, const char *branch_name)
163 struct branch_desc_cb cb;
164 struct strbuf name = STRBUF_INIT;
165 strbuf_addf(&name, "branch.%s.description", branch_name);
166 cb.config_name = name.buf;
168 if (git_config(read_branch_desc_cb, &cb) < 0) {
169 strbuf_release(&name);
173 strbuf_addstr(buf, cb.value);
174 strbuf_release(&name);
178 int validate_new_branchname(const char *name, struct strbuf *ref,
179 int force, int attr_only)
181 if (strbuf_check_branch_ref(ref, name))
182 die(_("'%s' is not a valid branch name."), name);
184 if (!ref_exists(ref->buf))
186 else if (!force && !attr_only)
187 die(_("A branch named '%s' already exists."), ref->buf + strlen("refs/heads/"));
191 unsigned char sha1[20];
193 head = resolve_ref_unsafe("HEAD", sha1, 0, NULL);
194 if (!is_bare_repository() && head && !strcmp(head, ref->buf))
195 die(_("Cannot force update the current branch."));
200 static int check_tracking_branch(struct remote *remote, void *cb_data)
202 char *tracking_branch = cb_data;
203 struct refspec query;
204 memset(&query, 0, sizeof(struct refspec));
205 query.dst = tracking_branch;
206 return !(remote_find_tracking(remote, &query) ||
207 prefixcmp(query.src, "refs/heads/"));
210 static int validate_remote_tracking_branch(char *ref)
212 return !for_each_remote(check_tracking_branch, ref);
215 static const char upstream_not_branch[] =
216 N_("Cannot setup tracking information; starting point '%s' is not a branch.");
217 static const char upstream_missing[] =
218 N_("the requested upstream branch '%s' does not exist");
219 static const char upstream_advice[] =
221 "If you are planning on basing your work on an upstream\n"
222 "branch that already exists at the remote, you may need to\n"
223 "run \"git fetch\" to retrieve it.\n"
225 "If you are planning to push out a new local branch that\n"
226 "will track its remote counterpart, you may want to use\n"
227 "\"git push -u\" to set the upstream config as you push.");
229 void create_branch(const char *head,
230 const char *name, const char *start_name,
231 int force, int reflog, int clobber_head,
232 int quiet, enum branch_track track)
234 struct ref_lock *lock = NULL;
235 struct commit *commit;
236 unsigned char sha1[20];
237 char *real_ref, msg[PATH_MAX + 20];
238 struct strbuf ref = STRBUF_INIT;
240 int dont_change_ref = 0;
241 int explicit_tracking = 0;
243 if (track == BRANCH_TRACK_EXPLICIT || track == BRANCH_TRACK_OVERRIDE)
244 explicit_tracking = 1;
246 if (validate_new_branchname(name, &ref, force,
247 track == BRANCH_TRACK_OVERRIDE ||
256 if (get_sha1(start_name, sha1)) {
257 if (explicit_tracking) {
258 if (advice_set_upstream_failure) {
259 error(_(upstream_missing), start_name);
260 advise(_(upstream_advice));
263 die(_(upstream_missing), start_name);
265 die(_("Not a valid object name: '%s'."), start_name);
268 switch (dwim_ref(start_name, strlen(start_name), sha1, &real_ref)) {
270 /* Not branching from any existing branch */
271 if (explicit_tracking)
272 die(_(upstream_not_branch), start_name);
275 /* Unique completion -- good, only if it is a real branch */
276 if (prefixcmp(real_ref, "refs/heads/") &&
277 validate_remote_tracking_branch(real_ref)) {
278 if (explicit_tracking)
279 die(_(upstream_not_branch), start_name);
285 die(_("Ambiguous object name: '%s'."), start_name);
289 if ((commit = lookup_commit_reference(sha1)) == NULL)
290 die(_("Not a valid branch point: '%s'."), start_name);
291 hashcpy(sha1, commit->object.sha1);
293 if (!dont_change_ref) {
294 lock = lock_any_ref_for_update(ref.buf, NULL, 0);
296 die_errno(_("Failed to lock ref for update"));
300 log_all_ref_updates = 1;
303 snprintf(msg, sizeof msg, "branch: Reset to %s",
305 else if (!dont_change_ref)
306 snprintf(msg, sizeof msg, "branch: Created from %s",
309 if (real_ref && track)
310 setup_tracking(ref.buf + 11, real_ref, track, quiet);
312 if (!dont_change_ref)
313 if (write_ref_sha1(lock, sha1, msg) < 0)
314 die_errno(_("Failed to write ref"));
316 strbuf_release(&ref);
320 void remove_branch_state(void)
322 unlink(git_path("CHERRY_PICK_HEAD"));
323 unlink(git_path("REVERT_HEAD"));
324 unlink(git_path("MERGE_HEAD"));
325 unlink(git_path("MERGE_RR"));
326 unlink(git_path("MERGE_MSG"));
327 unlink(git_path("MERGE_MODE"));
328 unlink(git_path("SQUASH_MSG"));