git-annex-unregisterurl(1)

📦
version 10.20261026 · 4 versions
, in alpine 3.24, arch rolling, nixos 26.05, nixpkgs unstable

💅 git-annex-unregisterurl 💅

okay bestie, welcome to the git-annex-unregisterurl manual page, straight out of the General Commands Manual ✨ this one's a plumbing-level icon and honestly she's so real for that 🫶

🎀 NAME 🎀

git-annex-unregisterurl — unregisters an url for a key, no cap 💅

🌸 SYNOPSIS 🌸

git annex unregisterurl [key url]

🦋 DESCRIPTION 🦋

okay so this is a plumbing-level command, and what she does is let you unregister urls when keys can no longer be downloaded from them 😭 like when a link is dead and you're just done with it, periodt.

Normally the key is a git-annex formatted key, that's the standard vibe ✨. BUT here's the fun part — when the key cannot be parsed as a key, and is a valid url, a key is generated from the url 👑 she's resourceful like that.

now the important lore bestie: unregistering a key's last web url will make git-annex no longer treat content as being present in the web special remote 🫶 that's real. And if some other special remote claims the url, unregistering the url will not update presence information for it, because the content may still be present on the remote 😭 like she's not gonna lie to you about what's where.

✨ OPTIONS ✨

  • --remote=name|uuid — Indicate that the url is expected to be claimed by the specified remote 💖. If some other remote claims the url instead, unregistering it will fail 💀. Also huge note: --remote=web will prevent any other remote from claiming the url, so that's the guardrail move 🛡️
  • --batch — In batch input mode, lines are read from stdin, and each line should contain a key and url, separated by a single space 🍓 (yes, a single space, be normal about it)
  • -z — When in batch mode, the input is delimited by nulls instead of the usual 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 ✨
  • --json-error-messages — Messages that would normally be output to standard error are included in the JSON instead 🙈 so the errors get tucked into the JSON too

Also the git-annex-common-options(1) can be used, bestie, those are always in the group chat 🫶

💜 SEE ALSO 💜

👑 AUTHOR 👑

Joey Hess <id@joeyh.name> — icon behavior, honestly 🎀

and that's the whole page bestie!! this one came from git-annex-unregisterurl(1) in the General Commands Manual, dated with the rest of that doc set, and it was literally a whole vibe — go unregister some urls, slay 💅✨🦋🌸🫶💖

📦 where this page comes from