1git-annex-whereused(1)      General Commands Manual     git-annex-whereused(1)
2
3
4

NAME

6       git-annex-whereused - find what files use or used a key
7

SYNOPSIS

9       git annex whereused --key=keyname|--unused
10

DESCRIPTION

12       Finds what files use or used a key.
13
14       For  each  file  in  the working tree that uses a key, this outputs one
15       line, starting with the key, then a space, and then  the  name  of  the
16       file.   When  multiple files use the same key, they will all be listed.
17       When nothing is found that uses the key, there will be no output.
18
19       The default is to find only files in the current working tree that  use
20       a  key.  The  --historical  option  makes it also find past versions of
21       files.
22

OPTIONS

24       --key=keyname
25
26              Operate on this key.
27
28       --unused
29              Operate on keys found by last run of git-annex unused.
30
31              Usually these keys won't be used by any  files  in  the  current
32              working  tree,  or  any  tags or branches. Combining this option
33              with --historical will find past uses of the keys.
34
35       --historical
36              When no files in the current working tree use a key, this causes
37              more  work  to  be done, looking at past versions of the current
38              branch, other branches, tags, and the reflog, to find  somewhere
39              that  the  key  was used.  It stops after finding one use of the
40              key, and outputs a git rev that refers to where it was used,  eg
41              "HEAD@{40}:somefile"
42

SEE ALSO

44       git-annex(1)
45
46       git-annex-unused(1)
47

AUTHOR

49       Joey Hess <id@joeyh.name>
50
51                                                        git-annex-whereused(1)