builtin/push.c

   1 /*
   2  * "git push"
   3  */
   4 #include "cache.h"
   5 #include "refs.h"
   6 #include "run-command.h"
   7 #include "builtin.h"
   8 #include "remote.h"
   9 #include "transport.h"
  10 #include "parse-options.h"
  11 #include "submodule.h"
  12
  13 static const char * const push_usage[] = {
  14         N_("git push [<options>] [<repository> [<refspec>...]]"),
  15         NULL,
  16 };
  17
  18 static int thin;
  19 static int deleterefs;
  20 static const char *receivepack;
  21 static int verbosity;
  22 static int progress = -1;
  23
  24 static struct push_cas_option cas;
  25
  26 static const char **refspec;
  27 static int refspec_nr;
  28 static int refspec_alloc;
  29 static int default_matching_used;
  30
  31 static void add_refspec(const char *ref)
  32 {
  33         refspec_nr++;
  34         ALLOC_GROW(refspec, refspec_nr, refspec_alloc);
  35         refspec[refspec_nr-1] = ref;
  36 }
  37
  38 static void set_refspecs(const char **refs, int nr)
  39 {
  40         int i;
  41         for (i = 0; i < nr; i++) {
  42                 const char *ref = refs[i];
  43                 if (!strcmp("tag", ref)) {
  44                         char *tag;
  45                         int len;
  46                         if (nr <= ++i)
  47                                 die(_("tag shorthand without <tag>"));
  48                         len = strlen(refs[i]) + 11;
  49                         if (deleterefs) {
  50                                 tag = xmalloc(len+1);
  51                                 strcpy(tag, ":refs/tags/");
  52                         } else {
  53                                 tag = xmalloc(len);
  54                                 strcpy(tag, "refs/tags/");
  55                         }
  56                         strcat(tag, refs[i]);
  57                         ref = tag;
  58                 } else if (deleterefs && !strchr(ref, ':')) {
  59                         char *delref;
  60                         int len = strlen(ref)+1;
  61                         delref = xmalloc(len+1);
  62                         strcpy(delref, ":");
  63                         strcat(delref, ref);
  64                         ref = delref;
  65                 } else if (deleterefs)
  66                         die(_("--delete only accepts plain target ref names"));
  67                 add_refspec(ref);
  68         }
  69 }
  70
  71 static int push_url_of_remote(struct remote *remote, const char ***url_p)
  72 {
  73         if (remote->pushurl_nr) {
  74                 *url_p = remote->pushurl;
  75                 return remote->pushurl_nr;
  76         }
  77         *url_p = remote->url;
  78         return remote->url_nr;
  79 }
  80
  81 static NORETURN int die_push_simple(struct branch *branch, struct remote *remote) {
  82         /*
  83          * There's no point in using shorten_unambiguous_ref here,
  84          * as the ambiguity would be on the remote side, not what
  85          * we have locally. Plus, this is supposed to be the simple
  86          * mode. If the user is doing something crazy like setting
  87          * upstream to a non-branch, we should probably be showing
  88          * them the big ugly fully qualified ref.
  89          */
  90         const char *advice_maybe = "";
  91         const char *short_upstream =
  92                 skip_prefix(branch->merge[0]->src, "refs/heads/");
  93
  94         if (!short_upstream)
  95                 short_upstream = branch->merge[0]->src;
  96         /*
  97          * Don't show advice for people who explicitely set
  98          * push.default.
  99          */
 100         if (push_default == PUSH_DEFAULT_UNSPECIFIED)
 101                 advice_maybe = _("\n"
 102                                  "To choose either option permanently, "
 103                                  "see push.default in 'git help config'.");
 104         die(_("The upstream branch of your current branch does not match\n"
 105               "the name of your current branch.  To push to the upstream branch\n"
 106               "on the remote, use\n"
 107               "\n"
 108               "    git push %s HEAD:%s\n"
 109               "\n"
 110               "To push to the branch of the same name on the remote, use\n"
 111               "\n"
 112               "    git push %s %s\n"
 113               "%s"),
 114             remote->name, short_upstream,
 115             remote->name, branch->name, advice_maybe);
 116 }
 117
 118 static const char message_detached_head_die[] =
 119         N_("You are not currently on a branch.\n"
 120            "To push the history leading to the current (detached HEAD)\n"
 121            "state now, use\n"
 122            "\n"
 123            "    git push %s HEAD:<name-of-remote-branch>\n");
 124
 125 static void setup_push_upstream(struct remote *remote, int simple)
 126 {
 127         struct strbuf refspec = STRBUF_INIT;
 128         struct branch *branch = branch_get(NULL);
 129         if (!branch)
 130                 die(_(message_detached_head_die), remote->name);
 131         if (!branch->merge_nr || !branch->merge || !branch->remote_name)
 132                 die(_("The current branch %s has no upstream branch.\n"
 133                     "To push the current branch and set the remote as upstream, use\n"
 134                     "\n"
 135                     "    git push --set-upstream %s %s\n"),
 136                     branch->name,
 137                     remote->name,
 138                     branch->name);
 139         if (branch->merge_nr != 1)
 140                 die(_("The current branch %s has multiple upstream branches, "
 141                     "refusing to push."), branch->name);
 142         if (strcmp(branch->remote_name, remote->name))
 143                 die(_("You are pushing to remote '%s', which is not the upstream of\n"
 144                       "your current branch '%s', without telling me what to push\n"
 145                       "to update which remote branch."),
 146                     remote->name, branch->name);
 147         if (simple && strcmp(branch->refname, branch->merge[0]->src))
 148                 die_push_simple(branch, remote);
 149
 150         strbuf_addf(&refspec, "%s:%s", branch->name, branch->merge[0]->src);
 151         add_refspec(refspec.buf);
 152 }
 153
 154 static char warn_unspecified_push_default_msg[] =
 155 N_("push.default is unset; its implicit value is changing in\n"
 156    "Git 2.0 from 'matching' to 'simple'. To squelch this message\n"
 157    "and maintain the current behavior after the default changes, use:\n"
 158    "\n"
 159    "  git config --global push.default matching\n"
 160    "\n"
 161    "To squelch this message and adopt the new behavior now, use:\n"
 162    "\n"
 163    "  git config --global push.default simple\n"
 164    "\n"
 165    "See 'git help config' and search for 'push.default' for further information.\n"
 166    "(the 'simple' mode was introduced in Git 1.7.11. Use the similar mode\n"
 167    "'current' instead of 'simple' if you sometimes use older versions of Git)");
 168
 169 static void warn_unspecified_push_default_configuration(void)
 170 {
 171         static int warn_once;
 172
 173         if (warn_once++)
 174                 return;
 175         warning("%s\n", _(warn_unspecified_push_default_msg));
 176 }
 177
 178 static void setup_default_push_refspecs(struct remote *remote)
 179 {
 180         struct branch *branch;
 181
 182         switch (push_default) {
 183         default:
 184         case PUSH_DEFAULT_UNSPECIFIED:
 185                 default_matching_used = 1;
 186                 warn_unspecified_push_default_configuration();
 187                 /* fallthru */
 188         case PUSH_DEFAULT_MATCHING:
 189                 add_refspec(":");
 190                 break;
 191
 192         case PUSH_DEFAULT_SIMPLE:
 193                 setup_push_upstream(remote, 1);
 194                 break;
 195
 196         case PUSH_DEFAULT_UPSTREAM:
 197                 setup_push_upstream(remote, 0);
 198                 break;
 199
 200         case PUSH_DEFAULT_CURRENT:
 201                 branch = branch_get(NULL);
 202                 if (!branch)
 203                         die(_(message_detached_head_die), remote->name);
 204                 add_refspec(branch->name);
 205                 break;
 206
 207         case PUSH_DEFAULT_NOTHING:
 208                 die(_("You didn't specify any refspecs to push, and "
 209                     "push.default is \"nothing\"."));
 210                 break;
 211         }
 212 }
 213
 214 static const char message_advice_pull_before_push[] =
 215         N_("Updates were rejected because the tip of your current branch is behind\n"
 216            "its remote counterpart. Merge the remote changes (e.g. 'git pull')\n"
 217            "before pushing again.\n"
 218            "See the 'Note about fast-forwards' in 'git push --help' for details.");
 219
 220 static const char message_advice_use_upstream[] =
 221         N_("Updates were rejected because a pushed branch tip is behind its remote\n"
 222            "counterpart. If you did not intend to push that branch, you may want to\n"
 223            "specify branches to push or set the 'push.default' configuration variable\n"
 224            "to 'simple', 'current' or 'upstream' to push only the current branch.");
 225
 226 static const char message_advice_checkout_pull_push[] =
 227         N_("Updates were rejected because a pushed branch tip is behind its remote\n"
 228            "counterpart. Check out this branch and merge the remote changes\n"
 229            "(e.g. 'git pull') before pushing again.\n"
 230            "See the 'Note about fast-forwards' in 'git push --help' for details.");
 231
 232 static const char message_advice_ref_fetch_first[] =
 233         N_("Updates were rejected because the remote contains work that you do\n"
 234            "not have locally. This is usually caused by another repository pushing\n"
 235            "to the same ref. You may want to first merge the remote changes (e.g.,\n"
 236            "'git pull') before pushing again.\n"
 237            "See the 'Note about fast-forwards' in 'git push --help' for details.");
 238
 239 static const char message_advice_ref_already_exists[] =
 240         N_("Updates were rejected because the tag already exists in the remote.");
 241
 242 static const char message_advice_ref_needs_force[] =
 243         N_("You cannot update a remote ref that points at a non-commit object,\n"
 244            "or update a remote ref to make it point at a non-commit object,\n"
 245            "without using the '--force' option.\n");
 246
 247 static void advise_pull_before_push(void)
 248 {
 249         if (!advice_push_non_ff_current || !advice_push_update_rejected)
 250                 return;
 251         advise(_(message_advice_pull_before_push));
 252 }
 253
 254 static void advise_use_upstream(void)
 255 {
 256         if (!advice_push_non_ff_default || !advice_push_update_rejected)
 257                 return;
 258         advise(_(message_advice_use_upstream));
 259 }
 260
 261 static void advise_checkout_pull_push(void)
 262 {
 263         if (!advice_push_non_ff_matching || !advice_push_update_rejected)
 264                 return;
 265         advise(_(message_advice_checkout_pull_push));
 266 }
 267
 268 static void advise_ref_already_exists(void)
 269 {
 270         if (!advice_push_already_exists || !advice_push_update_rejected)
 271                 return;
 272         advise(_(message_advice_ref_already_exists));
 273 }
 274
 275 static void advise_ref_fetch_first(void)
 276 {
 277         if (!advice_push_fetch_first || !advice_push_update_rejected)
 278                 return;
 279         advise(_(message_advice_ref_fetch_first));
 280 }
 281
 282 static void advise_ref_needs_force(void)
 283 {
 284         if (!advice_push_needs_force || !advice_push_update_rejected)
 285                 return;
 286         advise(_(message_advice_ref_needs_force));
 287 }
 288
 289 static int push_with_options(struct transport *transport, int flags)
 290 {
 291         int err;
 292         unsigned int reject_reasons;
 293
 294         transport_set_verbosity(transport, verbosity, progress);
 295
 296         if (receivepack)
 297                 transport_set_option(transport,
 298                                      TRANS_OPT_RECEIVEPACK, receivepack);
 299         if (thin)
 300                 transport_set_option(transport, TRANS_OPT_THIN, "yes");
 301
 302         if (verbosity > 0)
 303                 fprintf(stderr, _("Pushing to %s\n"), transport->url);
 304         err = transport_push(transport, refspec_nr, refspec, flags,
 305                              &reject_reasons);
 306         if (err != 0)
 307                 error(_("failed to push some refs to '%s'"), transport->url);
 308
 309         err |= transport_disconnect(transport);
 310         if (!err)
 311                 return 0;
 312
 313         if (reject_reasons & REJECT_NON_FF_HEAD) {
 314                 advise_pull_before_push();
 315         } else if (reject_reasons & REJECT_NON_FF_OTHER) {
 316                 if (default_matching_used)
 317                         advise_use_upstream();
 318                 else
 319                         advise_checkout_pull_push();
 320         } else if (reject_reasons & REJECT_ALREADY_EXISTS) {
 321                 advise_ref_already_exists();
 322         } else if (reject_reasons & REJECT_FETCH_FIRST) {
 323                 advise_ref_fetch_first();
 324         } else if (reject_reasons & REJECT_NEEDS_FORCE) {
 325                 advise_ref_needs_force();
 326         }
 327
 328         return 1;
 329 }
 330
 331 static int do_push(const char *repo, int flags)
 332 {
 333         int i, errs;
 334         struct remote *remote = pushremote_get(repo);
 335         const char **url;
 336         int url_nr;
 337
 338         if (!remote) {
 339                 if (repo)
 340                         die(_("bad repository '%s'"), repo);
 341                 die(_("No configured push destination.\n"
 342                     "Either specify the URL from the command-line or configure a remote repository using\n"
 343                     "\n"
 344                     "    git remote add <name> <url>\n"
 345                     "\n"
 346                     "and then push using the remote name\n"
 347                     "\n"
 348                     "    git push <name>\n"));
 349         }
 350
 351         if (remote->mirror)
 352                 flags |= (TRANSPORT_PUSH_MIRROR|TRANSPORT_PUSH_FORCE);
 353
 354         if ((flags & TRANSPORT_PUSH_ALL) && refspec) {
 355                 if (!strcmp(*refspec, "refs/tags/*"))
 356                         return error(_("--all and --tags are incompatible"));
 357                 return error(_("--all can't be combined with refspecs"));
 358         }
 359
 360         if ((flags & TRANSPORT_PUSH_MIRROR) && refspec) {
 361                 if (!strcmp(*refspec, "refs/tags/*"))
 362                         return error(_("--mirror and --tags are incompatible"));
 363                 return error(_("--mirror can't be combined with refspecs"));
 364         }
 365
 366         if ((flags & (TRANSPORT_PUSH_ALL|TRANSPORT_PUSH_MIRROR)) ==
 367                                 (TRANSPORT_PUSH_ALL|TRANSPORT_PUSH_MIRROR)) {
 368                 return error(_("--all and --mirror are incompatible"));
 369         }
 370
 371         if (!refspec && !(flags & TRANSPORT_PUSH_ALL)) {
 372                 if (remote->push_refspec_nr) {
 373                         refspec = remote->push_refspec;
 374                         refspec_nr = remote->push_refspec_nr;
 375                 } else if (!(flags & TRANSPORT_PUSH_MIRROR))
 376                         setup_default_push_refspecs(remote);
 377         }
 378         errs = 0;
 379         url_nr = push_url_of_remote(remote, &url);
 380         if (url_nr) {
 381                 for (i = 0; i < url_nr; i++) {
 382                         struct transport *transport =
 383                                 transport_get(remote, url[i]);
 384                         if (push_with_options(transport, flags))
 385                                 errs++;
 386                 }
 387         } else {
 388                 struct transport *transport =
 389                         transport_get(remote, NULL);
 390
 391                 if (push_with_options(transport, flags))
 392                         errs++;
 393         }
 394         return !!errs;
 395 }
 396
 397 static int option_parse_recurse_submodules(const struct option *opt,
 398                                    const char *arg, int unset)
 399 {
 400         int *flags = opt->value;
 401
 402         if (*flags & (TRANSPORT_RECURSE_SUBMODULES_CHECK |
 403                       TRANSPORT_RECURSE_SUBMODULES_ON_DEMAND))
 404                 die("%s can only be used once.", opt->long_name);
 405
 406         if (arg) {
 407                 if (!strcmp(arg, "check"))
 408                         *flags |= TRANSPORT_RECURSE_SUBMODULES_CHECK;
 409                 else if (!strcmp(arg, "on-demand"))
 410                         *flags |= TRANSPORT_RECURSE_SUBMODULES_ON_DEMAND;
 411                 else
 412                         die("bad %s argument: %s", opt->long_name, arg);
 413         } else
 414                 die("option %s needs an argument (check|on-demand)",
 415                                 opt->long_name);
 416
 417         return 0;
 418 }
 419
 420 int cmd_push(int argc, const char **argv, const char *prefix)
 421 {
 422         int flags = 0;
 423         int tags = 0;
 424         int rc;
 425         const char *repo = NULL;        /* default repository */
 426         struct option options[] = {
 427                 OPT__VERBOSITY(&verbosity),
 428                 OPT_STRING( 0 , "repo", &repo, N_("repository"), N_("repository")),
 429                 OPT_BIT( 0 , "all", &flags, N_("push all refs"), TRANSPORT_PUSH_ALL),
 430                 OPT_BIT( 0 , "mirror", &flags, N_("mirror all refs"),
 431                             (TRANSPORT_PUSH_MIRROR|TRANSPORT_PUSH_FORCE)),
 432                 OPT_BOOL( 0, "delete", &deleterefs, N_("delete refs")),
 433                 OPT_BOOL( 0 , "tags", &tags, N_("push tags (can't be used with --all or --mirror)")),
 434                 OPT_BIT('n' , "dry-run", &flags, N_("dry run"), TRANSPORT_PUSH_DRY_RUN),
 435                 OPT_BIT( 0,  "porcelain", &flags, N_("machine-readable output"), TRANSPORT_PUSH_PORCELAIN),
 436                 OPT_BIT('f', "force", &flags, N_("force updates"), TRANSPORT_PUSH_FORCE),
 437                 { OPTION_CALLBACK,
 438                   0, CAS_OPT_NAME, &cas, N_("refname>:<expect"),
 439                   N_("require old value of ref to be at this value"),
 440                   PARSE_OPT_OPTARG, parseopt_push_cas_option },
 441                 { OPTION_CALLBACK, 0, "recurse-submodules", &flags, N_("check"),
 442                         N_("control recursive pushing of submodules"),
 443                         PARSE_OPT_OPTARG, option_parse_recurse_submodules },
 444                 OPT_BOOL( 0 , "thin", &thin, N_("use thin pack")),
 445                 OPT_STRING( 0 , "receive-pack", &receivepack, "receive-pack", N_("receive pack program")),
 446                 OPT_STRING( 0 , "exec", &receivepack, "receive-pack", N_("receive pack program")),
 447                 OPT_BIT('u', "set-upstream", &flags, N_("set upstream for git pull/status"),
 448                         TRANSPORT_PUSH_SET_UPSTREAM),
 449                 OPT_BOOL(0, "progress", &progress, N_("force progress reporting")),
 450                 OPT_BIT(0, "prune", &flags, N_("prune locally removed refs"),
 451                         TRANSPORT_PUSH_PRUNE),
 452                 OPT_BIT(0, "no-verify", &flags, N_("bypass pre-push hook"), TRANSPORT_PUSH_NO_HOOK),
 453                 OPT_BIT(0, "follow-tags", &flags, N_("push missing but relevant tags"),
 454                         TRANSPORT_PUSH_FOLLOW_TAGS),
 455                 OPT_END()
 456         };
 457
 458         packet_trace_identity("push");
 459         git_config(git_default_config, NULL);
 460         argc = parse_options(argc, argv, prefix, options, push_usage, 0);
 461
 462         if (deleterefs && (tags || (flags & (TRANSPORT_PUSH_ALL | TRANSPORT_PUSH_MIRROR))))
 463                 die(_("--delete is incompatible with --all, --mirror and --tags"));
 464         if (deleterefs && argc < 2)
 465                 die(_("--delete doesn't make sense without any refs"));
 466
 467         if (tags)
 468                 add_refspec("refs/tags/*");
 469
 470         if (argc > 0) {
 471                 repo = argv[0];
 472                 set_refspecs(argv + 1, argc - 1);
 473         }
 474
 475         rc = do_push(repo, flags);
 476         if (rc == -1)
 477                 usage_with_options(push_usage, options);
 478         else
 479                 return rc;
 480 }