git-annex-reregisterurl(1)

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

💖 git-annex-reregisterurl(1) 💖

okay bestie, so this is a page from the General Commands Manual — it's the one all about git-annex-reregisterurl, and fr fr it's a little plumbing gremlin that fixes up your url registration tea. let's get into it 🫶

✨ NAME ✨

git-annex-reregisterurl — updates url registration information 🌸

✨ SYNOPSIS ✨

git annex reregisterurl [key]

✨ DESCRIPTION ✨

so like. this is a plumbing-level command (iykyk — plumbing commands are the ones scripts use, not the cute porcelain ones you'd type by hand). what it does is update the info about the urls that are registered for a key. that's it, that's the whole vibe. 💅

✨ OPTIONS ✨

  • --move-from=name|uuid — for each key, this takes any urls that are currently claimed by the remote you name here and switches them over to be used by the web special remote instead. 🦋

the classic use case: a special remote had to be in the mix to provide authorization to get an url, but now that url is publically available, so the web special remote can just handle it directly. glow up moment for that url honestly.

⚠️ heads up, no cap: just like git-annex unregisterurl, using this option unregisters an url from a special remote, but it does not mark the content as not present in that special remote. so the content is still there, it's just not registered anymore. HOWEVER — and this is the other half — just like git-annex registerurl, this option does mark the content as being present in the web special remote. so it's giving "moved out but the old place still has your stuff, and the new place thinks you live there now." 😭
  • --batch — batch input mode! lines get read from stdin, and each line should contain a key. one key per line, very demure, very mindful. 📥
  • -z — when you're in batch mode, this makes the input delimited by nulls instead of the usual newlines. for when your keys are feeling chaotic and newline-free. ✨
  • --json — turns on JSON output. this is meant to be parsed by programs that use git-annex, so it's not really for human eyeballs. each line of output is a JSON object. 🤖
  • --json-error-messages — messages that would normally go to standard error get included in the JSON instead. everything in one tidy little json basket. 🧺

also, the git-annex-common-options(1) can be used with this. yes, those ones. they're always invited to the party. 👑

✨ SEE ALSO ✨

✨ AUTHOR ✨

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

and that's the whole page bestie!! this was git-annex-reregisterurl(1) straight out of the General Commands Manual, and yeah, the footer down at the bottom was just the page name doing its little encore — git-annex-reregisterurl(1) — no extra version or date drama on this one, she's mysterious like that. 💜✨

📦 where this page comes from