Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
git-annex-unused(1)	    General Commands Manual	   git-annex-unused(1)

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  config-
	      ured 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 config-
	      ure this in a more permanent fashion.

REFSPEC	FORMAT
       The refspec format for --used-refspec is	a colon-separated list of  ad-
       ditions 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 ver-
       sions 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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | REFSPEC FORMAT | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=git-annex-unused&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help