1 #include "git-compat-util.h"
17 static int find_tracked_branch(struct remote *remote, void *priv)
19 struct tracking *tracking = priv;
21 if (!remote_find_tracking(remote, &tracking->spec)) {
22 if (++tracking->matches == 1) {
23 tracking->src = tracking->spec.src;
24 tracking->remote = remote->name;
26 free(tracking->spec.src);
28 FREE_AND_NULL(tracking->src);
31 tracking->spec.src = NULL;
37 static int should_setup_rebase(const char *origin)
40 case AUTOREBASE_NEVER:
42 case AUTOREBASE_LOCAL:
43 return origin == NULL;
44 case AUTOREBASE_REMOTE:
45 return origin != NULL;
46 case AUTOREBASE_ALWAYS:
52 static const char tracking_advice[] =
54 "After fixing the error cause you may try to fix up\n"
55 "the remote tracking information by invoking\n"
56 "\"git branch --set-upstream-to=%s%s%s\".");
58 int install_branch_config(int flag, const char *local, const char *origin, const char *remote)
60 const char *shortname = NULL;
61 struct strbuf key = STRBUF_INIT;
62 int rebasing = should_setup_rebase(origin);
64 if (skip_prefix(remote, "refs/heads/", &shortname)
65 && !strcmp(local, shortname)
67 warning(_("Not setting branch %s as its own upstream."),
72 strbuf_addf(&key, "branch.%s.remote", local);
73 if (git_config_set_gently(key.buf, origin ? origin : ".") < 0)
77 strbuf_addf(&key, "branch.%s.merge", local);
78 if (git_config_set_gently(key.buf, remote) < 0)
83 strbuf_addf(&key, "branch.%s.rebase", local);
84 if (git_config_set_gently(key.buf, "true") < 0)
89 if (flag & BRANCH_CONFIG_VERBOSE) {
93 _("Branch '%s' set up to track remote branch '%s' from '%s' by rebasing.") :
94 _("Branch '%s' set up to track remote branch '%s' from '%s'."),
95 local, shortname, origin);
98 _("Branch '%s' set up to track local branch '%s' by rebasing.") :
99 _("Branch '%s' set up to track local branch '%s'."),
104 _("Branch '%s' set up to track remote ref '%s' by rebasing.") :
105 _("Branch '%s' set up to track remote ref '%s'."),
109 _("Branch '%s' set up to track local ref '%s' by rebasing.") :
110 _("Branch '%s' set up to track local ref '%s'."),
118 strbuf_release(&key);
119 error(_("Unable to write upstream branch configuration"));
121 advise(_(tracking_advice),
122 origin ? origin : "",
124 shortname ? shortname : remote);
130 * This is called when new_ref is branched off of orig_ref, and tries
131 * to infer the settings for branch.<new_ref>.{remote,merge} from the
134 static void setup_tracking(const char *new_ref, const char *orig_ref,
135 enum branch_track track, int quiet)
137 struct tracking tracking;
138 int config_flags = quiet ? 0 : BRANCH_CONFIG_VERBOSE;
140 memset(&tracking, 0, sizeof(tracking));
141 tracking.spec.dst = (char *)orig_ref;
142 if (for_each_remote(find_tracked_branch, &tracking))
145 if (!tracking.matches)
147 case BRANCH_TRACK_ALWAYS:
148 case BRANCH_TRACK_EXPLICIT:
149 case BRANCH_TRACK_OVERRIDE:
155 if (tracking.matches > 1)
156 die(_("Not tracking: ambiguous information for ref %s"),
159 if (install_branch_config(config_flags, new_ref, tracking.remote,
160 tracking.src ? tracking.src : orig_ref) < 0)
166 int read_branch_desc(struct strbuf *buf, const char *branch_name)
169 struct strbuf name = STRBUF_INIT;
170 strbuf_addf(&name, "branch.%s.description", branch_name);
171 if (git_config_get_string(name.buf, &v)) {
172 strbuf_release(&name);
175 strbuf_addstr(buf, v);
177 strbuf_release(&name);
182 * Check if 'name' can be a valid name for a branch; die otherwise.
183 * Return 1 if the named branch already exists; return 0 otherwise.
184 * Fill ref with the full refname for the branch.
186 int validate_branchname(const char *name, struct strbuf *ref)
188 if (strbuf_check_branch_ref(ref, name))
189 die(_("'%s' is not a valid branch name."), name);
191 return ref_exists(ref->buf);
195 * Check if a branch 'name' can be created as a new branch; die otherwise.
196 * 'force' can be used when it is OK for the named branch already exists.
197 * Return 1 if the named branch already exists; return 0 otherwise.
198 * Fill ref with the full refname for the branch.
200 int validate_new_branchname(const char *name, struct strbuf *ref, int force)
204 if (!validate_branchname(name, ref))
208 die(_("A branch named '%s' already exists."),
209 ref->buf + strlen("refs/heads/"));
211 head = resolve_ref_unsafe("HEAD", 0, NULL, NULL);
212 if (!is_bare_repository() && head && !strcmp(head, ref->buf))
213 die(_("Cannot force update the current branch."));
218 static int check_tracking_branch(struct remote *remote, void *cb_data)
220 char *tracking_branch = cb_data;
221 struct refspec query;
222 memset(&query, 0, sizeof(struct refspec));
223 query.dst = tracking_branch;
224 return !remote_find_tracking(remote, &query);
227 static int validate_remote_tracking_branch(char *ref)
229 return !for_each_remote(check_tracking_branch, ref);
232 static const char upstream_not_branch[] =
233 N_("Cannot setup tracking information; starting point '%s' is not a branch.");
234 static const char upstream_missing[] =
235 N_("the requested upstream branch '%s' does not exist");
236 static const char upstream_advice[] =
238 "If you are planning on basing your work on an upstream\n"
239 "branch that already exists at the remote, you may need to\n"
240 "run \"git fetch\" to retrieve it.\n"
242 "If you are planning to push out a new local branch that\n"
243 "will track its remote counterpart, you may want to use\n"
244 "\"git push -u\" to set the upstream config as you push.");
246 void create_branch(const char *name, const char *start_name,
247 int force, int clobber_head_ok, int reflog,
248 int quiet, enum branch_track track)
250 struct commit *commit;
251 struct object_id oid;
253 struct strbuf ref = STRBUF_INIT;
255 int dont_change_ref = 0;
256 int explicit_tracking = 0;
258 if (track == BRANCH_TRACK_EXPLICIT || track == BRANCH_TRACK_OVERRIDE)
259 explicit_tracking = 1;
261 if ((track == BRANCH_TRACK_OVERRIDE || clobber_head_ok)
262 ? validate_branchname(name, &ref)
263 : validate_new_branchname(name, &ref, force)) {
271 if (get_oid(start_name, &oid)) {
272 if (explicit_tracking) {
273 if (advice_set_upstream_failure) {
274 error(_(upstream_missing), start_name);
275 advise(_(upstream_advice));
278 die(_(upstream_missing), start_name);
280 die(_("Not a valid object name: '%s'."), start_name);
283 switch (dwim_ref(start_name, strlen(start_name), &oid, &real_ref)) {
285 /* Not branching from any existing branch */
286 if (explicit_tracking)
287 die(_(upstream_not_branch), start_name);
290 /* Unique completion -- good, only if it is a real branch */
291 if (!starts_with(real_ref, "refs/heads/") &&
292 validate_remote_tracking_branch(real_ref)) {
293 if (explicit_tracking)
294 die(_(upstream_not_branch), start_name);
300 die(_("Ambiguous object name: '%s'."), start_name);
304 if ((commit = lookup_commit_reference(&oid)) == NULL)
305 die(_("Not a valid branch point: '%s'."), start_name);
306 oidcpy(&oid, &commit->object.oid);
309 log_all_ref_updates = LOG_REFS_NORMAL;
311 if (!dont_change_ref) {
312 struct ref_transaction *transaction;
313 struct strbuf err = STRBUF_INIT;
317 msg = xstrfmt("branch: Reset to %s", start_name);
319 msg = xstrfmt("branch: Created from %s", start_name);
321 transaction = ref_transaction_begin(&err);
323 ref_transaction_update(transaction, ref.buf,
324 &oid, forcing ? NULL : &null_oid,
326 ref_transaction_commit(transaction, &err))
328 ref_transaction_free(transaction);
329 strbuf_release(&err);
333 if (real_ref && track)
334 setup_tracking(ref.buf + 11, real_ref, track, quiet);
336 strbuf_release(&ref);
340 void remove_branch_state(void)
342 unlink(git_path_cherry_pick_head());
343 unlink(git_path_revert_head());
344 unlink(git_path_merge_head());
345 unlink(git_path_merge_rr());
346 unlink(git_path_merge_msg());
347 unlink(git_path_merge_mode());
348 unlink(git_path_squash_msg());
351 void die_if_checked_out(const char *branch, int ignore_current_worktree)
353 const struct worktree *wt;
355 wt = find_shared_symref("HEAD", branch);
356 if (!wt || (ignore_current_worktree && wt->is_current))
358 skip_prefix(branch, "refs/heads/", &branch);
359 die(_("'%s' is already checked out at '%s'"),
363 int replace_each_worktree_head_symref(const char *oldref, const char *newref,
367 struct worktree **worktrees = get_worktrees(0);
370 for (i = 0; worktrees[i]; i++) {
371 struct ref_store *refs;
373 if (worktrees[i]->is_detached)
375 if (!worktrees[i]->head_ref)
377 if (strcmp(oldref, worktrees[i]->head_ref))
380 refs = get_worktree_ref_store(worktrees[i]);
381 if (refs_create_symref(refs, "HEAD", newref, logmsg))
382 ret = error(_("HEAD of working tree %s is not updated"),
386 free_worktrees(worktrees);