cache-tree.con commit date: add "unix" format (642833d)
   1#include "cache.h"
   2#include "lockfile.h"
   3#include "tree.h"
   4#include "tree-walk.h"
   5#include "cache-tree.h"
   6
   7#ifndef DEBUG
   8#define DEBUG 0
   9#endif
  10
  11struct cache_tree *cache_tree(void)
  12{
  13        struct cache_tree *it = xcalloc(1, sizeof(struct cache_tree));
  14        it->entry_count = -1;
  15        return it;
  16}
  17
  18void cache_tree_free(struct cache_tree **it_p)
  19{
  20        int i;
  21        struct cache_tree *it = *it_p;
  22
  23        if (!it)
  24                return;
  25        for (i = 0; i < it->subtree_nr; i++)
  26                if (it->down[i]) {
  27                        cache_tree_free(&it->down[i]->cache_tree);
  28                        free(it->down[i]);
  29                }
  30        free(it->down);
  31        free(it);
  32        *it_p = NULL;
  33}
  34
  35static int subtree_name_cmp(const char *one, int onelen,
  36                            const char *two, int twolen)
  37{
  38        if (onelen < twolen)
  39                return -1;
  40        if (twolen < onelen)
  41                return 1;
  42        return memcmp(one, two, onelen);
  43}
  44
  45static int subtree_pos(struct cache_tree *it, const char *path, int pathlen)
  46{
  47        struct cache_tree_sub **down = it->down;
  48        int lo, hi;
  49        lo = 0;
  50        hi = it->subtree_nr;
  51        while (lo < hi) {
  52                int mi = (lo + hi) / 2;
  53                struct cache_tree_sub *mdl = down[mi];
  54                int cmp = subtree_name_cmp(path, pathlen,
  55                                           mdl->name, mdl->namelen);
  56                if (!cmp)
  57                        return mi;
  58                if (cmp < 0)
  59                        hi = mi;
  60                else
  61                        lo = mi + 1;
  62        }
  63        return -lo-1;
  64}
  65
  66static struct cache_tree_sub *find_subtree(struct cache_tree *it,
  67                                           const char *path,
  68                                           int pathlen,
  69                                           int create)
  70{
  71        struct cache_tree_sub *down;
  72        int pos = subtree_pos(it, path, pathlen);
  73        if (0 <= pos)
  74                return it->down[pos];
  75        if (!create)
  76                return NULL;
  77
  78        pos = -pos-1;
  79        ALLOC_GROW(it->down, it->subtree_nr + 1, it->subtree_alloc);
  80        it->subtree_nr++;
  81
  82        FLEX_ALLOC_MEM(down, name, path, pathlen);
  83        down->cache_tree = NULL;
  84        down->namelen = pathlen;
  85
  86        if (pos < it->subtree_nr)
  87                memmove(it->down + pos + 1,
  88                        it->down + pos,
  89                        sizeof(down) * (it->subtree_nr - pos - 1));
  90        it->down[pos] = down;
  91        return down;
  92}
  93
  94struct cache_tree_sub *cache_tree_sub(struct cache_tree *it, const char *path)
  95{
  96        int pathlen = strlen(path);
  97        return find_subtree(it, path, pathlen, 1);
  98}
  99
 100static int do_invalidate_path(struct cache_tree *it, const char *path)
 101{
 102        /* a/b/c
 103         * ==> invalidate self
 104         * ==> find "a", have it invalidate "b/c"
 105         * a
 106         * ==> invalidate self
 107         * ==> if "a" exists as a subtree, remove it.
 108         */
 109        const char *slash;
 110        int namelen;
 111        struct cache_tree_sub *down;
 112
 113#if DEBUG
 114        fprintf(stderr, "cache-tree invalidate <%s>\n", path);
 115#endif
 116
 117        if (!it)
 118                return 0;
 119        slash = strchrnul(path, '/');
 120        namelen = slash - path;
 121        it->entry_count = -1;
 122        if (!*slash) {
 123                int pos;
 124                pos = subtree_pos(it, path, namelen);
 125                if (0 <= pos) {
 126                        cache_tree_free(&it->down[pos]->cache_tree);
 127                        free(it->down[pos]);
 128                        /* 0 1 2 3 4 5
 129                         *       ^     ^subtree_nr = 6
 130                         *       pos
 131                         * move 4 and 5 up one place (2 entries)
 132                         * 2 = 6 - 3 - 1 = subtree_nr - pos - 1
 133                         */
 134                        memmove(it->down+pos, it->down+pos+1,
 135                                sizeof(struct cache_tree_sub *) *
 136                                (it->subtree_nr - pos - 1));
 137                        it->subtree_nr--;
 138                }
 139                return 1;
 140        }
 141        down = find_subtree(it, path, namelen, 0);
 142        if (down)
 143                do_invalidate_path(down->cache_tree, slash + 1);
 144        return 1;
 145}
 146
 147void cache_tree_invalidate_path(struct index_state *istate, const char *path)
 148{
 149        if (do_invalidate_path(istate->cache_tree, path))
 150                istate->cache_changed |= CACHE_TREE_CHANGED;
 151}
 152
 153static int verify_cache(struct cache_entry **cache,
 154                        int entries, int flags)
 155{
 156        int i, funny;
 157        int silent = flags & WRITE_TREE_SILENT;
 158
 159        /* Verify that the tree is merged */
 160        funny = 0;
 161        for (i = 0; i < entries; i++) {
 162                const struct cache_entry *ce = cache[i];
 163                if (ce_stage(ce)) {
 164                        if (silent)
 165                                return -1;
 166                        if (10 < ++funny) {
 167                                fprintf(stderr, "...\n");
 168                                break;
 169                        }
 170                        fprintf(stderr, "%s: unmerged (%s)\n",
 171                                ce->name, sha1_to_hex(ce->sha1));
 172                }
 173        }
 174        if (funny)
 175                return -1;
 176
 177        /* Also verify that the cache does not have path and path/file
 178         * at the same time.  At this point we know the cache has only
 179         * stage 0 entries.
 180         */
 181        funny = 0;
 182        for (i = 0; i < entries - 1; i++) {
 183                /* path/file always comes after path because of the way
 184                 * the cache is sorted.  Also path can appear only once,
 185                 * which means conflicting one would immediately follow.
 186                 */
 187                const char *this_name = cache[i]->name;
 188                const char *next_name = cache[i+1]->name;
 189                int this_len = strlen(this_name);
 190                if (this_len < strlen(next_name) &&
 191                    strncmp(this_name, next_name, this_len) == 0 &&
 192                    next_name[this_len] == '/') {
 193                        if (10 < ++funny) {
 194                                fprintf(stderr, "...\n");
 195                                break;
 196                        }
 197                        fprintf(stderr, "You have both %s and %s\n",
 198                                this_name, next_name);
 199                }
 200        }
 201        if (funny)
 202                return -1;
 203        return 0;
 204}
 205
 206static void discard_unused_subtrees(struct cache_tree *it)
 207{
 208        struct cache_tree_sub **down = it->down;
 209        int nr = it->subtree_nr;
 210        int dst, src;
 211        for (dst = src = 0; src < nr; src++) {
 212                struct cache_tree_sub *s = down[src];
 213                if (s->used)
 214                        down[dst++] = s;
 215                else {
 216                        cache_tree_free(&s->cache_tree);
 217                        free(s);
 218                        it->subtree_nr--;
 219                }
 220        }
 221}
 222
 223int cache_tree_fully_valid(struct cache_tree *it)
 224{
 225        int i;
 226        if (!it)
 227                return 0;
 228        if (it->entry_count < 0 || !has_sha1_file(it->sha1))
 229                return 0;
 230        for (i = 0; i < it->subtree_nr; i++) {
 231                if (!cache_tree_fully_valid(it->down[i]->cache_tree))
 232                        return 0;
 233        }
 234        return 1;
 235}
 236
 237static int update_one(struct cache_tree *it,
 238                      struct cache_entry **cache,
 239                      int entries,
 240                      const char *base,
 241                      int baselen,
 242                      int *skip_count,
 243                      int flags)
 244{
 245        struct strbuf buffer;
 246        int missing_ok = flags & WRITE_TREE_MISSING_OK;
 247        int dryrun = flags & WRITE_TREE_DRY_RUN;
 248        int repair = flags & WRITE_TREE_REPAIR;
 249        int to_invalidate = 0;
 250        int i;
 251
 252        assert(!(dryrun && repair));
 253
 254        *skip_count = 0;
 255
 256        if (0 <= it->entry_count && has_sha1_file(it->sha1))
 257                return it->entry_count;
 258
 259        /*
 260         * We first scan for subtrees and update them; we start by
 261         * marking existing subtrees -- the ones that are unmarked
 262         * should not be in the result.
 263         */
 264        for (i = 0; i < it->subtree_nr; i++)
 265                it->down[i]->used = 0;
 266
 267        /*
 268         * Find the subtrees and update them.
 269         */
 270        i = 0;
 271        while (i < entries) {
 272                const struct cache_entry *ce = cache[i];
 273                struct cache_tree_sub *sub;
 274                const char *path, *slash;
 275                int pathlen, sublen, subcnt, subskip;
 276
 277                path = ce->name;
 278                pathlen = ce_namelen(ce);
 279                if (pathlen <= baselen || memcmp(base, path, baselen))
 280                        break; /* at the end of this level */
 281
 282                slash = strchr(path + baselen, '/');
 283                if (!slash) {
 284                        i++;
 285                        continue;
 286                }
 287                /*
 288                 * a/bbb/c (base = a/, slash = /c)
 289                 * ==>
 290                 * path+baselen = bbb/c, sublen = 3
 291                 */
 292                sublen = slash - (path + baselen);
 293                sub = find_subtree(it, path + baselen, sublen, 1);
 294                if (!sub->cache_tree)
 295                        sub->cache_tree = cache_tree();
 296                subcnt = update_one(sub->cache_tree,
 297                                    cache + i, entries - i,
 298                                    path,
 299                                    baselen + sublen + 1,
 300                                    &subskip,
 301                                    flags);
 302                if (subcnt < 0)
 303                        return subcnt;
 304                if (!subcnt)
 305                        die("index cache-tree records empty sub-tree");
 306                i += subcnt;
 307                sub->count = subcnt; /* to be used in the next loop */
 308                *skip_count += subskip;
 309                sub->used = 1;
 310        }
 311
 312        discard_unused_subtrees(it);
 313
 314        /*
 315         * Then write out the tree object for this level.
 316         */
 317        strbuf_init(&buffer, 8192);
 318
 319        i = 0;
 320        while (i < entries) {
 321                const struct cache_entry *ce = cache[i];
 322                struct cache_tree_sub *sub;
 323                const char *path, *slash;
 324                int pathlen, entlen;
 325                const unsigned char *sha1;
 326                unsigned mode;
 327                int expected_missing = 0;
 328
 329                path = ce->name;
 330                pathlen = ce_namelen(ce);
 331                if (pathlen <= baselen || memcmp(base, path, baselen))
 332                        break; /* at the end of this level */
 333
 334                slash = strchr(path + baselen, '/');
 335                if (slash) {
 336                        entlen = slash - (path + baselen);
 337                        sub = find_subtree(it, path + baselen, entlen, 0);
 338                        if (!sub)
 339                                die("cache-tree.c: '%.*s' in '%s' not found",
 340                                    entlen, path + baselen, path);
 341                        i += sub->count;
 342                        sha1 = sub->cache_tree->sha1;
 343                        mode = S_IFDIR;
 344                        if (sub->cache_tree->entry_count < 0) {
 345                                to_invalidate = 1;
 346                                expected_missing = 1;
 347                        }
 348                }
 349                else {
 350                        sha1 = ce->sha1;
 351                        mode = ce->ce_mode;
 352                        entlen = pathlen - baselen;
 353                        i++;
 354                }
 355                if (mode != S_IFGITLINK && !missing_ok && !has_sha1_file(sha1)) {
 356                        strbuf_release(&buffer);
 357                        if (expected_missing)
 358                                return -1;
 359                        return error("invalid object %06o %s for '%.*s'",
 360                                mode, sha1_to_hex(sha1), entlen+baselen, path);
 361                }
 362
 363                /*
 364                 * CE_REMOVE entries are removed before the index is
 365                 * written to disk. Skip them to remain consistent
 366                 * with the future on-disk index.
 367                 */
 368                if (ce->ce_flags & CE_REMOVE) {
 369                        *skip_count = *skip_count + 1;
 370                        continue;
 371                }
 372
 373                /*
 374                 * CE_INTENT_TO_ADD entries exist on on-disk index but
 375                 * they are not part of generated trees. Invalidate up
 376                 * to root to force cache-tree users to read elsewhere.
 377                 */
 378                if (ce_intent_to_add(ce)) {
 379                        to_invalidate = 1;
 380                        continue;
 381                }
 382
 383                strbuf_grow(&buffer, entlen + 100);
 384                strbuf_addf(&buffer, "%o %.*s%c", mode, entlen, path + baselen, '\0');
 385                strbuf_add(&buffer, sha1, 20);
 386
 387#if DEBUG
 388                fprintf(stderr, "cache-tree update-one %o %.*s\n",
 389                        mode, entlen, path + baselen);
 390#endif
 391        }
 392
 393        if (repair) {
 394                unsigned char sha1[20];
 395                hash_sha1_file(buffer.buf, buffer.len, tree_type, sha1);
 396                if (has_sha1_file(sha1))
 397                        hashcpy(it->sha1, sha1);
 398                else
 399                        to_invalidate = 1;
 400        } else if (dryrun)
 401                hash_sha1_file(buffer.buf, buffer.len, tree_type, it->sha1);
 402        else if (write_sha1_file(buffer.buf, buffer.len, tree_type, it->sha1)) {
 403                strbuf_release(&buffer);
 404                return -1;
 405        }
 406
 407        strbuf_release(&buffer);
 408        it->entry_count = to_invalidate ? -1 : i - *skip_count;
 409#if DEBUG
 410        fprintf(stderr, "cache-tree update-one (%d ent, %d subtree) %s\n",
 411                it->entry_count, it->subtree_nr,
 412                sha1_to_hex(it->sha1));
 413#endif
 414        return i;
 415}
 416
 417int cache_tree_update(struct index_state *istate, int flags)
 418{
 419        struct cache_tree *it = istate->cache_tree;
 420        struct cache_entry **cache = istate->cache;
 421        int entries = istate->cache_nr;
 422        int skip, i = verify_cache(cache, entries, flags);
 423
 424        if (i)
 425                return i;
 426        i = update_one(it, cache, entries, "", 0, &skip, flags);
 427        if (i < 0)
 428                return i;
 429        istate->cache_changed |= CACHE_TREE_CHANGED;
 430        return 0;
 431}
 432
 433static void write_one(struct strbuf *buffer, struct cache_tree *it,
 434                      const char *path, int pathlen)
 435{
 436        int i;
 437
 438        /* One "cache-tree" entry consists of the following:
 439         * path (NUL terminated)
 440         * entry_count, subtree_nr ("%d %d\n")
 441         * tree-sha1 (missing if invalid)
 442         * subtree_nr "cache-tree" entries for subtrees.
 443         */
 444        strbuf_grow(buffer, pathlen + 100);
 445        strbuf_add(buffer, path, pathlen);
 446        strbuf_addf(buffer, "%c%d %d\n", 0, it->entry_count, it->subtree_nr);
 447
 448#if DEBUG
 449        if (0 <= it->entry_count)
 450                fprintf(stderr, "cache-tree <%.*s> (%d ent, %d subtree) %s\n",
 451                        pathlen, path, it->entry_count, it->subtree_nr,
 452                        sha1_to_hex(it->sha1));
 453        else
 454                fprintf(stderr, "cache-tree <%.*s> (%d subtree) invalid\n",
 455                        pathlen, path, it->subtree_nr);
 456#endif
 457
 458        if (0 <= it->entry_count) {
 459                strbuf_add(buffer, it->sha1, 20);
 460        }
 461        for (i = 0; i < it->subtree_nr; i++) {
 462                struct cache_tree_sub *down = it->down[i];
 463                if (i) {
 464                        struct cache_tree_sub *prev = it->down[i-1];
 465                        if (subtree_name_cmp(down->name, down->namelen,
 466                                             prev->name, prev->namelen) <= 0)
 467                                die("fatal - unsorted cache subtree");
 468                }
 469                write_one(buffer, down->cache_tree, down->name, down->namelen);
 470        }
 471}
 472
 473void cache_tree_write(struct strbuf *sb, struct cache_tree *root)
 474{
 475        write_one(sb, root, "", 0);
 476}
 477
 478static struct cache_tree *read_one(const char **buffer, unsigned long *size_p)
 479{
 480        const char *buf = *buffer;
 481        unsigned long size = *size_p;
 482        const char *cp;
 483        char *ep;
 484        struct cache_tree *it;
 485        int i, subtree_nr;
 486
 487        it = NULL;
 488        /* skip name, but make sure name exists */
 489        while (size && *buf) {
 490                size--;
 491                buf++;
 492        }
 493        if (!size)
 494                goto free_return;
 495        buf++; size--;
 496        it = cache_tree();
 497
 498        cp = buf;
 499        it->entry_count = strtol(cp, &ep, 10);
 500        if (cp == ep)
 501                goto free_return;
 502        cp = ep;
 503        subtree_nr = strtol(cp, &ep, 10);
 504        if (cp == ep)
 505                goto free_return;
 506        while (size && *buf && *buf != '\n') {
 507                size--;
 508                buf++;
 509        }
 510        if (!size)
 511                goto free_return;
 512        buf++; size--;
 513        if (0 <= it->entry_count) {
 514                if (size < 20)
 515                        goto free_return;
 516                hashcpy(it->sha1, (const unsigned char*)buf);
 517                buf += 20;
 518                size -= 20;
 519        }
 520
 521#if DEBUG
 522        if (0 <= it->entry_count)
 523                fprintf(stderr, "cache-tree <%s> (%d ent, %d subtree) %s\n",
 524                        *buffer, it->entry_count, subtree_nr,
 525                        sha1_to_hex(it->sha1));
 526        else
 527                fprintf(stderr, "cache-tree <%s> (%d subtrees) invalid\n",
 528                        *buffer, subtree_nr);
 529#endif
 530
 531        /*
 532         * Just a heuristic -- we do not add directories that often but
 533         * we do not want to have to extend it immediately when we do,
 534         * hence +2.
 535         */
 536        it->subtree_alloc = subtree_nr + 2;
 537        it->down = xcalloc(it->subtree_alloc, sizeof(struct cache_tree_sub *));
 538        for (i = 0; i < subtree_nr; i++) {
 539                /* read each subtree */
 540                struct cache_tree *sub;
 541                struct cache_tree_sub *subtree;
 542                const char *name = buf;
 543
 544                sub = read_one(&buf, &size);
 545                if (!sub)
 546                        goto free_return;
 547                subtree = cache_tree_sub(it, name);
 548                subtree->cache_tree = sub;
 549        }
 550        if (subtree_nr != it->subtree_nr)
 551                die("cache-tree: internal error");
 552        *buffer = buf;
 553        *size_p = size;
 554        return it;
 555
 556 free_return:
 557        cache_tree_free(&it);
 558        return NULL;
 559}
 560
 561struct cache_tree *cache_tree_read(const char *buffer, unsigned long size)
 562{
 563        if (buffer[0])
 564                return NULL; /* not the whole tree */
 565        return read_one(&buffer, &size);
 566}
 567
 568static struct cache_tree *cache_tree_find(struct cache_tree *it, const char *path)
 569{
 570        if (!it)
 571                return NULL;
 572        while (*path) {
 573                const char *slash;
 574                struct cache_tree_sub *sub;
 575
 576                slash = strchrnul(path, '/');
 577                /*
 578                 * Between path and slash is the name of the subtree
 579                 * to look for.
 580                 */
 581                sub = find_subtree(it, path, slash - path, 0);
 582                if (!sub)
 583                        return NULL;
 584                it = sub->cache_tree;
 585
 586                path = slash;
 587                while (*path == '/')
 588                        path++;
 589        }
 590        return it;
 591}
 592
 593int write_index_as_tree(unsigned char *sha1, struct index_state *index_state, const char *index_path, int flags, const char *prefix)
 594{
 595        int entries, was_valid, newfd;
 596        struct lock_file *lock_file;
 597
 598        /*
 599         * We can't free this memory, it becomes part of a linked list
 600         * parsed atexit()
 601         */
 602        lock_file = xcalloc(1, sizeof(struct lock_file));
 603
 604        newfd = hold_lock_file_for_update(lock_file, index_path, LOCK_DIE_ON_ERROR);
 605
 606        entries = read_index_from(index_state, index_path);
 607        if (entries < 0)
 608                return WRITE_TREE_UNREADABLE_INDEX;
 609        if (flags & WRITE_TREE_IGNORE_CACHE_TREE)
 610                cache_tree_free(&index_state->cache_tree);
 611
 612        if (!index_state->cache_tree)
 613                index_state->cache_tree = cache_tree();
 614
 615        was_valid = cache_tree_fully_valid(index_state->cache_tree);
 616        if (!was_valid) {
 617                if (cache_tree_update(index_state, flags) < 0)
 618                        return WRITE_TREE_UNMERGED_INDEX;
 619                if (0 <= newfd) {
 620                        if (!write_locked_index(index_state, lock_file, COMMIT_LOCK))
 621                                newfd = -1;
 622                }
 623                /* Not being able to write is fine -- we are only interested
 624                 * in updating the cache-tree part, and if the next caller
 625                 * ends up using the old index with unupdated cache-tree part
 626                 * it misses the work we did here, but that is just a
 627                 * performance penalty and not a big deal.
 628                 */
 629        }
 630
 631        if (prefix) {
 632                struct cache_tree *subtree;
 633                subtree = cache_tree_find(index_state->cache_tree, prefix);
 634                if (!subtree)
 635                        return WRITE_TREE_PREFIX_ERROR;
 636                hashcpy(sha1, subtree->sha1);
 637        }
 638        else
 639                hashcpy(sha1, index_state->cache_tree->sha1);
 640
 641        if (0 <= newfd)
 642                rollback_lock_file(lock_file);
 643
 644        return 0;
 645}
 646
 647int write_cache_as_tree(unsigned char *sha1, int flags, const char *prefix)
 648{
 649        return write_index_as_tree(sha1, &the_index, get_index_file(), flags, prefix);
 650}
 651
 652static void prime_cache_tree_rec(struct cache_tree *it, struct tree *tree)
 653{
 654        struct tree_desc desc;
 655        struct name_entry entry;
 656        int cnt;
 657
 658        hashcpy(it->sha1, tree->object.oid.hash);
 659        init_tree_desc(&desc, tree->buffer, tree->size);
 660        cnt = 0;
 661        while (tree_entry(&desc, &entry)) {
 662                if (!S_ISDIR(entry.mode))
 663                        cnt++;
 664                else {
 665                        struct cache_tree_sub *sub;
 666                        struct tree *subtree = lookup_tree(entry.oid->hash);
 667                        if (!subtree->object.parsed)
 668                                parse_tree(subtree);
 669                        sub = cache_tree_sub(it, entry.path);
 670                        sub->cache_tree = cache_tree();
 671                        prime_cache_tree_rec(sub->cache_tree, subtree);
 672                        cnt += sub->cache_tree->entry_count;
 673                }
 674        }
 675        it->entry_count = cnt;
 676}
 677
 678void prime_cache_tree(struct index_state *istate, struct tree *tree)
 679{
 680        cache_tree_free(&istate->cache_tree);
 681        istate->cache_tree = cache_tree();
 682        prime_cache_tree_rec(istate->cache_tree, tree);
 683        istate->cache_changed |= CACHE_TREE_CHANGED;
 684}
 685
 686/*
 687 * find the cache_tree that corresponds to the current level without
 688 * exploding the full path into textual form.  The root of the
 689 * cache tree is given as "root", and our current level is "info".
 690 * (1) When at root level, info->prev is NULL, so it is "root" itself.
 691 * (2) Otherwise, find the cache_tree that corresponds to one level
 692 *     above us, and find ourselves in there.
 693 */
 694static struct cache_tree *find_cache_tree_from_traversal(struct cache_tree *root,
 695                                                         struct traverse_info *info)
 696{
 697        struct cache_tree *our_parent;
 698
 699        if (!info->prev)
 700                return root;
 701        our_parent = find_cache_tree_from_traversal(root, info->prev);
 702        return cache_tree_find(our_parent, info->name.path);
 703}
 704
 705int cache_tree_matches_traversal(struct cache_tree *root,
 706                                 struct name_entry *ent,
 707                                 struct traverse_info *info)
 708{
 709        struct cache_tree *it;
 710
 711        it = find_cache_tree_from_traversal(root, info);
 712        it = cache_tree_find(it, ent->path);
 713        if (it && it->entry_count > 0 && !hashcmp(ent->oid->hash, it->sha1))
 714                return it->entry_count;
 715        return 0;
 716}
 717
 718int update_main_cache_tree(int flags)
 719{
 720        if (!the_index.cache_tree)
 721                the_index.cache_tree = cache_tree();
 722        return cache_tree_update(&the_index, flags);
 723}