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