tree-walk.con commit t9138-git-svn-authors-prog.sh fixups (01730a3)
   1#include "cache.h"
   2#include "tree-walk.h"
   3#include "unpack-trees.h"
   4#include "dir.h"
   5#include "tree.h"
   6#include "pathspec.h"
   7
   8static const char *get_mode(const char *str, unsigned int *modep)
   9{
  10        unsigned char c;
  11        unsigned int mode = 0;
  12
  13        if (*str == ' ')
  14                return NULL;
  15
  16        while ((c = *str++) != ' ') {
  17                if (c < '0' || c > '7')
  18                        return NULL;
  19                mode = (mode << 3) + (c - '0');
  20        }
  21        *modep = mode;
  22        return str;
  23}
  24
  25static void decode_tree_entry(struct tree_desc *desc, const char *buf, unsigned long size)
  26{
  27        const char *path;
  28        unsigned int mode, len;
  29
  30        if (size < 24 || buf[size - 21])
  31                die("corrupt tree file");
  32
  33        path = get_mode(buf, &mode);
  34        if (!path || !*path)
  35                die("corrupt tree file");
  36        len = strlen(path) + 1;
  37
  38        /* Initialize the descriptor entry */
  39        desc->entry.path = path;
  40        desc->entry.mode = canon_mode(mode);
  41        desc->entry.sha1 = (const unsigned char *)(path + len);
  42}
  43
  44void init_tree_desc(struct tree_desc *desc, const void *buffer, unsigned long size)
  45{
  46        desc->buffer = buffer;
  47        desc->size = size;
  48        if (size)
  49                decode_tree_entry(desc, buffer, size);
  50}
  51
  52void *fill_tree_descriptor(struct tree_desc *desc, const unsigned char *sha1)
  53{
  54        unsigned long size = 0;
  55        void *buf = NULL;
  56
  57        if (sha1) {
  58                buf = read_object_with_reference(sha1, tree_type, &size, NULL);
  59                if (!buf)
  60                        die("unable to read tree %s", sha1_to_hex(sha1));
  61        }
  62        init_tree_desc(desc, buf, size);
  63        return buf;
  64}
  65
  66static void entry_clear(struct name_entry *a)
  67{
  68        memset(a, 0, sizeof(*a));
  69}
  70
  71static void entry_extract(struct tree_desc *t, struct name_entry *a)
  72{
  73        *a = t->entry;
  74}
  75
  76void update_tree_entry(struct tree_desc *desc)
  77{
  78        const void *buf = desc->buffer;
  79        const unsigned char *end = desc->entry.sha1 + 20;
  80        unsigned long size = desc->size;
  81        unsigned long len = end - (const unsigned char *)buf;
  82
  83        if (size < len)
  84                die("corrupt tree file");
  85        buf = end;
  86        size -= len;
  87        desc->buffer = buf;
  88        desc->size = size;
  89        if (size)
  90                decode_tree_entry(desc, buf, size);
  91}
  92
  93int tree_entry(struct tree_desc *desc, struct name_entry *entry)
  94{
  95        if (!desc->size)
  96                return 0;
  97
  98        *entry = desc->entry;
  99        update_tree_entry(desc);
 100        return 1;
 101}
 102
 103void setup_traverse_info(struct traverse_info *info, const char *base)
 104{
 105        int pathlen = strlen(base);
 106        static struct traverse_info dummy;
 107
 108        memset(info, 0, sizeof(*info));
 109        if (pathlen && base[pathlen-1] == '/')
 110                pathlen--;
 111        info->pathlen = pathlen ? pathlen + 1 : 0;
 112        info->name.path = base;
 113        info->name.sha1 = (void *)(base + pathlen + 1);
 114        if (pathlen)
 115                info->prev = &dummy;
 116}
 117
 118char *make_traverse_path(char *path, const struct traverse_info *info, const struct name_entry *n)
 119{
 120        int len = tree_entry_len(n);
 121        int pathlen = info->pathlen;
 122
 123        path[pathlen + len] = 0;
 124        for (;;) {
 125                memcpy(path + pathlen, n->path, len);
 126                if (!pathlen)
 127                        break;
 128                path[--pathlen] = '/';
 129                n = &info->name;
 130                len = tree_entry_len(n);
 131                info = info->prev;
 132                pathlen -= len;
 133        }
 134        return path;
 135}
 136
 137struct tree_desc_skip {
 138        struct tree_desc_skip *prev;
 139        const void *ptr;
 140};
 141
 142struct tree_desc_x {
 143        struct tree_desc d;
 144        struct tree_desc_skip *skip;
 145};
 146
 147static int name_compare(const char *a, int a_len,
 148                        const char *b, int b_len)
 149{
 150        int len = (a_len < b_len) ? a_len : b_len;
 151        int cmp = memcmp(a, b, len);
 152        if (cmp)
 153                return cmp;
 154        return (a_len - b_len);
 155}
 156
 157static int check_entry_match(const char *a, int a_len, const char *b, int b_len)
 158{
 159        /*
 160         * The caller wants to pick *a* from a tree or nothing.
 161         * We are looking at *b* in a tree.
 162         *
 163         * (0) If a and b are the same name, we are trivially happy.
 164         *
 165         * There are three possibilities where *a* could be hiding
 166         * behind *b*.
 167         *
 168         * (1) *a* == "t",   *b* == "ab"  i.e. *b* sorts earlier than *a* no
 169         *                                matter what.
 170         * (2) *a* == "t",   *b* == "t-2" and "t" is a subtree in the tree;
 171         * (3) *a* == "t-2", *b* == "t"   and "t-2" is a blob in the tree.
 172         *
 173         * Otherwise we know *a* won't appear in the tree without
 174         * scanning further.
 175         */
 176
 177        int cmp = name_compare(a, a_len, b, b_len);
 178
 179        /* Most common case first -- reading sync'd trees */
 180        if (!cmp)
 181                return cmp;
 182
 183        if (0 < cmp) {
 184                /* a comes after b; it does not matter if it is case (3)
 185                if (b_len < a_len && !memcmp(a, b, b_len) && a[b_len] < '/')
 186                        return 1;
 187                */
 188                return 1; /* keep looking */
 189        }
 190
 191        /* b comes after a; are we looking at case (2)? */
 192        if (a_len < b_len && !memcmp(a, b, a_len) && b[a_len] < '/')
 193                return 1; /* keep looking */
 194
 195        return -1; /* a cannot appear in the tree */
 196}
 197
 198/*
 199 * From the extended tree_desc, extract the first name entry, while
 200 * paying attention to the candidate "first" name.  Most importantly,
 201 * when looking for an entry, if there are entries that sorts earlier
 202 * in the tree object representation than that name, skip them and
 203 * process the named entry first.  We will remember that we haven't
 204 * processed the first entry yet, and in the later call skip the
 205 * entry we processed early when update_extended_entry() is called.
 206 *
 207 * E.g. if the underlying tree object has these entries:
 208 *
 209 *    blob    "t-1"
 210 *    blob    "t-2"
 211 *    tree    "t"
 212 *    blob    "t=1"
 213 *
 214 * and the "first" asks for "t", remember that we still need to
 215 * process "t-1" and "t-2" but extract "t".  After processing the
 216 * entry "t" from this call, the caller will let us know by calling
 217 * update_extended_entry() that we can remember "t" has been processed
 218 * already.
 219 */
 220
 221static void extended_entry_extract(struct tree_desc_x *t,
 222                                   struct name_entry *a,
 223                                   const char *first,
 224                                   int first_len)
 225{
 226        const char *path;
 227        int len;
 228        struct tree_desc probe;
 229        struct tree_desc_skip *skip;
 230
 231        /*
 232         * Extract the first entry from the tree_desc, but skip the
 233         * ones that we already returned in earlier rounds.
 234         */
 235        while (1) {
 236                if (!t->d.size) {
 237                        entry_clear(a);
 238                        break; /* not found */
 239                }
 240                entry_extract(&t->d, a);
 241                for (skip = t->skip; skip; skip = skip->prev)
 242                        if (a->path == skip->ptr)
 243                                break; /* found */
 244                if (!skip)
 245                        break;
 246                /* We have processed this entry already. */
 247                update_tree_entry(&t->d);
 248        }
 249
 250        if (!first || !a->path)
 251                return;
 252
 253        /*
 254         * The caller wants "first" from this tree, or nothing.
 255         */
 256        path = a->path;
 257        len = tree_entry_len(a);
 258        switch (check_entry_match(first, first_len, path, len)) {
 259        case -1:
 260                entry_clear(a);
 261        case 0:
 262                return;
 263        default:
 264                break;
 265        }
 266
 267        /*
 268         * We need to look-ahead -- we suspect that a subtree whose
 269         * name is "first" may be hiding behind the current entry "path".
 270         */
 271        probe = t->d;
 272        while (probe.size) {
 273                entry_extract(&probe, a);
 274                path = a->path;
 275                len = tree_entry_len(a);
 276                switch (check_entry_match(first, first_len, path, len)) {
 277                case -1:
 278                        entry_clear(a);
 279                case 0:
 280                        return;
 281                default:
 282                        update_tree_entry(&probe);
 283                        break;
 284                }
 285                /* keep looking */
 286        }
 287        entry_clear(a);
 288}
 289
 290static void update_extended_entry(struct tree_desc_x *t, struct name_entry *a)
 291{
 292        if (t->d.entry.path == a->path) {
 293                update_tree_entry(&t->d);
 294        } else {
 295                /* we have returned this entry early */
 296                struct tree_desc_skip *skip = xmalloc(sizeof(*skip));
 297                skip->ptr = a->path;
 298                skip->prev = t->skip;
 299                t->skip = skip;
 300        }
 301}
 302
 303static void free_extended_entry(struct tree_desc_x *t)
 304{
 305        struct tree_desc_skip *p, *s;
 306
 307        for (s = t->skip; s; s = p) {
 308                p = s->prev;
 309                free(s);
 310        }
 311}
 312
 313static inline int prune_traversal(struct name_entry *e,
 314                                  struct traverse_info *info,
 315                                  struct strbuf *base,
 316                                  int still_interesting)
 317{
 318        if (!info->pathspec || still_interesting == 2)
 319                return 2;
 320        if (still_interesting < 0)
 321                return still_interesting;
 322        return tree_entry_interesting(e, base, 0, info->pathspec);
 323}
 324
 325int traverse_trees(int n, struct tree_desc *t, struct traverse_info *info)
 326{
 327        int error = 0;
 328        struct name_entry *entry = xmalloc(n*sizeof(*entry));
 329        int i;
 330        struct tree_desc_x *tx = xcalloc(n, sizeof(*tx));
 331        struct strbuf base = STRBUF_INIT;
 332        int interesting = 1;
 333
 334        for (i = 0; i < n; i++)
 335                tx[i].d = t[i];
 336
 337        if (info->prev) {
 338                strbuf_grow(&base, info->pathlen);
 339                make_traverse_path(base.buf, info->prev, &info->name);
 340                base.buf[info->pathlen-1] = '/';
 341                strbuf_setlen(&base, info->pathlen);
 342        }
 343        for (;;) {
 344                int trees_used;
 345                unsigned long mask, dirmask;
 346                const char *first = NULL;
 347                int first_len = 0;
 348                struct name_entry *e = NULL;
 349                int len;
 350
 351                for (i = 0; i < n; i++) {
 352                        e = entry + i;
 353                        extended_entry_extract(tx + i, e, NULL, 0);
 354                }
 355
 356                /*
 357                 * A tree may have "t-2" at the current location even
 358                 * though it may have "t" that is a subtree behind it,
 359                 * and another tree may return "t".  We want to grab
 360                 * all "t" from all trees to match in such a case.
 361                 */
 362                for (i = 0; i < n; i++) {
 363                        e = entry + i;
 364                        if (!e->path)
 365                                continue;
 366                        len = tree_entry_len(e);
 367                        if (!first) {
 368                                first = e->path;
 369                                first_len = len;
 370                                continue;
 371                        }
 372                        if (name_compare(e->path, len, first, first_len) < 0) {
 373                                first = e->path;
 374                                first_len = len;
 375                        }
 376                }
 377
 378                if (first) {
 379                        for (i = 0; i < n; i++) {
 380                                e = entry + i;
 381                                extended_entry_extract(tx + i, e, first, first_len);
 382                                /* Cull the ones that are not the earliest */
 383                                if (!e->path)
 384                                        continue;
 385                                len = tree_entry_len(e);
 386                                if (name_compare(e->path, len, first, first_len))
 387                                        entry_clear(e);
 388                        }
 389                }
 390
 391                /* Now we have in entry[i] the earliest name from the trees */
 392                mask = 0;
 393                dirmask = 0;
 394                for (i = 0; i < n; i++) {
 395                        if (!entry[i].path)
 396                                continue;
 397                        mask |= 1ul << i;
 398                        if (S_ISDIR(entry[i].mode))
 399                                dirmask |= 1ul << i;
 400                        e = &entry[i];
 401                }
 402                if (!mask)
 403                        break;
 404                interesting = prune_traversal(e, info, &base, interesting);
 405                if (interesting < 0)
 406                        break;
 407                if (interesting) {
 408                        trees_used = info->fn(n, mask, dirmask, entry, info);
 409                        if (trees_used < 0) {
 410                                error = trees_used;
 411                                if (!info->show_all_errors)
 412                                        break;
 413                        }
 414                        mask &= trees_used;
 415                }
 416                for (i = 0; i < n; i++)
 417                        if (mask & (1ul << i))
 418                                update_extended_entry(tx + i, entry + i);
 419        }
 420        free(entry);
 421        for (i = 0; i < n; i++)
 422                free_extended_entry(tx + i);
 423        free(tx);
 424        strbuf_release(&base);
 425        return error;
 426}
 427
 428static int find_tree_entry(struct tree_desc *t, const char *name, unsigned char *result, unsigned *mode)
 429{
 430        int namelen = strlen(name);
 431        while (t->size) {
 432                const char *entry;
 433                const unsigned char *sha1;
 434                int entrylen, cmp;
 435
 436                sha1 = tree_entry_extract(t, &entry, mode);
 437                entrylen = tree_entry_len(&t->entry);
 438                update_tree_entry(t);
 439                if (entrylen > namelen)
 440                        continue;
 441                cmp = memcmp(name, entry, entrylen);
 442                if (cmp > 0)
 443                        continue;
 444                if (cmp < 0)
 445                        break;
 446                if (entrylen == namelen) {
 447                        hashcpy(result, sha1);
 448                        return 0;
 449                }
 450                if (name[entrylen] != '/')
 451                        continue;
 452                if (!S_ISDIR(*mode))
 453                        break;
 454                if (++entrylen == namelen) {
 455                        hashcpy(result, sha1);
 456                        return 0;
 457                }
 458                return get_tree_entry(sha1, name + entrylen, result, mode);
 459        }
 460        return -1;
 461}
 462
 463int get_tree_entry(const unsigned char *tree_sha1, const char *name, unsigned char *sha1, unsigned *mode)
 464{
 465        int retval;
 466        void *tree;
 467        unsigned long size;
 468        unsigned char root[20];
 469
 470        tree = read_object_with_reference(tree_sha1, tree_type, &size, root);
 471        if (!tree)
 472                return -1;
 473
 474        if (name[0] == '\0') {
 475                hashcpy(sha1, root);
 476                free(tree);
 477                return 0;
 478        }
 479
 480        if (!size) {
 481                retval = -1;
 482        } else {
 483                struct tree_desc t;
 484                init_tree_desc(&t, tree, size);
 485                retval = find_tree_entry(&t, name, sha1, mode);
 486        }
 487        free(tree);
 488        return retval;
 489}
 490
 491static int match_entry(const struct pathspec_item *item,
 492                       const struct name_entry *entry, int pathlen,
 493                       const char *match, int matchlen,
 494                       enum interesting *never_interesting)
 495{
 496        int m = -1; /* signals that we haven't called strncmp() */
 497
 498        if (item->magic & PATHSPEC_ICASE)
 499                /*
 500                 * "Never interesting" trick requires exact
 501                 * matching. We could do something clever with inexact
 502                 * matching, but it's trickier (and not to forget that
 503                 * strcasecmp is locale-dependent, at least in
 504                 * glibc). Just disable it for now. It can't be worse
 505                 * than the wildcard's codepath of '[Tt][Hi][Is][Ss]'
 506                 * pattern.
 507                 */
 508                *never_interesting = entry_not_interesting;
 509        else if (*never_interesting != entry_not_interesting) {
 510                /*
 511                 * We have not seen any match that sorts later
 512                 * than the current path.
 513                 */
 514
 515                /*
 516                 * Does match sort strictly earlier than path
 517                 * with their common parts?
 518                 */
 519                m = strncmp(match, entry->path,
 520                            (matchlen < pathlen) ? matchlen : pathlen);
 521                if (m < 0)
 522                        return 0;
 523
 524                /*
 525                 * If we come here even once, that means there is at
 526                 * least one pathspec that would sort equal to or
 527                 * later than the path we are currently looking at.
 528                 * In other words, if we have never reached this point
 529                 * after iterating all pathspecs, it means all
 530                 * pathspecs are either outside of base, or inside the
 531                 * base but sorts strictly earlier than the current
 532                 * one.  In either case, they will never match the
 533                 * subsequent entries.  In such a case, we initialized
 534                 * the variable to -1 and that is what will be
 535                 * returned, allowing the caller to terminate early.
 536                 */
 537                *never_interesting = entry_not_interesting;
 538        }
 539
 540        if (pathlen > matchlen)
 541                return 0;
 542
 543        if (matchlen > pathlen) {
 544                if (match[pathlen] != '/')
 545                        return 0;
 546                if (!S_ISDIR(entry->mode) && !S_ISGITLINK(entry->mode))
 547                        return 0;
 548        }
 549
 550        if (m == -1)
 551                /*
 552                 * we cheated and did not do strncmp(), so we do
 553                 * that here.
 554                 */
 555                m = ps_strncmp(item, match, entry->path, pathlen);
 556
 557        /*
 558         * If common part matched earlier then it is a hit,
 559         * because we rejected the case where path is not a
 560         * leading directory and is shorter than match.
 561         */
 562        if (!m)
 563                /*
 564                 * match_entry does not check if the prefix part is
 565                 * matched case-sensitively. If the entry is a
 566                 * directory and part of prefix, it'll be rematched
 567                 * eventually by basecmp with special treatment for
 568                 * the prefix.
 569                 */
 570                return 1;
 571
 572        return 0;
 573}
 574
 575/* :(icase)-aware string compare */
 576static int basecmp(const struct pathspec_item *item,
 577                   const char *base, const char *match, int len)
 578{
 579        if (item->magic & PATHSPEC_ICASE) {
 580                int ret, n = len > item->prefix ? item->prefix : len;
 581                ret = strncmp(base, match, n);
 582                if (ret)
 583                        return ret;
 584                base += n;
 585                match += n;
 586                len -= n;
 587        }
 588        return ps_strncmp(item, base, match, len);
 589}
 590
 591static int match_dir_prefix(const struct pathspec_item *item,
 592                            const char *base,
 593                            const char *match, int matchlen)
 594{
 595        if (basecmp(item, base, match, matchlen))
 596                return 0;
 597
 598        /*
 599         * If the base is a subdirectory of a path which
 600         * was specified, all of them are interesting.
 601         */
 602        if (!matchlen ||
 603            base[matchlen] == '/' ||
 604            match[matchlen - 1] == '/')
 605                return 1;
 606
 607        /* Just a random prefix match */
 608        return 0;
 609}
 610
 611/*
 612 * Perform matching on the leading non-wildcard part of
 613 * pathspec. item->nowildcard_len must be greater than zero. Return
 614 * non-zero if base is matched.
 615 */
 616static int match_wildcard_base(const struct pathspec_item *item,
 617                               const char *base, int baselen,
 618                               int *matched)
 619{
 620        const char *match = item->match;
 621        /* the wildcard part is not considered in this function */
 622        int matchlen = item->nowildcard_len;
 623
 624        if (baselen) {
 625                int dirlen;
 626                /*
 627                 * Return early if base is longer than the
 628                 * non-wildcard part but it does not match.
 629                 */
 630                if (baselen >= matchlen) {
 631                        *matched = matchlen;
 632                        return !basecmp(item, base, match, matchlen);
 633                }
 634
 635                dirlen = matchlen;
 636                while (dirlen && match[dirlen - 1] != '/')
 637                        dirlen--;
 638
 639                /*
 640                 * Return early if base is shorter than the
 641                 * non-wildcard part but it does not match. Note that
 642                 * base ends with '/' so we are sure it really matches
 643                 * directory
 644                 */
 645                if (basecmp(item, base, match, baselen))
 646                        return 0;
 647                *matched = baselen;
 648        } else
 649                *matched = 0;
 650        /*
 651         * we could have checked entry against the non-wildcard part
 652         * that is not in base and does similar never_interesting
 653         * optimization as in match_entry. For now just be happy with
 654         * base comparison.
 655         */
 656        return entry_interesting;
 657}
 658
 659/*
 660 * Is a tree entry interesting given the pathspec we have?
 661 *
 662 * Pre-condition: either baselen == base_offset (i.e. empty path)
 663 * or base[baselen-1] == '/' (i.e. with trailing slash).
 664 */
 665static enum interesting do_match(const struct name_entry *entry,
 666                                 struct strbuf *base, int base_offset,
 667                                 const struct pathspec *ps,
 668                                 int exclude)
 669{
 670        int i;
 671        int pathlen, baselen = base->len - base_offset;
 672        enum interesting never_interesting = ps->has_wildcard ?
 673                entry_not_interesting : all_entries_not_interesting;
 674
 675        GUARD_PATHSPEC(ps,
 676                       PATHSPEC_FROMTOP |
 677                       PATHSPEC_MAXDEPTH |
 678                       PATHSPEC_LITERAL |
 679                       PATHSPEC_GLOB |
 680                       PATHSPEC_ICASE |
 681                       PATHSPEC_EXCLUDE);
 682
 683        if (!ps->nr) {
 684                if (!ps->recursive ||
 685                    !(ps->magic & PATHSPEC_MAXDEPTH) ||
 686                    ps->max_depth == -1)
 687                        return all_entries_interesting;
 688                return within_depth(base->buf + base_offset, baselen,
 689                                    !!S_ISDIR(entry->mode),
 690                                    ps->max_depth) ?
 691                        entry_interesting : entry_not_interesting;
 692        }
 693
 694        pathlen = tree_entry_len(entry);
 695
 696        for (i = ps->nr - 1; i >= 0; i--) {
 697                const struct pathspec_item *item = ps->items+i;
 698                const char *match = item->match;
 699                const char *base_str = base->buf + base_offset;
 700                int matchlen = item->len, matched = 0;
 701
 702                if ((!exclude &&   item->magic & PATHSPEC_EXCLUDE) ||
 703                    ( exclude && !(item->magic & PATHSPEC_EXCLUDE)))
 704                        continue;
 705
 706                if (baselen >= matchlen) {
 707                        /* If it doesn't match, move along... */
 708                        if (!match_dir_prefix(item, base_str, match, matchlen))
 709                                goto match_wildcards;
 710
 711                        if (!ps->recursive ||
 712                            !(ps->magic & PATHSPEC_MAXDEPTH) ||
 713                            ps->max_depth == -1)
 714                                return all_entries_interesting;
 715
 716                        return within_depth(base_str + matchlen + 1,
 717                                            baselen - matchlen - 1,
 718                                            !!S_ISDIR(entry->mode),
 719                                            ps->max_depth) ?
 720                                entry_interesting : entry_not_interesting;
 721                }
 722
 723                /* Either there must be no base, or the base must match. */
 724                if (baselen == 0 || !basecmp(item, base_str, match, baselen)) {
 725                        if (match_entry(item, entry, pathlen,
 726                                        match + baselen, matchlen - baselen,
 727                                        &never_interesting))
 728                                return entry_interesting;
 729
 730                        if (item->nowildcard_len < item->len) {
 731                                if (!git_fnmatch(item, match + baselen, entry->path,
 732                                                 item->nowildcard_len - baselen))
 733                                        return entry_interesting;
 734
 735                                /*
 736                                 * Match all directories. We'll try to
 737                                 * match files later on.
 738                                 */
 739                                if (ps->recursive && S_ISDIR(entry->mode))
 740                                        return entry_interesting;
 741                        }
 742
 743                        continue;
 744                }
 745
 746match_wildcards:
 747                if (item->nowildcard_len == item->len)
 748                        continue;
 749
 750                if (item->nowildcard_len &&
 751                    !match_wildcard_base(item, base_str, baselen, &matched))
 752                        continue;
 753
 754                /*
 755                 * Concatenate base and entry->path into one and do
 756                 * fnmatch() on it.
 757                 *
 758                 * While we could avoid concatenation in certain cases
 759                 * [1], which saves a memcpy and potentially a
 760                 * realloc, it turns out not worth it. Measurement on
 761                 * linux-2.6 does not show any clear improvements,
 762                 * partly because of the nowildcard_len optimization
 763                 * in git_fnmatch(). Avoid micro-optimizations here.
 764                 *
 765                 * [1] if match_wildcard_base() says the base
 766                 * directory is already matched, we only need to match
 767                 * the rest, which is shorter so _in theory_ faster.
 768                 */
 769
 770                strbuf_add(base, entry->path, pathlen);
 771
 772                if (!git_fnmatch(item, match, base->buf + base_offset,
 773                                 item->nowildcard_len)) {
 774                        strbuf_setlen(base, base_offset + baselen);
 775                        return entry_interesting;
 776                }
 777                strbuf_setlen(base, base_offset + baselen);
 778
 779                /*
 780                 * Match all directories. We'll try to match files
 781                 * later on.
 782                 * max_depth is ignored but we may consider support it
 783                 * in future, see
 784                 * http://thread.gmane.org/gmane.comp.version-control.git/163757/focus=163840
 785                 */
 786                if (ps->recursive && S_ISDIR(entry->mode))
 787                        return entry_interesting;
 788        }
 789        return never_interesting; /* No matches */
 790}
 791
 792/*
 793 * Is a tree entry interesting given the pathspec we have?
 794 *
 795 * Pre-condition: either baselen == base_offset (i.e. empty path)
 796 * or base[baselen-1] == '/' (i.e. with trailing slash).
 797 */
 798enum interesting tree_entry_interesting(const struct name_entry *entry,
 799                                        struct strbuf *base, int base_offset,
 800                                        const struct pathspec *ps)
 801{
 802        enum interesting positive, negative;
 803        positive = do_match(entry, base, base_offset, ps, 0);
 804
 805        /*
 806         * case | entry | positive | negative | result
 807         * -----+-------+----------+----------+-------
 808         *   1  |  file |   -1     |  -1..2   |  -1
 809         *   2  |  file |    0     |  -1..2   |   0
 810         *   3  |  file |    1     |   -1     |   1
 811         *   4  |  file |    1     |    0     |   1
 812         *   5  |  file |    1     |    1     |   0
 813         *   6  |  file |    1     |    2     |   0
 814         *   7  |  file |    2     |   -1     |   2
 815         *   8  |  file |    2     |    0     |   2
 816         *   9  |  file |    2     |    1     |   0
 817         *  10  |  file |    2     |    2     |  -1
 818         * -----+-------+----------+----------+-------
 819         *  11  |  dir  |   -1     |  -1..2   |  -1
 820         *  12  |  dir  |    0     |  -1..2   |   0
 821         *  13  |  dir  |    1     |   -1     |   1
 822         *  14  |  dir  |    1     |    0     |   1
 823         *  15  |  dir  |    1     |    1     |   1 (*)
 824         *  16  |  dir  |    1     |    2     |   0
 825         *  17  |  dir  |    2     |   -1     |   2
 826         *  18  |  dir  |    2     |    0     |   2
 827         *  19  |  dir  |    2     |    1     |   1 (*)
 828         *  20  |  dir  |    2     |    2     |  -1
 829         *
 830         * (*) An exclude pattern interested in a directory does not
 831         * necessarily mean it will exclude all of the directory. In
 832         * wildcard case, it can't decide until looking at individual
 833         * files inside. So don't write such directories off yet.
 834         */
 835
 836        if (!(ps->magic & PATHSPEC_EXCLUDE) ||
 837            positive <= entry_not_interesting) /* #1, #2, #11, #12 */
 838                return positive;
 839
 840        negative = do_match(entry, base, base_offset, ps, 1);
 841
 842        /* #3, #4, #7, #8, #13, #14, #17, #18 */
 843        if (negative <= entry_not_interesting)
 844                return positive;
 845
 846        /* #15, #19 */
 847        if (S_ISDIR(entry->mode) &&
 848            positive >= entry_interesting &&
 849            negative == entry_interesting)
 850                return entry_interesting;
 851
 852        if ((positive == entry_interesting &&
 853             negative >= entry_interesting) || /* #5, #6, #16 */
 854            (positive == all_entries_interesting &&
 855             negative == entry_interesting)) /* #9 */
 856                return entry_not_interesting;
 857
 858        return all_entries_not_interesting; /* #10, #20 */
 859}