NAME

       git-annex-unused - look for unused file content

SYNOPSIS

       git annex unused

DESCRIPTION

       Checks  the annex for data that does not correspond to any files present in any tag or branch, and prints
       a numbered list of the data.

       After running this command, you can use the --unused option with many other git-annex commands to operate
       on all the unused data that was found.

       For example, to move all unused data to origin:

        git annex unused; git annex move --unused --to origin

OPTIONS

       --fast

              Only show unused temp and bad files.

       --from=repository
              Check for unused data that is located in a repository.

              The  repository  should  be  specified  using  the  name  of  a  configured remote, or the UUID or
              description of a repository.

       --used-refspec=+ref:-ref
              By default, any data that the work tree uses, or that any refs in the git repository point  to  is
              considered  to  be used. If you only want to use some refs, you can use this option to specify the
              ones to use. Data that is not in the specified refs (and not used by the work tree) will  then  be
              considered unused.

              The  git  configuration  annex.used-refspec  can  be  used  to  configure this in a more permanent
              fashion.

REFSPEC FORMAT

       The refspec format for --used-refspec is a colon-separated list of additions and removals  of  refs.  For
       example:

        +refs/heads/*:+HEAD^:+refs/tags/*:-refs/tags/old-tag

       This  adds  all  refs/heads/ refs, as well as the previous version of HEAD. It also adds all tags, except
       for old-tag.

       The refspec is processed by starting with an empty set of refs, and walking the list in order  from  left
       to right.

       Each + using a glob is matched against all relevant refs (a subset of git show-ref) and all matching refs
       are added to the set.  For example, "+refs/remotes/*" adds all remote refs.

       Each + without a glob adds the literal value to the set.  For example, "+HEAD^" adds "HEAD^".

       Each - is matched against the set of refs accumulated so far.  Any refs with names that match are removed
       from the set.

       "reflog" adds all the refs from the reflog. This will make past versions of files not be considered to be
       unused until the ref expires from the reflog (by default for 90 days). Note that this may make  git-annex
       unused take some time to complete, it if needs to check every ref from the reflog.

SEE ALSO

       git-annex(1)

       git-annex-dropunused(1)

       git-annex-addunused(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                                             git-annex-unused(1)