2 * This merges the file listing in the directory cache index
3 * with the actual working directory list, and shows different
4 * combinations of the two.
6 * Copyright (C) Linus Torvalds, 2005
14 static int abbrev
= 0;
15 static int show_deleted
= 0;
16 static int show_cached
= 0;
17 static int show_others
= 0;
18 static int show_ignored
= 0;
19 static int show_stage
= 0;
20 static int show_unmerged
= 0;
21 static int show_modified
= 0;
22 static int show_killed
= 0;
23 static int show_other_directories
= 0;
24 static int show_valid_bit
= 0;
25 static int line_terminator
= '\n';
27 static int prefix_len
= 0, prefix_offset
= 0;
28 static const char *prefix
= NULL
;
29 static const char **pathspec
= NULL
;
30 static int error_unmatch
= 0;
31 static char *ps_matched
= NULL
;
33 static const char *tag_cached
= "";
34 static const char *tag_unmerged
= "";
35 static const char *tag_removed
= "";
36 static const char *tag_other
= "";
37 static const char *tag_killed
= "";
38 static const char *tag_modified
= "";
40 static const char *exclude_per_dir
= NULL
;
42 /* We maintain three exclude pattern lists:
43 * EXC_CMDL lists patterns explicitly given on the command line.
44 * EXC_DIRS lists patterns obtained from per-directory ignore files.
45 * EXC_FILE lists patterns from fallback ignore files.
50 static struct exclude_list
{
60 static void add_exclude(const char *string
, const char *base
,
61 int baselen
, struct exclude_list
*which
)
63 struct exclude
*x
= xmalloc(sizeof (*x
));
68 if (which
->nr
== which
->alloc
) {
69 which
->alloc
= alloc_nr(which
->alloc
);
70 which
->excludes
= realloc(which
->excludes
,
71 which
->alloc
* sizeof(x
));
73 which
->excludes
[which
->nr
++] = x
;
76 static int add_excludes_from_file_1(const char *fname
,
79 struct exclude_list
*which
)
85 fd
= open(fname
, O_RDONLY
);
88 size
= lseek(fd
, 0, SEEK_END
);
91 lseek(fd
, 0, SEEK_SET
);
97 if (read(fd
, buf
, size
) != size
)
102 for (i
= 0; i
< size
; i
++) {
103 if (buf
[i
] == '\n') {
104 if (entry
!= buf
+ i
&& entry
[0] != '#') {
105 buf
[i
- (i
&& buf
[i
-1] == '\r')] = 0;
106 add_exclude(entry
, base
, baselen
, which
);
119 static void add_excludes_from_file(const char *fname
)
121 if (add_excludes_from_file_1(fname
, "", 0,
122 &exclude_list
[EXC_FILE
]) < 0)
123 die("cannot use %s as an exclude file", fname
);
126 static int push_exclude_per_directory(const char *base
, int baselen
)
128 char exclude_file
[PATH_MAX
];
129 struct exclude_list
*el
= &exclude_list
[EXC_DIRS
];
130 int current_nr
= el
->nr
;
132 if (exclude_per_dir
) {
133 memcpy(exclude_file
, base
, baselen
);
134 strcpy(exclude_file
+ baselen
, exclude_per_dir
);
135 add_excludes_from_file_1(exclude_file
, base
, baselen
, el
);
140 static void pop_exclude_per_directory(int stk
)
142 struct exclude_list
*el
= &exclude_list
[EXC_DIRS
];
145 free(el
->excludes
[--el
->nr
]);
148 /* Scan the list and let the last match determines the fate.
149 * Return 1 for exclude, 0 for include and -1 for undecided.
151 static int excluded_1(const char *pathname
,
153 struct exclude_list
*el
)
158 for (i
= el
->nr
- 1; 0 <= i
; i
--) {
159 struct exclude
*x
= el
->excludes
[i
];
160 const char *exclude
= x
->pattern
;
163 if (*exclude
== '!') {
168 if (!strchr(exclude
, '/')) {
170 const char *basename
= strrchr(pathname
, '/');
171 basename
= (basename
) ? basename
+1 : pathname
;
172 if (fnmatch(exclude
, basename
, 0) == 0)
176 /* match with FNM_PATHNAME:
177 * exclude has base (baselen long) implicitly
180 int baselen
= x
->baselen
;
184 if (pathlen
< baselen
||
185 (baselen
&& pathname
[baselen
-1] != '/') ||
186 strncmp(pathname
, x
->base
, baselen
))
189 if (fnmatch(exclude
, pathname
+baselen
,
195 return -1; /* undecided */
198 static int excluded(const char *pathname
)
200 int pathlen
= strlen(pathname
);
203 for (st
= EXC_CMDL
; st
<= EXC_FILE
; st
++) {
204 switch (excluded_1(pathname
, pathlen
, &exclude_list
[st
])) {
216 char name
[FLEX_ARRAY
]; /* more */
219 static struct nond_on_fs
**dir
;
221 static int dir_alloc
;
223 static void add_name(const char *pathname
, int len
)
225 struct nond_on_fs
*ent
;
227 if (cache_name_pos(pathname
, len
) >= 0)
230 if (nr_dir
== dir_alloc
) {
231 dir_alloc
= alloc_nr(dir_alloc
);
232 dir
= xrealloc(dir
, dir_alloc
*sizeof(ent
));
234 ent
= xmalloc(sizeof(*ent
) + len
+ 1);
236 memcpy(ent
->name
, pathname
, len
);
241 static int dir_exists(const char *dirname
, int len
)
243 int pos
= cache_name_pos(dirname
, len
);
247 if (pos
>= active_nr
) /* can't */
249 return !strncmp(active_cache
[pos
]->name
, dirname
, len
);
253 * Read a directory tree. We currently ignore anything but
254 * directories, regular files and symlinks. That's because git
255 * doesn't handle them at all yet. Maybe that will change some
258 * Also, we ignore the name ".git" (even if it is not a directory).
259 * That likely will not change.
261 static void read_directory(const char *path
, const char *base
, int baselen
)
263 DIR *dir
= opendir(path
);
268 char fullname
[MAXPATHLEN
+ 1];
269 memcpy(fullname
, base
, baselen
);
271 exclude_stk
= push_exclude_per_directory(base
, baselen
);
273 while ((de
= readdir(dir
)) != NULL
) {
276 if ((de
->d_name
[0] == '.') &&
277 (de
->d_name
[1] == 0 ||
278 !strcmp(de
->d_name
+ 1, ".") ||
279 !strcmp(de
->d_name
+ 1, "git")))
281 len
= strlen(de
->d_name
);
282 memcpy(fullname
+ baselen
, de
->d_name
, len
+1);
283 if (excluded(fullname
) != show_ignored
) {
284 if (!show_ignored
|| DTYPE(de
) != DT_DIR
) {
294 if (lstat(fullname
, &st
))
296 if (S_ISREG(st
.st_mode
) || S_ISLNK(st
.st_mode
))
298 if (!S_ISDIR(st
.st_mode
))
302 memcpy(fullname
+ baselen
+ len
, "/", 2);
304 if (show_other_directories
&&
305 !dir_exists(fullname
, baselen
+ len
))
307 read_directory(fullname
, fullname
,
314 add_name(fullname
, baselen
+ len
);
318 pop_exclude_per_directory(exclude_stk
);
322 static int cmp_name(const void *p1
, const void *p2
)
324 const struct nond_on_fs
*e1
= *(const struct nond_on_fs
**)p1
;
325 const struct nond_on_fs
*e2
= *(const struct nond_on_fs
**)p2
;
327 return cache_name_compare(e1
->name
, e1
->len
,
332 * Match a pathspec against a filename. The first "len" characters
333 * are the common prefix
335 static int match(const char **spec
, char *ps_matched
,
336 const char *filename
, int len
)
340 while ((m
= *spec
++) != NULL
) {
341 int matchlen
= strlen(m
+ len
);
345 if (!strncmp(m
+ len
, filename
+ len
, matchlen
)) {
346 if (m
[len
+ matchlen
- 1] == '/')
348 switch (filename
[len
+ matchlen
]) {
353 if (!fnmatch(m
+ len
, filename
+ len
, 0))
366 static void show_dir_entry(const char *tag
, struct nond_on_fs
*ent
)
368 int len
= prefix_len
;
369 int offset
= prefix_offset
;
372 die("git-ls-files: internal error - directory entry not superset of prefix");
374 if (pathspec
&& !match(pathspec
, ps_matched
, ent
->name
, len
))
378 write_name_quoted("", 0, ent
->name
+ offset
, line_terminator
, stdout
);
379 putchar(line_terminator
);
382 static void show_other_files(void)
385 for (i
= 0; i
< nr_dir
; i
++) {
386 /* We should not have a matching entry, but we
387 * may have an unmerged entry for this path.
389 struct nond_on_fs
*ent
= dir
[i
];
390 int pos
= cache_name_pos(ent
->name
, ent
->len
);
391 struct cache_entry
*ce
;
393 die("bug in show-other-files");
395 if (pos
< active_nr
) {
396 ce
= active_cache
[pos
];
397 if (ce_namelen(ce
) == ent
->len
&&
398 !memcmp(ce
->name
, ent
->name
, ent
->len
))
399 continue; /* Yup, this one exists unmerged */
401 show_dir_entry(tag_other
, ent
);
405 static void show_killed_files(void)
408 for (i
= 0; i
< nr_dir
; i
++) {
409 struct nond_on_fs
*ent
= dir
[i
];
411 int pos
, len
, killed
= 0;
413 for (cp
= ent
->name
; cp
- ent
->name
< ent
->len
; cp
= sp
+ 1) {
414 sp
= strchr(cp
, '/');
416 /* If ent->name is prefix of an entry in the
417 * cache, it will be killed.
419 pos
= cache_name_pos(ent
->name
, ent
->len
);
421 die("bug in show-killed-files");
423 while (pos
< active_nr
&&
424 ce_stage(active_cache
[pos
]))
425 pos
++; /* skip unmerged */
426 if (active_nr
<= pos
)
428 /* pos points at a name immediately after
429 * ent->name in the cache. Does it expect
430 * ent->name to be a directory?
432 len
= ce_namelen(active_cache
[pos
]);
433 if ((ent
->len
< len
) &&
434 !strncmp(active_cache
[pos
]->name
,
435 ent
->name
, ent
->len
) &&
436 active_cache
[pos
]->name
[ent
->len
] == '/')
440 if (0 <= cache_name_pos(ent
->name
, sp
- ent
->name
)) {
441 /* If any of the leading directories in
442 * ent->name is registered in the cache,
443 * ent->name will be killed.
450 show_dir_entry(tag_killed
, dir
[i
]);
454 static void show_ce_entry(const char *tag
, struct cache_entry
*ce
)
456 int len
= prefix_len
;
457 int offset
= prefix_offset
;
459 if (len
>= ce_namelen(ce
))
460 die("git-ls-files: internal error - cache entry not superset of prefix");
462 if (pathspec
&& !match(pathspec
, ps_matched
, ce
->name
, len
))
465 if (tag
&& *tag
&& show_valid_bit
&&
466 (ce
->ce_flags
& htons(CE_VALID
))) {
467 static char alttag
[4];
468 memcpy(alttag
, tag
, 3);
470 alttag
[0] = tolower(tag
[0]);
471 else if (tag
[0] == '?')
484 write_name_quoted("", 0, ce
->name
+ offset
,
485 line_terminator
, stdout
);
486 putchar(line_terminator
);
489 printf("%s%06o %s %d\t",
492 abbrev
? find_unique_abbrev(ce
->sha1
,abbrev
)
493 : sha1_to_hex(ce
->sha1
),
495 write_name_quoted("", 0, ce
->name
+ offset
,
496 line_terminator
, stdout
);
497 putchar(line_terminator
);
501 static void show_files(void)
505 /* For cached/deleted files we don't need to even do the readdir */
506 if (show_others
|| show_killed
) {
507 const char *path
= ".", *base
= "";
508 int baselen
= prefix_len
;
511 path
= base
= prefix
;
512 if (exclude_per_dir
) {
513 char *p
, *pp
= xmalloc(baselen
+1);
514 memcpy(pp
, prefix
, baselen
+1);
519 push_exclude_per_directory(pp
, p
-pp
);
532 read_directory(path
, base
, baselen
);
533 qsort(dir
, nr_dir
, sizeof(struct nond_on_fs
*), cmp_name
);
539 if (show_cached
| show_stage
) {
540 for (i
= 0; i
< active_nr
; i
++) {
541 struct cache_entry
*ce
= active_cache
[i
];
542 if (excluded(ce
->name
) != show_ignored
)
544 if (show_unmerged
&& !ce_stage(ce
))
546 show_ce_entry(ce_stage(ce
) ? tag_unmerged
: tag_cached
, ce
);
549 if (show_deleted
| show_modified
) {
550 for (i
= 0; i
< active_nr
; i
++) {
551 struct cache_entry
*ce
= active_cache
[i
];
554 if (excluded(ce
->name
) != show_ignored
)
556 err
= lstat(ce
->name
, &st
);
557 if (show_deleted
&& err
)
558 show_ce_entry(tag_removed
, ce
);
559 if (show_modified
&& ce_modified(ce
, &st
, 0))
560 show_ce_entry(tag_modified
, ce
);
566 * Prune the index to only contain stuff starting with "prefix"
568 static void prune_cache(void)
570 int pos
= cache_name_pos(prefix
, prefix_len
);
571 unsigned int first
, last
;
579 while (last
> first
) {
580 int next
= (last
+ first
) >> 1;
581 struct cache_entry
*ce
= active_cache
[next
];
582 if (!strncmp(ce
->name
, prefix
, prefix_len
)) {
591 static void verify_pathspec(void)
593 const char **p
, *n
, *prev
;
599 for (p
= pathspec
; (n
= *p
) != NULL
; p
++) {
601 for (i
= 0; i
< max
; i
++) {
603 if (prev
&& prev
[i
] != c
)
605 if (!c
|| c
== '*' || c
== '?')
618 if (prefix_offset
> max
|| memcmp(prev
, prefix
, prefix_offset
))
619 die("git-ls-files: cannot generate relative filenames containing '..'");
624 real_prefix
= xmalloc(max
+ 1);
625 memcpy(real_prefix
, prev
, max
);
626 real_prefix
[max
] = 0;
628 prefix
= real_prefix
;
631 static const char ls_files_usage
[] =
632 "git-ls-files [-z] [-t] [-v] (--[cached|deleted|others|stage|unmerged|killed|modified])* "
633 "[ --ignored ] [--exclude=<pattern>] [--exclude-from=<file>] "
634 "[ --exclude-per-directory=<filename> ] [--full-name] [--abbrev] "
637 int main(int argc
, const char **argv
)
642 prefix
= setup_git_directory();
644 prefix_offset
= strlen(prefix
);
645 git_config(git_default_config
);
647 for (i
= 1; i
< argc
; i
++) {
648 const char *arg
= argv
[i
];
650 if (!strcmp(arg
, "--")) {
654 if (!strcmp(arg
, "-z")) {
658 if (!strcmp(arg
, "-t") || !strcmp(arg
, "-v")) {
669 if (!strcmp(arg
, "-c") || !strcmp(arg
, "--cached")) {
673 if (!strcmp(arg
, "-d") || !strcmp(arg
, "--deleted")) {
677 if (!strcmp(arg
, "-m") || !strcmp(arg
, "--modified")) {
681 if (!strcmp(arg
, "-o") || !strcmp(arg
, "--others")) {
685 if (!strcmp(arg
, "-i") || !strcmp(arg
, "--ignored")) {
689 if (!strcmp(arg
, "-s") || !strcmp(arg
, "--stage")) {
693 if (!strcmp(arg
, "-k") || !strcmp(arg
, "--killed")) {
697 if (!strcmp(arg
, "--directory")) {
698 show_other_directories
= 1;
701 if (!strcmp(arg
, "-u") || !strcmp(arg
, "--unmerged")) {
702 /* There's no point in showing unmerged unless
703 * you also show the stage information.
709 if (!strcmp(arg
, "-x") && i
+1 < argc
) {
711 add_exclude(argv
[++i
], "", 0, &exclude_list
[EXC_CMDL
]);
714 if (!strncmp(arg
, "--exclude=", 10)) {
716 add_exclude(arg
+10, "", 0, &exclude_list
[EXC_CMDL
]);
719 if (!strcmp(arg
, "-X") && i
+1 < argc
) {
721 add_excludes_from_file(argv
[++i
]);
724 if (!strncmp(arg
, "--exclude-from=", 15)) {
726 add_excludes_from_file(arg
+15);
729 if (!strncmp(arg
, "--exclude-per-directory=", 24)) {
731 exclude_per_dir
= arg
+ 24;
734 if (!strcmp(arg
, "--full-name")) {
738 if (!strcmp(arg
, "--error-unmatch")) {
742 if (!strncmp(arg
, "--abbrev=", 9)) {
743 abbrev
= strtoul(arg
+9, NULL
, 10);
744 if (abbrev
&& abbrev
< MINIMUM_ABBREV
)
745 abbrev
= MINIMUM_ABBREV
;
746 else if (abbrev
> 40)
750 if (!strcmp(arg
, "--abbrev")) {
751 abbrev
= DEFAULT_ABBREV
;
755 usage(ls_files_usage
);
759 pathspec
= get_pathspec(prefix
, argv
+ i
);
761 /* Verify that the pathspec matches the prefix */
765 /* Treat unmatching pathspec elements as errors */
766 if (pathspec
&& error_unmatch
) {
768 for (num
= 0; pathspec
[num
]; num
++)
770 ps_matched
= xcalloc(1, num
);
773 if (show_ignored
&& !exc_given
) {
774 fprintf(stderr
, "%s: --ignored needs some exclude pattern\n",
779 /* With no flags, we default to showing the cached files */
780 if (!(show_stage
| show_deleted
| show_others
| show_unmerged
|
781 show_killed
| show_modified
))
790 /* We need to make sure all pathspec matched otherwise
794 for (num
= 0; pathspec
[num
]; num
++) {
797 error("pathspec '%s' did not match any.",
798 pathspec
[num
] + prefix_offset
);
801 return errors
? 1 : 0;