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_early(config_fn_t fn, void *data, const char *repo_config)
 838 {
 839         int ret = 0, found = 0;
 840         const char *home = NULL;
 841
 842         /* Setting $GIT_CONFIG makes git read _only_ the given config file. */
 843         if (config_exclusive_filename)
 844                 return git_config_from_file(fn, config_exclusive_filename, data);
 845         if (git_config_system() && !access(git_etc_gitconfig(), R_OK)) {
 846                 ret += git_config_from_file(fn, git_etc_gitconfig(),
 847                                             data);
 848                 found += 1;
 849         }
 850
 851         home = get_home_directory();
 852         if (home) {
 853                 char *user_config = xstrdup(mkpath("%s/.gitconfig", home));
 854                 if (!access(user_config, R_OK)) {
 855                         ret += git_config_from_file(fn, user_config, data);
 856                         found += 1;
 857                 }
 858                 free(user_config);
 859         }
 860
 861         if (repo_config && !access(repo_config, R_OK)) {
 862                 ret += git_config_from_file(fn, repo_config, data);
 863                 found += 1;
 864         }
 865
 866         switch (git_config_from_parameters(fn, data)) {
 867         case -1: /* error */
 868                 ret--;
 869                 break;
 870         case 0: /* found nothing */
 871                 break;
 872         default: /* found at least one item */
 873                 found++;
 874                 break;
 875         }
 876
 877         return ret == 0 ? found : ret;
 878 }
 879
 880 int git_config(config_fn_t fn, void *data)
 881 {
 882         char *repo_config = NULL;
 883         int ret;
 884
 885         repo_config = git_pathdup("config");
 886         ret = git_config_early(fn, data, repo_config);
 887         if (repo_config)
 888                 free(repo_config);
 889         return ret;
 890 }
 891
 892 /*
 893  * Find all the stuff for git_config_set() below.
 894  */
 895
 896 #define MAX_MATCHES 512
 897
 898 static struct {
 899         int baselen;
 900         char *key;
 901         int do_not_match;
 902         regex_t *value_regex;
 903         int multi_replace;
 904         size_t offset[MAX_MATCHES];
 905         enum { START, SECTION_SEEN, SECTION_END_SEEN, KEY_SEEN } state;
 906         int seen;
 907 } store;
 908
 909 static int matches(const char *key, const char *value)
 910 {
 911         return !strcmp(key, store.key) &&
 912                 (store.value_regex == NULL ||
 913                  (store.do_not_match ^
 914                   !regexec(store.value_regex, value, 0, NULL, 0)));
 915 }
 916
 917 static int store_aux(const char *key, const char *value, void *cb)
 918 {
 919         const char *ep;
 920         size_t section_len;
 921
 922         switch (store.state) {
 923         case KEY_SEEN:
 924                 if (matches(key, value)) {
 925                         if (store.seen == 1 && store.multi_replace == 0) {
 926                                 warning("%s has multiple values", key);
 927                         } else if (store.seen >= MAX_MATCHES) {
 928                                 error("too many matches for %s", key);
 929                                 return 1;
 930                         }
 931
 932                         store.offset[store.seen] = ftell(config_file);
 933                         store.seen++;
 934                 }
 935                 break;
 936         case SECTION_SEEN:
 937                 /*
 938                  * What we are looking for is in store.key (both
 939                  * section and var), and its section part is baselen
 940                  * long.  We found key (again, both section and var).
 941                  * We would want to know if this key is in the same
 942                  * section as what we are looking for.  We already
 943                  * know we are in the same section as what should
 944                  * hold store.key.
 945                  */
 946                 ep = strrchr(key, '.');
 947                 section_len = ep - key;
 948
 949                 if ((section_len != store.baselen) ||
 950                     memcmp(key, store.key, section_len+1)) {
 951                         store.state = SECTION_END_SEEN;
 952                         break;
 953                 }
 954
 955                 /*
 956                  * Do not increment matches: this is no match, but we
 957                  * just made sure we are in the desired section.
 958                  */
 959                 store.offset[store.seen] = ftell(config_file);
 960                 /* fallthru */
 961         case SECTION_END_SEEN:
 962         case START:
 963                 if (matches(key, value)) {
 964                         store.offset[store.seen] = ftell(config_file);
 965                         store.state = KEY_SEEN;
 966                         store.seen++;
 967                 } else {
 968                         if (strrchr(key, '.') - key == store.baselen &&
 969                               !strncmp(key, store.key, store.baselen)) {
 970                                         store.state = SECTION_SEEN;
 971                                         store.offset[store.seen] = ftell(config_file);
 972                         }
 973                 }
 974         }
 975         return 0;
 976 }
 977
 978 static int write_error(const char *filename)
 979 {
 980         error("failed to write new configuration file %s", filename);
 981
 982         /* Same error code as "failed to rename". */
 983         return 4;
 984 }
 985
 986 static int store_write_section(int fd, const char *key)
 987 {
 988         const char *dot;
 989         int i, success;
 990         struct strbuf sb = STRBUF_INIT;
 991
 992         dot = memchr(key, '.', store.baselen);
 993         if (dot) {
 994                 strbuf_addf(&sb, "[%.*s \"", (int)(dot - key), key);
 995                 for (i = dot - key + 1; i < store.baselen; i++) {
 996                         if (key[i] == '"' || key[i] == '\\')
 997                                 strbuf_addch(&sb, '\\');
 998                         strbuf_addch(&sb, key[i]);
 999                 }
1000                 strbuf_addstr(&sb, "\"]\n");
1001         } else {
1002                 strbuf_addf(&sb, "[%.*s]\n", store.baselen, key);
1003         }
1004
1005         success = write_in_full(fd, sb.buf, sb.len) == sb.len;
1006         strbuf_release(&sb);
1007
1008         return success;
1009 }
1010
1011 static int store_write_pair(int fd, const char *key, const char *value)
1012 {
1013         int i, success;
1014         int length = strlen(key + store.baselen + 1);
1015         const char *quote = "";
1016         struct strbuf sb = STRBUF_INIT;
1017
1018         /*
1019          * Check to see if the value needs to be surrounded with a dq pair.
1020          * Note that problematic characters are always backslash-quoted; this
1021          * check is about not losing leading or trailing SP and strings that
1022          * follow beginning-of-comment characters (i.e. ';' and '#') by the
1023          * configuration parser.
1024          */
1025         if (value[0] == ' ')
1026                 quote = "\"";
1027         for (i = 0; value[i]; i++)
1028                 if (value[i] == ';' || value[i] == '#')
1029                         quote = "\"";
1030         if (i && value[i - 1] == ' ')
1031                 quote = "\"";
1032
1033         strbuf_addf(&sb, "\t%.*s = %s",
1034                     length, key + store.baselen + 1, quote);
1035
1036         for (i = 0; value[i]; i++)
1037                 switch (value[i]) {
1038                 case '\n':
1039                         strbuf_addstr(&sb, "\\n");
1040                         break;
1041                 case '\t':
1042                         strbuf_addstr(&sb, "\\t");
1043                         break;
1044                 case '"':
1045                 case '\\':
1046                         strbuf_addch(&sb, '\\');
1047                 default:
1048                         strbuf_addch(&sb, value[i]);
1049                         break;
1050                 }
1051         strbuf_addf(&sb, "%s\n", quote);
1052
1053         success = write_in_full(fd, sb.buf, sb.len) == sb.len;
1054         strbuf_release(&sb);
1055
1056         return success;
1057 }
1058
1059 static ssize_t find_beginning_of_line(const char *contents, size_t size,
1060         size_t offset_, int *found_bracket)
1061 {
1062         size_t equal_offset = size, bracket_offset = size;
1063         ssize_t offset;
1064
1065 contline:
1066         for (offset = offset_-2; offset > 0
1067                         && contents[offset] != '\n'; offset--)
1068                 switch (contents[offset]) {
1069                         case '=': equal_offset = offset; break;
1070                         case ']': bracket_offset = offset; break;
1071                 }
1072         if (offset > 0 && contents[offset-1] == '\\') {
1073                 offset_ = offset;
1074                 goto contline;
1075         }
1076         if (bracket_offset < equal_offset) {
1077                 *found_bracket = 1;
1078                 offset = bracket_offset+1;
1079         } else
1080                 offset++;
1081
1082         return offset;
1083 }
1084
1085 int git_config_set(const char *key, const char *value)
1086 {
1087         return git_config_set_multivar(key, value, NULL, 0);
1088 }
1089
1090 /*
1091  * Auxiliary function to sanity-check and split the key into the section
1092  * identifier and variable name.
1093  *
1094  * Returns 0 on success, -1 when there is an invalid character in the key and
1095  * -2 if there is no section name in the key.
1096  *
1097  * store_key - pointer to char* which will hold a copy of the key with
1098  *             lowercase section and variable name
1099  * baselen - pointer to int which will hold the length of the
1100  *           section + subsection part, can be NULL
1101  */
1102 int git_config_parse_key(const char *key, char **store_key, int *baselen_)
1103 {
1104         int i, dot, baselen;
1105         const char *last_dot = strrchr(key, '.');
1106
1107         /*
1108          * Since "key" actually contains the section name and the real
1109          * key name separated by a dot, we have to know where the dot is.
1110          */
1111
1112         if (last_dot == NULL || last_dot == key) {
1113                 error("key does not contain a section: %s", key);
1114                 return -CONFIG_NO_SECTION_OR_NAME;
1115         }
1116
1117         if (!last_dot[1]) {
1118                 error("key does not contain variable name: %s", key);
1119                 return -CONFIG_NO_SECTION_OR_NAME;
1120         }
1121
1122         baselen = last_dot - key;
1123         if (baselen_)
1124                 *baselen_ = baselen;
1125
1126         /*
1127          * Validate the key and while at it, lower case it for matching.
1128          */
1129         *store_key = xmalloc(strlen(key) + 1);
1130
1131         dot = 0;
1132         for (i = 0; key[i]; i++) {
1133                 unsigned char c = key[i];
1134                 if (c == '.')
1135                         dot = 1;
1136                 /* Leave the extended basename untouched.. */
1137                 if (!dot || i > baselen) {
1138                         if (!iskeychar(c) ||
1139                             (i == baselen + 1 && !isalpha(c))) {
1140                                 error("invalid key: %s", key);
1141                                 goto out_free_ret_1;
1142                         }
1143                         c = tolower(c);
1144                 } else if (c == '\n') {
1145                         error("invalid key (newline): %s", key);
1146                         goto out_free_ret_1;
1147                 }
1148                 (*store_key)[i] = c;
1149         }
1150         (*store_key)[i] = 0;
1151
1152         return 0;
1153
1154 out_free_ret_1:
1155         free(*store_key);
1156         return -CONFIG_INVALID_KEY;
1157 }
1158
1159 /*
1160  * If value==NULL, unset in (remove from) config,
1161  * if value_regex!=NULL, disregard key/value pairs where value does not match.
1162  * if multi_replace==0, nothing, or only one matching key/value is replaced,
1163  *     else all matching key/values (regardless how many) are removed,
1164  *     before the new pair is written.
1165  *
1166  * Returns 0 on success.
1167  *
1168  * This function does this:
1169  *
1170  * - it locks the config file by creating ".git/config.lock"
1171  *
1172  * - it then parses the config using store_aux() as validator to find
1173  *   the position on the key/value pair to replace. If it is to be unset,
1174  *   it must be found exactly once.
1175  *
1176  * - the config file is mmap()ed and the part before the match (if any) is
1177  *   written to the lock file, then the changed part and the rest.
1178  *
1179  * - the config file is removed and the lock file rename()d to it.
1180  *
1181  */
1182 int git_config_set_multivar(const char *key, const char *value,
1183         const char *value_regex, int multi_replace)
1184 {
1185         int fd = -1, in_fd;
1186         int ret;
1187         char *config_filename;
1188         struct lock_file *lock = NULL;
1189
1190         if (config_exclusive_filename)
1191                 config_filename = xstrdup(config_exclusive_filename);
1192         else
1193                 config_filename = git_pathdup("config");
1194
1195         /* parse-key returns negative; flip the sign to feed exit(3) */
1196         ret = 0 - git_config_parse_key(key, &store.key, &store.baselen);
1197         if (ret)
1198                 goto out_free;
1199
1200         store.multi_replace = multi_replace;
1201
1202
1203         /*
1204          * The lock serves a purpose in addition to locking: the new
1205          * contents of .git/config will be written into it.
1206          */
1207         lock = xcalloc(sizeof(struct lock_file), 1);
1208         fd = hold_lock_file_for_update(lock, config_filename, 0);
1209         if (fd < 0) {
1210                 error("could not lock config file %s: %s", config_filename, strerror(errno));
1211                 free(store.key);
1212                 ret = CONFIG_NO_LOCK;
1213                 goto out_free;
1214         }
1215
1216         /*
1217          * If .git/config does not exist yet, write a minimal version.
1218          */
1219         in_fd = open(config_filename, O_RDONLY);
1220         if ( in_fd < 0 ) {
1221                 free(store.key);
1222
1223                 if ( ENOENT != errno ) {
1224                         error("opening %s: %s", config_filename,
1225                               strerror(errno));
1226                         ret = CONFIG_INVALID_FILE; /* same as "invalid config file" */
1227                         goto out_free;
1228                 }
1229                 /* if nothing to unset, error out */
1230                 if (value == NULL) {
1231                         ret = CONFIG_NOTHING_SET;
1232                         goto out_free;
1233                 }
1234
1235                 store.key = (char *)key;
1236                 if (!store_write_section(fd, key) ||
1237                     !store_write_pair(fd, key, value))
1238                         goto write_err_out;
1239         } else {
1240                 struct stat st;
1241                 char *contents;
1242                 size_t contents_sz, copy_begin, copy_end;
1243                 int i, new_line = 0;
1244
1245                 if (value_regex == NULL)
1246                         store.value_regex = NULL;
1247                 else {
1248                         if (value_regex[0] == '!') {
1249                                 store.do_not_match = 1;
1250                                 value_regex++;
1251                         } else
1252                                 store.do_not_match = 0;
1253
1254                         store.value_regex = (regex_t*)xmalloc(sizeof(regex_t));
1255                         if (regcomp(store.value_regex, value_regex,
1256                                         REG_EXTENDED)) {
1257                                 error("invalid pattern: %s", value_regex);
1258                                 free(store.value_regex);
1259                                 ret = CONFIG_INVALID_PATTERN;
1260                                 goto out_free;
1261                         }
1262                 }
1263
1264                 store.offset[0] = 0;
1265                 store.state = START;
1266                 store.seen = 0;
1267
1268                 /*
1269                  * After this, store.offset will contain the *end* offset
1270                  * of the last match, or remain at 0 if no match was found.
1271                  * As a side effect, we make sure to transform only a valid
1272                  * existing config file.
1273                  */
1274                 if (git_config_from_file(store_aux, config_filename, NULL)) {
1275                         error("invalid config file %s", config_filename);
1276                         free(store.key);
1277                         if (store.value_regex != NULL) {
1278                                 regfree(store.value_regex);
1279                                 free(store.value_regex);
1280                         }
1281                         ret = CONFIG_INVALID_FILE;
1282                         goto out_free;
1283                 }
1284
1285                 free(store.key);
1286                 if (store.value_regex != NULL) {
1287                         regfree(store.value_regex);
1288                         free(store.value_regex);
1289                 }
1290
1291                 /* if nothing to unset, or too many matches, error out */
1292                 if ((store.seen == 0 && value == NULL) ||
1293                                 (store.seen > 1 && multi_replace == 0)) {
1294                         ret = CONFIG_NOTHING_SET;
1295                         goto out_free;
1296                 }
1297
1298                 fstat(in_fd, &st);
1299                 contents_sz = xsize_t(st.st_size);
1300                 contents = xmmap(NULL, contents_sz, PROT_READ,
1301                         MAP_PRIVATE, in_fd, 0);
1302                 close(in_fd);
1303
1304                 if (store.seen == 0)
1305                         store.seen = 1;
1306
1307                 for (i = 0, copy_begin = 0; i < store.seen; i++) {
1308                         if (store.offset[i] == 0) {
1309                                 store.offset[i] = copy_end = contents_sz;
1310                         } else if (store.state != KEY_SEEN) {
1311                                 copy_end = store.offset[i];
1312                         } else
1313                                 copy_end = find_beginning_of_line(
1314                                         contents, contents_sz,
1315                                         store.offset[i]-2, &new_line);
1316
1317                         if (copy_end > 0 && contents[copy_end-1] != '\n')
1318                                 new_line = 1;
1319
1320                         /* write the first part of the config */
1321                         if (copy_end > copy_begin) {
1322                                 if (write_in_full(fd, contents + copy_begin,
1323                                                   copy_end - copy_begin) <
1324                                     copy_end - copy_begin)
1325                                         goto write_err_out;
1326                                 if (new_line &&
1327                                     write_str_in_full(fd, "\n") != 1)
1328                                         goto write_err_out;
1329                         }
1330                         copy_begin = store.offset[i];
1331                 }
1332
1333                 /* write the pair (value == NULL means unset) */
1334                 if (value != NULL) {
1335                         if (store.state == START) {
1336                                 if (!store_write_section(fd, key))
1337                                         goto write_err_out;
1338                         }
1339                         if (!store_write_pair(fd, key, value))
1340                                 goto write_err_out;
1341                 }
1342
1343                 /* write the rest of the config */
1344                 if (copy_begin < contents_sz)
1345                         if (write_in_full(fd, contents + copy_begin,
1346                                           contents_sz - copy_begin) <
1347                             contents_sz - copy_begin)
1348                                 goto write_err_out;
1349
1350                 munmap(contents, contents_sz);
1351         }
1352
1353         if (commit_lock_file(lock) < 0) {
1354                 error("could not commit config file %s", config_filename);
1355                 ret = CONFIG_NO_WRITE;
1356                 goto out_free;
1357         }
1358
1359         /*
1360          * lock is committed, so don't try to roll it back below.
1361          * NOTE: Since lockfile.c keeps a linked list of all created
1362          * lock_file structures, it isn't safe to free(lock).  It's
1363          * better to just leave it hanging around.
1364          */
1365         lock = NULL;
1366         ret = 0;
1367
1368 out_free:
1369         if (lock)
1370                 rollback_lock_file(lock);
1371         free(config_filename);
1372         return ret;
1373
1374 write_err_out:
1375         ret = write_error(lock->filename);
1376         goto out_free;
1377
1378 }
1379
1380 static int section_name_match (const char *buf, const char *name)
1381 {
1382         int i = 0, j = 0, dot = 0;
1383         if (buf[i] != '[')
1384                 return 0;
1385         for (i = 1; buf[i] && buf[i] != ']'; i++) {
1386                 if (!dot && isspace(buf[i])) {
1387                         dot = 1;
1388                         if (name[j++] != '.')
1389                                 break;
1390                         for (i++; isspace(buf[i]); i++)
1391                                 ; /* do nothing */
1392                         if (buf[i] != '"')
1393                                 break;
1394                         continue;
1395                 }
1396                 if (buf[i] == '\\' && dot)
1397                         i++;
1398                 else if (buf[i] == '"' && dot) {
1399                         for (i++; isspace(buf[i]); i++)
1400                                 ; /* do_nothing */
1401                         break;
1402                 }
1403                 if (buf[i] != name[j++])
1404                         break;
1405         }
1406         if (buf[i] == ']' && name[j] == 0) {
1407                 /*
1408                  * We match, now just find the right length offset by
1409                  * gobbling up any whitespace after it, as well
1410                  */
1411                 i++;
1412                 for (; buf[i] && isspace(buf[i]); i++)
1413                         ; /* do nothing */
1414                 return i;
1415         }
1416         return 0;
1417 }
1418
1419 /* if new_name == NULL, the section is removed instead */
1420 int git_config_rename_section(const char *old_name, const char *new_name)
1421 {
1422         int ret = 0, remove = 0;
1423         char *config_filename;
1424         struct lock_file *lock = xcalloc(sizeof(struct lock_file), 1);
1425         int out_fd;
1426         char buf[1024];
1427
1428         if (config_exclusive_filename)
1429                 config_filename = xstrdup(config_exclusive_filename);
1430         else
1431                 config_filename = git_pathdup("config");
1432         out_fd = hold_lock_file_for_update(lock, config_filename, 0);
1433         if (out_fd < 0) {
1434                 ret = error("could not lock config file %s", config_filename);
1435                 goto out;
1436         }
1437
1438         if (!(config_file = fopen(config_filename, "rb"))) {
1439                 /* no config file means nothing to rename, no error */
1440                 goto unlock_and_out;
1441         }
1442
1443         while (fgets(buf, sizeof(buf), config_file)) {
1444                 int i;
1445                 int length;
1446                 char *output = buf;
1447                 for (i = 0; buf[i] && isspace(buf[i]); i++)
1448                         ; /* do nothing */
1449                 if (buf[i] == '[') {
1450                         /* it's a section */
1451                         int offset = section_name_match(&buf[i], old_name);
1452                         if (offset > 0) {
1453                                 ret++;
1454                                 if (new_name == NULL) {
1455                                         remove = 1;
1456                                         continue;
1457                                 }
1458                                 store.baselen = strlen(new_name);
1459                                 if (!store_write_section(out_fd, new_name)) {
1460                                         ret = write_error(lock->filename);
1461                                         goto out;
1462                                 }
1463                                 /*
1464                                  * We wrote out the new section, with
1465                                  * a newline, now skip the old
1466                                  * section's length
1467                                  */
1468                                 output += offset + i;
1469                                 if (strlen(output) > 0) {
1470                                         /*
1471                                          * More content means there's
1472                                          * a declaration to put on the
1473                                          * next line; indent with a
1474                                          * tab
1475                                          */
1476                                         output -= 1;
1477                                         output[0] = '\t';
1478                                 }
1479                         }
1480                         remove = 0;
1481                 }
1482                 if (remove)
1483                         continue;
1484                 length = strlen(output);
1485                 if (write_in_full(out_fd, output, length) != length) {
1486                         ret = write_error(lock->filename);
1487                         goto out;
1488                 }
1489         }
1490         fclose(config_file);
1491  unlock_and_out:
1492         if (commit_lock_file(lock) < 0)
1493                 ret = error("could not commit config file %s", config_filename);
1494  out:
1495         free(config_filename);
1496         return ret;
1497 }
1498
1499 /*
1500  * Call this to report error for your variable that should not
1501  * get a boolean value (i.e. "[my] var" means "true").
1502  */
1503 int config_error_nonbool(const char *var)
1504 {
1505         return error("Missing value for '%s'", var);
1506 }