git-annex-dropkey(1)

💖 git-annex-dropkey(1) 💖

okay bestie, welcome to the General Commands Manual corner of the git-annex universe — this is the page for git-annex-dropkey, and yes it's a whole vibe, but a dangerous one so pls read the warning, fr fr 🫶

✨ NAME ✨

git-annex-dropkey — drops annexed content for specified keys 💅

🌸 SYNOPSIS 🌸

git annex dropkey [key ...]

🦋 DESCRIPTION 🦋

So here's the tea: this is a plumbing-level command, which is a fancy way of saying it's down in the pipes doing the raw work, no cute user-friendly wrapper, no hand-holding. It drops the annexed data for the keys you name, from this repository. gone. poof. 🫧

And here's why that's lowkey iconic: you can use it to drop content for arbitrary keys, which means those keys do not need to have a file in the git repository pointing at them. No file, no pointer, no problem — the key itself is enough. main character energy tbh 👑

⚠️ Warning: This command does not check that enough other copies of the content exist. Using it can easily result in data loss. ⚠️

Not me being dramatic — that's literally what it says. It does not vibe check your backups first. It does not ask around. It just drops. So if that content only lived here... it's gone gone, no cap 😭💀

🎀 OPTIONS 🎀

• --batch — Enables batch mode, where the lines containing the keys to drop are read from stdin. Yes bestie, you feed it keys line by line like a little conveyor belt of deletion. 🍓
• --json — Enable JSON output. This is intended to be parsed by programs that use git-annex. Each line of output is a JSON object. Machine-readable slay ✨
• --json-error-messages — Messages that would normally be output to standard error are included in the JSON instead. So your error gossip gets tucked into the JSON too, no stray stderr crumbs 🙈

Also the git-annex-common-options(1) can be used. so many options, we love options 🌈

👀 SEE ALSO 👀

• git-annex(1)
• git-annex-setkey(1)

💜 AUTHOR 💜

Joey Hess <id@joeyh.name> — the icon, the legend, the blueprint 👑

that's the whole page babes — git-annex-dropkey(1), straight from the General Commands Manual section, written by Joey Hess, and delivered to you with love and a healthy fear of data loss 🧚💖 periodt.