git-ls-files (1) Linux Manual Page

NAME

git-ls-files – Show information about files in the index and the working tree

SYNOPSIS

git ls - files[-z][-t][-v][-f](--[cached | deleted | others | ignored | stage | unmerged | killed | modified]) *
             (-[c | d | o | i | s | u | k | m]) *
             [--eol]
                 [--deduplicate]
                 [-x<pattern> | --exclude = <pattern>]
                 [-X<file> | --exclude - from = <file>]
                 [--exclude - per - directory = <file>]
                 [--exclude - standard]
                 [--error - unmatch][--with - tree = <tree - ish>]
                 [--full - name][--recurse - submodules]
                 [--abbrev[=<n>]][--][<file>...]

DESCRIPTION

This merges the file listing in the index with the actual working directory list, and shows different combinations of the two.

One or more of the options below may be used to determine the files shown:

OPTIONS

-c, –cached

Show cached files in the output (default)

-d, –deleted

Show deleted files in the output

-m, –modified

Show modified files in the output

-o, –others

Show other (i.e. untracked) files in the output

-i, –ignored

Show only ignored files in the output. When showing files in the index, print only those matched by an exclude pattern. When showing "other" files, show only those matched by an exclude pattern. Standard ignore rules are not automatically activated, therefore at least one of the –exclude* options is required.

-s, –stage

Show staged contents’ mode bits, object name and stage number in the output.

–directory

If a whole directory is classified as "other", show just its name (with a trailing slash) and not its whole contents.

–no-empty-directory

Do not list empty directories. Has no effect without –directory.

-u, –unmerged

Show unmerged files in the output (forces –stage)

-k, –killed

Show files on the filesystem that need to be removed due to file/directory conflicts for checkout-index to succeed.

-z