bupstash-gc

SYNOPSIS

Run the garbage collector against a repository, removing unreferenced data and freeing disk space.

bupstash gc [OPTIONS]

DESCRIPTION

bupstash gc walks the repository contents attempting to find unreachable data chunks and removing them, potentially reclaiming disk space.

For periods of time during garbage collection operations that modify the repository (such as bupstash-put) may temporarily fail and report that the repository is busy.

The garbage collector only relies on unencrypted metadata, so does not need access to decryption keys to operate.

OPTIONS

-r, --repository REPO
The repository to connect to and operate on. May be of the form ssh://$SERVER/$PATH for remote repositories if ssh access is configured. If not specified, is set to BUPSTASH_REPOSITORY.
-q, --quiet
Suppress progress indicators (Progress indicators are also suppressed when stderr is not an interactive terminal).

ENVIRONMENT

BUPSTASH_REPOSITORY

The repository to connect to. May be of the form ssh://$SERVER/$PATH for remote repositories if ssh access is configured.

BUPSTASH_REPOSITORY_COMMAND

A command to run to connect to an instance of bupstash-serve. This allows more complex connections to the repository for less common use cases.

SEE ALSO

bupstash, bupstash-repository