config.con commit Documentation: wording fixes in the user manual and glossary (3c735e0)
   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
  13struct config_source {
  14        struct config_source *prev;
  15        union {
  16                FILE *file;
  17                struct config_buf {
  18                        const char *buf;
  19                        size_t len;
  20                        size_t pos;
  21                } buf;
  22        } u;
  23        const char *name;
  24        const char *path;
  25        int die_on_error;
  26        int linenr;
  27        int eof;
  28        struct strbuf value;
  29        struct strbuf var;
  30
  31        int (*do_fgetc)(struct config_source *c);
  32        int (*do_ungetc)(int c, struct config_source *conf);
  33        long (*do_ftell)(struct config_source *c);
  34};
  35
  36static struct config_source *cf;
  37
  38static int zlib_compression_seen;
  39
  40static int config_file_fgetc(struct config_source *conf)
  41{
  42        return fgetc(conf->u.file);
  43}
  44
  45static int config_file_ungetc(int c, struct config_source *conf)
  46{
  47        return ungetc(c, conf->u.file);
  48}
  49
  50static long config_file_ftell(struct config_source *conf)
  51{
  52        return ftell(conf->u.file);
  53}
  54
  55
  56static int config_buf_fgetc(struct config_source *conf)
  57{
  58        if (conf->u.buf.pos < conf->u.buf.len)
  59                return conf->u.buf.buf[conf->u.buf.pos++];
  60
  61        return EOF;
  62}
  63
  64static int config_buf_ungetc(int c, struct config_source *conf)
  65{
  66        if (conf->u.buf.pos > 0)
  67                return conf->u.buf.buf[--conf->u.buf.pos];
  68
  69        return EOF;
  70}
  71
  72static long config_buf_ftell(struct config_source *conf)
  73{
  74        return conf->u.buf.pos;
  75}
  76
  77#define MAX_INCLUDE_DEPTH 10
  78static const char include_depth_advice[] =
  79"exceeded maximum include depth (%d) while including\n"
  80"       %s\n"
  81"from\n"
  82"       %s\n"
  83"Do you have circular includes?";
  84static int handle_path_include(const char *path, struct config_include_data *inc)
  85{
  86        int ret = 0;
  87        struct strbuf buf = STRBUF_INIT;
  88        char *expanded;
  89
  90        if (!path)
  91                return config_error_nonbool("include.path");
  92
  93        expanded = expand_user_path(path);
  94        if (!expanded)
  95                return error("Could not expand include path '%s'", path);
  96        path = expanded;
  97
  98        /*
  99         * Use an absolute path as-is, but interpret relative paths
 100         * based on the including config file.
 101         */
 102        if (!is_absolute_path(path)) {
 103                char *slash;
 104
 105                if (!cf || !cf->path)
 106                        return error("relative config includes must come from files");
 107
 108                slash = find_last_dir_sep(cf->path);
 109                if (slash)
 110                        strbuf_add(&buf, cf->path, slash - cf->path + 1);
 111                strbuf_addstr(&buf, path);
 112                path = buf.buf;
 113        }
 114
 115        if (!access_or_die(path, R_OK, 0)) {
 116                if (++inc->depth > MAX_INCLUDE_DEPTH)
 117                        die(include_depth_advice, MAX_INCLUDE_DEPTH, path,
 118                            cf && cf->name ? cf->name : "the command line");
 119                ret = git_config_from_file(git_config_include, path, inc);
 120                inc->depth--;
 121        }
 122        strbuf_release(&buf);
 123        free(expanded);
 124        return ret;
 125}
 126
 127int git_config_include(const char *var, const char *value, void *data)
 128{
 129        struct config_include_data *inc = data;
 130        const char *type;
 131        int ret;
 132
 133        /*
 134         * Pass along all values, including "include" directives; this makes it
 135         * possible to query information on the includes themselves.
 136         */
 137        ret = inc->fn(var, value, inc->data);
 138        if (ret < 0)
 139                return ret;
 140
 141        type = skip_prefix(var, "include.");
 142        if (!type)
 143                return ret;
 144
 145        if (!strcmp(type, "path"))
 146                ret = handle_path_include(value, inc);
 147        return ret;
 148}
 149
 150static void lowercase(char *p)
 151{
 152        for (; *p; p++)
 153                *p = tolower(*p);
 154}
 155
 156void git_config_push_parameter(const char *text)
 157{
 158        struct strbuf env = STRBUF_INIT;
 159        const char *old = getenv(CONFIG_DATA_ENVIRONMENT);
 160        if (old) {
 161                strbuf_addstr(&env, old);
 162                strbuf_addch(&env, ' ');
 163        }
 164        sq_quote_buf(&env, text);
 165        setenv(CONFIG_DATA_ENVIRONMENT, env.buf, 1);
 166        strbuf_release(&env);
 167}
 168
 169int git_config_parse_parameter(const char *text,
 170                               config_fn_t fn, void *data)
 171{
 172        struct strbuf **pair;
 173        pair = strbuf_split_str(text, '=', 2);
 174        if (!pair[0])
 175                return error("bogus config parameter: %s", text);
 176        if (pair[0]->len && pair[0]->buf[pair[0]->len - 1] == '=')
 177                strbuf_setlen(pair[0], pair[0]->len - 1);
 178        strbuf_trim(pair[0]);
 179        if (!pair[0]->len) {
 180                strbuf_list_free(pair);
 181                return error("bogus config parameter: %s", text);
 182        }
 183        lowercase(pair[0]->buf);
 184        if (fn(pair[0]->buf, pair[1] ? pair[1]->buf : NULL, data) < 0) {
 185                strbuf_list_free(pair);
 186                return -1;
 187        }
 188        strbuf_list_free(pair);
 189        return 0;
 190}
 191
 192int git_config_from_parameters(config_fn_t fn, void *data)
 193{
 194        const char *env = getenv(CONFIG_DATA_ENVIRONMENT);
 195        char *envw;
 196        const char **argv = NULL;
 197        int nr = 0, alloc = 0;
 198        int i;
 199
 200        if (!env)
 201                return 0;
 202        /* sq_dequote will write over it */
 203        envw = xstrdup(env);
 204
 205        if (sq_dequote_to_argv(envw, &argv, &nr, &alloc) < 0) {
 206                free(envw);
 207                return error("bogus format in " CONFIG_DATA_ENVIRONMENT);
 208        }
 209
 210        for (i = 0; i < nr; i++) {
 211                if (git_config_parse_parameter(argv[i], fn, data) < 0) {
 212                        free(argv);
 213                        free(envw);
 214                        return -1;
 215                }
 216        }
 217
 218        free(argv);
 219        free(envw);
 220        return nr > 0;
 221}
 222
 223static int get_next_char(void)
 224{
 225        int c = cf->do_fgetc(cf);
 226
 227        if (c == '\r') {
 228                /* DOS like systems */
 229                c = cf->do_fgetc(cf);
 230                if (c != '\n') {
 231                        cf->do_ungetc(c, cf);
 232                        c = '\r';
 233                }
 234        }
 235        if (c == '\n')
 236                cf->linenr++;
 237        if (c == EOF) {
 238                cf->eof = 1;
 239                c = '\n';
 240        }
 241        return c;
 242}
 243
 244static char *parse_value(void)
 245{
 246        int quote = 0, comment = 0, space = 0;
 247
 248        strbuf_reset(&cf->value);
 249        for (;;) {
 250                int c = get_next_char();
 251                if (c == '\n') {
 252                        if (quote) {
 253                                cf->linenr--;
 254                                return NULL;
 255                        }
 256                        return cf->value.buf;
 257                }
 258                if (comment)
 259                        continue;
 260                if (isspace(c) && !quote) {
 261                        if (cf->value.len)
 262                                space++;
 263                        continue;
 264                }
 265                if (!quote) {
 266                        if (c == ';' || c == '#') {
 267                                comment = 1;
 268                                continue;
 269                        }
 270                }
 271                for (; space; space--)
 272                        strbuf_addch(&cf->value, ' ');
 273                if (c == '\\') {
 274                        c = get_next_char();
 275                        switch (c) {
 276                        case '\n':
 277                                continue;
 278                        case 't':
 279                                c = '\t';
 280                                break;
 281                        case 'b':
 282                                c = '\b';
 283                                break;
 284                        case 'n':
 285                                c = '\n';
 286                                break;
 287                        /* Some characters escape as themselves */
 288                        case '\\': case '"':
 289                                break;
 290                        /* Reject unknown escape sequences */
 291                        default:
 292                                return NULL;
 293                        }
 294                        strbuf_addch(&cf->value, c);
 295                        continue;
 296                }
 297                if (c == '"') {
 298                        quote = 1-quote;
 299                        continue;
 300                }
 301                strbuf_addch(&cf->value, c);
 302        }
 303}
 304
 305static inline int iskeychar(int c)
 306{
 307        return isalnum(c) || c == '-';
 308}
 309
 310static int get_value(config_fn_t fn, void *data, struct strbuf *name)
 311{
 312        int c;
 313        char *value;
 314
 315        /* Get the full name */
 316        for (;;) {
 317                c = get_next_char();
 318                if (cf->eof)
 319                        break;
 320                if (!iskeychar(c))
 321                        break;
 322                strbuf_addch(name, tolower(c));
 323        }
 324
 325        while (c == ' ' || c == '\t')
 326                c = get_next_char();
 327
 328        value = NULL;
 329        if (c != '\n') {
 330                if (c != '=')
 331                        return -1;
 332                value = parse_value();
 333                if (!value)
 334                        return -1;
 335        }
 336        return fn(name->buf, value, data);
 337}
 338
 339static int get_extended_base_var(struct strbuf *name, int c)
 340{
 341        do {
 342                if (c == '\n')
 343                        goto error_incomplete_line;
 344                c = get_next_char();
 345        } while (isspace(c));
 346
 347        /* We require the format to be '[base "extension"]' */
 348        if (c != '"')
 349                return -1;
 350        strbuf_addch(name, '.');
 351
 352        for (;;) {
 353                int c = get_next_char();
 354                if (c == '\n')
 355                        goto error_incomplete_line;
 356                if (c == '"')
 357                        break;
 358                if (c == '\\') {
 359                        c = get_next_char();
 360                        if (c == '\n')
 361                                goto error_incomplete_line;
 362                }
 363                strbuf_addch(name, c);
 364        }
 365
 366        /* Final ']' */
 367        if (get_next_char() != ']')
 368                return -1;
 369        return 0;
 370error_incomplete_line:
 371        cf->linenr--;
 372        return -1;
 373}
 374
 375static int get_base_var(struct strbuf *name)
 376{
 377        for (;;) {
 378                int c = get_next_char();
 379                if (cf->eof)
 380                        return -1;
 381                if (c == ']')
 382                        return 0;
 383                if (isspace(c))
 384                        return get_extended_base_var(name, c);
 385                if (!iskeychar(c) && c != '.')
 386                        return -1;
 387                strbuf_addch(name, tolower(c));
 388        }
 389}
 390
 391static int git_parse_source(config_fn_t fn, void *data)
 392{
 393        int comment = 0;
 394        int baselen = 0;
 395        struct strbuf *var = &cf->var;
 396
 397        /* U+FEFF Byte Order Mark in UTF8 */
 398        static const unsigned char *utf8_bom = (unsigned char *) "\xef\xbb\xbf";
 399        const unsigned char *bomptr = utf8_bom;
 400
 401        for (;;) {
 402                int c = get_next_char();
 403                if (bomptr && *bomptr) {
 404                        /* We are at the file beginning; skip UTF8-encoded BOM
 405                         * if present. Sane editors won't put this in on their
 406                         * own, but e.g. Windows Notepad will do it happily. */
 407                        if ((unsigned char) c == *bomptr) {
 408                                bomptr++;
 409                                continue;
 410                        } else {
 411                                /* Do not tolerate partial BOM. */
 412                                if (bomptr != utf8_bom)
 413                                        break;
 414                                /* No BOM at file beginning. Cool. */
 415                                bomptr = NULL;
 416                        }
 417                }
 418                if (c == '\n') {
 419                        if (cf->eof)
 420                                return 0;
 421                        comment = 0;
 422                        continue;
 423                }
 424                if (comment || isspace(c))
 425                        continue;
 426                if (c == '#' || c == ';') {
 427                        comment = 1;
 428                        continue;
 429                }
 430                if (c == '[') {
 431                        /* Reset prior to determining a new stem */
 432                        strbuf_reset(var);
 433                        if (get_base_var(var) < 0 || var->len < 1)
 434                                break;
 435                        strbuf_addch(var, '.');
 436                        baselen = var->len;
 437                        continue;
 438                }
 439                if (!isalpha(c))
 440                        break;
 441                /*
 442                 * Truncate the var name back to the section header
 443                 * stem prior to grabbing the suffix part of the name
 444                 * and the value.
 445                 */
 446                strbuf_setlen(var, baselen);
 447                strbuf_addch(var, tolower(c));
 448                if (get_value(fn, data, var) < 0)
 449                        break;
 450        }
 451        if (cf->die_on_error)
 452                die("bad config file line %d in %s", cf->linenr, cf->name);
 453        else
 454                return error("bad config file line %d in %s", cf->linenr, cf->name);
 455}
 456
 457static int parse_unit_factor(const char *end, uintmax_t *val)
 458{
 459        if (!*end)
 460                return 1;
 461        else if (!strcasecmp(end, "k")) {
 462                *val *= 1024;
 463                return 1;
 464        }
 465        else if (!strcasecmp(end, "m")) {
 466                *val *= 1024 * 1024;
 467                return 1;
 468        }
 469        else if (!strcasecmp(end, "g")) {
 470                *val *= 1024 * 1024 * 1024;
 471                return 1;
 472        }
 473        return 0;
 474}
 475
 476static int git_parse_signed(const char *value, intmax_t *ret, intmax_t max)
 477{
 478        if (value && *value) {
 479                char *end;
 480                intmax_t val;
 481                uintmax_t uval;
 482                uintmax_t factor = 1;
 483
 484                errno = 0;
 485                val = strtoimax(value, &end, 0);
 486                if (errno == ERANGE)
 487                        return 0;
 488                if (!parse_unit_factor(end, &factor)) {
 489                        errno = EINVAL;
 490                        return 0;
 491                }
 492                uval = abs(val);
 493                uval *= factor;
 494                if (uval > max || abs(val) > uval) {
 495                        errno = ERANGE;
 496                        return 0;
 497                }
 498                val *= factor;
 499                *ret = val;
 500                return 1;
 501        }
 502        errno = EINVAL;
 503        return 0;
 504}
 505
 506static int git_parse_unsigned(const char *value, uintmax_t *ret, uintmax_t max)
 507{
 508        if (value && *value) {
 509                char *end;
 510                uintmax_t val;
 511                uintmax_t oldval;
 512
 513                errno = 0;
 514                val = strtoumax(value, &end, 0);
 515                if (errno == ERANGE)
 516                        return 0;
 517                oldval = val;
 518                if (!parse_unit_factor(end, &val)) {
 519                        errno = EINVAL;
 520                        return 0;
 521                }
 522                if (val > max || oldval > val) {
 523                        errno = ERANGE;
 524                        return 0;
 525                }
 526                *ret = val;
 527                return 1;
 528        }
 529        errno = EINVAL;
 530        return 0;
 531}
 532
 533static int git_parse_int(const char *value, int *ret)
 534{
 535        intmax_t tmp;
 536        if (!git_parse_signed(value, &tmp, maximum_signed_value_of_type(int)))
 537                return 0;
 538        *ret = tmp;
 539        return 1;
 540}
 541
 542static int git_parse_int64(const char *value, int64_t *ret)
 543{
 544        intmax_t tmp;
 545        if (!git_parse_signed(value, &tmp, maximum_signed_value_of_type(int64_t)))
 546                return 0;
 547        *ret = tmp;
 548        return 1;
 549}
 550
 551int git_parse_ulong(const char *value, unsigned long *ret)
 552{
 553        uintmax_t tmp;
 554        if (!git_parse_unsigned(value, &tmp, maximum_unsigned_value_of_type(long)))
 555                return 0;
 556        *ret = tmp;
 557        return 1;
 558}
 559
 560NORETURN
 561static void die_bad_number(const char *name, const char *value)
 562{
 563        const char *reason = errno == ERANGE ?
 564                             "out of range" :
 565                             "invalid unit";
 566        if (!value)
 567                value = "";
 568
 569        if (cf && cf->name)
 570                die("bad numeric config value '%s' for '%s' in %s: %s",
 571                    value, name, cf->name, reason);
 572        die("bad numeric config value '%s' for '%s': %s", value, name, reason);
 573}
 574
 575int git_config_int(const char *name, const char *value)
 576{
 577        int ret;
 578        if (!git_parse_int(value, &ret))
 579                die_bad_number(name, value);
 580        return ret;
 581}
 582
 583int64_t git_config_int64(const char *name, const char *value)
 584{
 585        int64_t ret;
 586        if (!git_parse_int64(value, &ret))
 587                die_bad_number(name, value);
 588        return ret;
 589}
 590
 591unsigned long git_config_ulong(const char *name, const char *value)
 592{
 593        unsigned long ret;
 594        if (!git_parse_ulong(value, &ret))
 595                die_bad_number(name, value);
 596        return ret;
 597}
 598
 599static int git_config_maybe_bool_text(const char *name, const char *value)
 600{
 601        if (!value)
 602                return 1;
 603        if (!*value)
 604                return 0;
 605        if (!strcasecmp(value, "true")
 606            || !strcasecmp(value, "yes")
 607            || !strcasecmp(value, "on"))
 608                return 1;
 609        if (!strcasecmp(value, "false")
 610            || !strcasecmp(value, "no")
 611            || !strcasecmp(value, "off"))
 612                return 0;
 613        return -1;
 614}
 615
 616int git_config_maybe_bool(const char *name, const char *value)
 617{
 618        int v = git_config_maybe_bool_text(name, value);
 619        if (0 <= v)
 620                return v;
 621        if (git_parse_int(value, &v))
 622                return !!v;
 623        return -1;
 624}
 625
 626int git_config_bool_or_int(const char *name, const char *value, int *is_bool)
 627{
 628        int v = git_config_maybe_bool_text(name, value);
 629        if (0 <= v) {
 630                *is_bool = 1;
 631                return v;
 632        }
 633        *is_bool = 0;
 634        return git_config_int(name, value);
 635}
 636
 637int git_config_bool(const char *name, const char *value)
 638{
 639        int discard;
 640        return !!git_config_bool_or_int(name, value, &discard);
 641}
 642
 643int git_config_string(const char **dest, const char *var, const char *value)
 644{
 645        if (!value)
 646                return config_error_nonbool(var);
 647        *dest = xstrdup(value);
 648        return 0;
 649}
 650
 651int git_config_pathname(const char **dest, const char *var, const char *value)
 652{
 653        if (!value)
 654                return config_error_nonbool(var);
 655        *dest = expand_user_path(value);
 656        if (!*dest)
 657                die("Failed to expand user dir in: '%s'", value);
 658        return 0;
 659}
 660
 661static int git_default_core_config(const char *var, const char *value)
 662{
 663        /* This needs a better name */
 664        if (!strcmp(var, "core.filemode")) {
 665                trust_executable_bit = git_config_bool(var, value);
 666                return 0;
 667        }
 668        if (!strcmp(var, "core.trustctime")) {
 669                trust_ctime = git_config_bool(var, value);
 670                return 0;
 671        }
 672        if (!strcmp(var, "core.checkstat")) {
 673                if (!strcasecmp(value, "default"))
 674                        check_stat = 1;
 675                else if (!strcasecmp(value, "minimal"))
 676                        check_stat = 0;
 677        }
 678
 679        if (!strcmp(var, "core.quotepath")) {
 680                quote_path_fully = git_config_bool(var, value);
 681                return 0;
 682        }
 683
 684        if (!strcmp(var, "core.symlinks")) {
 685                has_symlinks = git_config_bool(var, value);
 686                return 0;
 687        }
 688
 689        if (!strcmp(var, "core.ignorecase")) {
 690                ignore_case = git_config_bool(var, value);
 691                return 0;
 692        }
 693
 694        if (!strcmp(var, "core.attributesfile"))
 695                return git_config_pathname(&git_attributes_file, var, value);
 696
 697        if (!strcmp(var, "core.bare")) {
 698                is_bare_repository_cfg = git_config_bool(var, value);
 699                return 0;
 700        }
 701
 702        if (!strcmp(var, "core.ignorestat")) {
 703                assume_unchanged = git_config_bool(var, value);
 704                return 0;
 705        }
 706
 707        if (!strcmp(var, "core.prefersymlinkrefs")) {
 708                prefer_symlink_refs = git_config_bool(var, value);
 709                return 0;
 710        }
 711
 712        if (!strcmp(var, "core.logallrefupdates")) {
 713                log_all_ref_updates = git_config_bool(var, value);
 714                return 0;
 715        }
 716
 717        if (!strcmp(var, "core.warnambiguousrefs")) {
 718                warn_ambiguous_refs = git_config_bool(var, value);
 719                return 0;
 720        }
 721
 722        if (!strcmp(var, "core.abbrev")) {
 723                int abbrev = git_config_int(var, value);
 724                if (abbrev < minimum_abbrev || abbrev > 40)
 725                        return -1;
 726                default_abbrev = abbrev;
 727                return 0;
 728        }
 729
 730        if (!strcmp(var, "core.loosecompression")) {
 731                int level = git_config_int(var, value);
 732                if (level == -1)
 733                        level = Z_DEFAULT_COMPRESSION;
 734                else if (level < 0 || level > Z_BEST_COMPRESSION)
 735                        die("bad zlib compression level %d", level);
 736                zlib_compression_level = level;
 737                zlib_compression_seen = 1;
 738                return 0;
 739        }
 740
 741        if (!strcmp(var, "core.compression")) {
 742                int level = git_config_int(var, value);
 743                if (level == -1)
 744                        level = Z_DEFAULT_COMPRESSION;
 745                else if (level < 0 || level > Z_BEST_COMPRESSION)
 746                        die("bad zlib compression level %d", level);
 747                core_compression_level = level;
 748                core_compression_seen = 1;
 749                if (!zlib_compression_seen)
 750                        zlib_compression_level = level;
 751                return 0;
 752        }
 753
 754        if (!strcmp(var, "core.packedgitwindowsize")) {
 755                int pgsz_x2 = getpagesize() * 2;
 756                packed_git_window_size = git_config_ulong(var, value);
 757
 758                /* This value must be multiple of (pagesize * 2) */
 759                packed_git_window_size /= pgsz_x2;
 760                if (packed_git_window_size < 1)
 761                        packed_git_window_size = 1;
 762                packed_git_window_size *= pgsz_x2;
 763                return 0;
 764        }
 765
 766        if (!strcmp(var, "core.bigfilethreshold")) {
 767                big_file_threshold = git_config_ulong(var, value);
 768                return 0;
 769        }
 770
 771        if (!strcmp(var, "core.packedgitlimit")) {
 772                packed_git_limit = git_config_ulong(var, value);
 773                return 0;
 774        }
 775
 776        if (!strcmp(var, "core.deltabasecachelimit")) {
 777                delta_base_cache_limit = git_config_ulong(var, value);
 778                return 0;
 779        }
 780
 781        if (!strcmp(var, "core.autocrlf")) {
 782                if (value && !strcasecmp(value, "input")) {
 783                        if (core_eol == EOL_CRLF)
 784                                return error("core.autocrlf=input conflicts with core.eol=crlf");
 785                        auto_crlf = AUTO_CRLF_INPUT;
 786                        return 0;
 787                }
 788                auto_crlf = git_config_bool(var, value);
 789                return 0;
 790        }
 791
 792        if (!strcmp(var, "core.safecrlf")) {
 793                if (value && !strcasecmp(value, "warn")) {
 794                        safe_crlf = SAFE_CRLF_WARN;
 795                        return 0;
 796                }
 797                safe_crlf = git_config_bool(var, value);
 798                return 0;
 799        }
 800
 801        if (!strcmp(var, "core.eol")) {
 802                if (value && !strcasecmp(value, "lf"))
 803                        core_eol = EOL_LF;
 804                else if (value && !strcasecmp(value, "crlf"))
 805                        core_eol = EOL_CRLF;
 806                else if (value && !strcasecmp(value, "native"))
 807                        core_eol = EOL_NATIVE;
 808                else
 809                        core_eol = EOL_UNSET;
 810                if (core_eol == EOL_CRLF && auto_crlf == AUTO_CRLF_INPUT)
 811                        return error("core.autocrlf=input conflicts with core.eol=crlf");
 812                return 0;
 813        }
 814
 815        if (!strcmp(var, "core.notesref")) {
 816                notes_ref_name = xstrdup(value);
 817                return 0;
 818        }
 819
 820        if (!strcmp(var, "core.pager"))
 821                return git_config_string(&pager_program, var, value);
 822
 823        if (!strcmp(var, "core.editor"))
 824                return git_config_string(&editor_program, var, value);
 825
 826        if (!strcmp(var, "core.commentchar")) {
 827                const char *comment;
 828                int ret = git_config_string(&comment, var, value);
 829                if (!ret)
 830                        comment_line_char = comment[0];
 831                return ret;
 832        }
 833
 834        if (!strcmp(var, "core.askpass"))
 835                return git_config_string(&askpass_program, var, value);
 836
 837        if (!strcmp(var, "core.excludesfile"))
 838                return git_config_pathname(&excludes_file, var, value);
 839
 840        if (!strcmp(var, "core.whitespace")) {
 841                if (!value)
 842                        return config_error_nonbool(var);
 843                whitespace_rule_cfg = parse_whitespace_rule(value);
 844                return 0;
 845        }
 846
 847        if (!strcmp(var, "core.fsyncobjectfiles")) {
 848                fsync_object_files = git_config_bool(var, value);
 849                return 0;
 850        }
 851
 852        if (!strcmp(var, "core.preloadindex")) {
 853                core_preload_index = git_config_bool(var, value);
 854                return 0;
 855        }
 856
 857        if (!strcmp(var, "core.createobject")) {
 858                if (!strcmp(value, "rename"))
 859                        object_creation_mode = OBJECT_CREATION_USES_RENAMES;
 860                else if (!strcmp(value, "link"))
 861                        object_creation_mode = OBJECT_CREATION_USES_HARDLINKS;
 862                else
 863                        die("Invalid mode for object creation: %s", value);
 864                return 0;
 865        }
 866
 867        if (!strcmp(var, "core.sparsecheckout")) {
 868                core_apply_sparse_checkout = git_config_bool(var, value);
 869                return 0;
 870        }
 871
 872        if (!strcmp(var, "core.precomposeunicode")) {
 873                precomposed_unicode = git_config_bool(var, value);
 874                return 0;
 875        }
 876
 877        /* Add other config variables here and to Documentation/config.txt. */
 878        return 0;
 879}
 880
 881static int git_default_i18n_config(const char *var, const char *value)
 882{
 883        if (!strcmp(var, "i18n.commitencoding"))
 884                return git_config_string(&git_commit_encoding, var, value);
 885
 886        if (!strcmp(var, "i18n.logoutputencoding"))
 887                return git_config_string(&git_log_output_encoding, var, value);
 888
 889        /* Add other config variables here and to Documentation/config.txt. */
 890        return 0;
 891}
 892
 893static int git_default_branch_config(const char *var, const char *value)
 894{
 895        if (!strcmp(var, "branch.autosetupmerge")) {
 896                if (value && !strcasecmp(value, "always")) {
 897                        git_branch_track = BRANCH_TRACK_ALWAYS;
 898                        return 0;
 899                }
 900                git_branch_track = git_config_bool(var, value);
 901                return 0;
 902        }
 903        if (!strcmp(var, "branch.autosetuprebase")) {
 904                if (!value)
 905                        return config_error_nonbool(var);
 906                else if (!strcmp(value, "never"))
 907                        autorebase = AUTOREBASE_NEVER;
 908                else if (!strcmp(value, "local"))
 909                        autorebase = AUTOREBASE_LOCAL;
 910                else if (!strcmp(value, "remote"))
 911                        autorebase = AUTOREBASE_REMOTE;
 912                else if (!strcmp(value, "always"))
 913                        autorebase = AUTOREBASE_ALWAYS;
 914                else
 915                        return error("Malformed value for %s", var);
 916                return 0;
 917        }
 918
 919        /* Add other config variables here and to Documentation/config.txt. */
 920        return 0;
 921}
 922
 923static int git_default_push_config(const char *var, const char *value)
 924{
 925        if (!strcmp(var, "push.default")) {
 926                if (!value)
 927                        return config_error_nonbool(var);
 928                else if (!strcmp(value, "nothing"))
 929                        push_default = PUSH_DEFAULT_NOTHING;
 930                else if (!strcmp(value, "matching"))
 931                        push_default = PUSH_DEFAULT_MATCHING;
 932                else if (!strcmp(value, "simple"))
 933                        push_default = PUSH_DEFAULT_SIMPLE;
 934                else if (!strcmp(value, "upstream"))
 935                        push_default = PUSH_DEFAULT_UPSTREAM;
 936                else if (!strcmp(value, "tracking")) /* deprecated */
 937                        push_default = PUSH_DEFAULT_UPSTREAM;
 938                else if (!strcmp(value, "current"))
 939                        push_default = PUSH_DEFAULT_CURRENT;
 940                else {
 941                        error("Malformed value for %s: %s", var, value);
 942                        return error("Must be one of nothing, matching, simple, "
 943                                     "upstream or current.");
 944                }
 945                return 0;
 946        }
 947
 948        /* Add other config variables here and to Documentation/config.txt. */
 949        return 0;
 950}
 951
 952static int git_default_mailmap_config(const char *var, const char *value)
 953{
 954        if (!strcmp(var, "mailmap.file"))
 955                return git_config_string(&git_mailmap_file, var, value);
 956        if (!strcmp(var, "mailmap.blob"))
 957                return git_config_string(&git_mailmap_blob, var, value);
 958
 959        /* Add other config variables here and to Documentation/config.txt. */
 960        return 0;
 961}
 962
 963int git_default_config(const char *var, const char *value, void *dummy)
 964{
 965        if (starts_with(var, "core."))
 966                return git_default_core_config(var, value);
 967
 968        if (starts_with(var, "user."))
 969                return git_ident_config(var, value, dummy);
 970
 971        if (starts_with(var, "i18n."))
 972                return git_default_i18n_config(var, value);
 973
 974        if (starts_with(var, "branch."))
 975                return git_default_branch_config(var, value);
 976
 977        if (starts_with(var, "push."))
 978                return git_default_push_config(var, value);
 979
 980        if (starts_with(var, "mailmap."))
 981                return git_default_mailmap_config(var, value);
 982
 983        if (starts_with(var, "advice."))
 984                return git_default_advice_config(var, value);
 985
 986        if (!strcmp(var, "pager.color") || !strcmp(var, "color.pager")) {
 987                pager_use_color = git_config_bool(var,value);
 988                return 0;
 989        }
 990
 991        if (!strcmp(var, "pack.packsizelimit")) {
 992                pack_size_limit_cfg = git_config_ulong(var, value);
 993                return 0;
 994        }
 995        /* Add other config variables here and to Documentation/config.txt. */
 996        return 0;
 997}
 998
 999/*
1000 * All source specific fields in the union, die_on_error, name and the callbacks
1001 * fgetc, ungetc, ftell of top need to be initialized before calling
1002 * this function.
1003 */
1004static int do_config_from(struct config_source *top, config_fn_t fn, void *data)
1005{
1006        int ret;
1007
1008        /* push config-file parsing state stack */
1009        top->prev = cf;
1010        top->linenr = 1;
1011        top->eof = 0;
1012        strbuf_init(&top->value, 1024);
1013        strbuf_init(&top->var, 1024);
1014        cf = top;
1015
1016        ret = git_parse_source(fn, data);
1017
1018        /* pop config-file parsing state stack */
1019        strbuf_release(&top->value);
1020        strbuf_release(&top->var);
1021        cf = top->prev;
1022
1023        return ret;
1024}
1025
1026static int do_config_from_file(config_fn_t fn,
1027                const char *name, const char *path, FILE *f, void *data)
1028{
1029        struct config_source top;
1030
1031        top.u.file = f;
1032        top.name = name;
1033        top.path = path;
1034        top.die_on_error = 1;
1035        top.do_fgetc = config_file_fgetc;
1036        top.do_ungetc = config_file_ungetc;
1037        top.do_ftell = config_file_ftell;
1038
1039        return do_config_from(&top, fn, data);
1040}
1041
1042static int git_config_from_stdin(config_fn_t fn, void *data)
1043{
1044        return do_config_from_file(fn, "<stdin>", NULL, stdin, data);
1045}
1046
1047int git_config_from_file(config_fn_t fn, const char *filename, void *data)
1048{
1049        int ret = -1;
1050        FILE *f;
1051
1052        f = fopen(filename, "r");
1053        if (f) {
1054                ret = do_config_from_file(fn, filename, filename, f, data);
1055                fclose(f);
1056        }
1057        return ret;
1058}
1059
1060int git_config_from_buf(config_fn_t fn, const char *name, const char *buf,
1061                        size_t len, void *data)
1062{
1063        struct config_source top;
1064
1065        top.u.buf.buf = buf;
1066        top.u.buf.len = len;
1067        top.u.buf.pos = 0;
1068        top.name = name;
1069        top.path = NULL;
1070        top.die_on_error = 0;
1071        top.do_fgetc = config_buf_fgetc;
1072        top.do_ungetc = config_buf_ungetc;
1073        top.do_ftell = config_buf_ftell;
1074
1075        return do_config_from(&top, fn, data);
1076}
1077
1078static int git_config_from_blob_sha1(config_fn_t fn,
1079                                     const char *name,
1080                                     const unsigned char *sha1,
1081                                     void *data)
1082{
1083        enum object_type type;
1084        char *buf;
1085        unsigned long size;
1086        int ret;
1087
1088        buf = read_sha1_file(sha1, &type, &size);
1089        if (!buf)
1090                return error("unable to load config blob object '%s'", name);
1091        if (type != OBJ_BLOB) {
1092                free(buf);
1093                return error("reference '%s' does not point to a blob", name);
1094        }
1095
1096        ret = git_config_from_buf(fn, name, buf, size, data);
1097        free(buf);
1098
1099        return ret;
1100}
1101
1102static int git_config_from_blob_ref(config_fn_t fn,
1103                                    const char *name,
1104                                    void *data)
1105{
1106        unsigned char sha1[20];
1107
1108        if (get_sha1(name, sha1) < 0)
1109                return error("unable to resolve config blob '%s'", name);
1110        return git_config_from_blob_sha1(fn, name, sha1, data);
1111}
1112
1113const char *git_etc_gitconfig(void)
1114{
1115        static const char *system_wide;
1116        if (!system_wide)
1117                system_wide = system_path(ETC_GITCONFIG);
1118        return system_wide;
1119}
1120
1121int git_env_bool(const char *k, int def)
1122{
1123        const char *v = getenv(k);
1124        return v ? git_config_bool(k, v) : def;
1125}
1126
1127int git_config_system(void)
1128{
1129        return !git_env_bool("GIT_CONFIG_NOSYSTEM", 0);
1130}
1131
1132int git_config_early(config_fn_t fn, void *data, const char *repo_config)
1133{
1134        int ret = 0, found = 0;
1135        char *xdg_config = NULL;
1136        char *user_config = NULL;
1137
1138        home_config_paths(&user_config, &xdg_config, "config");
1139
1140        if (git_config_system() && !access_or_die(git_etc_gitconfig(), R_OK, 0)) {
1141                ret += git_config_from_file(fn, git_etc_gitconfig(),
1142                                            data);
1143                found += 1;
1144        }
1145
1146        if (xdg_config && !access_or_die(xdg_config, R_OK, ACCESS_EACCES_OK)) {
1147                ret += git_config_from_file(fn, xdg_config, data);
1148                found += 1;
1149        }
1150
1151        if (user_config && !access_or_die(user_config, R_OK, ACCESS_EACCES_OK)) {
1152                ret += git_config_from_file(fn, user_config, data);
1153                found += 1;
1154        }
1155
1156        if (repo_config && !access_or_die(repo_config, R_OK, 0)) {
1157                ret += git_config_from_file(fn, repo_config, data);
1158                found += 1;
1159        }
1160
1161        switch (git_config_from_parameters(fn, data)) {
1162        case -1: /* error */
1163                die("unable to parse command-line config");
1164                break;
1165        case 0: /* found nothing */
1166                break;
1167        default: /* found at least one item */
1168                found++;
1169                break;
1170        }
1171
1172        free(xdg_config);
1173        free(user_config);
1174        return ret == 0 ? found : ret;
1175}
1176
1177int git_config_with_options(config_fn_t fn, void *data,
1178                            struct git_config_source *config_source,
1179                            int respect_includes)
1180{
1181        char *repo_config = NULL;
1182        int ret;
1183        struct config_include_data inc = CONFIG_INCLUDE_INIT;
1184
1185        if (respect_includes) {
1186                inc.fn = fn;
1187                inc.data = data;
1188                fn = git_config_include;
1189                data = &inc;
1190        }
1191
1192        /*
1193         * If we have a specific filename, use it. Otherwise, follow the
1194         * regular lookup sequence.
1195         */
1196        if (config_source && config_source->use_stdin)
1197                return git_config_from_stdin(fn, data);
1198        else if (config_source && config_source->file)
1199                return git_config_from_file(fn, config_source->file, data);
1200        else if (config_source && config_source->blob)
1201                return git_config_from_blob_ref(fn, config_source->blob, data);
1202
1203        repo_config = git_pathdup("config");
1204        ret = git_config_early(fn, data, repo_config);
1205        if (repo_config)
1206                free(repo_config);
1207        return ret;
1208}
1209
1210int git_config(config_fn_t fn, void *data)
1211{
1212        return git_config_with_options(fn, data, NULL, 1);
1213}
1214
1215/*
1216 * Find all the stuff for git_config_set() below.
1217 */
1218
1219static struct {
1220        int baselen;
1221        char *key;
1222        int do_not_match;
1223        regex_t *value_regex;
1224        int multi_replace;
1225        size_t *offset;
1226        unsigned int offset_alloc;
1227        enum { START, SECTION_SEEN, SECTION_END_SEEN, KEY_SEEN } state;
1228        int seen;
1229} store;
1230
1231static int matches(const char *key, const char *value)
1232{
1233        return !strcmp(key, store.key) &&
1234                (store.value_regex == NULL ||
1235                 (store.do_not_match ^
1236                  !regexec(store.value_regex, value, 0, NULL, 0)));
1237}
1238
1239static int store_aux(const char *key, const char *value, void *cb)
1240{
1241        const char *ep;
1242        size_t section_len;
1243
1244        switch (store.state) {
1245        case KEY_SEEN:
1246                if (matches(key, value)) {
1247                        if (store.seen == 1 && store.multi_replace == 0) {
1248                                warning("%s has multiple values", key);
1249                        }
1250
1251                        ALLOC_GROW(store.offset, store.seen + 1,
1252                                   store.offset_alloc);
1253
1254                        store.offset[store.seen] = cf->do_ftell(cf);
1255                        store.seen++;
1256                }
1257                break;
1258        case SECTION_SEEN:
1259                /*
1260                 * What we are looking for is in store.key (both
1261                 * section and var), and its section part is baselen
1262                 * long.  We found key (again, both section and var).
1263                 * We would want to know if this key is in the same
1264                 * section as what we are looking for.  We already
1265                 * know we are in the same section as what should
1266                 * hold store.key.
1267                 */
1268                ep = strrchr(key, '.');
1269                section_len = ep - key;
1270
1271                if ((section_len != store.baselen) ||
1272                    memcmp(key, store.key, section_len+1)) {
1273                        store.state = SECTION_END_SEEN;
1274                        break;
1275                }
1276
1277                /*
1278                 * Do not increment matches: this is no match, but we
1279                 * just made sure we are in the desired section.
1280                 */
1281                ALLOC_GROW(store.offset, store.seen + 1,
1282                           store.offset_alloc);
1283                store.offset[store.seen] = cf->do_ftell(cf);
1284                /* fallthru */
1285        case SECTION_END_SEEN:
1286        case START:
1287                if (matches(key, value)) {
1288                        ALLOC_GROW(store.offset, store.seen + 1,
1289                                   store.offset_alloc);
1290                        store.offset[store.seen] = cf->do_ftell(cf);
1291                        store.state = KEY_SEEN;
1292                        store.seen++;
1293                } else {
1294                        if (strrchr(key, '.') - key == store.baselen &&
1295                              !strncmp(key, store.key, store.baselen)) {
1296                                        store.state = SECTION_SEEN;
1297                                        ALLOC_GROW(store.offset,
1298                                                   store.seen + 1,
1299                                                   store.offset_alloc);
1300                                        store.offset[store.seen] = cf->do_ftell(cf);
1301                        }
1302                }
1303        }
1304        return 0;
1305}
1306
1307static int write_error(const char *filename)
1308{
1309        error("failed to write new configuration file %s", filename);
1310
1311        /* Same error code as "failed to rename". */
1312        return 4;
1313}
1314
1315static int store_write_section(int fd, const char *key)
1316{
1317        const char *dot;
1318        int i, success;
1319        struct strbuf sb = STRBUF_INIT;
1320
1321        dot = memchr(key, '.', store.baselen);
1322        if (dot) {
1323                strbuf_addf(&sb, "[%.*s \"", (int)(dot - key), key);
1324                for (i = dot - key + 1; i < store.baselen; i++) {
1325                        if (key[i] == '"' || key[i] == '\\')
1326                                strbuf_addch(&sb, '\\');
1327                        strbuf_addch(&sb, key[i]);
1328                }
1329                strbuf_addstr(&sb, "\"]\n");
1330        } else {
1331                strbuf_addf(&sb, "[%.*s]\n", store.baselen, key);
1332        }
1333
1334        success = write_in_full(fd, sb.buf, sb.len) == sb.len;
1335        strbuf_release(&sb);
1336
1337        return success;
1338}
1339
1340static int store_write_pair(int fd, const char *key, const char *value)
1341{
1342        int i, success;
1343        int length = strlen(key + store.baselen + 1);
1344        const char *quote = "";
1345        struct strbuf sb = STRBUF_INIT;
1346
1347        /*
1348         * Check to see if the value needs to be surrounded with a dq pair.
1349         * Note that problematic characters are always backslash-quoted; this
1350         * check is about not losing leading or trailing SP and strings that
1351         * follow beginning-of-comment characters (i.e. ';' and '#') by the
1352         * configuration parser.
1353         */
1354        if (value[0] == ' ')
1355                quote = "\"";
1356        for (i = 0; value[i]; i++)
1357                if (value[i] == ';' || value[i] == '#')
1358                        quote = "\"";
1359        if (i && value[i - 1] == ' ')
1360                quote = "\"";
1361
1362        strbuf_addf(&sb, "\t%.*s = %s",
1363                    length, key + store.baselen + 1, quote);
1364
1365        for (i = 0; value[i]; i++)
1366                switch (value[i]) {
1367                case '\n':
1368                        strbuf_addstr(&sb, "\\n");
1369                        break;
1370                case '\t':
1371                        strbuf_addstr(&sb, "\\t");
1372                        break;
1373                case '"':
1374                case '\\':
1375                        strbuf_addch(&sb, '\\');
1376                default:
1377                        strbuf_addch(&sb, value[i]);
1378                        break;
1379                }
1380        strbuf_addf(&sb, "%s\n", quote);
1381
1382        success = write_in_full(fd, sb.buf, sb.len) == sb.len;
1383        strbuf_release(&sb);
1384
1385        return success;
1386}
1387
1388static ssize_t find_beginning_of_line(const char *contents, size_t size,
1389        size_t offset_, int *found_bracket)
1390{
1391        size_t equal_offset = size, bracket_offset = size;
1392        ssize_t offset;
1393
1394contline:
1395        for (offset = offset_-2; offset > 0
1396                        && contents[offset] != '\n'; offset--)
1397                switch (contents[offset]) {
1398                        case '=': equal_offset = offset; break;
1399                        case ']': bracket_offset = offset; break;
1400                }
1401        if (offset > 0 && contents[offset-1] == '\\') {
1402                offset_ = offset;
1403                goto contline;
1404        }
1405        if (bracket_offset < equal_offset) {
1406                *found_bracket = 1;
1407                offset = bracket_offset+1;
1408        } else
1409                offset++;
1410
1411        return offset;
1412}
1413
1414int git_config_set_in_file(const char *config_filename,
1415                        const char *key, const char *value)
1416{
1417        return git_config_set_multivar_in_file(config_filename, key, value, NULL, 0);
1418}
1419
1420int git_config_set(const char *key, const char *value)
1421{
1422        return git_config_set_multivar(key, value, NULL, 0);
1423}
1424
1425/*
1426 * Auxiliary function to sanity-check and split the key into the section
1427 * identifier and variable name.
1428 *
1429 * Returns 0 on success, -1 when there is an invalid character in the key and
1430 * -2 if there is no section name in the key.
1431 *
1432 * store_key - pointer to char* which will hold a copy of the key with
1433 *             lowercase section and variable name
1434 * baselen - pointer to int which will hold the length of the
1435 *           section + subsection part, can be NULL
1436 */
1437int git_config_parse_key(const char *key, char **store_key, int *baselen_)
1438{
1439        int i, dot, baselen;
1440        const char *last_dot = strrchr(key, '.');
1441
1442        /*
1443         * Since "key" actually contains the section name and the real
1444         * key name separated by a dot, we have to know where the dot is.
1445         */
1446
1447        if (last_dot == NULL || last_dot == key) {
1448                error("key does not contain a section: %s", key);
1449                return -CONFIG_NO_SECTION_OR_NAME;
1450        }
1451
1452        if (!last_dot[1]) {
1453                error("key does not contain variable name: %s", key);
1454                return -CONFIG_NO_SECTION_OR_NAME;
1455        }
1456
1457        baselen = last_dot - key;
1458        if (baselen_)
1459                *baselen_ = baselen;
1460
1461        /*
1462         * Validate the key and while at it, lower case it for matching.
1463         */
1464        *store_key = xmalloc(strlen(key) + 1);
1465
1466        dot = 0;
1467        for (i = 0; key[i]; i++) {
1468                unsigned char c = key[i];
1469                if (c == '.')
1470                        dot = 1;
1471                /* Leave the extended basename untouched.. */
1472                if (!dot || i > baselen) {
1473                        if (!iskeychar(c) ||
1474                            (i == baselen + 1 && !isalpha(c))) {
1475                                error("invalid key: %s", key);
1476                                goto out_free_ret_1;
1477                        }
1478                        c = tolower(c);
1479                } else if (c == '\n') {
1480                        error("invalid key (newline): %s", key);
1481                        goto out_free_ret_1;
1482                }
1483                (*store_key)[i] = c;
1484        }
1485        (*store_key)[i] = 0;
1486
1487        return 0;
1488
1489out_free_ret_1:
1490        free(*store_key);
1491        *store_key = NULL;
1492        return -CONFIG_INVALID_KEY;
1493}
1494
1495/*
1496 * If value==NULL, unset in (remove from) config,
1497 * if value_regex!=NULL, disregard key/value pairs where value does not match.
1498 * if multi_replace==0, nothing, or only one matching key/value is replaced,
1499 *     else all matching key/values (regardless how many) are removed,
1500 *     before the new pair is written.
1501 *
1502 * Returns 0 on success.
1503 *
1504 * This function does this:
1505 *
1506 * - it locks the config file by creating ".git/config.lock"
1507 *
1508 * - it then parses the config using store_aux() as validator to find
1509 *   the position on the key/value pair to replace. If it is to be unset,
1510 *   it must be found exactly once.
1511 *
1512 * - the config file is mmap()ed and the part before the match (if any) is
1513 *   written to the lock file, then the changed part and the rest.
1514 *
1515 * - the config file is removed and the lock file rename()d to it.
1516 *
1517 */
1518int git_config_set_multivar_in_file(const char *config_filename,
1519                                const char *key, const char *value,
1520                                const char *value_regex, int multi_replace)
1521{
1522        int fd = -1, in_fd;
1523        int ret;
1524        struct lock_file *lock = NULL;
1525        char *filename_buf = NULL;
1526
1527        /* parse-key returns negative; flip the sign to feed exit(3) */
1528        ret = 0 - git_config_parse_key(key, &store.key, &store.baselen);
1529        if (ret)
1530                goto out_free;
1531
1532        store.multi_replace = multi_replace;
1533
1534        if (!config_filename)
1535                config_filename = filename_buf = git_pathdup("config");
1536
1537        /*
1538         * The lock serves a purpose in addition to locking: the new
1539         * contents of .git/config will be written into it.
1540         */
1541        lock = xcalloc(sizeof(struct lock_file), 1);
1542        fd = hold_lock_file_for_update(lock, config_filename, 0);
1543        if (fd < 0) {
1544                error("could not lock config file %s: %s", config_filename, strerror(errno));
1545                free(store.key);
1546                ret = CONFIG_NO_LOCK;
1547                goto out_free;
1548        }
1549
1550        /*
1551         * If .git/config does not exist yet, write a minimal version.
1552         */
1553        in_fd = open(config_filename, O_RDONLY);
1554        if ( in_fd < 0 ) {
1555                free(store.key);
1556
1557                if ( ENOENT != errno ) {
1558                        error("opening %s: %s", config_filename,
1559                              strerror(errno));
1560                        ret = CONFIG_INVALID_FILE; /* same as "invalid config file" */
1561                        goto out_free;
1562                }
1563                /* if nothing to unset, error out */
1564                if (value == NULL) {
1565                        ret = CONFIG_NOTHING_SET;
1566                        goto out_free;
1567                }
1568
1569                store.key = (char *)key;
1570                if (!store_write_section(fd, key) ||
1571                    !store_write_pair(fd, key, value))
1572                        goto write_err_out;
1573        } else {
1574                struct stat st;
1575                char *contents;
1576                size_t contents_sz, copy_begin, copy_end;
1577                int i, new_line = 0;
1578
1579                if (value_regex == NULL)
1580                        store.value_regex = NULL;
1581                else {
1582                        if (value_regex[0] == '!') {
1583                                store.do_not_match = 1;
1584                                value_regex++;
1585                        } else
1586                                store.do_not_match = 0;
1587
1588                        store.value_regex = (regex_t*)xmalloc(sizeof(regex_t));
1589                        if (regcomp(store.value_regex, value_regex,
1590                                        REG_EXTENDED)) {
1591                                error("invalid pattern: %s", value_regex);
1592                                free(store.value_regex);
1593                                ret = CONFIG_INVALID_PATTERN;
1594                                goto out_free;
1595                        }
1596                }
1597
1598                ALLOC_GROW(store.offset, 1, store.offset_alloc);
1599                store.offset[0] = 0;
1600                store.state = START;
1601                store.seen = 0;
1602
1603                /*
1604                 * After this, store.offset will contain the *end* offset
1605                 * of the last match, or remain at 0 if no match was found.
1606                 * As a side effect, we make sure to transform only a valid
1607                 * existing config file.
1608                 */
1609                if (git_config_from_file(store_aux, config_filename, NULL)) {
1610                        error("invalid config file %s", config_filename);
1611                        free(store.key);
1612                        if (store.value_regex != NULL) {
1613                                regfree(store.value_regex);
1614                                free(store.value_regex);
1615                        }
1616                        ret = CONFIG_INVALID_FILE;
1617                        goto out_free;
1618                }
1619
1620                free(store.key);
1621                if (store.value_regex != NULL) {
1622                        regfree(store.value_regex);
1623                        free(store.value_regex);
1624                }
1625
1626                /* if nothing to unset, or too many matches, error out */
1627                if ((store.seen == 0 && value == NULL) ||
1628                                (store.seen > 1 && multi_replace == 0)) {
1629                        ret = CONFIG_NOTHING_SET;
1630                        goto out_free;
1631                }
1632
1633                fstat(in_fd, &st);
1634                contents_sz = xsize_t(st.st_size);
1635                contents = xmmap(NULL, contents_sz, PROT_READ,
1636                        MAP_PRIVATE, in_fd, 0);
1637                close(in_fd);
1638
1639                if (store.seen == 0)
1640                        store.seen = 1;
1641
1642                for (i = 0, copy_begin = 0; i < store.seen; i++) {
1643                        if (store.offset[i] == 0) {
1644                                store.offset[i] = copy_end = contents_sz;
1645                        } else if (store.state != KEY_SEEN) {
1646                                copy_end = store.offset[i];
1647                        } else
1648                                copy_end = find_beginning_of_line(
1649                                        contents, contents_sz,
1650                                        store.offset[i]-2, &new_line);
1651
1652                        if (copy_end > 0 && contents[copy_end-1] != '\n')
1653                                new_line = 1;
1654
1655                        /* write the first part of the config */
1656                        if (copy_end > copy_begin) {
1657                                if (write_in_full(fd, contents + copy_begin,
1658                                                  copy_end - copy_begin) <
1659                                    copy_end - copy_begin)
1660                                        goto write_err_out;
1661                                if (new_line &&
1662                                    write_str_in_full(fd, "\n") != 1)
1663                                        goto write_err_out;
1664                        }
1665                        copy_begin = store.offset[i];
1666                }
1667
1668                /* write the pair (value == NULL means unset) */
1669                if (value != NULL) {
1670                        if (store.state == START) {
1671                                if (!store_write_section(fd, key))
1672                                        goto write_err_out;
1673                        }
1674                        if (!store_write_pair(fd, key, value))
1675                                goto write_err_out;
1676                }
1677
1678                /* write the rest of the config */
1679                if (copy_begin < contents_sz)
1680                        if (write_in_full(fd, contents + copy_begin,
1681                                          contents_sz - copy_begin) <
1682                            contents_sz - copy_begin)
1683                                goto write_err_out;
1684
1685                munmap(contents, contents_sz);
1686        }
1687
1688        if (commit_lock_file(lock) < 0) {
1689                error("could not commit config file %s", config_filename);
1690                ret = CONFIG_NO_WRITE;
1691                goto out_free;
1692        }
1693
1694        /*
1695         * lock is committed, so don't try to roll it back below.
1696         * NOTE: Since lockfile.c keeps a linked list of all created
1697         * lock_file structures, it isn't safe to free(lock).  It's
1698         * better to just leave it hanging around.
1699         */
1700        lock = NULL;
1701        ret = 0;
1702
1703out_free:
1704        if (lock)
1705                rollback_lock_file(lock);
1706        free(filename_buf);
1707        return ret;
1708
1709write_err_out:
1710        ret = write_error(lock->filename);
1711        goto out_free;
1712
1713}
1714
1715int git_config_set_multivar(const char *key, const char *value,
1716                        const char *value_regex, int multi_replace)
1717{
1718        return git_config_set_multivar_in_file(NULL, key, value, value_regex,
1719                                               multi_replace);
1720}
1721
1722static int section_name_match (const char *buf, const char *name)
1723{
1724        int i = 0, j = 0, dot = 0;
1725        if (buf[i] != '[')
1726                return 0;
1727        for (i = 1; buf[i] && buf[i] != ']'; i++) {
1728                if (!dot && isspace(buf[i])) {
1729                        dot = 1;
1730                        if (name[j++] != '.')
1731                                break;
1732                        for (i++; isspace(buf[i]); i++)
1733                                ; /* do nothing */
1734                        if (buf[i] != '"')
1735                                break;
1736                        continue;
1737                }
1738                if (buf[i] == '\\' && dot)
1739                        i++;
1740                else if (buf[i] == '"' && dot) {
1741                        for (i++; isspace(buf[i]); i++)
1742                                ; /* do_nothing */
1743                        break;
1744                }
1745                if (buf[i] != name[j++])
1746                        break;
1747        }
1748        if (buf[i] == ']' && name[j] == 0) {
1749                /*
1750                 * We match, now just find the right length offset by
1751                 * gobbling up any whitespace after it, as well
1752                 */
1753                i++;
1754                for (; buf[i] && isspace(buf[i]); i++)
1755                        ; /* do nothing */
1756                return i;
1757        }
1758        return 0;
1759}
1760
1761static int section_name_is_ok(const char *name)
1762{
1763        /* Empty section names are bogus. */
1764        if (!*name)
1765                return 0;
1766
1767        /*
1768         * Before a dot, we must be alphanumeric or dash. After the first dot,
1769         * anything goes, so we can stop checking.
1770         */
1771        for (; *name && *name != '.'; name++)
1772                if (*name != '-' && !isalnum(*name))
1773                        return 0;
1774        return 1;
1775}
1776
1777/* if new_name == NULL, the section is removed instead */
1778int git_config_rename_section_in_file(const char *config_filename,
1779                                      const char *old_name, const char *new_name)
1780{
1781        int ret = 0, remove = 0;
1782        char *filename_buf = NULL;
1783        struct lock_file *lock;
1784        int out_fd;
1785        char buf[1024];
1786        FILE *config_file;
1787
1788        if (new_name && !section_name_is_ok(new_name)) {
1789                ret = error("invalid section name: %s", new_name);
1790                goto out;
1791        }
1792
1793        if (!config_filename)
1794                config_filename = filename_buf = git_pathdup("config");
1795
1796        lock = xcalloc(sizeof(struct lock_file), 1);
1797        out_fd = hold_lock_file_for_update(lock, config_filename, 0);
1798        if (out_fd < 0) {
1799                ret = error("could not lock config file %s", config_filename);
1800                goto out;
1801        }
1802
1803        if (!(config_file = fopen(config_filename, "rb"))) {
1804                /* no config file means nothing to rename, no error */
1805                goto unlock_and_out;
1806        }
1807
1808        while (fgets(buf, sizeof(buf), config_file)) {
1809                int i;
1810                int length;
1811                char *output = buf;
1812                for (i = 0; buf[i] && isspace(buf[i]); i++)
1813                        ; /* do nothing */
1814                if (buf[i] == '[') {
1815                        /* it's a section */
1816                        int offset = section_name_match(&buf[i], old_name);
1817                        if (offset > 0) {
1818                                ret++;
1819                                if (new_name == NULL) {
1820                                        remove = 1;
1821                                        continue;
1822                                }
1823                                store.baselen = strlen(new_name);
1824                                if (!store_write_section(out_fd, new_name)) {
1825                                        ret = write_error(lock->filename);
1826                                        goto out;
1827                                }
1828                                /*
1829                                 * We wrote out the new section, with
1830                                 * a newline, now skip the old
1831                                 * section's length
1832                                 */
1833                                output += offset + i;
1834                                if (strlen(output) > 0) {
1835                                        /*
1836                                         * More content means there's
1837                                         * a declaration to put on the
1838                                         * next line; indent with a
1839                                         * tab
1840                                         */
1841                                        output -= 1;
1842                                        output[0] = '\t';
1843                                }
1844                        }
1845                        remove = 0;
1846                }
1847                if (remove)
1848                        continue;
1849                length = strlen(output);
1850                if (write_in_full(out_fd, output, length) != length) {
1851                        ret = write_error(lock->filename);
1852                        goto out;
1853                }
1854        }
1855        fclose(config_file);
1856unlock_and_out:
1857        if (commit_lock_file(lock) < 0)
1858                ret = error("could not commit config file %s", config_filename);
1859out:
1860        free(filename_buf);
1861        return ret;
1862}
1863
1864int git_config_rename_section(const char *old_name, const char *new_name)
1865{
1866        return git_config_rename_section_in_file(NULL, old_name, new_name);
1867}
1868
1869/*
1870 * Call this to report error for your variable that should not
1871 * get a boolean value (i.e. "[my] var" means "true").
1872 */
1873#undef config_error_nonbool
1874int config_error_nonbool(const char *var)
1875{
1876        return error("Missing value for '%s'", var);
1877}
1878
1879int parse_config_key(const char *var,
1880                     const char *section,
1881                     const char **subsection, int *subsection_len,
1882                     const char **key)
1883{
1884        int section_len = strlen(section);
1885        const char *dot;
1886
1887        /* Does it start with "section." ? */
1888        if (!starts_with(var, section) || var[section_len] != '.')
1889                return -1;
1890
1891        /*
1892         * Find the key; we don't know yet if we have a subsection, but we must
1893         * parse backwards from the end, since the subsection may have dots in
1894         * it, too.
1895         */
1896        dot = strrchr(var, '.');
1897        *key = dot + 1;
1898
1899        /* Did we have a subsection at all? */
1900        if (dot == var + section_len) {
1901                *subsection = NULL;
1902                *subsection_len = 0;
1903        }
1904        else {
1905                *subsection = var + section_len + 1;
1906                *subsection_len = dot - *subsection;
1907        }
1908
1909        return 0;
1910}