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

NAME

6       git-annex-unused - look for unused file content
7

SYNOPSIS

9       git annex unused
10

DESCRIPTION

12       Checks the annex for data that does not correspond to any files present
13       in any tag or branch, and prints a numbered list of the data.
14
15       After running this command, you can use the --unused option  with  many
16       other  git-annex  commands  to  operate on all the unused data that was
17       found.
18
19       For example, to move all unused data to origin:
20
21        git annex unused; git annex move --unused --to origin
22

OPTIONS

24       --fast
25
26              Only show unused temp and bad files.
27
28       --from=repository
29              Check for unused data that is located in a repository.
30
31              The repository should be specified using the name of  a  config‐
32              ured remote, or the UUID or description of a repository.
33
34       --used-refspec=+ref:-ref
35              By  default,  any data that the work tree uses, or that any refs
36              in the git repository point to is considered to be used. If  you
37              only  want  to use some refs, you can use this option to specify
38              the ones to use. Data that is not in the specified refs (and not
39              used by the work tree) will then be considered unused.
40
41              The  git configuration annex.used-refspec can be used to config‐
42              ure this in a more permanent fashion.
43

REFSPEC FORMAT

45       The refspec format for --used-refspec  is  a  colon-separated  list  of
46       additions and removals of refs. For example:
47
48        +refs/heads/*:+HEAD^:+refs/tags/*:-refs/tags/old-tag
49
50       This  adds  all  refs/heads/  refs,  as well as the previous version of
51       HEAD. It also adds all tags, except for old-tag.
52
53       The refspec is processed by starting with an empty  set  of  refs,  and
54       walking the list in order from left to right.
55
56       Each  +  using a glob is matched against all relevant refs (a subset of
57       git show-ref) and all matching refs are added to the set.  For example,
58       "+refs/remotes/*" adds all remote refs.
59
60       Each  + without a glob adds the literal value to the set.  For example,
61       "+HEAD^" adds "HEAD^".
62
63       Each - is matched against the set of refs accumulated so far.  Any refs
64       with names that match are removed from the set.
65
66       "reflog"  adds  all  the refs from the reflog. This will make past ver‐
67       sions of files not be considered to be unused  until  the  ref  expires
68       from  the reflog (by default for 90 days). Note that this may make git-
69       annex unused take some time to complete, it if needs to check every ref
70       from the reflog.
71

SEE ALSO

73       git-annex(1)
74
75       git-annex-dropunused(1)
76
77       git-annex-addunused(1)
78

AUTHOR

80       Joey Hess <id@joeyh.name>
81
82                                                           git-annex-unused(1)
Impressum