config.c

   1 /*
   2  * GIT - The information manager from hell
   3  *
   4  * Copyright (C) Linus Torvalds, 2005
   5  * Copyright (C) Johannes Schindelin, 2005
   6  *
   7  */
   8 #include "cache.h"
   9 #include "exec_cmd.h"
  10 #include "strbuf.h"
  11 #include "quote.h"
  12
  13 #define MAXNAME (256)
  14
  15 static FILE *config_file;
  16 static const char *config_file_name;
  17 static int config_linenr;
  18 static int config_file_eof;
  19 static int zlib_compression_seen;
  20
  21 const char *config_exclusive_filename = NULL;
  22
  23 struct config_item
  24 {
  25         struct config_item *next;
  26         char *name;
  27         char *value;
  28 };
  29 static struct config_item *config_parameters;
  30 static struct config_item **config_parameters_tail = &config_parameters;
  31
  32 static void lowercase(char *p)
  33 {
  34         for (; *p; p++)
  35                 *p = tolower(*p);
  36 }
  37
  38 void git_config_push_parameter(const char *text)
  39 {
  40         struct strbuf env = STRBUF_INIT;
  41         const char *old = getenv(CONFIG_DATA_ENVIRONMENT);
  42         if (old) {
  43                 strbuf_addstr(&env, old);
  44                 strbuf_addch(&env, ' ');
  45         }
  46         sq_quote_buf(&env, text);
  47         setenv(CONFIG_DATA_ENVIRONMENT, env.buf, 1);
  48         strbuf_release(&env);
  49 }
  50
  51 int git_config_parse_parameter(const char *text)
  52 {
  53         struct config_item *ct;
  54         struct strbuf tmp = STRBUF_INIT;
  55         struct strbuf **pair;
  56         strbuf_addstr(&tmp, text);
  57         pair = strbuf_split(&tmp, '=');
  58         if (pair[0]->len && pair[0]->buf[pair[0]->len - 1] == '=')
  59                 strbuf_setlen(pair[0], pair[0]->len - 1);
  60         strbuf_trim(pair[0]);
  61         if (!pair[0]->len) {
  62                 strbuf_list_free(pair);
  63                 return -1;
  64         }
  65         ct = xcalloc(1, sizeof(struct config_item));
  66         ct->name = strbuf_detach(pair[0], NULL);
  67         if (pair[1]) {
  68                 strbuf_trim(pair[1]);
  69                 ct->value = strbuf_detach(pair[1], NULL);
  70         }
  71         strbuf_list_free(pair);
  72         lowercase(ct->name);
  73         *config_parameters_tail = ct;
  74         config_parameters_tail = &ct->next;
  75         return 0;
  76 }
  77
  78 int git_config_parse_environment(void) {
  79         const char *env = getenv(CONFIG_DATA_ENVIRONMENT);
  80         char *envw;
  81         const char **argv = NULL;
  82         int nr = 0, alloc = 0;
  83         int i;
  84
  85         if (!env)
  86                 return 0;
  87         /* sq_dequote will write over it */
  88         envw = xstrdup(env);
  89
  90         if (sq_dequote_to_argv(envw, &argv, &nr, &alloc) < 0) {
  91                 free(envw);
  92                 return error("bogus format in " CONFIG_DATA_ENVIRONMENT);
  93         }
  94
  95         for (i = 0; i < nr; i++) {
  96                 if (git_config_parse_parameter(argv[i]) < 0) {
  97                         error("bogus config parameter: %s", argv[i]);
  98                         free(argv);
  99                         free(envw);
 100                         return -1;
 101                 }
 102         }
 103
 104         free(argv);
 105         free(envw);
 106         return 0;
 107 }
 108
 109 static int get_next_char(void)
 110 {
 111         int c;
 112         FILE *f;
 113
 114         c = '\n';
 115         if ((f = config_file) != NULL) {
 116                 c = fgetc(f);
 117                 if (c == '\r') {
 118                         /* DOS like systems */
 119                         c = fgetc(f);
 120                         if (c != '\n') {
 121                                 ungetc(c, f);
 122                                 c = '\r';
 123                         }
 124                 }
 125                 if (c == '\n')
 126                         config_linenr++;
 127                 if (c == EOF) {
 128                         config_file_eof = 1;
 129                         c = '\n';
 130                 }
 131         }
 132         return c;
 133 }
 134
 135 static char *parse_value(void)
 136 {
 137         static char value[1024];
 138         int quote = 0, comment = 0, len = 0, space = 0;
 139
 140         for (;;) {
 141                 int c = get_next_char();
 142                 if (len >= sizeof(value) - 1)
 143                         return NULL;
 144                 if (c == '\n') {
 145                         if (quote)
 146                                 return NULL;
 147                         value[len] = 0;
 148                         return value;
 149                 }
 150                 if (comment)
 151                         continue;
 152                 if (isspace(c) && !quote) {
 153                         if (len)
 154                                 space++;
 155                         continue;
 156                 }
 157                 if (!quote) {
 158                         if (c == ';' || c == '#') {
 159                                 comment = 1;
 160                                 continue;
 161                         }
 162                 }
 163                 for (; space; space--)
 164                         value[len++] = ' ';
 165                 if (c == '\\') {
 166                         c = get_next_char();
 167                         switch (c) {
 168                         case '\n':
 169                                 continue;
 170                         case 't':
 171                                 c = '\t';
 172                                 break;
 173                         case 'b':
 174                                 c = '\b';
 175                                 break;
 176                         case 'n':
 177                                 c = '\n';
 178                                 break;
 179                         /* Some characters escape as themselves */
 180                         case '\\': case '"':
 181                                 break;
 182                         /* Reject unknown escape sequences */
 183                         default:
 184                                 return NULL;
 185                         }
 186                         value[len++] = c;
 187                         continue;
 188                 }
 189                 if (c == '"') {
 190                         quote = 1-quote;
 191                         continue;
 192                 }
 193                 value[len++] = c;
 194         }
 195 }
 196
 197 static inline int iskeychar(int c)
 198 {
 199         return isalnum(c) || c == '-';
 200 }
 201
 202 static int get_value(config_fn_t fn, void *data, char *name, unsigned int len)
 203 {
 204         int c;
 205         char *value;
 206
 207         /* Get the full name */
 208         for (;;) {
 209                 c = get_next_char();
 210                 if (config_file_eof)
 211                         break;
 212                 if (!iskeychar(c))
 213                         break;
 214                 name[len++] = tolower(c);
 215                 if (len >= MAXNAME)
 216                         return -1;
 217         }
 218         name[len] = 0;
 219         while (c == ' ' || c == '\t')
 220                 c = get_next_char();
 221
 222         value = NULL;
 223         if (c != '\n') {
 224                 if (c != '=')
 225                         return -1;
 226                 value = parse_value();
 227                 if (!value)
 228                         return -1;
 229         }
 230         return fn(name, value, data);
 231 }
 232
 233 static int get_extended_base_var(char *name, int baselen, int c)
 234 {
 235         do {
 236                 if (c == '\n')
 237                         return -1;
 238                 c = get_next_char();
 239         } while (isspace(c));
 240
 241         /* We require the format to be '[base "extension"]' */
 242         if (c != '"')
 243                 return -1;
 244         name[baselen++] = '.';
 245
 246         for (;;) {
 247                 int c = get_next_char();
 248                 if (c == '\n')
 249                         return -1;
 250                 if (c == '"')
 251                         break;
 252                 if (c == '\\') {
 253                         c = get_next_char();
 254                         if (c == '\n')
 255                                 return -1;
 256                 }
 257                 name[baselen++] = c;
 258                 if (baselen > MAXNAME / 2)
 259                         return -1;
 260         }
 261
 262         /* Final ']' */
 263         if (get_next_char() != ']')
 264                 return -1;
 265         return baselen;
 266 }
 267
 268 static int get_base_var(char *name)
 269 {
 270         int baselen = 0;
 271
 272         for (;;) {
 273                 int c = get_next_char();
 274                 if (config_file_eof)
 275                         return -1;
 276                 if (c == ']')
 277                         return baselen;
 278                 if (isspace(c))
 279                         return get_extended_base_var(name, baselen, c);
 280                 if (!iskeychar(c) && c != '.')
 281                         return -1;
 282                 if (baselen > MAXNAME / 2)
 283                         return -1;
 284                 name[baselen++] = tolower(c);
 285         }
 286 }
 287
 288 static int git_parse_file(config_fn_t fn, void *data)
 289 {
 290         int comment = 0;
 291         int baselen = 0;
 292         static char var[MAXNAME];
 293
 294         /* U+FEFF Byte Order Mark in UTF8 */
 295         static const unsigned char *utf8_bom = (unsigned char *) "\xef\xbb\xbf";
 296         const unsigned char *bomptr = utf8_bom;
 297
 298         for (;;) {
 299                 int c = get_next_char();
 300                 if (bomptr && *bomptr) {
 301                         /* We are at the file beginning; skip UTF8-encoded BOM
 302                          * if present. Sane editors won't put this in on their
 303                          * own, but e.g. Windows Notepad will do it happily. */
 304                         if ((unsigned char) c == *bomptr) {
 305                                 bomptr++;
 306                                 continue;
 307                         } else {
 308                                 /* Do not tolerate partial BOM. */
 309                                 if (bomptr != utf8_bom)
 310                                         break;
 311                                 /* No BOM at file beginning. Cool. */
 312                                 bomptr = NULL;
 313                         }
 314                 }
 315                 if (c == '\n') {
 316                         if (config_file_eof)
 317                                 return 0;
 318                         comment = 0;
 319                         continue;
 320                 }
 321                 if (comment || isspace(c))
 322                         continue;
 323                 if (c == '#' || c == ';') {
 324                         comment = 1;
 325                         continue;
 326                 }
 327                 if (c == '[') {
 328                         baselen = get_base_var(var);
 329                         if (baselen <= 0)
 330                                 break;
 331                         var[baselen++] = '.';
 332                         var[baselen] = 0;
 333                         continue;
 334                 }
 335                 if (!isalpha(c))
 336                         break;
 337                 var[baselen] = tolower(c);
 338                 if (get_value(fn, data, var, baselen+1) < 0)
 339                         break;
 340         }
 341         die("bad config file line %d in %s", config_linenr, config_file_name);
 342 }
 343
 344 static int parse_unit_factor(const char *end, unsigned long *val)
 345 {
 346         if (!*end)
 347                 return 1;
 348         else if (!strcasecmp(end, "k")) {
 349                 *val *= 1024;
 350                 return 1;
 351         }
 352         else if (!strcasecmp(end, "m")) {
 353                 *val *= 1024 * 1024;
 354                 return 1;
 355         }
 356         else if (!strcasecmp(end, "g")) {
 357                 *val *= 1024 * 1024 * 1024;
 358                 return 1;
 359         }
 360         return 0;
 361 }
 362
 363 static int git_parse_long(const char *value, long *ret)
 364 {
 365         if (value && *value) {
 366                 char *end;
 367                 long val = strtol(value, &end, 0);
 368                 unsigned long factor = 1;
 369                 if (!parse_unit_factor(end, &factor))
 370                         return 0;
 371                 *ret = val * factor;
 372                 return 1;
 373         }
 374         return 0;
 375 }
 376
 377 int git_parse_ulong(const char *value, unsigned long *ret)
 378 {
 379         if (value && *value) {
 380                 char *end;
 381                 unsigned long val = strtoul(value, &end, 0);
 382                 if (!parse_unit_factor(end, &val))
 383                         return 0;
 384                 *ret = val;
 385                 return 1;
 386         }
 387         return 0;
 388 }
 389
 390 static void die_bad_config(const char *name)
 391 {
 392         if (config_file_name)
 393                 die("bad config value for '%s' in %s", name, config_file_name);
 394         die("bad config value for '%s'", name);
 395 }
 396
 397 int git_config_int(const char *name, const char *value)
 398 {
 399         long ret = 0;
 400         if (!git_parse_long(value, &ret))
 401                 die_bad_config(name);
 402         return ret;
 403 }
 404
 405 unsigned long git_config_ulong(const char *name, const char *value)
 406 {
 407         unsigned long ret;
 408         if (!git_parse_ulong(value, &ret))
 409                 die_bad_config(name);
 410         return ret;
 411 }
 412
 413 static int git_config_maybe_bool_text(const char *name, const char *value)
 414 {
 415         if (!value)
 416                 return 1;
 417         if (!*value)
 418                 return 0;
 419         if (!strcasecmp(value, "true")
 420             || !strcasecmp(value, "yes")
 421             || !strcasecmp(value, "on"))
 422                 return 1;
 423         if (!strcasecmp(value, "false")
 424             || !strcasecmp(value, "no")
 425             || !strcasecmp(value, "off"))
 426                 return 0;
 427         return -1;
 428 }
 429
 430 int git_config_maybe_bool(const char *name, const char *value)
 431 {
 432         long v = git_config_maybe_bool_text(name, value);
 433         if (0 <= v)
 434                 return v;
 435         if (git_parse_long(value, &v))
 436                 return !!v;
 437         return -1;
 438 }
 439
 440 int git_config_bool_or_int(const char *name, const char *value, int *is_bool)
 441 {
 442         int v = git_config_maybe_bool_text(name, value);
 443         if (0 <= v) {
 444                 *is_bool = 1;
 445                 return v;
 446         }
 447         *is_bool = 0;
 448         return git_config_int(name, value);
 449 }
 450
 451 int git_config_bool(const char *name, const char *value)
 452 {
 453         int discard;
 454         return !!git_config_bool_or_int(name, value, &discard);
 455 }
 456
 457 int git_config_string(const char **dest, const char *var, const char *value)
 458 {
 459         if (!value)
 460                 return config_error_nonbool(var);
 461         *dest = xstrdup(value);
 462         return 0;
 463 }
 464
 465 int git_config_pathname(const char **dest, const char *var, const char *value)
 466 {
 467         if (!value)
 468                 return config_error_nonbool(var);
 469         *dest = expand_user_path(value);
 470         if (!*dest)
 471                 die("Failed to expand user dir in: '%s'", value);
 472         return 0;
 473 }
 474
 475 static int git_default_core_config(const char *var, const char *value)
 476 {
 477         /* This needs a better name */
 478         if (!strcmp(var, "core.filemode")) {
 479                 trust_executable_bit = git_config_bool(var, value);
 480                 return 0;
 481         }
 482         if (!strcmp(var, "core.trustctime")) {
 483                 trust_ctime = git_config_bool(var, value);
 484                 return 0;
 485         }
 486
 487         if (!strcmp(var, "core.quotepath")) {
 488                 quote_path_fully = git_config_bool(var, value);
 489                 return 0;
 490         }
 491
 492         if (!strcmp(var, "core.symlinks")) {
 493                 has_symlinks = git_config_bool(var, value);
 494                 return 0;
 495         }
 496
 497         if (!strcmp(var, "core.ignorecase")) {
 498                 ignore_case = git_config_bool(var, value);
 499                 return 0;
 500         }
 501
 502         if (!strcmp(var, "core.abbrevguard")) {
 503                 unique_abbrev_extra_length = git_config_int(var, value);
 504                 if (unique_abbrev_extra_length < 0)
 505                         unique_abbrev_extra_length = 0;
 506                 return 0;
 507         }
 508
 509         if (!strcmp(var, "core.bare")) {
 510                 is_bare_repository_cfg = git_config_bool(var, value);
 511                 return 0;
 512         }
 513
 514         if (!strcmp(var, "core.ignorestat")) {
 515                 assume_unchanged = git_config_bool(var, value);
 516                 return 0;
 517         }
 518
 519         if (!strcmp(var, "core.prefersymlinkrefs")) {
 520                 prefer_symlink_refs = git_config_bool(var, value);
 521                 return 0;
 522         }
 523
 524         if (!strcmp(var, "core.logallrefupdates")) {
 525                 log_all_ref_updates = git_config_bool(var, value);
 526                 return 0;
 527         }
 528
 529         if (!strcmp(var, "core.warnambiguousrefs")) {
 530                 warn_ambiguous_refs = git_config_bool(var, value);
 531                 return 0;
 532         }
 533
 534         if (!strcmp(var, "core.loosecompression")) {
 535                 int level = git_config_int(var, value);
 536                 if (level == -1)
 537                         level = Z_DEFAULT_COMPRESSION;
 538                 else if (level < 0 || level > Z_BEST_COMPRESSION)
 539                         die("bad zlib compression level %d", level);
 540                 zlib_compression_level = level;
 541                 zlib_compression_seen = 1;
 542                 return 0;
 543         }
 544
 545         if (!strcmp(var, "core.compression")) {
 546                 int level = git_config_int(var, value);
 547                 if (level == -1)
 548                         level = Z_DEFAULT_COMPRESSION;
 549                 else if (level < 0 || level > Z_BEST_COMPRESSION)
 550                         die("bad zlib compression level %d", level);
 551                 core_compression_level = level;
 552                 core_compression_seen = 1;
 553                 if (!zlib_compression_seen)
 554                         zlib_compression_level = level;
 555                 return 0;
 556         }
 557
 558         if (!strcmp(var, "core.packedgitwindowsize")) {
 559                 int pgsz_x2 = getpagesize() * 2;
 560                 packed_git_window_size = git_config_int(var, value);
 561
 562                 /* This value must be multiple of (pagesize * 2) */
 563                 packed_git_window_size /= pgsz_x2;
 564                 if (packed_git_window_size < 1)
 565                         packed_git_window_size = 1;
 566                 packed_git_window_size *= pgsz_x2;
 567                 return 0;
 568         }
 569
 570         if (!strcmp(var, "core.bigfilethreshold")) {
 571                 long n = git_config_int(var, value);
 572                 big_file_threshold = 0 < n ? n : 0;
 573                 return 0;
 574         }
 575
 576         if (!strcmp(var, "core.packedgitlimit")) {
 577                 packed_git_limit = git_config_int(var, value);
 578                 return 0;
 579         }
 580
 581         if (!strcmp(var, "core.deltabasecachelimit")) {
 582                 delta_base_cache_limit = git_config_int(var, value);
 583                 return 0;
 584         }
 585
 586         if (!strcmp(var, "core.autocrlf")) {
 587                 if (value && !strcasecmp(value, "input")) {
 588                         if (eol == EOL_CRLF)
 589                                 return error("core.autocrlf=input conflicts with core.eol=crlf");
 590                         auto_crlf = AUTO_CRLF_INPUT;
 591                         return 0;
 592                 }
 593                 auto_crlf = git_config_bool(var, value);
 594                 return 0;
 595         }
 596
 597         if (!strcmp(var, "core.safecrlf")) {
 598                 if (value && !strcasecmp(value, "warn")) {
 599                         safe_crlf = SAFE_CRLF_WARN;
 600                         return 0;
 601                 }
 602                 safe_crlf = git_config_bool(var, value);
 603                 return 0;
 604         }
 605
 606         if (!strcmp(var, "core.eol")) {
 607                 if (value && !strcasecmp(value, "lf"))
 608                         eol = EOL_LF;
 609                 else if (value && !strcasecmp(value, "crlf"))
 610                         eol = EOL_CRLF;
 611                 else if (value && !strcasecmp(value, "native"))
 612                         eol = EOL_NATIVE;
 613                 else
 614                         eol = EOL_UNSET;
 615                 if (eol == EOL_CRLF && auto_crlf == AUTO_CRLF_INPUT)
 616                         return error("core.autocrlf=input conflicts with core.eol=crlf");
 617                 return 0;
 618         }
 619
 620         if (!strcmp(var, "core.notesref")) {
 621                 notes_ref_name = xstrdup(value);
 622                 return 0;
 623         }
 624
 625         if (!strcmp(var, "core.pager"))
 626                 return git_config_string(&pager_program, var, value);
 627
 628         if (!strcmp(var, "core.editor"))
 629                 return git_config_string(&editor_program, var, value);
 630
 631         if (!strcmp(var, "core.askpass"))
 632                 return git_config_string(&askpass_program, var, value);
 633
 634         if (!strcmp(var, "core.excludesfile"))
 635                 return git_config_pathname(&excludes_file, var, value);
 636
 637         if (!strcmp(var, "core.whitespace")) {
 638                 if (!value)
 639                         return config_error_nonbool(var);
 640                 whitespace_rule_cfg = parse_whitespace_rule(value);
 641                 return 0;
 642         }
 643
 644         if (!strcmp(var, "core.fsyncobjectfiles")) {
 645                 fsync_object_files = git_config_bool(var, value);
 646                 return 0;
 647         }
 648
 649         if (!strcmp(var, "core.preloadindex")) {
 650                 core_preload_index = git_config_bool(var, value);
 651                 return 0;
 652         }
 653
 654         if (!strcmp(var, "core.createobject")) {
 655                 if (!strcmp(value, "rename"))
 656                         object_creation_mode = OBJECT_CREATION_USES_RENAMES;
 657                 else if (!strcmp(value, "link"))
 658                         object_creation_mode = OBJECT_CREATION_USES_HARDLINKS;
 659                 else
 660                         die("Invalid mode for object creation: %s", value);
 661                 return 0;
 662         }
 663
 664         if (!strcmp(var, "core.sparsecheckout")) {
 665                 core_apply_sparse_checkout = git_config_bool(var, value);
 666                 return 0;
 667         }
 668
 669         /* Add other config variables here and to Documentation/config.txt. */
 670         return 0;
 671 }
 672
 673 static int git_default_user_config(const char *var, const char *value)
 674 {
 675         if (!strcmp(var, "user.name")) {
 676                 if (!value)
 677                         return config_error_nonbool(var);
 678                 strlcpy(git_default_name, value, sizeof(git_default_name));
 679                 user_ident_explicitly_given |= IDENT_NAME_GIVEN;
 680                 return 0;
 681         }
 682
 683         if (!strcmp(var, "user.email")) {
 684                 if (!value)
 685                         return config_error_nonbool(var);
 686                 strlcpy(git_default_email, value, sizeof(git_default_email));
 687                 user_ident_explicitly_given |= IDENT_MAIL_GIVEN;
 688                 return 0;
 689         }
 690
 691         /* Add other config variables here and to Documentation/config.txt. */
 692         return 0;
 693 }
 694
 695 static int git_default_i18n_config(const char *var, const char *value)
 696 {
 697         if (!strcmp(var, "i18n.commitencoding"))
 698                 return git_config_string(&git_commit_encoding, var, value);
 699
 700         if (!strcmp(var, "i18n.logoutputencoding"))
 701                 return git_config_string(&git_log_output_encoding, var, value);
 702
 703         /* Add other config variables here and to Documentation/config.txt. */
 704         return 0;
 705 }
 706
 707 static int git_default_branch_config(const char *var, const char *value)
 708 {
 709         if (!strcmp(var, "branch.autosetupmerge")) {
 710                 if (value && !strcasecmp(value, "always")) {
 711                         git_branch_track = BRANCH_TRACK_ALWAYS;
 712                         return 0;
 713                 }
 714                 git_branch_track = git_config_bool(var, value);
 715                 return 0;
 716         }
 717         if (!strcmp(var, "branch.autosetuprebase")) {
 718                 if (!value)
 719                         return config_error_nonbool(var);
 720                 else if (!strcmp(value, "never"))
 721                         autorebase = AUTOREBASE_NEVER;
 722                 else if (!strcmp(value, "local"))
 723                         autorebase = AUTOREBASE_LOCAL;
 724                 else if (!strcmp(value, "remote"))
 725                         autorebase = AUTOREBASE_REMOTE;
 726                 else if (!strcmp(value, "always"))
 727                         autorebase = AUTOREBASE_ALWAYS;
 728                 else
 729                         return error("Malformed value for %s", var);
 730                 return 0;
 731         }
 732
 733         /* Add other config variables here and to Documentation/config.txt. */
 734         return 0;
 735 }
 736
 737 static int git_default_push_config(const char *var, const char *value)
 738 {
 739         if (!strcmp(var, "push.default")) {
 740                 if (!value)
 741                         return config_error_nonbool(var);
 742                 else if (!strcmp(value, "nothing"))
 743                         push_default = PUSH_DEFAULT_NOTHING;
 744                 else if (!strcmp(value, "matching"))
 745                         push_default = PUSH_DEFAULT_MATCHING;
 746                 else if (!strcmp(value, "tracking"))
 747                         push_default = PUSH_DEFAULT_TRACKING;
 748                 else if (!strcmp(value, "current"))
 749                         push_default = PUSH_DEFAULT_CURRENT;
 750                 else {
 751                         error("Malformed value for %s: %s", var, value);
 752                         return error("Must be one of nothing, matching, "
 753                                      "tracking or current.");
 754                 }
 755                 return 0;
 756         }
 757
 758         /* Add other config variables here and to Documentation/config.txt. */
 759         return 0;
 760 }
 761
 762 static int git_default_mailmap_config(const char *var, const char *value)
 763 {
 764         if (!strcmp(var, "mailmap.file"))
 765                 return git_config_string(&git_mailmap_file, var, value);
 766
 767         /* Add other config variables here and to Documentation/config.txt. */
 768         return 0;
 769 }
 770
 771 int git_default_config(const char *var, const char *value, void *dummy)
 772 {
 773         if (!prefixcmp(var, "core."))
 774                 return git_default_core_config(var, value);
 775
 776         if (!prefixcmp(var, "user."))
 777                 return git_default_user_config(var, value);
 778
 779         if (!prefixcmp(var, "i18n."))
 780                 return git_default_i18n_config(var, value);
 781
 782         if (!prefixcmp(var, "branch."))
 783                 return git_default_branch_config(var, value);
 784
 785         if (!prefixcmp(var, "push."))
 786                 return git_default_push_config(var, value);
 787
 788         if (!prefixcmp(var, "mailmap."))
 789                 return git_default_mailmap_config(var, value);
 790
 791         if (!prefixcmp(var, "advice."))
 792                 return git_default_advice_config(var, value);
 793
 794         if (!strcmp(var, "pager.color") || !strcmp(var, "color.pager")) {
 795                 pager_use_color = git_config_bool(var,value);
 796                 return 0;
 797         }
 798
 799         /* Add other config variables here and to Documentation/config.txt. */
 800         return 0;
 801 }
 802
 803 int git_config_from_file(config_fn_t fn, const char *filename, void *data)
 804 {
 805         int ret;
 806         FILE *f = fopen(filename, "r");
 807
 808         ret = -1;
 809         if (f) {
 810                 config_file = f;
 811                 config_file_name = filename;
 812                 config_linenr = 1;
 813                 config_file_eof = 0;
 814                 ret = git_parse_file(fn, data);
 815                 fclose(f);
 816                 config_file_name = NULL;
 817         }
 818         return ret;
 819 }
 820
 821 const char *git_etc_gitconfig(void)
 822 {
 823         static const char *system_wide;
 824         if (!system_wide)
 825                 system_wide = system_path(ETC_GITCONFIG);
 826         return system_wide;
 827 }
 828
 829 int git_env_bool(const char *k, int def)
 830 {
 831         const char *v = getenv(k);
 832         return v ? git_config_bool(k, v) : def;
 833 }
 834
 835 int git_config_system(void)
 836 {
 837         return !git_env_bool("GIT_CONFIG_NOSYSTEM", 0);
 838 }
 839
 840 int git_config_global(void)
 841 {
 842         return !git_env_bool("GIT_CONFIG_NOGLOBAL", 0);
 843 }
 844
 845 int git_config_from_parameters(config_fn_t fn, void *data)
 846 {
 847         static int loaded_environment;
 848         const struct config_item *ct;
 849
 850         if (!loaded_environment) {
 851                 if (git_config_parse_environment() < 0)
 852                         return -1;
 853                 loaded_environment = 1;
 854         }
 855         for (ct = config_parameters; ct; ct = ct->next)
 856                 if (fn(ct->name, ct->value, data) < 0)
 857                         return -1;
 858         return 0;
 859 }
 860
 861 int git_config_early(config_fn_t fn, void *data, const char *repo_config)
 862 {
 863         int ret = 0, found = 0;
 864         const char *home = NULL;
 865
 866         /* Setting $GIT_CONFIG makes git read _only_ the given config file. */
 867         if (config_exclusive_filename)
 868                 return git_config_from_file(fn, config_exclusive_filename, data);
 869         if (git_config_system() && !access(git_etc_gitconfig(), R_OK)) {
 870                 ret += git_config_from_file(fn, git_etc_gitconfig(),
 871                                             data);
 872                 found += 1;
 873         }
 874
 875         home = getenv("HOME");
 876         if (git_config_global() && home) {
 877                 char *user_config = xstrdup(mkpath("%s/.gitconfig", home));
 878                 if (!access(user_config, R_OK)) {
 879                         ret += git_config_from_file(fn, user_config, data);
 880                         found += 1;
 881                 }
 882                 free(user_config);
 883         }
 884
 885         if (repo_config && !access(repo_config, R_OK)) {
 886                 ret += git_config_from_file(fn, repo_config, data);
 887                 found += 1;
 888         }
 889
 890         ret += git_config_from_parameters(fn, data);
 891         if (config_parameters)
 892                 found += 1;
 893
 894         return ret == 0 ? found : ret;
 895 }
 896
 897 int git_config(config_fn_t fn, void *data)
 898 {
 899         char *repo_config = NULL;
 900         int ret;
 901
 902         repo_config = git_pathdup("config");
 903         ret = git_config_early(fn, data, repo_config);
 904         if (repo_config)
 905                 free(repo_config);
 906         return ret;
 907 }
 908
 909 /*
 910  * Find all the stuff for git_config_set() below.
 911  */
 912
 913 #define MAX_MATCHES 512
 914
 915 static struct {
 916         int baselen;
 917         char *key;
 918         int do_not_match;
 919         regex_t *value_regex;
 920         int multi_replace;
 921         size_t offset[MAX_MATCHES];
 922         enum { START, SECTION_SEEN, SECTION_END_SEEN, KEY_SEEN } state;
 923         int seen;
 924 } store;
 925
 926 static int matches(const char *key, const char *value)
 927 {
 928         return !strcmp(key, store.key) &&
 929                 (store.value_regex == NULL ||
 930                  (store.do_not_match ^
 931                   !regexec(store.value_regex, value, 0, NULL, 0)));
 932 }
 933
 934 static int store_aux(const char *key, const char *value, void *cb)
 935 {
 936         const char *ep;
 937         size_t section_len;
 938
 939         switch (store.state) {
 940         case KEY_SEEN:
 941                 if (matches(key, value)) {
 942                         if (store.seen == 1 && store.multi_replace == 0) {
 943                                 warning("%s has multiple values", key);
 944                         } else if (store.seen >= MAX_MATCHES) {
 945                                 error("too many matches for %s", key);
 946                                 return 1;
 947                         }
 948
 949                         store.offset[store.seen] = ftell(config_file);
 950                         store.seen++;
 951                 }
 952                 break;
 953         case SECTION_SEEN:
 954                 /*
 955                  * What we are looking for is in store.key (both
 956                  * section and var), and its section part is baselen
 957                  * long.  We found key (again, both section and var).
 958                  * We would want to know if this key is in the same
 959                  * section as what we are looking for.  We already
 960                  * know we are in the same section as what should
 961                  * hold store.key.
 962                  */
 963                 ep = strrchr(key, '.');
 964                 section_len = ep - key;
 965
 966                 if ((section_len != store.baselen) ||
 967                     memcmp(key, store.key, section_len+1)) {
 968                         store.state = SECTION_END_SEEN;
 969                         break;
 970                 }
 971
 972                 /*
 973                  * Do not increment matches: this is no match, but we
 974                  * just made sure we are in the desired section.
 975                  */
 976                 store.offset[store.seen] = ftell(config_file);
 977                 /* fallthru */
 978         case SECTION_END_SEEN:
 979         case START:
 980                 if (matches(key, value)) {
 981                         store.offset[store.seen] = ftell(config_file);
 982                         store.state = KEY_SEEN;
 983                         store.seen++;
 984                 } else {
 985                         if (strrchr(key, '.') - key == store.baselen &&
 986                               !strncmp(key, store.key, store.baselen)) {
 987                                         store.state = SECTION_SEEN;
 988                                         store.offset[store.seen] = ftell(config_file);
 989                         }
 990                 }
 991         }
 992         return 0;
 993 }
 994
 995 static int write_error(const char *filename)
 996 {
 997         error("failed to write new configuration file %s", filename);
 998
 999         /* Same error code as "failed to rename". */
1000         return 4;
1001 }
1002
1003 static int store_write_section(int fd, const char *key)
1004 {
1005         const char *dot;
1006         int i, success;
1007         struct strbuf sb = STRBUF_INIT;
1008
1009         dot = memchr(key, '.', store.baselen);
1010         if (dot) {
1011                 strbuf_addf(&sb, "[%.*s \"", (int)(dot - key), key);
1012                 for (i = dot - key + 1; i < store.baselen; i++) {
1013                         if (key[i] == '"' || key[i] == '\\')
1014                                 strbuf_addch(&sb, '\\');
1015                         strbuf_addch(&sb, key[i]);
1016                 }
1017                 strbuf_addstr(&sb, "\"]\n");
1018         } else {
1019                 strbuf_addf(&sb, "[%.*s]\n", store.baselen, key);
1020         }
1021
1022         success = write_in_full(fd, sb.buf, sb.len) == sb.len;
1023         strbuf_release(&sb);
1024
1025         return success;
1026 }
1027
1028 static int store_write_pair(int fd, const char *key, const char *value)
1029 {
1030         int i, success;
1031         int length = strlen(key + store.baselen + 1);
1032         const char *quote = "";
1033         struct strbuf sb = STRBUF_INIT;
1034
1035         /*
1036          * Check to see if the value needs to be surrounded with a dq pair.
1037          * Note that problematic characters are always backslash-quoted; this
1038          * check is about not losing leading or trailing SP and strings that
1039          * follow beginning-of-comment characters (i.e. ';' and '#') by the
1040          * configuration parser.
1041          */
1042         if (value[0] == ' ')
1043                 quote = "\"";
1044         for (i = 0; value[i]; i++)
1045                 if (value[i] == ';' || value[i] == '#')
1046                         quote = "\"";
1047         if (i && value[i - 1] == ' ')
1048                 quote = "\"";
1049
1050         strbuf_addf(&sb, "\t%.*s = %s",
1051                     length, key + store.baselen + 1, quote);
1052
1053         for (i = 0; value[i]; i++)
1054                 switch (value[i]) {
1055                 case '\n':
1056                         strbuf_addstr(&sb, "\\n");
1057                         break;
1058                 case '\t':
1059                         strbuf_addstr(&sb, "\\t");
1060                         break;
1061                 case '"':
1062                 case '\\':
1063                         strbuf_addch(&sb, '\\');
1064                 default:
1065                         strbuf_addch(&sb, value[i]);
1066                         break;
1067                 }
1068         strbuf_addf(&sb, "%s\n", quote);
1069
1070         success = write_in_full(fd, sb.buf, sb.len) == sb.len;
1071         strbuf_release(&sb);
1072
1073         return success;
1074 }
1075
1076 static ssize_t find_beginning_of_line(const char *contents, size_t size,
1077         size_t offset_, int *found_bracket)
1078 {
1079         size_t equal_offset = size, bracket_offset = size;
1080         ssize_t offset;
1081
1082 contline:
1083         for (offset = offset_-2; offset > 0
1084                         && contents[offset] != '\n'; offset--)
1085                 switch (contents[offset]) {
1086                         case '=': equal_offset = offset; break;
1087                         case ']': bracket_offset = offset; break;
1088                 }
1089         if (offset > 0 && contents[offset-1] == '\\') {
1090                 offset_ = offset;
1091                 goto contline;
1092         }
1093         if (bracket_offset < equal_offset) {
1094                 *found_bracket = 1;
1095                 offset = bracket_offset+1;
1096         } else
1097                 offset++;
1098
1099         return offset;
1100 }
1101
1102 int git_config_set(const char *key, const char *value)
1103 {
1104         return git_config_set_multivar(key, value, NULL, 0);
1105 }
1106
1107 /*
1108  * If value==NULL, unset in (remove from) config,
1109  * if value_regex!=NULL, disregard key/value pairs where value does not match.
1110  * if multi_replace==0, nothing, or only one matching key/value is replaced,
1111  *     else all matching key/values (regardless how many) are removed,
1112  *     before the new pair is written.
1113  *
1114  * Returns 0 on success.
1115  *
1116  * This function does this:
1117  *
1118  * - it locks the config file by creating ".git/config.lock"
1119  *
1120  * - it then parses the config using store_aux() as validator to find
1121  *   the position on the key/value pair to replace. If it is to be unset,
1122  *   it must be found exactly once.
1123  *
1124  * - the config file is mmap()ed and the part before the match (if any) is
1125  *   written to the lock file, then the changed part and the rest.
1126  *
1127  * - the config file is removed and the lock file rename()d to it.
1128  *
1129  */
1130 int git_config_set_multivar(const char *key, const char *value,
1131         const char *value_regex, int multi_replace)
1132 {
1133         int i, dot;
1134         int fd = -1, in_fd;
1135         int ret;
1136         char *config_filename;
1137         struct lock_file *lock = NULL;
1138         const char *last_dot = strrchr(key, '.');
1139
1140         if (config_exclusive_filename)
1141                 config_filename = xstrdup(config_exclusive_filename);
1142         else
1143                 config_filename = git_pathdup("config");
1144
1145         /*
1146          * Since "key" actually contains the section name and the real
1147          * key name separated by a dot, we have to know where the dot is.
1148          */
1149
1150         if (last_dot == NULL) {
1151                 error("key does not contain a section: %s", key);
1152                 ret = 2;
1153                 goto out_free;
1154         }
1155         store.baselen = last_dot - key;
1156
1157         store.multi_replace = multi_replace;
1158
1159         /*
1160          * Validate the key and while at it, lower case it for matching.
1161          */
1162         store.key = xmalloc(strlen(key) + 1);
1163         dot = 0;
1164         for (i = 0; key[i]; i++) {
1165                 unsigned char c = key[i];
1166                 if (c == '.')
1167                         dot = 1;
1168                 /* Leave the extended basename untouched.. */
1169                 if (!dot || i > store.baselen) {
1170                         if (!iskeychar(c) || (i == store.baselen+1 && !isalpha(c))) {
1171                                 error("invalid key: %s", key);
1172                                 free(store.key);
1173                                 ret = 1;
1174                                 goto out_free;
1175                         }
1176                         c = tolower(c);
1177                 } else if (c == '\n') {
1178                         error("invalid key (newline): %s", key);
1179                         free(store.key);
1180                         ret = 1;
1181                         goto out_free;
1182                 }
1183                 store.key[i] = c;
1184         }
1185         store.key[i] = 0;
1186
1187         /*
1188          * The lock serves a purpose in addition to locking: the new
1189          * contents of .git/config will be written into it.
1190          */
1191         lock = xcalloc(sizeof(struct lock_file), 1);
1192         fd = hold_lock_file_for_update(lock, config_filename, 0);
1193         if (fd < 0) {
1194                 error("could not lock config file %s: %s", config_filename, strerror(errno));
1195                 free(store.key);
1196                 ret = -1;
1197                 goto out_free;
1198         }
1199
1200         /*
1201          * If .git/config does not exist yet, write a minimal version.
1202          */
1203         in_fd = open(config_filename, O_RDONLY);
1204         if ( in_fd < 0 ) {
1205                 free(store.key);
1206
1207                 if ( ENOENT != errno ) {
1208                         error("opening %s: %s", config_filename,
1209                               strerror(errno));
1210                         ret = 3; /* same as "invalid config file" */
1211                         goto out_free;
1212                 }
1213                 /* if nothing to unset, error out */
1214                 if (value == NULL) {
1215                         ret = 5;
1216                         goto out_free;
1217                 }
1218
1219                 store.key = (char *)key;
1220                 if (!store_write_section(fd, key) ||
1221                     !store_write_pair(fd, key, value))
1222                         goto write_err_out;
1223         } else {
1224                 struct stat st;
1225                 char *contents;
1226                 size_t contents_sz, copy_begin, copy_end;
1227                 int i, new_line = 0;
1228
1229                 if (value_regex == NULL)
1230                         store.value_regex = NULL;
1231                 else {
1232                         if (value_regex[0] == '!') {
1233                                 store.do_not_match = 1;
1234                                 value_regex++;
1235                         } else
1236                                 store.do_not_match = 0;
1237
1238                         store.value_regex = (regex_t*)xmalloc(sizeof(regex_t));
1239                         if (regcomp(store.value_regex, value_regex,
1240                                         REG_EXTENDED)) {
1241                                 error("invalid pattern: %s", value_regex);
1242                                 free(store.value_regex);
1243                                 ret = 6;
1244                                 goto out_free;
1245                         }
1246                 }
1247
1248                 store.offset[0] = 0;
1249                 store.state = START;
1250                 store.seen = 0;
1251
1252                 /*
1253                  * After this, store.offset will contain the *end* offset
1254                  * of the last match, or remain at 0 if no match was found.
1255                  * As a side effect, we make sure to transform only a valid
1256                  * existing config file.
1257                  */
1258                 if (git_config_from_file(store_aux, config_filename, NULL)) {
1259                         error("invalid config file %s", config_filename);
1260                         free(store.key);
1261                         if (store.value_regex != NULL) {
1262                                 regfree(store.value_regex);
1263                                 free(store.value_regex);
1264                         }
1265                         ret = 3;
1266                         goto out_free;
1267                 }
1268
1269                 free(store.key);
1270                 if (store.value_regex != NULL) {
1271                         regfree(store.value_regex);
1272                         free(store.value_regex);
1273                 }
1274
1275                 /* if nothing to unset, or too many matches, error out */
1276                 if ((store.seen == 0 && value == NULL) ||
1277                                 (store.seen > 1 && multi_replace == 0)) {
1278                         ret = 5;
1279                         goto out_free;
1280                 }
1281
1282                 fstat(in_fd, &st);
1283                 contents_sz = xsize_t(st.st_size);
1284                 contents = xmmap(NULL, contents_sz, PROT_READ,
1285                         MAP_PRIVATE, in_fd, 0);
1286                 close(in_fd);
1287
1288                 if (store.seen == 0)
1289                         store.seen = 1;
1290
1291                 for (i = 0, copy_begin = 0; i < store.seen; i++) {
1292                         if (store.offset[i] == 0) {
1293                                 store.offset[i] = copy_end = contents_sz;
1294                         } else if (store.state != KEY_SEEN) {
1295                                 copy_end = store.offset[i];
1296                         } else
1297                                 copy_end = find_beginning_of_line(
1298                                         contents, contents_sz,
1299                                         store.offset[i]-2, &new_line);
1300
1301                         if (copy_end > 0 && contents[copy_end-1] != '\n')
1302                                 new_line = 1;
1303
1304                         /* write the first part of the config */
1305                         if (copy_end > copy_begin) {
1306                                 if (write_in_full(fd, contents + copy_begin,
1307                                                   copy_end - copy_begin) <
1308                                     copy_end - copy_begin)
1309                                         goto write_err_out;
1310                                 if (new_line &&
1311                                     write_str_in_full(fd, "\n") != 1)
1312                                         goto write_err_out;
1313                         }
1314                         copy_begin = store.offset[i];
1315                 }
1316
1317                 /* write the pair (value == NULL means unset) */
1318                 if (value != NULL) {
1319                         if (store.state == START) {
1320                                 if (!store_write_section(fd, key))
1321                                         goto write_err_out;
1322                         }
1323                         if (!store_write_pair(fd, key, value))
1324                                 goto write_err_out;
1325                 }
1326
1327                 /* write the rest of the config */
1328                 if (copy_begin < contents_sz)
1329                         if (write_in_full(fd, contents + copy_begin,
1330                                           contents_sz - copy_begin) <
1331                             contents_sz - copy_begin)
1332                                 goto write_err_out;
1333
1334                 munmap(contents, contents_sz);
1335         }
1336
1337         if (commit_lock_file(lock) < 0) {
1338                 error("could not commit config file %s", config_filename);
1339                 ret = 4;
1340                 goto out_free;
1341         }
1342
1343         /*
1344          * lock is committed, so don't try to roll it back below.
1345          * NOTE: Since lockfile.c keeps a linked list of all created
1346          * lock_file structures, it isn't safe to free(lock).  It's
1347          * better to just leave it hanging around.
1348          */
1349         lock = NULL;
1350         ret = 0;
1351
1352 out_free:
1353         if (lock)
1354                 rollback_lock_file(lock);
1355         free(config_filename);
1356         return ret;
1357
1358 write_err_out:
1359         ret = write_error(lock->filename);
1360         goto out_free;
1361
1362 }
1363
1364 static int section_name_match (const char *buf, const char *name)
1365 {
1366         int i = 0, j = 0, dot = 0;
1367         if (buf[i] != '[')
1368                 return 0;
1369         for (i = 1; buf[i] && buf[i] != ']'; i++) {
1370                 if (!dot && isspace(buf[i])) {
1371                         dot = 1;
1372                         if (name[j++] != '.')
1373                                 break;
1374                         for (i++; isspace(buf[i]); i++)
1375                                 ; /* do nothing */
1376                         if (buf[i] != '"')
1377                                 break;
1378                         continue;
1379                 }
1380                 if (buf[i] == '\\' && dot)
1381                         i++;
1382                 else if (buf[i] == '"' && dot) {
1383                         for (i++; isspace(buf[i]); i++)
1384                                 ; /* do_nothing */
1385                         break;
1386                 }
1387                 if (buf[i] != name[j++])
1388                         break;
1389         }
1390         if (buf[i] == ']' && name[j] == 0) {
1391                 /*
1392                  * We match, now just find the right length offset by
1393                  * gobbling up any whitespace after it, as well
1394                  */
1395                 i++;
1396                 for (; buf[i] && isspace(buf[i]); i++)
1397                         ; /* do nothing */
1398                 return i;
1399         }
1400         return 0;
1401 }
1402
1403 /* if new_name == NULL, the section is removed instead */
1404 int git_config_rename_section(const char *old_name, const char *new_name)
1405 {
1406         int ret = 0, remove = 0;
1407         char *config_filename;
1408         struct lock_file *lock = xcalloc(sizeof(struct lock_file), 1);
1409         int out_fd;
1410         char buf[1024];
1411
1412         if (config_exclusive_filename)
1413                 config_filename = xstrdup(config_exclusive_filename);
1414         else
1415                 config_filename = git_pathdup("config");
1416         out_fd = hold_lock_file_for_update(lock, config_filename, 0);
1417         if (out_fd < 0) {
1418                 ret = error("could not lock config file %s", config_filename);
1419                 goto out;
1420         }
1421
1422         if (!(config_file = fopen(config_filename, "rb"))) {
1423                 /* no config file means nothing to rename, no error */
1424                 goto unlock_and_out;
1425         }
1426
1427         while (fgets(buf, sizeof(buf), config_file)) {
1428                 int i;
1429                 int length;
1430                 char *output = buf;
1431                 for (i = 0; buf[i] && isspace(buf[i]); i++)
1432                         ; /* do nothing */
1433                 if (buf[i] == '[') {
1434                         /* it's a section */
1435                         int offset = section_name_match(&buf[i], old_name);
1436                         if (offset > 0) {
1437                                 ret++;
1438                                 if (new_name == NULL) {
1439                                         remove = 1;
1440                                         continue;
1441                                 }
1442                                 store.baselen = strlen(new_name);
1443                                 if (!store_write_section(out_fd, new_name)) {
1444                                         ret = write_error(lock->filename);
1445                                         goto out;
1446                                 }
1447                                 /*
1448                                  * We wrote out the new section, with
1449                                  * a newline, now skip the old
1450                                  * section's length
1451                                  */
1452                                 output += offset + i;
1453                                 if (strlen(output) > 0) {
1454                                         /*
1455                                          * More content means there's
1456                                          * a declaration to put on the
1457                                          * next line; indent with a
1458                                          * tab
1459                                          */
1460                                         output -= 1;
1461                                         output[0] = '\t';
1462                                 }
1463                         }
1464                         remove = 0;
1465                 }
1466                 if (remove)
1467                         continue;
1468                 length = strlen(output);
1469                 if (write_in_full(out_fd, output, length) != length) {
1470                         ret = write_error(lock->filename);
1471                         goto out;
1472                 }
1473         }
1474         fclose(config_file);
1475  unlock_and_out:
1476         if (commit_lock_file(lock) < 0)
1477                 ret = error("could not commit config file %s", config_filename);
1478  out:
1479         free(config_filename);
1480         return ret;
1481 }
1482
1483 /*
1484  * Call this to report error for your variable that should not
1485  * get a boolean value (i.e. "[my] var" means "true").
1486  */
1487 int config_error_nonbool(const char *var)
1488 {
1489         return error("Missing value for '%s'", var);
1490 }