1GIT-LFS-CHECKOUT(1)         General Commands Manual        GIT-LFS-CHECKOUT(1)
2
3
4

NAME

6       git-lfs-checkout - Update working copy with file content if available
7

SYNOPSIS

9       git lfs checkout [glob-pattern...]
10       git lfs checkout --to file {--base|--ours|--theirs} conflict-obj-path
11

DESCRIPTION

13       Try  to  ensure that the working copy contains file content for Git LFS
14       objects for the current ref, if the object data is available. Does  not
15       download any content; see git-lfs-fetch(1) for that.
16
17       Checkout  scans  the  current ref for all LFS objects that would be re‐
18       quired, then where a file is either missing in  the  working  copy,  or
19       contains  placeholder  pointer content with the same SHA, the real file
20       content is written, provided we have it in the  local  store.  Modified
21       files are never overwritten.
22
23       One  or more glob-patterns may be provided as arguments to restrict the
24       set of files that are updated. Glob patterns are  matched  as  per  the
25       format described in gitignore(5).
26
27       When  used  with --to and the working tree is in a conflicted state due
28       to a merge, this option checks out one of the three stages a  conflict‐
29       ing  Git  LFS  object into a separate file (which can be outside of the
30       work tree). This can make using  diff  tools  to  inspect  and  resolve
31       merges  easier. A single Git LFS object´s file path must be provided in
32       conflict-obj-path.
33

OPTIONS

35       --base Check out the merge base of the specified file.
36
37       --ours Check out our side (that of the current branch) of the  conflict
38              for the specified file.
39
40       --theirs
41              Check  out their side (that of the other branch) of the conflict
42              for the specified file.
43
44       --to path
45              If the working tree is in a conflicted state, check out the por‐
46              tion of the conflict specified by --base, --ours, or --theirs to
47              the given path.
48

EXAMPLES

50       Checkout all files that are missing or placeholders:
51
52
53       $ git lfs checkout
54
55       Checkout a specific couple of files:
56
57
58       $ git lfs checkout path/to/file1.png path/to.file2.png
59
60       Checkout a path with a merge conflict into separate files:
61
62
63       ``` # Attempt merge with a branch that has a merge conflict $ git merge
64       conflicting-branch  CONFLICT  (content): Merge conflict in path/to/con‐
65       flicting/file.dat$ git lfs checkout ours.dat  --ours  path/to/conflict‐
66       ing/file.dat  $  git lfs checkout theirs.dat --theirs path/to/conflict‐
67       ing/file.dat# then resolve conflict (e.g., by choosing one version over
68       #  the  other, or creating a new version)$ rm ours.dat theirs.dat $ git
69       add path/to/conflicting/file.dat $ git merge --continue ```
70

SEE ALSO

72       git-lfs-fetch(1), git-lfs-pull(1), gitignore(5).
73
74       Part of the git-lfs(1) suite.
75
76
77
78                                   May 2022                GIT-LFS-CHECKOUT(1)
Impressum