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

NAME

6       git-lfs-smudge - Git smudge filter that converts pointer in blobs to
7       the actual content
8

SYNOPSIS

10       git lfs smudge [<path>]
11       git lfs smudge --skip [<path>]
12

DESCRIPTION

14       Read a Git LFS pointer file from standard input and write the contents
15       of the corresponding large file to standard output. If needed, download
16       the file’s contents from the Git LFS endpoint. The argument, if
17       provided, is only used for a progress bar.
18
19       Smudge is typically run by Git’s smudge filter, configured by the
20       repository’s Git attributes.
21
22       In your Git configuration or in a .lfsconfig file, you may set either
23       or both of lfs.fetchinclude and lfs.fetchexclude to comma-separated
24       lists of paths. If lfs.fetchinclude is defined, Git LFS pointer files
25       will only be replaced with the contents of the corresponding Git LFS
26       object file if their path matches one in that list, and if
27       lfs.fetchexclude is defined, Git LFS pointer files will only be
28       replaced with the contents of the corresponding Git LFS object file if
29       their path does not match one in that list. Paths are matched using
30       wildcard matching as per gitignore(5). Git LFS pointer files that are
31       not replaced with the contents of their corresponding object files are
32       simply copied to standard output without change.
33

OPTIONS

35       Without any options, git lfs smudge outputs the raw Git LFS content to
36       standard output.
37
38       --skip
39           Skip automatic downloading of objects on clone or pull.
40
41       GIT_LFS_SKIP_SMUDGE
42           Disables the smudging process. For more, see: git-lfs-config(5).
43

KNOWN BUGS

45       On Windows, Git before 2.34.0 does not handle files in the working tree
46       larger than 4 gigabytes. Newer versions of Git, as well as Unix
47       versions, are unaffected.
48

SEE ALSO

50       git-lfs-install(1), gitattributes(5), gitignore(5).
51
52       Part of the git-lfs(1) suite.
53
54
55
56                                                             GIT-LFS-SMUDGE(1)
Impressum