NAME

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

SYNOPSIS

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

DESCRIPTION

       Finds what files use or used a key.

       For  each  file in the working tree that uses a key, this outputs one line, starting with the key, then a
       space, and then the name of the file.  When multiple files use the same key, they  will  all  be  listed.
       When nothing is found that uses the key, there will be no output.

       The  default  is  to  find only files in the current working tree that use a key. The --historical option
       makes it also find past versions of files.

OPTIONS

       --key=keyname

              Operate on this key.

       --unused
              Operate on keys found by last run of git-annex unused.

              Usually these keys won't be used by any files  in  the  current  working  tree,  or  any  tags  or
              branches. Combining this option with --historical will find past uses of the keys.

       --historical
              When  no files in the current working tree use a key, this causes more work to be done, looking at
              past versions of the current branch, other branches, tags, and the reflog, to find somewhere  that
              the key was used.  It stops after finding one use of the key, and outputs a git rev that refers to
              where it was used, eg "HEAD@{40}:somefile"

SEE ALSO

       git-annex(1)

       git-annex-unused(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                                          git-annex-whereused(1)