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