1GIT-LFS-TRACK(1)                                              GIT-LFS-TRACK(1)
2
3
4

NAME

6       git-lfs-track - View or add Git LFS paths to Git attributes
7

SYNOPSIS

9       git lfs track [options] [<pattern>...]
10

DESCRIPTION

12       Start tracking the given patterns(s) through Git LFS. The argument is
13       written to .gitattributes. If no paths are provided, simply list the
14       currently-tracked paths.
15
16       The gitattributes documentation
17       <https://git-scm.com/docs/gitattributes> states that patterns use the
18       gitignore pattern rules <https://git-scm.com/docs/gitignore> to match
19       paths. This means that patterns which contain asterisk (*), question
20       mark (?), and the bracket characters ([ and ]) are treated specially;
21       to disable this behavior and treat them literally instead, use
22       --filename or escape the character with a backslash.
23

OPTIONS

25       --verbose, -v
26           If enabled, have git lfs track log files which it will touch.
27           Disabled by default.
28
29       --dry-run, -d
30           If enabled, have git lfs track log all actions it would normally
31           take (adding entries to .gitattributes, touching files on disk,
32           etc) without performing any mutative operations to the disk.
33
34           git lfs track --dry-run [files] also implicitly mocks the behavior
35           of passing the --verbose, and will log in greater detail what it is
36           doing.
37
38           Disabled by default.
39
40       --filename
41           Treat the arguments as literal filenames, not as patterns. Any
42           special glob characters in the filename will be escaped when
43           writing the .gitattributes file.
44
45       --lockable, -l
46           Make the paths 'lockable', meaning they should be locked to edit
47           them, and will be made read-only in the working copy when not
48           locked.
49
50       --not-lockable
51           Remove the lockable flag from the paths so they are no longer
52           read-only unless locked.
53
54       --no-excluded
55             Do not list patterns that are excluded in the output; only list
56           patterns that are tracked. --no-modify-attrs: Makes matched entries
57           stat-dirty so that Git can re-index files you wish to convert to
58           LFS. Does not modify any .gitattributes file(s).
59

EXAMPLES

61       •   List the patterns that Git LFS is currently tracking:
62
63           git lfs track
64
65       •   Configure Git LFS to track GIF files:
66
67           git lfs track "*.gif"
68
69       •   Configure Git LFS to track PSD files and make them read-only unless
70           locked:
71
72           git lfs track --lockable "*.psd"
73
74       •   Configure Git LFS to track the file named project [1].psd:
75
76           git lfs track --filename "project [1].psd"
77

SEE ALSO

79       git-lfs-untrack(1), git-lfs-install(1), gitattributes(5), gitignore(5).
80
81       Part of the git-lfs(1) suite.
82
83
84
85                                                              GIT-LFS-TRACK(1)
Impressum