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         struct config_item *next;
  25         char *name;
  26         char *value;
  27 };
  28 static struct config_item *config_parameters;
  29 static struct config_item **config_parameters_tail = &config_parameters;
  30
  31 static void lowercase(char *p)
  32 {
  33         for (; *p; p++)
  34                 *p = tolower(*p);
  35 }
  36
  37 void git_config_push_parameter(const char *text)
  38 {
  39         struct strbuf env = STRBUF_INIT;
  40         const char *old = getenv(CONFIG_DATA_ENVIRONMENT);
  41         if (old) {
  42                 strbuf_addstr(&env, old);
  43                 strbuf_addch(&env, ' ');
  44         }
  45         sq_quote_buf(&env, text);
  46         setenv(CONFIG_DATA_ENVIRONMENT, env.buf, 1);
  47         strbuf_release(&env);
  48 }
  49
  50 int git_config_parse_parameter(const char *text)
  51 {
  52         struct config_item *ct;
  53         struct strbuf tmp = STRBUF_INIT;
  54         struct strbuf **pair;
  55         strbuf_addstr(&tmp, text);
  56         pair = strbuf_split(&tmp, '=');
  57         if (pair[0]->len && pair[0]->buf[pair[0]->len - 1] == '=')
  58                 strbuf_setlen(pair[0], pair[0]->len - 1);
  59         strbuf_trim(pair[0]);
  60         if (!pair[0]->len) {
  61                 strbuf_list_free(pair);
  62                 return -1;
  63         }
  64         ct = xcalloc(1, sizeof(struct config_item));
  65         ct->name = strbuf_detach(pair[0], NULL);
  66         if (pair[1]) {
  67                 strbuf_trim(pair[1]);
  68                 ct->value = strbuf_detach(pair[1], NULL);
  69         }
  70         strbuf_list_free(pair);
  71         lowercase(ct->name);
  72         *config_parameters_tail = ct;
  73         config_parameters_tail = &ct->next;
  74         return 0;
  75 }
  76
  77 int git_config_parse_environment(void) {
  78         const char *env = getenv(CONFIG_DATA_ENVIRONMENT);
  79         char *envw;
  80         const char **argv = NULL;
  81         int nr = 0, alloc = 0;
  82         int i;
  83
  84         if (!env)
  85                 return 0;
  86         /* sq_dequote will write over it */
  87         envw = xstrdup(env);
  88
  89         if (sq_dequote_to_argv(envw, &argv, &nr, &alloc) < 0) {
  90                 free(envw);
  91                 return error("bogus format in " CONFIG_DATA_ENVIRONMENT);
  92         }
  93
  94         for (i = 0; i < nr; i++) {
  95                 if (git_config_parse_parameter(argv[i]) < 0) {
  96                         error("bogus config parameter: %s", argv[i]);
  97                         free(argv);
  98                         free(envw);
  99                         return -1;
 100                 }
 101         }
 102
 103         free(argv);
 104         free(envw);
 105         return 0;
 106 }
 107
 108 static int get_next_char(void)
 109 {
 110         int c;
 111         FILE *f;
 112
 113         c = '\n';
 114         if ((f = config_file) != NULL) {
 115                 c = fgetc(f);
 116                 if (c == '\r') {
 117                         /* DOS like systems */
 118                         c = fgetc(f);
 119                         if (c != '\n') {
 120                                 ungetc(c, f);
 121                                 c = '\r';
 122                         }
 123                 }
 124                 if (c == '\n')
 125                         config_linenr++;
 126                 if (c == EOF) {
 127                         config_file_eof = 1;
 128                         c = '\n';
 129                 }
 130         }
 131         return c;
 132 }
 133
 134 static char *parse_value(void)
 135 {
 136         static char value[1024];
 137         int quote = 0, comment = 0, len = 0, space = 0;
 138
 139         for (;;) {
 140                 int c = get_next_char();
 141                 if (len >= sizeof(value) - 1)
 142                         return NULL;
 143                 if (c == '\n') {
 144                         if (quote)
 145                                 return NULL;
 146                         value[len] = 0;
 147                         return value;
 148                 }
 149                 if (comment)
 150                         continue;
 151                 if (isspace(c) && !quote) {
 152                         if (len)
 153                                 space++;
 154                         continue;
 155                 }
 156                 if (!quote) {
 157                         if (c == ';' || c == '#') {
 158                                 comment = 1;
 159                                 continue;
 160                         }
 161                 }
 162                 for (; space; space--)
 163                         value[len++] = ' ';
 164                 if (c == '\\') {
 165                         c = get_next_char();
 166                         switch (c) {
 167                         case '\n':
 168                                 continue;
 169                         case 't':
 170                                 c = '\t';
 171                                 break;
 172                         case 'b':
 173                                 c = '\b';
 174                                 break;
 175                         case 'n':
 176                                 c = '\n';
 177                                 break;
 178                         /* Some characters escape as themselves */
 179                         case '\\': case '"':
 180                                 break;
 181                         /* Reject unknown escape sequences */
 182                         default:
 183                                 return NULL;
 184                         }
 185                         value[len++] = c;
 186                         continue;
 187                 }
 188                 if (c == '"') {
 189                         quote = 1-quote;
 190                         continue;
 191                 }
 192                 value[len++] = c;
 193         }
 194 }
 195
 196 static inline int iskeychar(int c)
 197 {
 198         return isalnum(c) || c == '-';
 199 }
 200
 201 static int get_value(config_fn_t fn, void *data, char *name, unsigned int len)
 202 {
 203         int c;
 204         char *value;
 205
 206         /* Get the full name */
 207         for (;;) {
 208                 c = get_next_char();
 209                 if (config_file_eof)
 210                         break;
 211                 if (!iskeychar(c))
 212                         break;
 213                 name[len++] = tolower(c);
 214                 if (len >= MAXNAME)
 215                         return -1;
 216         }
 217         name[len] = 0;
 218         while (c == ' ' || c == '\t')
 219                 c = get_next_char();
 220
 221         value = NULL;
 222         if (c != '\n') {
 223                 if (c != '=')
 224                         return -1;
 225                 value = parse_value();
 226                 if (!value)
 227                         return -1;
 228         }
 229         return fn(name, value, data);
 230 }
 231
 232 static int get_extended_base_var(char *name, int baselen, int c)
 233 {
 234         do {
 235                 if (c == '\n')
 236                         return -1;
 237                 c = get_next_char();
 238         } while (isspace(c));
 239
 240         /* We require the format to be '[base "extension"]' */
 241         if (c != '"')
 242                 return -1;
 243         name[baselen++] = '.';
 244
 245         for (;;) {
 246                 int c = get_next_char();
 247                 if (c == '\n')
 248                         return -1;
 249                 if (c == '"')
 250                         break;
 251                 if (c == '\\') {
 252                         c = get_next_char();
 253                         if (c == '\n')
 254                                 return -1;
 255                 }
 256                 name[baselen++] = c;
 257                 if (baselen > MAXNAME / 2)
 258                         return -1;
 259         }
 260
 261         /* Final ']' */
 262         if (get_next_char() != ']')
 263                 return -1;
 264         return baselen;
 265 }
 266
 267 static int get_base_var(char *name)
 268 {
 269         int baselen = 0;
 270
 271         for (;;) {
 272                 int c = get_next_char();
 273                 if (config_file_eof)
 274                         return -1;
 275                 if (c == ']')
 276                         return baselen;
 277                 if (isspace(c))
 278                         return get_extended_base_var(name, baselen, c);
 279                 if (!iskeychar(c) && c != '.')
 280                         return -1;
 281                 if (baselen > MAXNAME / 2)
 282                         return -1;
 283                 name[baselen++] = tolower(c);
 284         }
 285 }
 286
 287 static int git_parse_file(config_fn_t fn, void *data)
 288 {
 289         int comment = 0;
 290         int baselen = 0;
 291         static char var[MAXNAME];
 292
 293         /* U+FEFF Byte Order Mark in UTF8 */
 294         static const unsigned char *utf8_bom = (unsigned char *) "\xef\xbb\xbf";
 295         const unsigned char *bomptr = utf8_bom;
 296
 297         for (;;) {
 298                 int c = get_next_char();
 299                 if (bomptr && *bomptr) {
 300                         /* We are at the file beginning; skip UTF8-encoded BOM
 301                          * if present. Sane editors won't put this in on their
 302                          * own, but e.g. Windows Notepad will do it happily. */
 303                         if ((unsigned char) c == *bomptr) {
 304                                 bomptr++;
 305                                 continue;
 306                         } else {
 307                                 /* Do not tolerate partial BOM. */
 308                                 if (bomptr != utf8_bom)
 309                                         break;
 310                                 /* No BOM at file beginning. Cool. */
 311                                 bomptr = NULL;
 312                         }
 313                 }
 314                 if (c == '\n') {
 315                         if (config_file_eof)
 316                                 return 0;
 317                         comment = 0;
 318                         continue;
 319                 }
 320                 if (comment || isspace(c))
 321                         continue;
 322                 if (c == '#' || c == ';') {
 323                         comment = 1;
 324                         continue;
 325                 }
 326                 if (c == '[') {
 327                         baselen = get_base_var(var);
 328                         if (baselen <= 0)
 329                                 break;
 330                         var[baselen++] = '.';
 331                         var[baselen] = 0;
 332                         continue;
 333                 }
 334                 if (!isalpha(c))
 335                         break;
 336                 var[baselen] = tolower(c);
 337                 if (get_value(fn, data, var, baselen+1) < 0)
 338                         break;
 339         }
 340         die("bad config file line %d in %s", config_linenr, config_file_name);
 341 }
 342
 343 static int parse_unit_factor(const char *end, unsigned long *val)
 344 {
 345         if (!*end)
 346                 return 1;
 347         else if (!strcasecmp(end, "k")) {
 348                 *val *= 1024;
 349                 return 1;
 350         }
 351         else if (!strcasecmp(end, "m")) {
 352                 *val *= 1024 * 1024;
 353                 return 1;
 354         }
 355         else if (!strcasecmp(end, "g")) {
 356                 *val *= 1024 * 1024 * 1024;
 357                 return 1;
 358         }
 359         return 0;
 360 }
 361
 362 static int git_parse_long(const char *value, long *ret)
 363 {
 364         if (value && *value) {
 365                 char *end;
 366                 long val = strtol(value, &end, 0);
 367                 unsigned long factor = 1;
 368                 if (!parse_unit_factor(end, &factor))
 369                         return 0;
 370                 *ret = val * factor;
 371                 return 1;
 372         }
 373         return 0;
 374 }
 375
 376 int git_parse_ulong(const char *value, unsigned long *ret)
 377 {
 378         if (value && *value) {
 379                 char *end;
 380                 unsigned long val = strtoul(value, &end, 0);
 381                 if (!parse_unit_factor(end, &val))
 382                         return 0;
 383                 *ret = val;
 384                 return 1;
 385         }
 386         return 0;
 387 }
 388
 389 static void die_bad_config(const char *name)
 390 {
 391         if (config_file_name)
 392                 die("bad config value for '%s' in %s", name, config_file_name);
 393         die("bad config value for '%s'", name);
 394 }
 395
 396 int git_config_int(const char *name, const char *value)
 397 {
 398         long ret = 0;
 399         if (!git_parse_long(value, &ret))
 400                 die_bad_config(name);
 401         return ret;
 402 }
 403
 404 unsigned long git_config_ulong(const char *name, const char *value)
 405 {
 406         unsigned long ret;
 407         if (!git_parse_ulong(value, &ret))
 408                 die_bad_config(name);
 409         return ret;
 410 }
 411
 412 static int git_config_maybe_bool_text(const char *name, const char *value)
 413 {
 414         if (!value)
 415                 return 1;
 416         if (!*value)
 417                 return 0;
 418         if (!strcasecmp(value, "true")
 419             || !strcasecmp(value, "yes")
 420             || !strcasecmp(value, "on"))
 421                 return 1;
 422         if (!strcasecmp(value, "false")
 423             || !strcasecmp(value, "no")
 424             || !strcasecmp(value, "off"))
 425                 return 0;
 426         return -1;
 427 }
 428
 429 int git_config_maybe_bool(const char *name, const char *value)
 430 {
 431         long v = git_config_maybe_bool_text(name, value);
 432         if (0 <= v)
 433                 return v;
 434         if (git_parse_long(value, &v))
 435                 return !!v;
 436         return -1;
 437 }
 438
 439 int git_config_bool_or_int(const char *name, const char *value, int *is_bool)
 440 {
 441         int v = git_config_maybe_bool_text(name, value);
 442         if (0 <= v) {
 443                 *is_bool = 1;
 444                 return v;
 445         }
 446         *is_bool = 0;
 447         return git_config_int(name, value);
 448 }
 449
 450 int git_config_bool(const char *name, const char *value)
 451 {
 452         int discard;
 453         return !!git_config_bool_or_int(name, value, &discard);
 454 }
 455
 456 int git_config_string(const char **dest, const char *var, const char *value)
 457 {
 458         if (!value)
 459                 return config_error_nonbool(var);
 460         *dest = xstrdup(value);
 461         return 0;
 462 }
 463
 464 int git_config_pathname(const char **dest, const char *var, const char *value)
 465 {
 466         if (!value)
 467                 return config_error_nonbool(var);
 468         *dest = expand_user_path(value);
 469         if (!*dest)
 470                 die("Failed to expand user dir in: '%s'", value);
 471         return 0;
 472 }
 473
 474 static int git_default_core_config(const char *var, const char *value)
 475 {
 476         /* This needs a better name */
 477         if (!strcmp(var, "core.filemode")) {
 478                 trust_executable_bit = git_config_bool(var, value);
 479                 return 0;
 480         }
 481         if (!strcmp(var, "core.trustctime")) {
 482                 trust_ctime = git_config_bool(var, value);
 483                 return 0;
 484         }
 485
 486         if (!strcmp(var, "core.quotepath")) {
 487                 quote_path_fully = git_config_bool(var, value);
 488                 return 0;
 489         }
 490
 491         if (!strcmp(var, "core.symlinks")) {
 492                 has_symlinks = git_config_bool(var, value);
 493                 return 0;
 494         }
 495
 496         if (!strcmp(var, "core.ignorecase")) {
 497                 ignore_case = git_config_bool(var, value);
 498                 return 0;
 499         }
 500
 501         if (!strcmp(var, "core.bare")) {
 502                 is_bare_repository_cfg = git_config_bool(var, value);
 503                 return 0;
 504         }
 505
 506         if (!strcmp(var, "core.ignorestat")) {
 507                 assume_unchanged = git_config_bool(var, value);
 508                 return 0;
 509         }
 510
 511         if (!strcmp(var, "core.prefersymlinkrefs")) {
 512                 prefer_symlink_refs = git_config_bool(var, value);
 513                 return 0;
 514         }
 515
 516         if (!strcmp(var, "core.logallrefupdates")) {
 517                 log_all_ref_updates = git_config_bool(var, value);
 518                 return 0;
 519         }
 520
 521         if (!strcmp(var, "core.warnambiguousrefs")) {
 522                 warn_ambiguous_refs = git_config_bool(var, value);
 523                 return 0;
 524         }
 525
 526         if (!strcmp(var, "core.abbrevlength")) {
 527                 int abbrev = git_config_int(var, value);
 528                 if (abbrev < minimum_abbrev || abbrev > 40)
 529                         return -1;
 530                 default_abbrev = abbrev;
 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.packedgitlimit")) {
 571                 packed_git_limit = git_config_int(var, value);
 572                 return 0;
 573         }
 574
 575         if (!strcmp(var, "core.deltabasecachelimit")) {
 576                 delta_base_cache_limit = git_config_int(var, value);
 577                 return 0;
 578         }
 579
 580         if (!strcmp(var, "core.autocrlf")) {
 581                 if (value && !strcasecmp(value, "input")) {
 582                         if (eol == EOL_CRLF)
 583                                 return error("core.autocrlf=input conflicts with core.eol=crlf");
 584                         auto_crlf = AUTO_CRLF_INPUT;
 585                         return 0;
 586                 }
 587                 auto_crlf = git_config_bool(var, value);
 588                 return 0;
 589         }
 590
 591         if (!strcmp(var, "core.safecrlf")) {
 592                 if (value && !strcasecmp(value, "warn")) {
 593                         safe_crlf = SAFE_CRLF_WARN;
 594                         return 0;
 595                 }
 596                 safe_crlf = git_config_bool(var, value);
 597                 return 0;
 598         }
 599
 600         if (!strcmp(var, "core.eol")) {
 601                 if (value && !strcasecmp(value, "lf"))
 602                         eol = EOL_LF;
 603                 else if (value && !strcasecmp(value, "crlf"))
 604                         eol = EOL_CRLF;
 605                 else if (value && !strcasecmp(value, "native"))
 606                         eol = EOL_NATIVE;
 607                 else
 608                         eol = EOL_UNSET;
 609                 if (eol == EOL_CRLF && auto_crlf == AUTO_CRLF_INPUT)
 610                         return error("core.autocrlf=input conflicts with core.eol=crlf");
 611                 return 0;
 612         }
 613
 614         if (!strcmp(var, "core.notesref")) {
 615                 notes_ref_name = xstrdup(value);
 616                 return 0;
 617         }
 618
 619         if (!strcmp(var, "core.pager"))
 620                 return git_config_string(&pager_program, var, value);
 621
 622         if (!strcmp(var, "core.editor"))
 623                 return git_config_string(&editor_program, var, value);
 624
 625         if (!strcmp(var, "core.askpass"))
 626                 return git_config_string(&askpass_program, var, value);
 627
 628         if (!strcmp(var, "core.excludesfile"))
 629                 return git_config_pathname(&excludes_file, var, value);
 630
 631         if (!strcmp(var, "core.whitespace")) {
 632                 if (!value)
 633                         return config_error_nonbool(var);
 634                 whitespace_rule_cfg = parse_whitespace_rule(value);
 635                 return 0;
 636         }
 637
 638         if (!strcmp(var, "core.fsyncobjectfiles")) {
 639                 fsync_object_files = git_config_bool(var, value);
 640                 return 0;
 641         }
 642
 643         if (!strcmp(var, "core.preloadindex")) {
 644                 core_preload_index = git_config_bool(var, value);
 645                 return 0;
 646         }
 647
 648         if (!strcmp(var, "core.createobject")) {
 649                 if (!strcmp(value, "rename"))
 650                         object_creation_mode = OBJECT_CREATION_USES_RENAMES;
 651                 else if (!strcmp(value, "link"))
 652                         object_creation_mode = OBJECT_CREATION_USES_HARDLINKS;
 653                 else
 654                         die("Invalid mode for object creation: %s", value);
 655                 return 0;
 656         }
 657
 658         if (!strcmp(var, "core.sparsecheckout")) {
 659                 core_apply_sparse_checkout = git_config_bool(var, value);
 660                 return 0;
 661         }
 662
 663         if (!strcmp(var, "core.hidedotfiles")) {
 664                 if (value && !strcasecmp(value, "dotgitonly")) {
 665                         hide_dotfiles = HIDE_DOTFILES_DOTGITONLY;
 666                         return 0;
 667                 }
 668                 hide_dotfiles = git_config_bool(var, value);
 669                 return 0;
 670         }
 671
 672         /* Add other config variables here and to Documentation/config.txt. */
 673         return 0;
 674 }
 675
 676 static int git_default_user_config(const char *var, const char *value)
 677 {
 678         if (!strcmp(var, "user.name")) {
 679                 if (!value)
 680                         return config_error_nonbool(var);
 681                 strlcpy(git_default_name, value, sizeof(git_default_name));
 682                 user_ident_explicitly_given |= IDENT_NAME_GIVEN;
 683                 return 0;
 684         }
 685
 686         if (!strcmp(var, "user.email")) {
 687                 if (!value)
 688                         return config_error_nonbool(var);
 689                 strlcpy(git_default_email, value, sizeof(git_default_email));
 690                 user_ident_explicitly_given |= IDENT_MAIL_GIVEN;
 691                 return 0;
 692         }
 693
 694         /* Add other config variables here and to Documentation/config.txt. */
 695         return 0;
 696 }
 697
 698 static int git_default_i18n_config(const char *var, const char *value)
 699 {
 700         if (!strcmp(var, "i18n.commitencoding"))
 701                 return git_config_string(&git_commit_encoding, var, value);
 702
 703         if (!strcmp(var, "i18n.logoutputencoding"))
 704                 return git_config_string(&git_log_output_encoding, var, value);
 705
 706         /* Add other config variables here and to Documentation/config.txt. */
 707         return 0;
 708 }
 709
 710 static int git_default_branch_config(const char *var, const char *value)
 711 {
 712         if (!strcmp(var, "branch.autosetupmerge")) {
 713                 if (value && !strcasecmp(value, "always")) {
 714                         git_branch_track = BRANCH_TRACK_ALWAYS;
 715                         return 0;
 716                 }
 717                 git_branch_track = git_config_bool(var, value);
 718                 return 0;
 719         }
 720         if (!strcmp(var, "branch.autosetuprebase")) {
 721                 if (!value)
 722                         return config_error_nonbool(var);
 723                 else if (!strcmp(value, "never"))
 724                         autorebase = AUTOREBASE_NEVER;
 725                 else if (!strcmp(value, "local"))
 726                         autorebase = AUTOREBASE_LOCAL;
 727                 else if (!strcmp(value, "remote"))
 728                         autorebase = AUTOREBASE_REMOTE;
 729                 else if (!strcmp(value, "always"))
 730                         autorebase = AUTOREBASE_ALWAYS;
 731                 else
 732                         return error("Malformed value for %s", var);
 733                 return 0;
 734         }
 735
 736         /* Add other config variables here and to Documentation/config.txt. */
 737         return 0;
 738 }
 739
 740 static int git_default_push_config(const char *var, const char *value)
 741 {
 742         if (!strcmp(var, "push.default")) {
 743                 if (!value)
 744                         return config_error_nonbool(var);
 745                 else if (!strcmp(value, "nothing"))
 746                         push_default = PUSH_DEFAULT_NOTHING;
 747                 else if (!strcmp(value, "matching"))
 748                         push_default = PUSH_DEFAULT_MATCHING;
 749                 else if (!strcmp(value, "upstream"))
 750                         push_default = PUSH_DEFAULT_UPSTREAM;
 751                 else if (!strcmp(value, "tracking")) /* deprecated */
 752                         push_default = PUSH_DEFAULT_UPSTREAM;
 753                 else if (!strcmp(value, "current"))
 754                         push_default = PUSH_DEFAULT_CURRENT;
 755                 else {
 756                         error("Malformed value for %s: %s", var, value);
 757                         return error("Must be one of nothing, matching, "
 758                                      "tracking or current.");
 759                 }
 760                 return 0;
 761         }
 762
 763         /* Add other config variables here and to Documentation/config.txt. */
 764         return 0;
 765 }
 766
 767 static int git_default_mailmap_config(const char *var, const char *value)
 768 {
 769         if (!strcmp(var, "mailmap.file"))
 770                 return git_config_string(&git_mailmap_file, var, value);
 771
 772         /* Add other config variables here and to Documentation/config.txt. */
 773         return 0;
 774 }
 775
 776 int git_default_config(const char *var, const char *value, void *dummy)
 777 {
 778         if (!prefixcmp(var, "core."))
 779                 return git_default_core_config(var, value);
 780
 781         if (!prefixcmp(var, "user."))
 782                 return git_default_user_config(var, value);
 783
 784         if (!prefixcmp(var, "i18n."))
 785                 return git_default_i18n_config(var, value);
 786
 787         if (!prefixcmp(var, "branch."))
 788                 return git_default_branch_config(var, value);
 789
 790         if (!prefixcmp(var, "push."))
 791                 return git_default_push_config(var, value);
 792
 793         if (!prefixcmp(var, "mailmap."))
 794                 return git_default_mailmap_config(var, value);
 795
 796         if (!prefixcmp(var, "advice."))
 797                 return git_default_advice_config(var, value);
 798
 799         if (!strcmp(var, "pager.color") || !strcmp(var, "color.pager")) {
 800                 pager_use_color = git_config_bool(var,value);
 801                 return 0;
 802         }
 803
 804         /* Add other config variables here and to Documentation/config.txt. */
 805         return 0;
 806 }
 807
 808 int git_config_from_file(config_fn_t fn, const char *filename, void *data)
 809 {
 810         int ret;
 811         FILE *f = fopen(filename, "r");
 812
 813         ret = -1;
 814         if (f) {
 815                 config_file = f;
 816                 config_file_name = filename;
 817                 config_linenr = 1;
 818                 config_file_eof = 0;
 819                 ret = git_parse_file(fn, data);
 820                 fclose(f);
 821                 config_file_name = NULL;
 822         }
 823         return ret;
 824 }
 825
 826 const char *git_etc_gitconfig(void)
 827 {
 828         static const char *system_wide;
 829         if (!system_wide)
 830                 system_wide = system_path(ETC_GITCONFIG);
 831         return system_wide;
 832 }
 833
 834 int git_env_bool(const char *k, int def)
 835 {
 836         const char *v = getenv(k);
 837         return v ? git_config_bool(k, v) : def;
 838 }
 839
 840 int git_config_system(void)
 841 {
 842         return !git_env_bool("GIT_CONFIG_NOSYSTEM", 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 (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  * Auxiliary function to sanity-check and split the key into the section
1109  * identifier and variable name.
1110  *
1111  * Returns 0 on success, -1 when there is an invalid character in the key and
1112  * -2 if there is no section name in the key.
1113  *
1114  * store_key - pointer to char* which will hold a copy of the key with
1115  *             lowercase section and variable name
1116  * baselen - pointer to int which will hold the length of the
1117  *           section + subsection part, can be NULL
1118  */
1119 int git_config_parse_key(const char *key, char **store_key, int *baselen_)
1120 {
1121         int i, dot, baselen;
1122         const char *last_dot = strrchr(key, '.');
1123
1124         /*
1125          * Since "key" actually contains the section name and the real
1126          * key name separated by a dot, we have to know where the dot is.
1127          */
1128
1129         if (last_dot == NULL || last_dot == key) {
1130                 error("key does not contain a section: %s", key);
1131                 return -2;
1132         }
1133
1134         if (!last_dot[1]) {
1135                 error("key does not contain variable name: %s", key);
1136                 return -2;
1137         }
1138
1139         baselen = last_dot - key;
1140         if (baselen_)
1141                 *baselen_ = baselen;
1142
1143         /*
1144          * Validate the key and while at it, lower case it for matching.
1145          */
1146         *store_key = xmalloc(strlen(key) + 1);
1147
1148         dot = 0;
1149         for (i = 0; key[i]; i++) {
1150                 unsigned char c = key[i];
1151                 if (c == '.')
1152                         dot = 1;
1153                 /* Leave the extended basename untouched.. */
1154                 if (!dot || i > baselen) {
1155                         if (!iskeychar(c) ||
1156                             (i == baselen + 1 && !isalpha(c))) {
1157                                 error("invalid key: %s", key);
1158                                 goto out_free_ret_1;
1159                         }
1160                         c = tolower(c);
1161                 } else if (c == '\n') {
1162                         error("invalid key (newline): %s", key);
1163                         goto out_free_ret_1;
1164                 }
1165                 (*store_key)[i] = c;
1166         }
1167         (*store_key)[i] = 0;
1168
1169         return 0;
1170
1171 out_free_ret_1:
1172         free(*store_key);
1173         return -1;
1174 }
1175
1176 /*
1177  * If value==NULL, unset in (remove from) config,
1178  * if value_regex!=NULL, disregard key/value pairs where value does not match.
1179  * if multi_replace==0, nothing, or only one matching key/value is replaced,
1180  *     else all matching key/values (regardless how many) are removed,
1181  *     before the new pair is written.
1182  *
1183  * Returns 0 on success.
1184  *
1185  * This function does this:
1186  *
1187  * - it locks the config file by creating ".git/config.lock"
1188  *
1189  * - it then parses the config using store_aux() as validator to find
1190  *   the position on the key/value pair to replace. If it is to be unset,
1191  *   it must be found exactly once.
1192  *
1193  * - the config file is mmap()ed and the part before the match (if any) is
1194  *   written to the lock file, then the changed part and the rest.
1195  *
1196  * - the config file is removed and the lock file rename()d to it.
1197  *
1198  */
1199 int git_config_set_multivar(const char *key, const char *value,
1200         const char *value_regex, int multi_replace)
1201 {
1202         int fd = -1, in_fd;
1203         int ret;
1204         char *config_filename;
1205         struct lock_file *lock = NULL;
1206
1207         if (config_exclusive_filename)
1208                 config_filename = xstrdup(config_exclusive_filename);
1209         else
1210                 config_filename = git_pathdup("config");
1211
1212         /* parse-key returns negative; flip the sign to feed exit(3) */
1213         ret = 0 - git_config_parse_key(key, &store.key, &store.baselen);
1214         if (ret)
1215                 goto out_free;
1216
1217         store.multi_replace = multi_replace;
1218
1219
1220         /*
1221          * The lock serves a purpose in addition to locking: the new
1222          * contents of .git/config will be written into it.
1223          */
1224         lock = xcalloc(sizeof(struct lock_file), 1);
1225         fd = hold_lock_file_for_update(lock, config_filename, 0);
1226         if (fd < 0) {
1227                 error("could not lock config file %s: %s", config_filename, strerror(errno));
1228                 free(store.key);
1229                 ret = -1;
1230                 goto out_free;
1231         }
1232
1233         /*
1234          * If .git/config does not exist yet, write a minimal version.
1235          */
1236         in_fd = open(config_filename, O_RDONLY);
1237         if ( in_fd < 0 ) {
1238                 free(store.key);
1239
1240                 if ( ENOENT != errno ) {
1241                         error("opening %s: %s", config_filename,
1242                               strerror(errno));
1243                         ret = 3; /* same as "invalid config file" */
1244                         goto out_free;
1245                 }
1246                 /* if nothing to unset, error out */
1247                 if (value == NULL) {
1248                         ret = 5;
1249                         goto out_free;
1250                 }
1251
1252                 store.key = (char *)key;
1253                 if (!store_write_section(fd, key) ||
1254                     !store_write_pair(fd, key, value))
1255                         goto write_err_out;
1256         } else {
1257                 struct stat st;
1258                 char *contents;
1259                 size_t contents_sz, copy_begin, copy_end;
1260                 int i, new_line = 0;
1261
1262                 if (value_regex == NULL)
1263                         store.value_regex = NULL;
1264                 else {
1265                         if (value_regex[0] == '!') {
1266                                 store.do_not_match = 1;
1267                                 value_regex++;
1268                         } else
1269                                 store.do_not_match = 0;
1270
1271                         store.value_regex = (regex_t*)xmalloc(sizeof(regex_t));
1272                         if (regcomp(store.value_regex, value_regex,
1273                                         REG_EXTENDED)) {
1274                                 error("invalid pattern: %s", value_regex);
1275                                 free(store.value_regex);
1276                                 ret = 6;
1277                                 goto out_free;
1278                         }
1279                 }
1280
1281                 store.offset[0] = 0;
1282                 store.state = START;
1283                 store.seen = 0;
1284
1285                 /*
1286                  * After this, store.offset will contain the *end* offset
1287                  * of the last match, or remain at 0 if no match was found.
1288                  * As a side effect, we make sure to transform only a valid
1289                  * existing config file.
1290                  */
1291                 if (git_config_from_file(store_aux, config_filename, NULL)) {
1292                         error("invalid config file %s", config_filename);
1293                         free(store.key);
1294                         if (store.value_regex != NULL) {
1295                                 regfree(store.value_regex);
1296                                 free(store.value_regex);
1297                         }
1298                         ret = 3;
1299                         goto out_free;
1300                 }
1301
1302                 free(store.key);
1303                 if (store.value_regex != NULL) {
1304                         regfree(store.value_regex);
1305                         free(store.value_regex);
1306                 }
1307
1308                 /* if nothing to unset, or too many matches, error out */
1309                 if ((store.seen == 0 && value == NULL) ||
1310                                 (store.seen > 1 && multi_replace == 0)) {
1311                         ret = 5;
1312                         goto out_free;
1313                 }
1314
1315                 fstat(in_fd, &st);
1316                 contents_sz = xsize_t(st.st_size);
1317                 contents = xmmap(NULL, contents_sz, PROT_READ,
1318                         MAP_PRIVATE, in_fd, 0);
1319                 close(in_fd);
1320
1321                 if (store.seen == 0)
1322                         store.seen = 1;
1323
1324                 for (i = 0, copy_begin = 0; i < store.seen; i++) {
1325                         if (store.offset[i] == 0) {
1326                                 store.offset[i] = copy_end = contents_sz;
1327                         } else if (store.state != KEY_SEEN) {
1328                                 copy_end = store.offset[i];
1329                         } else
1330                                 copy_end = find_beginning_of_line(
1331                                         contents, contents_sz,
1332                                         store.offset[i]-2, &new_line);
1333
1334                         if (copy_end > 0 && contents[copy_end-1] != '\n')
1335                                 new_line = 1;
1336
1337                         /* write the first part of the config */
1338                         if (copy_end > copy_begin) {
1339                                 if (write_in_full(fd, contents + copy_begin,
1340                                                   copy_end - copy_begin) <
1341                                     copy_end - copy_begin)
1342                                         goto write_err_out;
1343                                 if (new_line &&
1344                                     write_str_in_full(fd, "\n") != 1)
1345                                         goto write_err_out;
1346                         }
1347                         copy_begin = store.offset[i];
1348                 }
1349
1350                 /* write the pair (value == NULL means unset) */
1351                 if (value != NULL) {
1352                         if (store.state == START) {
1353                                 if (!store_write_section(fd, key))
1354                                         goto write_err_out;
1355                         }
1356                         if (!store_write_pair(fd, key, value))
1357                                 goto write_err_out;
1358                 }
1359
1360                 /* write the rest of the config */
1361                 if (copy_begin < contents_sz)
1362                         if (write_in_full(fd, contents + copy_begin,
1363                                           contents_sz - copy_begin) <
1364                             contents_sz - copy_begin)
1365                                 goto write_err_out;
1366
1367                 munmap(contents, contents_sz);
1368         }
1369
1370         if (commit_lock_file(lock) < 0) {
1371                 error("could not commit config file %s", config_filename);
1372                 ret = 4;
1373                 goto out_free;
1374         }
1375
1376         /*
1377          * lock is committed, so don't try to roll it back below.
1378          * NOTE: Since lockfile.c keeps a linked list of all created
1379          * lock_file structures, it isn't safe to free(lock).  It's
1380          * better to just leave it hanging around.
1381          */
1382         lock = NULL;
1383         ret = 0;
1384
1385 out_free:
1386         if (lock)
1387                 rollback_lock_file(lock);
1388         free(config_filename);
1389         return ret;
1390
1391 write_err_out:
1392         ret = write_error(lock->filename);
1393         goto out_free;
1394
1395 }
1396
1397 static int section_name_match (const char *buf, const char *name)
1398 {
1399         int i = 0, j = 0, dot = 0;
1400         if (buf[i] != '[')
1401                 return 0;
1402         for (i = 1; buf[i] && buf[i] != ']'; i++) {
1403                 if (!dot && isspace(buf[i])) {
1404                         dot = 1;
1405                         if (name[j++] != '.')
1406                                 break;
1407                         for (i++; isspace(buf[i]); i++)
1408                                 ; /* do nothing */
1409                         if (buf[i] != '"')
1410                                 break;
1411                         continue;
1412                 }
1413                 if (buf[i] == '\\' && dot)
1414                         i++;
1415                 else if (buf[i] == '"' && dot) {
1416                         for (i++; isspace(buf[i]); i++)
1417                                 ; /* do_nothing */
1418                         break;
1419                 }
1420                 if (buf[i] != name[j++])
1421                         break;
1422         }
1423         if (buf[i] == ']' && name[j] == 0) {
1424                 /*
1425                  * We match, now just find the right length offset by
1426                  * gobbling up any whitespace after it, as well
1427                  */
1428                 i++;
1429                 for (; buf[i] && isspace(buf[i]); i++)
1430                         ; /* do nothing */
1431                 return i;
1432         }
1433         return 0;
1434 }
1435
1436 /* if new_name == NULL, the section is removed instead */
1437 int git_config_rename_section(const char *old_name, const char *new_name)
1438 {
1439         int ret = 0, remove = 0;
1440         char *config_filename;
1441         struct lock_file *lock = xcalloc(sizeof(struct lock_file), 1);
1442         int out_fd;
1443         char buf[1024];
1444
1445         if (config_exclusive_filename)
1446                 config_filename = xstrdup(config_exclusive_filename);
1447         else
1448                 config_filename = git_pathdup("config");
1449         out_fd = hold_lock_file_for_update(lock, config_filename, 0);
1450         if (out_fd < 0) {
1451                 ret = error("could not lock config file %s", config_filename);
1452                 goto out;
1453         }
1454
1455         if (!(config_file = fopen(config_filename, "rb"))) {
1456                 /* no config file means nothing to rename, no error */
1457                 goto unlock_and_out;
1458         }
1459
1460         while (fgets(buf, sizeof(buf), config_file)) {
1461                 int i;
1462                 int length;
1463                 char *output = buf;
1464                 for (i = 0; buf[i] && isspace(buf[i]); i++)
1465                         ; /* do nothing */
1466                 if (buf[i] == '[') {
1467                         /* it's a section */
1468                         int offset = section_name_match(&buf[i], old_name);
1469                         if (offset > 0) {
1470                                 ret++;
1471                                 if (new_name == NULL) {
1472                                         remove = 1;
1473                                         continue;
1474                                 }
1475                                 store.baselen = strlen(new_name);
1476                                 if (!store_write_section(out_fd, new_name)) {
1477                                         ret = write_error(lock->filename);
1478                                         goto out;
1479                                 }
1480                                 /*
1481                                  * We wrote out the new section, with
1482                                  * a newline, now skip the old
1483                                  * section's length
1484                                  */
1485                                 output += offset + i;
1486                                 if (strlen(output) > 0) {
1487                                         /*
1488                                          * More content means there's
1489                                          * a declaration to put on the
1490                                          * next line; indent with a
1491                                          * tab
1492                                          */
1493                                         output -= 1;
1494                                         output[0] = '\t';
1495                                 }
1496                         }
1497                         remove = 0;
1498                 }
1499                 if (remove)
1500                         continue;
1501                 length = strlen(output);
1502                 if (write_in_full(out_fd, output, length) != length) {
1503                         ret = write_error(lock->filename);
1504                         goto out;
1505                 }
1506         }
1507         fclose(config_file);
1508  unlock_and_out:
1509         if (commit_lock_file(lock) < 0)
1510                 ret = error("could not commit config file %s", config_filename);
1511  out:
1512         free(config_filename);
1513         return ret;
1514 }
1515
1516 /*
1517  * Call this to report error for your variable that should not
1518  * get a boolean value (i.e. "[my] var" means "true").
1519  */
1520 int config_error_nonbool(const char *var)
1521 {
1522         return error("Missing value for '%s'", var);
1523 }