git-annex-dropunused(1)

git-annex-dropunused1

Drop unused file content

Usage

git annex dropunused [{number | range ...}]

Overview

Drops the data corresponding to the numbers, as listed by the last git annex unused

You can also specify ranges of numbers, such as "1-1000". Or, specify "all" to drop all unused data.

Options

--from=remote

Rather than dropping the unused files from the local repository, drop them from the remote repository.

--force

Use this option with care! It bypasses safety checks, and forces git-annex to delete the content of the specified files, even from the last repository that is storing their content. Data loss can result from using this option.

--jobs=N -JN

Runs multiple drop jobs in parallel. This is particularly useful when git-annex has to contact remotes to check if it can drop content. For example: -J4

Setting this to "cpus" will run one job per CPU core.

--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.

Releases

6 releases since Debian 9 (Stretch); the text changed 2 times.

  1. 9–11
  2. 12
  3. 13–Arch

--json since Debian 13 (Trixie); --json-error-messages since Debian 13 (Trixie).

Author

Joey Hess <[email protected]>

From git-annex 10.20261026-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.