git-lfs-track
- View or add Git LFS paths to Git attributes
git lfs track
[options] [pattern...]
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 states
that patterns use the gitignore pattern rules
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.
--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).
git lfs track
git lfs track "*.gif"
git lfs track --lockable "*.psd"
project [1].psd
:
git lfs track --filename "project [1].psd"
git-lfs-untrack(1), git-lfs-install(1), gitattributes(5), gitignore(5).
Part of the git-lfs(1) suite.