git-annex-rekey(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-rekey(1) ✨

okay bestie, welcome to the General Commands Manual page for git-annex-rekey 💖 this is the one where you swap out the key a file is using, and honestly? it's giving glow-up for your annex.

🌸 NAME 🌸

git-annex-rekey — change keys used for files 💅

🎀 SYNOPSIS 🎀

git annex rekey [file key ...]

🦋 DESCRIPTION 🦋

so. this is a plumbing-level command, which basically means it's the low-level wiring, not the pretty front door. it's similar to migrate, but here's the twist: you get to specify both the file and the brand new key you want it to use. main character energy, honestly 👑

you can hand it multiple pairs of file and key in one single command line, no need to run it a million times. slay 🫶

⚠️ but listen — and this is important, no cap — unlike git-annex migrate, this does not copy over metadata, urls, and other such information from the old key to the new key. the old key's extra info does not come with. it stays behind. periodt 💀

💖 OPTIONS 💖

  • --force — allow rekeying of even files whose content is not currently available. Use with caution. 🚨 (like, genuinely, be careful bestie — this is the "yes I know what I'm doing" button)
  • --batch — turns on batch mode, where lines get read from stdin. each line should contain the file, and the new key to use for that file, separated by a single space. feed it a whole stream of them, go off 🌈
  • -z — makes the --batch input be delimited by nulls instead of the usual newlines. for when your filenames are feral and contain newlines 🙈
  • --json — enable JSON output. This is intended to be parsed by programs that use git-annex. Each line of output is a JSON object. 🤖 (machines love this one)
  • --json-error-messages — messages that would normally be output to standard error are included in the JSON instead. so all the sad stuff gets folded into the json, cute ✨

Also the git-annex-common-options(1) can be used. don't forget about the classics 💜

🌈 SEE ALSO 🌈

👑 AUTHOR 👑

Joey Hess <id@joeyh.name> — an absolute legend, fr fr 🫡

and that's the whole vibe check, bestie 🎀 this was git-annex-rekey(1) from the General Commands Manual, and yes, the footer really does just say git-annex-rekey(1) again — the manpage said it twice because it knew it ate 💅 go rekey something iconic, i believe in you 🌟

📦 where this page comes from