git-annex-dropunused(1)

📦
version 10.20261026 · 3 versions
, in alpine 3.24, arch rolling, debian trixie, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💅 git-annex-dropunused — drop unused file content

okay bestie, this is the git-annex-dropunused(1) page from the General Commands Manual, and it's literally about yeeting the file content you're not using anymore. let's get into it 🎀

✨ SYNOPSIS ✨

git annex dropunused [number|range ...]

🌸 DESCRIPTION 🌸

so here's the vibe: dropunused drops the data that corresponds to the numbers you give it — and those numbers are the ones listed by the last git annex unused. like, the most recent run of it, not some old one from three weeks ago. iykyk 👑

you can also hit it with ranges of numbers, like "1-1000". super handy when you've got a whole lil pile to clear out.

or, if you're feeling feral and want it ALL gone, just say "all" and it drops every single bit of unused data. periodt 💀

👑 OPTIONS 👑

  • --from=remote — instead of dropping the unused files from the local repo, you drop them from the remote repository instead. not me making the remote do the work 🙈
  • --force — okay so use this one with care, fr fr. it bypasses the 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 literally result from using this option. this is giving main character energy in the worst way possible, please be careful.
  • --jobs=N, -JN — runs multiple drop jobs in parallel. this is highkey 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. slay, let the machine cook 🔥

  • --json — enable JSON output. this is intended to be parsed by programs that use git-annex. each line of output is a JSON object. very demure, very machine-readable 💖
  • --json-error-messages — messages that would normally be output to standard error are included in the JSON instead. no stray stderr, just vibes 🌈

also the git-annex-common-options(1) can be used. go read those too bestie, they're iconic 🫶

🦋 SEE ALSO 🦋

🎀 AUTHOR 🎀

Joey Hess <id@joeyh.name> — absolute legend, no cap 👑

and that's the whole page bestie!! this was git-annex-dropunused(1) from the git-annex manual — go forth and drop responsibly, and don't touch --force unless you truly mean it 💜✨

📦 where this page comes from