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)