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
);
96 buf
= xmalloc(size
+1);
97 if (read(fd
, buf
, size
) != size
)
103 for (i
= 0; i
< size
; i
++) {
104 if (buf
[i
] == '\n') {
105 if (entry
!= buf
+ i
&& entry
[0] != '#') {
106 buf
[i
- (i
&& buf
[i
-1] == '\r')] = 0;
107 add_exclude(entry
, base
, baselen
, which
);
120 static void add_excludes_from_file(const char *fname
)
122 if (add_excludes_from_file_1(fname
, "", 0,
123 &exclude_list
[EXC_FILE
]) < 0)
124 die("cannot use %s as an exclude file", fname
);
127 static int push_exclude_per_directory(const char *base
, int baselen
)
129 char exclude_file
[PATH_MAX
];
130 struct exclude_list
*el
= &exclude_list
[EXC_DIRS
];
131 int current_nr
= el
->nr
;
133 if (exclude_per_dir
) {
134 memcpy(exclude_file
, base
, baselen
);
135 strcpy(exclude_file
+ baselen
, exclude_per_dir
);
136 add_excludes_from_file_1(exclude_file
, base
, baselen
, el
);
141 static void pop_exclude_per_directory(int stk
)
143 struct exclude_list
*el
= &exclude_list
[EXC_DIRS
];
146 free(el
->excludes
[--el
->nr
]);
149 /* Scan the list and let the last match determines the fate.
150 * Return 1 for exclude, 0 for include and -1 for undecided.
152 static int excluded_1(const char *pathname
,
154 struct exclude_list
*el
)
159 for (i
= el
->nr
- 1; 0 <= i
; i
--) {
160 struct exclude
*x
= el
->excludes
[i
];
161 const char *exclude
= x
->pattern
;
164 if (*exclude
== '!') {
169 if (!strchr(exclude
, '/')) {
171 const char *basename
= strrchr(pathname
, '/');
172 basename
= (basename
) ? basename
+1 : pathname
;
173 if (fnmatch(exclude
, basename
, 0) == 0)
177 /* match with FNM_PATHNAME:
178 * exclude has base (baselen long) implicitly
181 int baselen
= x
->baselen
;
185 if (pathlen
< baselen
||
186 (baselen
&& pathname
[baselen
-1] != '/') ||
187 strncmp(pathname
, x
->base
, baselen
))
190 if (fnmatch(exclude
, pathname
+baselen
,
196 return -1; /* undecided */
199 static int excluded(const char *pathname
)
201 int pathlen
= strlen(pathname
);
204 for (st
= EXC_CMDL
; st
<= EXC_FILE
; st
++) {
205 switch (excluded_1(pathname
, pathlen
, &exclude_list
[st
])) {
217 char name
[FLEX_ARRAY
]; /* more */
220 static struct nond_on_fs
**dir
;
222 static int dir_alloc
;
224 static void add_name(const char *pathname
, int len
)
226 struct nond_on_fs
*ent
;
228 if (cache_name_pos(pathname
, len
) >= 0)
231 if (nr_dir
== dir_alloc
) {
232 dir_alloc
= alloc_nr(dir_alloc
);
233 dir
= xrealloc(dir
, dir_alloc
*sizeof(ent
));
235 ent
= xmalloc(sizeof(*ent
) + len
+ 1);
237 memcpy(ent
->name
, pathname
, len
);
242 static int dir_exists(const char *dirname
, int len
)
244 int pos
= cache_name_pos(dirname
, len
);
248 if (pos
>= active_nr
) /* can't */
250 return !strncmp(active_cache
[pos
]->name
, dirname
, len
);
254 * Read a directory tree. We currently ignore anything but
255 * directories, regular files and symlinks. That's because git
256 * doesn't handle them at all yet. Maybe that will change some
259 * Also, we ignore the name ".git" (even if it is not a directory).
260 * That likely will not change.
262 static void read_directory(const char *path
, const char *base
, int baselen
)
264 DIR *dir
= opendir(path
);
269 char fullname
[MAXPATHLEN
+ 1];
270 memcpy(fullname
, base
, baselen
);
272 exclude_stk
= push_exclude_per_directory(base
, baselen
);
274 while ((de
= readdir(dir
)) != NULL
) {
277 if ((de
->d_name
[0] == '.') &&
278 (de
->d_name
[1] == 0 ||
279 !strcmp(de
->d_name
+ 1, ".") ||
280 !strcmp(de
->d_name
+ 1, "git")))
282 len
= strlen(de
->d_name
);
283 memcpy(fullname
+ baselen
, de
->d_name
, len
+1);
284 if (excluded(fullname
) != show_ignored
) {
285 if (!show_ignored
|| DTYPE(de
) != DT_DIR
) {
295 if (lstat(fullname
, &st
))
297 if (S_ISREG(st
.st_mode
) || S_ISLNK(st
.st_mode
))
299 if (!S_ISDIR(st
.st_mode
))
303 memcpy(fullname
+ baselen
+ len
, "/", 2);
305 if (show_other_directories
&&
306 !dir_exists(fullname
, baselen
+ len
))
308 read_directory(fullname
, fullname
,
315 add_name(fullname
, baselen
+ len
);
319 pop_exclude_per_directory(exclude_stk
);
323 static int cmp_name(const void *p1
, const void *p2
)
325 const struct nond_on_fs
*e1
= *(const struct nond_on_fs
**)p1
;
326 const struct nond_on_fs
*e2
= *(const struct nond_on_fs
**)p2
;
328 return cache_name_compare(e1
->name
, e1
->len
,
333 * Match a pathspec against a filename. The first "len" characters
334 * are the common prefix
336 static int match(const char **spec
, char *ps_matched
,
337 const char *filename
, int len
)
341 while ((m
= *spec
++) != NULL
) {
342 int matchlen
= strlen(m
+ len
);
346 if (!strncmp(m
+ len
, filename
+ len
, matchlen
)) {
347 if (m
[len
+ matchlen
- 1] == '/')
349 switch (filename
[len
+ matchlen
]) {
354 if (!fnmatch(m
+ len
, filename
+ len
, 0))
367 static void show_dir_entry(const char *tag
, struct nond_on_fs
*ent
)
369 int len
= prefix_len
;
370 int offset
= prefix_offset
;
373 die("git-ls-files: internal error - directory entry not superset of prefix");
375 if (pathspec
&& !match(pathspec
, ps_matched
, ent
->name
, len
))
379 write_name_quoted("", 0, ent
->name
+ offset
, line_terminator
, stdout
);
380 putchar(line_terminator
);
383 static void show_other_files(void)
386 for (i
= 0; i
< nr_dir
; i
++) {
387 /* We should not have a matching entry, but we
388 * may have an unmerged entry for this path.
390 struct nond_on_fs
*ent
= dir
[i
];
391 int pos
= cache_name_pos(ent
->name
, ent
->len
);
392 struct cache_entry
*ce
;
394 die("bug in show-other-files");
396 if (pos
< active_nr
) {
397 ce
= active_cache
[pos
];
398 if (ce_namelen(ce
) == ent
->len
&&
399 !memcmp(ce
->name
, ent
->name
, ent
->len
))
400 continue; /* Yup, this one exists unmerged */
402 show_dir_entry(tag_other
, ent
);
406 static void show_killed_files(void)
409 for (i
= 0; i
< nr_dir
; i
++) {
410 struct nond_on_fs
*ent
= dir
[i
];
412 int pos
, len
, killed
= 0;
414 for (cp
= ent
->name
; cp
- ent
->name
< ent
->len
; cp
= sp
+ 1) {
415 sp
= strchr(cp
, '/');
417 /* If ent->name is prefix of an entry in the
418 * cache, it will be killed.
420 pos
= cache_name_pos(ent
->name
, ent
->len
);
422 die("bug in show-killed-files");
424 while (pos
< active_nr
&&
425 ce_stage(active_cache
[pos
]))
426 pos
++; /* skip unmerged */
427 if (active_nr
<= pos
)
429 /* pos points at a name immediately after
430 * ent->name in the cache. Does it expect
431 * ent->name to be a directory?
433 len
= ce_namelen(active_cache
[pos
]);
434 if ((ent
->len
< len
) &&
435 !strncmp(active_cache
[pos
]->name
,
436 ent
->name
, ent
->len
) &&
437 active_cache
[pos
]->name
[ent
->len
] == '/')
441 if (0 <= cache_name_pos(ent
->name
, sp
- ent
->name
)) {
442 /* If any of the leading directories in
443 * ent->name is registered in the cache,
444 * ent->name will be killed.
451 show_dir_entry(tag_killed
, dir
[i
]);
455 static void show_ce_entry(const char *tag
, struct cache_entry
*ce
)
457 int len
= prefix_len
;
458 int offset
= prefix_offset
;
460 if (len
>= ce_namelen(ce
))
461 die("git-ls-files: internal error - cache entry not superset of prefix");
463 if (pathspec
&& !match(pathspec
, ps_matched
, ce
->name
, len
))
466 if (tag
&& *tag
&& show_valid_bit
&&
467 (ce
->ce_flags
& htons(CE_VALID
))) {
468 static char alttag
[4];
469 memcpy(alttag
, tag
, 3);
471 alttag
[0] = tolower(tag
[0]);
472 else if (tag
[0] == '?')
485 write_name_quoted("", 0, ce
->name
+ offset
,
486 line_terminator
, stdout
);
487 putchar(line_terminator
);
490 printf("%s%06o %s %d\t",
493 abbrev
? find_unique_abbrev(ce
->sha1
,abbrev
)
494 : sha1_to_hex(ce
->sha1
),
496 write_name_quoted("", 0, ce
->name
+ offset
,
497 line_terminator
, stdout
);
498 putchar(line_terminator
);
502 static void show_files(void)
506 /* For cached/deleted files we don't need to even do the readdir */
507 if (show_others
|| show_killed
) {
508 const char *path
= ".", *base
= "";
509 int baselen
= prefix_len
;
512 path
= base
= prefix
;
513 if (exclude_per_dir
) {
514 char *p
, *pp
= xmalloc(baselen
+1);
515 memcpy(pp
, prefix
, baselen
+1);
520 push_exclude_per_directory(pp
, p
-pp
);
533 read_directory(path
, base
, baselen
);
534 qsort(dir
, nr_dir
, sizeof(struct nond_on_fs
*), cmp_name
);
540 if (show_cached
| show_stage
) {
541 for (i
= 0; i
< active_nr
; i
++) {
542 struct cache_entry
*ce
= active_cache
[i
];
543 if (excluded(ce
->name
) != show_ignored
)
545 if (show_unmerged
&& !ce_stage(ce
))
547 show_ce_entry(ce_stage(ce
) ? tag_unmerged
: tag_cached
, ce
);
550 if (show_deleted
| show_modified
) {
551 for (i
= 0; i
< active_nr
; i
++) {
552 struct cache_entry
*ce
= active_cache
[i
];
555 if (excluded(ce
->name
) != show_ignored
)
557 err
= lstat(ce
->name
, &st
);
558 if (show_deleted
&& err
)
559 show_ce_entry(tag_removed
, ce
);
560 if (show_modified
&& ce_modified(ce
, &st
, 0))
561 show_ce_entry(tag_modified
, ce
);
567 * Prune the index to only contain stuff starting with "prefix"
569 static void prune_cache(void)
571 int pos
= cache_name_pos(prefix
, prefix_len
);
572 unsigned int first
, last
;
580 while (last
> first
) {
581 int next
= (last
+ first
) >> 1;
582 struct cache_entry
*ce
= active_cache
[next
];
583 if (!strncmp(ce
->name
, prefix
, prefix_len
)) {
592 static void verify_pathspec(void)
594 const char **p
, *n
, *prev
;
600 for (p
= pathspec
; (n
= *p
) != NULL
; p
++) {
602 for (i
= 0; i
< max
; i
++) {
604 if (prev
&& prev
[i
] != c
)
606 if (!c
|| c
== '*' || c
== '?')
619 if (prefix_offset
> max
|| memcmp(prev
, prefix
, prefix_offset
))
620 die("git-ls-files: cannot generate relative filenames containing '..'");
625 real_prefix
= xmalloc(max
+ 1);
626 memcpy(real_prefix
, prev
, max
);
627 real_prefix
[max
] = 0;
629 prefix
= real_prefix
;
632 static const char ls_files_usage
[] =
633 "git-ls-files [-z] [-t] [-v] (--[cached|deleted|others|stage|unmerged|killed|modified])* "
634 "[ --ignored ] [--exclude=<pattern>] [--exclude-from=<file>] "
635 "[ --exclude-per-directory=<filename> ] [--full-name] [--abbrev] "
638 int main(int argc
, const char **argv
)
643 prefix
= setup_git_directory();
645 prefix_offset
= strlen(prefix
);
646 git_config(git_default_config
);
648 for (i
= 1; i
< argc
; i
++) {
649 const char *arg
= argv
[i
];
651 if (!strcmp(arg
, "--")) {
655 if (!strcmp(arg
, "-z")) {
659 if (!strcmp(arg
, "-t") || !strcmp(arg
, "-v")) {
670 if (!strcmp(arg
, "-c") || !strcmp(arg
, "--cached")) {
674 if (!strcmp(arg
, "-d") || !strcmp(arg
, "--deleted")) {
678 if (!strcmp(arg
, "-m") || !strcmp(arg
, "--modified")) {
682 if (!strcmp(arg
, "-o") || !strcmp(arg
, "--others")) {
686 if (!strcmp(arg
, "-i") || !strcmp(arg
, "--ignored")) {
690 if (!strcmp(arg
, "-s") || !strcmp(arg
, "--stage")) {
694 if (!strcmp(arg
, "-k") || !strcmp(arg
, "--killed")) {
698 if (!strcmp(arg
, "--directory")) {
699 show_other_directories
= 1;
702 if (!strcmp(arg
, "-u") || !strcmp(arg
, "--unmerged")) {
703 /* There's no point in showing unmerged unless
704 * you also show the stage information.
710 if (!strcmp(arg
, "-x") && i
+1 < argc
) {
712 add_exclude(argv
[++i
], "", 0, &exclude_list
[EXC_CMDL
]);
715 if (!strncmp(arg
, "--exclude=", 10)) {
717 add_exclude(arg
+10, "", 0, &exclude_list
[EXC_CMDL
]);
720 if (!strcmp(arg
, "-X") && i
+1 < argc
) {
722 add_excludes_from_file(argv
[++i
]);
725 if (!strncmp(arg
, "--exclude-from=", 15)) {
727 add_excludes_from_file(arg
+15);
730 if (!strncmp(arg
, "--exclude-per-directory=", 24)) {
732 exclude_per_dir
= arg
+ 24;
735 if (!strcmp(arg
, "--full-name")) {
739 if (!strcmp(arg
, "--error-unmatch")) {
743 if (!strncmp(arg
, "--abbrev=", 9)) {
744 abbrev
= strtoul(arg
+9, NULL
, 10);
745 if (abbrev
&& abbrev
< MINIMUM_ABBREV
)
746 abbrev
= MINIMUM_ABBREV
;
747 else if (abbrev
> 40)
751 if (!strcmp(arg
, "--abbrev")) {
752 abbrev
= DEFAULT_ABBREV
;
756 usage(ls_files_usage
);
760 pathspec
= get_pathspec(prefix
, argv
+ i
);
762 /* Verify that the pathspec matches the prefix */
766 /* Treat unmatching pathspec elements as errors */
767 if (pathspec
&& error_unmatch
) {
769 for (num
= 0; pathspec
[num
]; num
++)
771 ps_matched
= xcalloc(1, num
);
774 if (show_ignored
&& !exc_given
) {
775 fprintf(stderr
, "%s: --ignored needs some exclude pattern\n",
780 /* With no flags, we default to showing the cached files */
781 if (!(show_stage
| show_deleted
| show_others
| show_unmerged
|
782 show_killed
| show_modified
))
791 /* We need to make sure all pathspec matched otherwise
795 for (num
= 0; pathspec
[num
]; num
++) {
798 error("pathspec '%s' did not match any.",
799 pathspec
[num
] + prefix_offset
);
802 return errors
? 1 : 0;