Provided by: git-annex_10.20250416-2ubuntu1_amd64 bug

NAME

       git-annex-expire - expire inactive repositories

SYNOPSIS

       git annex expire [repository:]time ...

DESCRIPTION

       This command expires repositories that have not performed some activity within a specified time period. A
       repository  is  expired by marking it as dead. De-expiration is also done; if a dead repository performed
       some activity recently, it is marked as semitrusted again.

       This can be useful when it's not possible to keep track  of  the  state  of  repositories  manually.  For
       example,  a  distributed network of repositories where nobody can directly access all the repositories to
       check their status.

       The repository can be specified using the name of a remote, or the description or uuid of the repository.

       The time is in the form "60d" or "1y". A time of "never" will disable expiration.

       If a time is specified without a repository, it is used as the default value for all  repositories.  Note
       that the current repository is never expired.

OPTIONS

       --no-act

              Print out what would be done, but not not actually expire or unexpire any repositories.

       --activity=Name
              Specify  the activity that a repository must have performed to avoid being expired. The default is
              any activity.

              Currently, the only activity that can be performed to avoid expiration  is  --activity=Fsck  which
              corresponds  to  git  annex fsck.  Note that fscking a remote updates the expiration of the remote
              repository, not the local repository.

              The first version of git-annex that recorded fsck activity was 5.20150405.

       --json Enable JSON output. This is intended to be parsed by programs that use  git-annex.  Each  line  of
              output is a JSON object.

       --json-error-messages
              Messages that would normally be output to standard error are included in the JSON instead.

       Also the git-annex-common-options(1) can be used.

SEE ALSO

       git-annex(1)

       git-annex-fsck(1)

       git-annex-schedule(1)

       git-annex-dead(1)

       git-annex-semitrust(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                                             git-annex-expire(1)