GIT-LFS-TRACK(1) | General Commands Manual | GIT-LFS-TRACK(1) |
NAME¶
git-lfs-track - View or add Git LFS paths to Git attributes
SYNOPSIS¶
git lfs track [options] [pattern...]
DESCRIPTION¶
Start tracking the given patterns(s) through Git LFS. The pattern argument is written to .gitattributes. If no paths are provided, simply list the currently-tracked paths.
The gitattributes documentation https://git-scm.com/docs/gitattributes states that patterns use the gitignore pattern rules https://git-scm.com/docs/gitignore to match paths. This means that patterns which contain asterisk (*), question mark (?), and the bracket characters ([ and ]) are treated specially; to disable this behavior and treat them literally instead, use --filename or escape the character with a backslash.
OPTIONS¶
- ○
- --verbose -v: If enabled, have git lfs track log files which it will touch. Disabled by default.
- ○
- --dry-run -d: If enabled, have git lfs track log all actions it would normally take (adding entries to .gitattributes, touching files on disk, etc) without performing any mutative operations to the disk.
- git lfs track --dry-run [files] also implicitly mocks the behavior of passing the --verbose, and will log in greater detail what it is doing.
- Disabled by default.
- ○
- --filename Treat the arguments as literal filenames, not as patterns. Any special glob characters in the filename will be escaped when writing the .gitattributes file.
- ○
- --lockable -l Make the paths ´lockable´, meaning they should be locked to edit them, and will be made read-only in the working copy when not locked.
- ○
- --not-lockable Remove the lockable flag from the paths so they are no longer read-only unless locked.
- ○
- --no-excluded Do not list patterns that are excluded in the output; only list patterns that are tracked.
- ○
- --no-modify-attrs Makes matched entries stat-dirty so that Git can re-index files you wish to convert to LFS. Does not modify any .gitattributes file(s).
EXAMPLES¶
SEE ALSO¶
git-lfs-untrack(1), git-lfs-install(1), gitattributes(5), gitignore(5).
Part of the git-lfs(1) suite.
May 2022 |