1GIT-LFS-SMUDGE(1)           General Commands Manual          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] git lfs smudge --skip [path]
11

DESCRIPTION

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

OPTIONS

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

KNOWN BUGS

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

SEE ALSO

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