0db79f9cf6a6b3c1f21b4e0b286bcd9f0ca7df0d
   1/*
   2 * This handles recursive filename detection with exclude
   3 * files, index knowledge etc..
   4 *
   5 * Copyright (C) Linus Torvalds, 2005-2006
   6 *               Junio Hamano, 2005-2006
   7 */
   8#include "cache.h"
   9#include "dir.h"
  10#include "refs.h"
  11
  12struct path_simplify {
  13        int len;
  14        const char *path;
  15};
  16
  17static int read_directory_recursive(struct dir_struct *dir, const char *path, int len,
  18        int check_only, const struct path_simplify *simplify);
  19static int get_dtype(struct dirent *de, const char *path, int len);
  20
  21/* helper string functions with support for the ignore_case flag */
  22int strcmp_icase(const char *a, const char *b)
  23{
  24        return ignore_case ? strcasecmp(a, b) : strcmp(a, b);
  25}
  26
  27int strncmp_icase(const char *a, const char *b, size_t count)
  28{
  29        return ignore_case ? strncasecmp(a, b, count) : strncmp(a, b, count);
  30}
  31
  32int fnmatch_icase(const char *pattern, const char *string, int flags)
  33{
  34        return fnmatch(pattern, string, flags | (ignore_case ? FNM_CASEFOLD : 0));
  35}
  36
  37static int fnmatch_icase_mem(const char *pattern, int patternlen,
  38                             const char *string, int stringlen,
  39                             int flags)
  40{
  41        int match_status;
  42        struct strbuf pat_buf = STRBUF_INIT;
  43        struct strbuf str_buf = STRBUF_INIT;
  44        const char *use_pat = pattern;
  45        const char *use_str = string;
  46
  47        if (pattern[patternlen]) {
  48                strbuf_add(&pat_buf, pattern, patternlen);
  49                use_pat = pat_buf.buf;
  50        }
  51        if (string[stringlen]) {
  52                strbuf_add(&str_buf, string, stringlen);
  53                use_str = str_buf.buf;
  54        }
  55
  56        match_status = fnmatch_icase(use_pat, use_str, flags);
  57
  58        strbuf_release(&pat_buf);
  59        strbuf_release(&str_buf);
  60
  61        return match_status;
  62}
  63
  64static size_t common_prefix_len(const char **pathspec)
  65{
  66        const char *n, *first;
  67        size_t max = 0;
  68
  69        if (!pathspec)
  70                return max;
  71
  72        first = *pathspec;
  73        while ((n = *pathspec++)) {
  74                size_t i, len = 0;
  75                for (i = 0; first == n || i < max; i++) {
  76                        char c = n[i];
  77                        if (!c || c != first[i] || is_glob_special(c))
  78                                break;
  79                        if (c == '/')
  80                                len = i + 1;
  81                }
  82                if (first == n || len < max) {
  83                        max = len;
  84                        if (!max)
  85                                break;
  86                }
  87        }
  88        return max;
  89}
  90
  91/*
  92 * Returns a copy of the longest leading path common among all
  93 * pathspecs.
  94 */
  95char *common_prefix(const char **pathspec)
  96{
  97        unsigned long len = common_prefix_len(pathspec);
  98
  99        return len ? xmemdupz(*pathspec, len) : NULL;
 100}
 101
 102int fill_directory(struct dir_struct *dir, const char **pathspec)
 103{
 104        size_t len;
 105
 106        /*
 107         * Calculate common prefix for the pathspec, and
 108         * use that to optimize the directory walk
 109         */
 110        len = common_prefix_len(pathspec);
 111
 112        /* Read the directory and prune it */
 113        read_directory(dir, pathspec ? *pathspec : "", len, pathspec);
 114        return len;
 115}
 116
 117int within_depth(const char *name, int namelen,
 118                        int depth, int max_depth)
 119{
 120        const char *cp = name, *cpe = name + namelen;
 121
 122        while (cp < cpe) {
 123                if (*cp++ != '/')
 124                        continue;
 125                depth++;
 126                if (depth > max_depth)
 127                        return 0;
 128        }
 129        return 1;
 130}
 131
 132/*
 133 * Does 'match' match the given name?
 134 * A match is found if
 135 *
 136 * (1) the 'match' string is leading directory of 'name', or
 137 * (2) the 'match' string is a wildcard and matches 'name', or
 138 * (3) the 'match' string is exactly the same as 'name'.
 139 *
 140 * and the return value tells which case it was.
 141 *
 142 * It returns 0 when there is no match.
 143 */
 144static int match_one(const char *match, const char *name, int namelen)
 145{
 146        int matchlen;
 147
 148        /* If the match was just the prefix, we matched */
 149        if (!*match)
 150                return MATCHED_RECURSIVELY;
 151
 152        if (ignore_case) {
 153                for (;;) {
 154                        unsigned char c1 = tolower(*match);
 155                        unsigned char c2 = tolower(*name);
 156                        if (c1 == '\0' || is_glob_special(c1))
 157                                break;
 158                        if (c1 != c2)
 159                                return 0;
 160                        match++;
 161                        name++;
 162                        namelen--;
 163                }
 164        } else {
 165                for (;;) {
 166                        unsigned char c1 = *match;
 167                        unsigned char c2 = *name;
 168                        if (c1 == '\0' || is_glob_special(c1))
 169                                break;
 170                        if (c1 != c2)
 171                                return 0;
 172                        match++;
 173                        name++;
 174                        namelen--;
 175                }
 176        }
 177
 178
 179        /*
 180         * If we don't match the matchstring exactly,
 181         * we need to match by fnmatch
 182         */
 183        matchlen = strlen(match);
 184        if (strncmp_icase(match, name, matchlen))
 185                return !fnmatch_icase(match, name, 0) ? MATCHED_FNMATCH : 0;
 186
 187        if (namelen == matchlen)
 188                return MATCHED_EXACTLY;
 189        if (match[matchlen-1] == '/' || name[matchlen] == '/')
 190                return MATCHED_RECURSIVELY;
 191        return 0;
 192}
 193
 194/*
 195 * Given a name and a list of pathspecs, see if the name matches
 196 * any of the pathspecs.  The caller is also interested in seeing
 197 * all pathspec matches some names it calls this function with
 198 * (otherwise the user could have mistyped the unmatched pathspec),
 199 * and a mark is left in seen[] array for pathspec element that
 200 * actually matched anything.
 201 */
 202int match_pathspec(const char **pathspec, const char *name, int namelen,
 203                int prefix, char *seen)
 204{
 205        int i, retval = 0;
 206
 207        if (!pathspec)
 208                return 1;
 209
 210        name += prefix;
 211        namelen -= prefix;
 212
 213        for (i = 0; pathspec[i] != NULL; i++) {
 214                int how;
 215                const char *match = pathspec[i] + prefix;
 216                if (seen && seen[i] == MATCHED_EXACTLY)
 217                        continue;
 218                how = match_one(match, name, namelen);
 219                if (how) {
 220                        if (retval < how)
 221                                retval = how;
 222                        if (seen && seen[i] < how)
 223                                seen[i] = how;
 224                }
 225        }
 226        return retval;
 227}
 228
 229/*
 230 * Does 'match' match the given name?
 231 * A match is found if
 232 *
 233 * (1) the 'match' string is leading directory of 'name', or
 234 * (2) the 'match' string is a wildcard and matches 'name', or
 235 * (3) the 'match' string is exactly the same as 'name'.
 236 *
 237 * and the return value tells which case it was.
 238 *
 239 * It returns 0 when there is no match.
 240 */
 241static int match_pathspec_item(const struct pathspec_item *item, int prefix,
 242                               const char *name, int namelen)
 243{
 244        /* name/namelen has prefix cut off by caller */
 245        const char *match = item->match + prefix;
 246        int matchlen = item->len - prefix;
 247
 248        /* If the match was just the prefix, we matched */
 249        if (!*match)
 250                return MATCHED_RECURSIVELY;
 251
 252        if (matchlen <= namelen && !strncmp(match, name, matchlen)) {
 253                if (matchlen == namelen)
 254                        return MATCHED_EXACTLY;
 255
 256                if (match[matchlen-1] == '/' || name[matchlen] == '/')
 257                        return MATCHED_RECURSIVELY;
 258        }
 259
 260        if (item->use_wildcard && !fnmatch(match, name, 0))
 261                return MATCHED_FNMATCH;
 262
 263        return 0;
 264}
 265
 266/*
 267 * Given a name and a list of pathspecs, see if the name matches
 268 * any of the pathspecs.  The caller is also interested in seeing
 269 * all pathspec matches some names it calls this function with
 270 * (otherwise the user could have mistyped the unmatched pathspec),
 271 * and a mark is left in seen[] array for pathspec element that
 272 * actually matched anything.
 273 */
 274int match_pathspec_depth(const struct pathspec *ps,
 275                         const char *name, int namelen,
 276                         int prefix, char *seen)
 277{
 278        int i, retval = 0;
 279
 280        if (!ps->nr) {
 281                if (!ps->recursive || ps->max_depth == -1)
 282                        return MATCHED_RECURSIVELY;
 283
 284                if (within_depth(name, namelen, 0, ps->max_depth))
 285                        return MATCHED_EXACTLY;
 286                else
 287                        return 0;
 288        }
 289
 290        name += prefix;
 291        namelen -= prefix;
 292
 293        for (i = ps->nr - 1; i >= 0; i--) {
 294                int how;
 295                if (seen && seen[i] == MATCHED_EXACTLY)
 296                        continue;
 297                how = match_pathspec_item(ps->items+i, prefix, name, namelen);
 298                if (ps->recursive && ps->max_depth != -1 &&
 299                    how && how != MATCHED_FNMATCH) {
 300                        int len = ps->items[i].len;
 301                        if (name[len] == '/')
 302                                len++;
 303                        if (within_depth(name+len, namelen-len, 0, ps->max_depth))
 304                                how = MATCHED_EXACTLY;
 305                        else
 306                                how = 0;
 307                }
 308                if (how) {
 309                        if (retval < how)
 310                                retval = how;
 311                        if (seen && seen[i] < how)
 312                                seen[i] = how;
 313                }
 314        }
 315        return retval;
 316}
 317
 318/*
 319 * Return the length of the "simple" part of a path match limiter.
 320 */
 321static int simple_length(const char *match)
 322{
 323        int len = -1;
 324
 325        for (;;) {
 326                unsigned char c = *match++;
 327                len++;
 328                if (c == '\0' || is_glob_special(c))
 329                        return len;
 330        }
 331}
 332
 333static int no_wildcard(const char *string)
 334{
 335        return string[simple_length(string)] == '\0';
 336}
 337
 338void parse_exclude_pattern(const char **pattern,
 339                           int *patternlen,
 340                           int *flags,
 341                           int *nowildcardlen)
 342{
 343        const char *p = *pattern;
 344        size_t i, len;
 345
 346        *flags = 0;
 347        if (*p == '!') {
 348                *flags |= EXC_FLAG_NEGATIVE;
 349                p++;
 350        }
 351        len = strlen(p);
 352        if (len && p[len - 1] == '/') {
 353                len--;
 354                *flags |= EXC_FLAG_MUSTBEDIR;
 355        }
 356        for (i = 0; i < len; i++) {
 357                if (p[i] == '/')
 358                        break;
 359        }
 360        if (i == len)
 361                *flags |= EXC_FLAG_NODIR;
 362        *nowildcardlen = simple_length(p);
 363        /*
 364         * we should have excluded the trailing slash from 'p' too,
 365         * but that's one more allocation. Instead just make sure
 366         * nowildcardlen does not exceed real patternlen
 367         */
 368        if (*nowildcardlen > len)
 369                *nowildcardlen = len;
 370        if (*p == '*' && no_wildcard(p + 1))
 371                *flags |= EXC_FLAG_ENDSWITH;
 372        *pattern = p;
 373        *patternlen = len;
 374}
 375
 376void add_exclude(const char *string, const char *base,
 377                 int baselen, struct exclude_list *which)
 378{
 379        struct exclude *x;
 380        int patternlen;
 381        int flags;
 382        int nowildcardlen;
 383
 384        parse_exclude_pattern(&string, &patternlen, &flags, &nowildcardlen);
 385        if (flags & EXC_FLAG_MUSTBEDIR) {
 386                char *s;
 387                x = xmalloc(sizeof(*x) + patternlen + 1);
 388                s = (char *)(x+1);
 389                memcpy(s, string, patternlen);
 390                s[patternlen] = '\0';
 391                x->pattern = s;
 392        } else {
 393                x = xmalloc(sizeof(*x));
 394                x->pattern = string;
 395        }
 396        x->patternlen = patternlen;
 397        x->nowildcardlen = nowildcardlen;
 398        x->base = base;
 399        x->baselen = baselen;
 400        x->flags = flags;
 401        ALLOC_GROW(which->excludes, which->nr + 1, which->alloc);
 402        which->excludes[which->nr++] = x;
 403}
 404
 405static void *read_skip_worktree_file_from_index(const char *path, size_t *size)
 406{
 407        int pos, len;
 408        unsigned long sz;
 409        enum object_type type;
 410        void *data;
 411        struct index_state *istate = &the_index;
 412
 413        len = strlen(path);
 414        pos = index_name_pos(istate, path, len);
 415        if (pos < 0)
 416                return NULL;
 417        if (!ce_skip_worktree(istate->cache[pos]))
 418                return NULL;
 419        data = read_sha1_file(istate->cache[pos]->sha1, &type, &sz);
 420        if (!data || type != OBJ_BLOB) {
 421                free(data);
 422                return NULL;
 423        }
 424        *size = xsize_t(sz);
 425        return data;
 426}
 427
 428void free_excludes(struct exclude_list *el)
 429{
 430        int i;
 431
 432        for (i = 0; i < el->nr; i++)
 433                free(el->excludes[i]);
 434        free(el->excludes);
 435
 436        el->nr = 0;
 437        el->excludes = NULL;
 438}
 439
 440int add_excludes_from_file_to_list(const char *fname,
 441                                   const char *base,
 442                                   int baselen,
 443                                   char **buf_p,
 444                                   struct exclude_list *which,
 445                                   int check_index)
 446{
 447        struct stat st;
 448        int fd, i;
 449        size_t size = 0;
 450        char *buf, *entry;
 451
 452        fd = open(fname, O_RDONLY);
 453        if (fd < 0 || fstat(fd, &st) < 0) {
 454                if (errno != ENOENT)
 455                        warn_on_inaccessible(fname);
 456                if (0 <= fd)
 457                        close(fd);
 458                if (!check_index ||
 459                    (buf = read_skip_worktree_file_from_index(fname, &size)) == NULL)
 460                        return -1;
 461                if (size == 0) {
 462                        free(buf);
 463                        return 0;
 464                }
 465                if (buf[size-1] != '\n') {
 466                        buf = xrealloc(buf, size+1);
 467                        buf[size++] = '\n';
 468                }
 469        }
 470        else {
 471                size = xsize_t(st.st_size);
 472                if (size == 0) {
 473                        close(fd);
 474                        return 0;
 475                }
 476                buf = xmalloc(size+1);
 477                if (read_in_full(fd, buf, size) != size) {
 478                        free(buf);
 479                        close(fd);
 480                        return -1;
 481                }
 482                buf[size++] = '\n';
 483                close(fd);
 484        }
 485
 486        if (buf_p)
 487                *buf_p = buf;
 488        entry = buf;
 489        for (i = 0; i < size; i++) {
 490                if (buf[i] == '\n') {
 491                        if (entry != buf + i && entry[0] != '#') {
 492                                buf[i - (i && buf[i-1] == '\r')] = 0;
 493                                add_exclude(entry, base, baselen, which);
 494                        }
 495                        entry = buf + i + 1;
 496                }
 497        }
 498        return 0;
 499}
 500
 501void add_excludes_from_file(struct dir_struct *dir, const char *fname)
 502{
 503        if (add_excludes_from_file_to_list(fname, "", 0, NULL,
 504                                           &dir->exclude_list[EXC_FILE], 0) < 0)
 505                die("cannot use %s as an exclude file", fname);
 506}
 507
 508static void prep_exclude(struct dir_struct *dir, const char *base, int baselen)
 509{
 510        struct exclude_list *el;
 511        struct exclude_stack *stk = NULL;
 512        int current;
 513
 514        if ((!dir->exclude_per_dir) ||
 515            (baselen + strlen(dir->exclude_per_dir) >= PATH_MAX))
 516                return; /* too long a path -- ignore */
 517
 518        /* Pop the ones that are not the prefix of the path being checked. */
 519        el = &dir->exclude_list[EXC_DIRS];
 520        while ((stk = dir->exclude_stack) != NULL) {
 521                if (stk->baselen <= baselen &&
 522                    !strncmp(dir->basebuf, base, stk->baselen))
 523                        break;
 524                dir->exclude_stack = stk->prev;
 525                while (stk->exclude_ix < el->nr)
 526                        free(el->excludes[--el->nr]);
 527                free(stk->filebuf);
 528                free(stk);
 529        }
 530
 531        /* Read from the parent directories and push them down. */
 532        current = stk ? stk->baselen : -1;
 533        while (current < baselen) {
 534                struct exclude_stack *stk = xcalloc(1, sizeof(*stk));
 535                const char *cp;
 536
 537                if (current < 0) {
 538                        cp = base;
 539                        current = 0;
 540                }
 541                else {
 542                        cp = strchr(base + current + 1, '/');
 543                        if (!cp)
 544                                die("oops in prep_exclude");
 545                        cp++;
 546                }
 547                stk->prev = dir->exclude_stack;
 548                stk->baselen = cp - base;
 549                stk->exclude_ix = el->nr;
 550                memcpy(dir->basebuf + current, base + current,
 551                       stk->baselen - current);
 552                strcpy(dir->basebuf + stk->baselen, dir->exclude_per_dir);
 553                add_excludes_from_file_to_list(dir->basebuf,
 554                                               dir->basebuf, stk->baselen,
 555                                               &stk->filebuf, el, 1);
 556                dir->exclude_stack = stk;
 557                current = stk->baselen;
 558        }
 559        dir->basebuf[baselen] = '\0';
 560}
 561
 562int match_basename(const char *basename, int basenamelen,
 563                   const char *pattern, int prefix, int patternlen,
 564                   int flags)
 565{
 566        if (prefix == patternlen) {
 567                if (patternlen == basenamelen &&
 568                    !strncmp_icase(pattern, basename, basenamelen))
 569                        return 1;
 570        } else if (flags & EXC_FLAG_ENDSWITH) {
 571                /* "*literal" matching against "fooliteral" */
 572                if (patternlen - 1 <= basenamelen &&
 573                    !strncmp_icase(pattern + 1,
 574                                   basename + basenamelen - (patternlen - 1),
 575                                   patternlen - 1))
 576                        return 1;
 577        } else {
 578                if (fnmatch_icase_mem(pattern, patternlen,
 579                                      basename, basenamelen,
 580                                      0) == 0)
 581                        return 1;
 582        }
 583        return 0;
 584}
 585
 586int match_pathname(const char *pathname, int pathlen,
 587                   const char *base, int baselen,
 588                   const char *pattern, int prefix, int patternlen,
 589                   int flags)
 590{
 591        const char *name;
 592        int namelen;
 593
 594        /*
 595         * match with FNM_PATHNAME; the pattern has base implicitly
 596         * in front of it.
 597         */
 598        if (*pattern == '/') {
 599                pattern++;
 600                prefix--;
 601        }
 602
 603        /*
 604         * baselen does not count the trailing slash. base[] may or
 605         * may not end with a trailing slash though.
 606         */
 607        if (pathlen < baselen + 1 ||
 608            (baselen && pathname[baselen] != '/') ||
 609            strncmp_icase(pathname, base, baselen))
 610                return 0;
 611
 612        namelen = baselen ? pathlen - baselen - 1 : pathlen;
 613        name = pathname + pathlen - namelen;
 614
 615        if (prefix) {
 616                /*
 617                 * if the non-wildcard part is longer than the
 618                 * remaining pathname, surely it cannot match.
 619                 */
 620                if (prefix > namelen)
 621                        return 0;
 622
 623                if (strncmp_icase(pattern, name, prefix))
 624                        return 0;
 625                pattern += prefix;
 626                name    += prefix;
 627                namelen -= prefix;
 628        }
 629
 630        return fnmatch_icase(pattern, name, FNM_PATHNAME) == 0;
 631}
 632
 633/* Scan the list and let the last match determine the fate.
 634 * Return 1 for exclude, 0 for include and -1 for undecided.
 635 */
 636int excluded_from_list(const char *pathname,
 637                       int pathlen, const char *basename, int *dtype,
 638                       struct exclude_list *el)
 639{
 640        int i;
 641
 642        if (!el->nr)
 643                return -1;      /* undefined */
 644
 645        for (i = el->nr - 1; 0 <= i; i--) {
 646                struct exclude *x = el->excludes[i];
 647                const char *exclude = x->pattern;
 648                int to_exclude = x->flags & EXC_FLAG_NEGATIVE ? 0 : 1;
 649                int prefix = x->nowildcardlen;
 650
 651                if (x->flags & EXC_FLAG_MUSTBEDIR) {
 652                        if (*dtype == DT_UNKNOWN)
 653                                *dtype = get_dtype(NULL, pathname, pathlen);
 654                        if (*dtype != DT_DIR)
 655                                continue;
 656                }
 657
 658                if (x->flags & EXC_FLAG_NODIR) {
 659                        if (match_basename(basename,
 660                                           pathlen - (basename - pathname),
 661                                           exclude, prefix, x->patternlen,
 662                                           x->flags))
 663                                return to_exclude;
 664                        continue;
 665                }
 666
 667                assert(x->baselen == 0 || x->base[x->baselen - 1] == '/');
 668                if (match_pathname(pathname, pathlen,
 669                                   x->base, x->baselen ? x->baselen - 1 : 0,
 670                                   exclude, prefix, x->patternlen, x->flags))
 671                        return to_exclude;
 672        }
 673        return -1; /* undecided */
 674}
 675
 676static int excluded(struct dir_struct *dir, const char *pathname, int *dtype_p)
 677{
 678        int pathlen = strlen(pathname);
 679        int st;
 680        const char *basename = strrchr(pathname, '/');
 681        basename = (basename) ? basename+1 : pathname;
 682
 683        prep_exclude(dir, pathname, basename-pathname);
 684        for (st = EXC_CMDL; st <= EXC_FILE; st++) {
 685                switch (excluded_from_list(pathname, pathlen, basename,
 686                                           dtype_p, &dir->exclude_list[st])) {
 687                case 0:
 688                        return 0;
 689                case 1:
 690                        return 1;
 691                }
 692        }
 693        return 0;
 694}
 695
 696void path_exclude_check_init(struct path_exclude_check *check,
 697                             struct dir_struct *dir)
 698{
 699        check->dir = dir;
 700        strbuf_init(&check->path, 256);
 701}
 702
 703void path_exclude_check_clear(struct path_exclude_check *check)
 704{
 705        strbuf_release(&check->path);
 706}
 707
 708/*
 709 * Is this name excluded?  This is for a caller like show_files() that
 710 * do not honor directory hierarchy and iterate through paths that are
 711 * possibly in an ignored directory.
 712 *
 713 * A path to a directory known to be excluded is left in check->path to
 714 * optimize for repeated checks for files in the same excluded directory.
 715 */
 716int path_excluded(struct path_exclude_check *check,
 717                  const char *name, int namelen, int *dtype)
 718{
 719        int i;
 720        struct strbuf *path = &check->path;
 721
 722        /*
 723         * we allow the caller to pass namelen as an optimization; it
 724         * must match the length of the name, as we eventually call
 725         * excluded() on the whole name string.
 726         */
 727        if (namelen < 0)
 728                namelen = strlen(name);
 729
 730        if (path->len &&
 731            path->len <= namelen &&
 732            !memcmp(name, path->buf, path->len) &&
 733            (!name[path->len] || name[path->len] == '/'))
 734                return 1;
 735
 736        strbuf_setlen(path, 0);
 737        for (i = 0; name[i]; i++) {
 738                int ch = name[i];
 739
 740                if (ch == '/') {
 741                        int dt = DT_DIR;
 742                        if (excluded(check->dir, path->buf, &dt))
 743                                return 1;
 744                }
 745                strbuf_addch(path, ch);
 746        }
 747
 748        /* An entry in the index; cannot be a directory with subentries */
 749        strbuf_setlen(path, 0);
 750
 751        return excluded(check->dir, name, dtype);
 752}
 753
 754static struct dir_entry *dir_entry_new(const char *pathname, int len)
 755{
 756        struct dir_entry *ent;
 757
 758        ent = xmalloc(sizeof(*ent) + len + 1);
 759        ent->len = len;
 760        memcpy(ent->name, pathname, len);
 761        ent->name[len] = 0;
 762        return ent;
 763}
 764
 765static struct dir_entry *dir_add_name(struct dir_struct *dir, const char *pathname, int len)
 766{
 767        if (cache_name_exists(pathname, len, ignore_case))
 768                return NULL;
 769
 770        ALLOC_GROW(dir->entries, dir->nr+1, dir->alloc);
 771        return dir->entries[dir->nr++] = dir_entry_new(pathname, len);
 772}
 773
 774struct dir_entry *dir_add_ignored(struct dir_struct *dir, const char *pathname, int len)
 775{
 776        if (!cache_name_is_other(pathname, len))
 777                return NULL;
 778
 779        ALLOC_GROW(dir->ignored, dir->ignored_nr+1, dir->ignored_alloc);
 780        return dir->ignored[dir->ignored_nr++] = dir_entry_new(pathname, len);
 781}
 782
 783enum exist_status {
 784        index_nonexistent = 0,
 785        index_directory,
 786        index_gitdir
 787};
 788
 789/*
 790 * Do not use the alphabetically stored index to look up
 791 * the directory name; instead, use the case insensitive
 792 * name hash.
 793 */
 794static enum exist_status directory_exists_in_index_icase(const char *dirname, int len)
 795{
 796        struct cache_entry *ce = index_name_exists(&the_index, dirname, len + 1, ignore_case);
 797        unsigned char endchar;
 798
 799        if (!ce)
 800                return index_nonexistent;
 801        endchar = ce->name[len];
 802
 803        /*
 804         * The cache_entry structure returned will contain this dirname
 805         * and possibly additional path components.
 806         */
 807        if (endchar == '/')
 808                return index_directory;
 809
 810        /*
 811         * If there are no additional path components, then this cache_entry
 812         * represents a submodule.  Submodules, despite being directories,
 813         * are stored in the cache without a closing slash.
 814         */
 815        if (!endchar && S_ISGITLINK(ce->ce_mode))
 816                return index_gitdir;
 817
 818        /* This should never be hit, but it exists just in case. */
 819        return index_nonexistent;
 820}
 821
 822/*
 823 * The index sorts alphabetically by entry name, which
 824 * means that a gitlink sorts as '\0' at the end, while
 825 * a directory (which is defined not as an entry, but as
 826 * the files it contains) will sort with the '/' at the
 827 * end.
 828 */
 829static enum exist_status directory_exists_in_index(const char *dirname, int len)
 830{
 831        int pos;
 832
 833        if (ignore_case)
 834                return directory_exists_in_index_icase(dirname, len);
 835
 836        pos = cache_name_pos(dirname, len);
 837        if (pos < 0)
 838                pos = -pos-1;
 839        while (pos < active_nr) {
 840                struct cache_entry *ce = active_cache[pos++];
 841                unsigned char endchar;
 842
 843                if (strncmp(ce->name, dirname, len))
 844                        break;
 845                endchar = ce->name[len];
 846                if (endchar > '/')
 847                        break;
 848                if (endchar == '/')
 849                        return index_directory;
 850                if (!endchar && S_ISGITLINK(ce->ce_mode))
 851                        return index_gitdir;
 852        }
 853        return index_nonexistent;
 854}
 855
 856/*
 857 * When we find a directory when traversing the filesystem, we
 858 * have three distinct cases:
 859 *
 860 *  - ignore it
 861 *  - see it as a directory
 862 *  - recurse into it
 863 *
 864 * and which one we choose depends on a combination of existing
 865 * git index contents and the flags passed into the directory
 866 * traversal routine.
 867 *
 868 * Case 1: If we *already* have entries in the index under that
 869 * directory name, we always recurse into the directory to see
 870 * all the files.
 871 *
 872 * Case 2: If we *already* have that directory name as a gitlink,
 873 * we always continue to see it as a gitlink, regardless of whether
 874 * there is an actual git directory there or not (it might not
 875 * be checked out as a subproject!)
 876 *
 877 * Case 3: if we didn't have it in the index previously, we
 878 * have a few sub-cases:
 879 *
 880 *  (a) if "show_other_directories" is true, we show it as
 881 *      just a directory, unless "hide_empty_directories" is
 882 *      also true and the directory is empty, in which case
 883 *      we just ignore it entirely.
 884 *  (b) if it looks like a git directory, and we don't have
 885 *      'no_gitlinks' set we treat it as a gitlink, and show it
 886 *      as a directory.
 887 *  (c) otherwise, we recurse into it.
 888 */
 889enum directory_treatment {
 890        show_directory,
 891        ignore_directory,
 892        recurse_into_directory
 893};
 894
 895static enum directory_treatment treat_directory(struct dir_struct *dir,
 896        const char *dirname, int len,
 897        const struct path_simplify *simplify)
 898{
 899        /* The "len-1" is to strip the final '/' */
 900        switch (directory_exists_in_index(dirname, len-1)) {
 901        case index_directory:
 902                return recurse_into_directory;
 903
 904        case index_gitdir:
 905                if (dir->flags & DIR_SHOW_OTHER_DIRECTORIES)
 906                        return ignore_directory;
 907                return show_directory;
 908
 909        case index_nonexistent:
 910                if (dir->flags & DIR_SHOW_OTHER_DIRECTORIES)
 911                        break;
 912                if (!(dir->flags & DIR_NO_GITLINKS)) {
 913                        unsigned char sha1[20];
 914                        if (resolve_gitlink_ref(dirname, "HEAD", sha1) == 0)
 915                                return show_directory;
 916                }
 917                return recurse_into_directory;
 918        }
 919
 920        /* This is the "show_other_directories" case */
 921        if (!(dir->flags & DIR_HIDE_EMPTY_DIRECTORIES))
 922                return show_directory;
 923        if (!read_directory_recursive(dir, dirname, len, 1, simplify))
 924                return ignore_directory;
 925        return show_directory;
 926}
 927
 928/*
 929 * This is an inexact early pruning of any recursive directory
 930 * reading - if the path cannot possibly be in the pathspec,
 931 * return true, and we'll skip it early.
 932 */
 933static int simplify_away(const char *path, int pathlen, const struct path_simplify *simplify)
 934{
 935        if (simplify) {
 936                for (;;) {
 937                        const char *match = simplify->path;
 938                        int len = simplify->len;
 939
 940                        if (!match)
 941                                break;
 942                        if (len > pathlen)
 943                                len = pathlen;
 944                        if (!memcmp(path, match, len))
 945                                return 0;
 946                        simplify++;
 947                }
 948                return 1;
 949        }
 950        return 0;
 951}
 952
 953/*
 954 * This function tells us whether an excluded path matches a
 955 * list of "interesting" pathspecs. That is, whether a path matched
 956 * by any of the pathspecs could possibly be ignored by excluding
 957 * the specified path. This can happen if:
 958 *
 959 *   1. the path is mentioned explicitly in the pathspec
 960 *
 961 *   2. the path is a directory prefix of some element in the
 962 *      pathspec
 963 */
 964static int exclude_matches_pathspec(const char *path, int len,
 965                const struct path_simplify *simplify)
 966{
 967        if (simplify) {
 968                for (; simplify->path; simplify++) {
 969                        if (len == simplify->len
 970                            && !memcmp(path, simplify->path, len))
 971                                return 1;
 972                        if (len < simplify->len
 973                            && simplify->path[len] == '/'
 974                            && !memcmp(path, simplify->path, len))
 975                                return 1;
 976                }
 977        }
 978        return 0;
 979}
 980
 981static int get_index_dtype(const char *path, int len)
 982{
 983        int pos;
 984        struct cache_entry *ce;
 985
 986        ce = cache_name_exists(path, len, 0);
 987        if (ce) {
 988                if (!ce_uptodate(ce))
 989                        return DT_UNKNOWN;
 990                if (S_ISGITLINK(ce->ce_mode))
 991                        return DT_DIR;
 992                /*
 993                 * Nobody actually cares about the
 994                 * difference between DT_LNK and DT_REG
 995                 */
 996                return DT_REG;
 997        }
 998
 999        /* Try to look it up as a directory */
1000        pos = cache_name_pos(path, len);
1001        if (pos >= 0)
1002                return DT_UNKNOWN;
1003        pos = -pos-1;
1004        while (pos < active_nr) {
1005                ce = active_cache[pos++];
1006                if (strncmp(ce->name, path, len))
1007                        break;
1008                if (ce->name[len] > '/')
1009                        break;
1010                if (ce->name[len] < '/')
1011                        continue;
1012                if (!ce_uptodate(ce))
1013                        break;  /* continue? */
1014                return DT_DIR;
1015        }
1016        return DT_UNKNOWN;
1017}
1018
1019static int get_dtype(struct dirent *de, const char *path, int len)
1020{
1021        int dtype = de ? DTYPE(de) : DT_UNKNOWN;
1022        struct stat st;
1023
1024        if (dtype != DT_UNKNOWN)
1025                return dtype;
1026        dtype = get_index_dtype(path, len);
1027        if (dtype != DT_UNKNOWN)
1028                return dtype;
1029        if (lstat(path, &st))
1030                return dtype;
1031        if (S_ISREG(st.st_mode))
1032                return DT_REG;
1033        if (S_ISDIR(st.st_mode))
1034                return DT_DIR;
1035        if (S_ISLNK(st.st_mode))
1036                return DT_LNK;
1037        return dtype;
1038}
1039
1040enum path_treatment {
1041        path_ignored,
1042        path_handled,
1043        path_recurse
1044};
1045
1046static enum path_treatment treat_one_path(struct dir_struct *dir,
1047                                          struct strbuf *path,
1048                                          const struct path_simplify *simplify,
1049                                          int dtype, struct dirent *de)
1050{
1051        int exclude = excluded(dir, path->buf, &dtype);
1052        if (exclude && (dir->flags & DIR_COLLECT_IGNORED)
1053            && exclude_matches_pathspec(path->buf, path->len, simplify))
1054                dir_add_ignored(dir, path->buf, path->len);
1055
1056        /*
1057         * Excluded? If we don't explicitly want to show
1058         * ignored files, ignore it
1059         */
1060        if (exclude && !(dir->flags & DIR_SHOW_IGNORED))
1061                return path_ignored;
1062
1063        if (dtype == DT_UNKNOWN)
1064                dtype = get_dtype(de, path->buf, path->len);
1065
1066        /*
1067         * Do we want to see just the ignored files?
1068         * We still need to recurse into directories,
1069         * even if we don't ignore them, since the
1070         * directory may contain files that we do..
1071         */
1072        if (!exclude && (dir->flags & DIR_SHOW_IGNORED)) {
1073                if (dtype != DT_DIR)
1074                        return path_ignored;
1075        }
1076
1077        switch (dtype) {
1078        default:
1079                return path_ignored;
1080        case DT_DIR:
1081                strbuf_addch(path, '/');
1082                switch (treat_directory(dir, path->buf, path->len, simplify)) {
1083                case show_directory:
1084                        if (exclude != !!(dir->flags
1085                                          & DIR_SHOW_IGNORED))
1086                                return path_ignored;
1087                        break;
1088                case recurse_into_directory:
1089                        return path_recurse;
1090                case ignore_directory:
1091                        return path_ignored;
1092                }
1093                break;
1094        case DT_REG:
1095        case DT_LNK:
1096                break;
1097        }
1098        return path_handled;
1099}
1100
1101static enum path_treatment treat_path(struct dir_struct *dir,
1102                                      struct dirent *de,
1103                                      struct strbuf *path,
1104                                      int baselen,
1105                                      const struct path_simplify *simplify)
1106{
1107        int dtype;
1108
1109        if (is_dot_or_dotdot(de->d_name) || !strcmp(de->d_name, ".git"))
1110                return path_ignored;
1111        strbuf_setlen(path, baselen);
1112        strbuf_addstr(path, de->d_name);
1113        if (simplify_away(path->buf, path->len, simplify))
1114                return path_ignored;
1115
1116        dtype = DTYPE(de);
1117        return treat_one_path(dir, path, simplify, dtype, de);
1118}
1119
1120/*
1121 * Read a directory tree. We currently ignore anything but
1122 * directories, regular files and symlinks. That's because git
1123 * doesn't handle them at all yet. Maybe that will change some
1124 * day.
1125 *
1126 * Also, we ignore the name ".git" (even if it is not a directory).
1127 * That likely will not change.
1128 */
1129static int read_directory_recursive(struct dir_struct *dir,
1130                                    const char *base, int baselen,
1131                                    int check_only,
1132                                    const struct path_simplify *simplify)
1133{
1134        DIR *fdir;
1135        int contents = 0;
1136        struct dirent *de;
1137        struct strbuf path = STRBUF_INIT;
1138
1139        strbuf_add(&path, base, baselen);
1140
1141        fdir = opendir(path.len ? path.buf : ".");
1142        if (!fdir)
1143                goto out;
1144
1145        while ((de = readdir(fdir)) != NULL) {
1146                switch (treat_path(dir, de, &path, baselen, simplify)) {
1147                case path_recurse:
1148                        contents += read_directory_recursive(dir, path.buf,
1149                                                             path.len, 0,
1150                                                             simplify);
1151                        continue;
1152                case path_ignored:
1153                        continue;
1154                case path_handled:
1155                        break;
1156                }
1157                contents++;
1158                if (check_only)
1159                        break;
1160                dir_add_name(dir, path.buf, path.len);
1161        }
1162        closedir(fdir);
1163 out:
1164        strbuf_release(&path);
1165
1166        return contents;
1167}
1168
1169static int cmp_name(const void *p1, const void *p2)
1170{
1171        const struct dir_entry *e1 = *(const struct dir_entry **)p1;
1172        const struct dir_entry *e2 = *(const struct dir_entry **)p2;
1173
1174        return cache_name_compare(e1->name, e1->len,
1175                                  e2->name, e2->len);
1176}
1177
1178static struct path_simplify *create_simplify(const char **pathspec)
1179{
1180        int nr, alloc = 0;
1181        struct path_simplify *simplify = NULL;
1182
1183        if (!pathspec)
1184                return NULL;
1185
1186        for (nr = 0 ; ; nr++) {
1187                const char *match;
1188                if (nr >= alloc) {
1189                        alloc = alloc_nr(alloc);
1190                        simplify = xrealloc(simplify, alloc * sizeof(*simplify));
1191                }
1192                match = *pathspec++;
1193                if (!match)
1194                        break;
1195                simplify[nr].path = match;
1196                simplify[nr].len = simple_length(match);
1197        }
1198        simplify[nr].path = NULL;
1199        simplify[nr].len = 0;
1200        return simplify;
1201}
1202
1203static void free_simplify(struct path_simplify *simplify)
1204{
1205        free(simplify);
1206}
1207
1208static int treat_leading_path(struct dir_struct *dir,
1209                              const char *path, int len,
1210                              const struct path_simplify *simplify)
1211{
1212        struct strbuf sb = STRBUF_INIT;
1213        int baselen, rc = 0;
1214        const char *cp;
1215
1216        while (len && path[len - 1] == '/')
1217                len--;
1218        if (!len)
1219                return 1;
1220        baselen = 0;
1221        while (1) {
1222                cp = path + baselen + !!baselen;
1223                cp = memchr(cp, '/', path + len - cp);
1224                if (!cp)
1225                        baselen = len;
1226                else
1227                        baselen = cp - path;
1228                strbuf_setlen(&sb, 0);
1229                strbuf_add(&sb, path, baselen);
1230                if (!is_directory(sb.buf))
1231                        break;
1232                if (simplify_away(sb.buf, sb.len, simplify))
1233                        break;
1234                if (treat_one_path(dir, &sb, simplify,
1235                                   DT_DIR, NULL) == path_ignored)
1236                        break; /* do not recurse into it */
1237                if (len <= baselen) {
1238                        rc = 1;
1239                        break; /* finished checking */
1240                }
1241        }
1242        strbuf_release(&sb);
1243        return rc;
1244}
1245
1246int read_directory(struct dir_struct *dir, const char *path, int len, const char **pathspec)
1247{
1248        struct path_simplify *simplify;
1249
1250        if (has_symlink_leading_path(path, len))
1251                return dir->nr;
1252
1253        simplify = create_simplify(pathspec);
1254        if (!len || treat_leading_path(dir, path, len, simplify))
1255                read_directory_recursive(dir, path, len, 0, simplify);
1256        free_simplify(simplify);
1257        qsort(dir->entries, dir->nr, sizeof(struct dir_entry *), cmp_name);
1258        qsort(dir->ignored, dir->ignored_nr, sizeof(struct dir_entry *), cmp_name);
1259        return dir->nr;
1260}
1261
1262int file_exists(const char *f)
1263{
1264        struct stat sb;
1265        return lstat(f, &sb) == 0;
1266}
1267
1268/*
1269 * Given two normalized paths (a trailing slash is ok), if subdir is
1270 * outside dir, return -1.  Otherwise return the offset in subdir that
1271 * can be used as relative path to dir.
1272 */
1273int dir_inside_of(const char *subdir, const char *dir)
1274{
1275        int offset = 0;
1276
1277        assert(dir && subdir && *dir && *subdir);
1278
1279        while (*dir && *subdir && *dir == *subdir) {
1280                dir++;
1281                subdir++;
1282                offset++;
1283        }
1284
1285        /* hel[p]/me vs hel[l]/yeah */
1286        if (*dir && *subdir)
1287                return -1;
1288
1289        if (!*subdir)
1290                return !*dir ? offset : -1; /* same dir */
1291
1292        /* foo/[b]ar vs foo/[] */
1293        if (is_dir_sep(dir[-1]))
1294                return is_dir_sep(subdir[-1]) ? offset : -1;
1295
1296        /* foo[/]bar vs foo[] */
1297        return is_dir_sep(*subdir) ? offset + 1 : -1;
1298}
1299
1300int is_inside_dir(const char *dir)
1301{
1302        char cwd[PATH_MAX];
1303        if (!dir)
1304                return 0;
1305        if (!getcwd(cwd, sizeof(cwd)))
1306                die_errno("can't find the current directory");
1307        return dir_inside_of(cwd, dir) >= 0;
1308}
1309
1310int is_empty_dir(const char *path)
1311{
1312        DIR *dir = opendir(path);
1313        struct dirent *e;
1314        int ret = 1;
1315
1316        if (!dir)
1317                return 0;
1318
1319        while ((e = readdir(dir)) != NULL)
1320                if (!is_dot_or_dotdot(e->d_name)) {
1321                        ret = 0;
1322                        break;
1323                }
1324
1325        closedir(dir);
1326        return ret;
1327}
1328
1329static int remove_dir_recurse(struct strbuf *path, int flag, int *kept_up)
1330{
1331        DIR *dir;
1332        struct dirent *e;
1333        int ret = 0, original_len = path->len, len, kept_down = 0;
1334        int only_empty = (flag & REMOVE_DIR_EMPTY_ONLY);
1335        int keep_toplevel = (flag & REMOVE_DIR_KEEP_TOPLEVEL);
1336        unsigned char submodule_head[20];
1337
1338        if ((flag & REMOVE_DIR_KEEP_NESTED_GIT) &&
1339            !resolve_gitlink_ref(path->buf, "HEAD", submodule_head)) {
1340                /* Do not descend and nuke a nested git work tree. */
1341                if (kept_up)
1342                        *kept_up = 1;
1343                return 0;
1344        }
1345
1346        flag &= ~REMOVE_DIR_KEEP_TOPLEVEL;
1347        dir = opendir(path->buf);
1348        if (!dir) {
1349                /* an empty dir could be removed even if it is unreadble */
1350                if (!keep_toplevel)
1351                        return rmdir(path->buf);
1352                else
1353                        return -1;
1354        }
1355        if (path->buf[original_len - 1] != '/')
1356                strbuf_addch(path, '/');
1357
1358        len = path->len;
1359        while ((e = readdir(dir)) != NULL) {
1360                struct stat st;
1361                if (is_dot_or_dotdot(e->d_name))
1362                        continue;
1363
1364                strbuf_setlen(path, len);
1365                strbuf_addstr(path, e->d_name);
1366                if (lstat(path->buf, &st))
1367                        ; /* fall thru */
1368                else if (S_ISDIR(st.st_mode)) {
1369                        if (!remove_dir_recurse(path, flag, &kept_down))
1370                                continue; /* happy */
1371                } else if (!only_empty && !unlink(path->buf))
1372                        continue; /* happy, too */
1373
1374                /* path too long, stat fails, or non-directory still exists */
1375                ret = -1;
1376                break;
1377        }
1378        closedir(dir);
1379
1380        strbuf_setlen(path, original_len);
1381        if (!ret && !keep_toplevel && !kept_down)
1382                ret = rmdir(path->buf);
1383        else if (kept_up)
1384                /*
1385                 * report the uplevel that it is not an error that we
1386                 * did not rmdir() our directory.
1387                 */
1388                *kept_up = !ret;
1389        return ret;
1390}
1391
1392int remove_dir_recursively(struct strbuf *path, int flag)
1393{
1394        return remove_dir_recurse(path, flag, NULL);
1395}
1396
1397void setup_standard_excludes(struct dir_struct *dir)
1398{
1399        const char *path;
1400        char *xdg_path;
1401
1402        dir->exclude_per_dir = ".gitignore";
1403        path = git_path("info/exclude");
1404        if (!excludes_file) {
1405                home_config_paths(NULL, &xdg_path, "ignore");
1406                excludes_file = xdg_path;
1407        }
1408        if (!access_or_warn(path, R_OK))
1409                add_excludes_from_file(dir, path);
1410        if (excludes_file && !access_or_warn(excludes_file, R_OK))
1411                add_excludes_from_file(dir, excludes_file);
1412}
1413
1414int remove_path(const char *name)
1415{
1416        char *slash;
1417
1418        if (unlink(name) && errno != ENOENT)
1419                return -1;
1420
1421        slash = strrchr(name, '/');
1422        if (slash) {
1423                char *dirs = xstrdup(name);
1424                slash = dirs + (slash - name);
1425                do {
1426                        *slash = '\0';
1427                } while (rmdir(dirs) == 0 && (slash = strrchr(dirs, '/')));
1428                free(dirs);
1429        }
1430        return 0;
1431}
1432
1433static int pathspec_item_cmp(const void *a_, const void *b_)
1434{
1435        struct pathspec_item *a, *b;
1436
1437        a = (struct pathspec_item *)a_;
1438        b = (struct pathspec_item *)b_;
1439        return strcmp(a->match, b->match);
1440}
1441
1442int init_pathspec(struct pathspec *pathspec, const char **paths)
1443{
1444        const char **p = paths;
1445        int i;
1446
1447        memset(pathspec, 0, sizeof(*pathspec));
1448        if (!p)
1449                return 0;
1450        while (*p)
1451                p++;
1452        pathspec->raw = paths;
1453        pathspec->nr = p - paths;
1454        if (!pathspec->nr)
1455                return 0;
1456
1457        pathspec->items = xmalloc(sizeof(struct pathspec_item)*pathspec->nr);
1458        for (i = 0; i < pathspec->nr; i++) {
1459                struct pathspec_item *item = pathspec->items+i;
1460                const char *path = paths[i];
1461
1462                item->match = path;
1463                item->len = strlen(path);
1464                item->use_wildcard = !no_wildcard(path);
1465                if (item->use_wildcard)
1466                        pathspec->has_wildcard = 1;
1467        }
1468
1469        qsort(pathspec->items, pathspec->nr,
1470              sizeof(struct pathspec_item), pathspec_item_cmp);
1471
1472        return 0;
1473}
1474
1475void free_pathspec(struct pathspec *pathspec)
1476{
1477        free(pathspec->items);
1478        pathspec->items = NULL;
1479}