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