git-annex-setpresentkey(1)

💖 git-annex-setpresentkey — change records of where key is present 💖

okay bestie, welcome to the git-annex-setpresentkey(1) page, straight out of the General Commands Manual ✨ this one's a lil niche but it's so real, let's get into it 🫶

✨ SYNOPSIS ✨

git annex setpresentkey key uuid [1|0]

that's it. three-ish args and a vibe. slay 💅

🌸 DESCRIPTION 🌸

so. this is a plumbing-level command, which is a fancy way of saying it's the under-the-hood one, not the one you'd casually type on a Tuesday. what it does is change git-annex's records about whether the specified key's content is present in a remote with the specified uuid. it's literally editing the bookkeeping, no cap 📚

and then the big question: do you pass a 1 or a 0?

• 1 — indicates the key is present ✅
• 0 — indicates the key is not present ❌

iconic little binary moment. it's giving binary. it's giving boolean. we love her 💜

✨ OPTIONS ✨

• --batch — turns on batch mode, where lines get read from stdin 🧚 the line format is exactly "key uuid [1|0]" — keep it in that shape, bestie, don't freestyle it 🙈
• --json — enables JSON output. this is meant to be parsed by programs that use git-annex, so like, robots eat this one, not you 🎀 every line of output is a JSON object.
• --json-error-messages — messages that would normally go out to standard error get tucked into the JSON instead 📦 so everything lands in one tidy lil stream.
• also the git-annex-common-options(1) can be used, periodt 🔥

👑 SEE ALSO 👑

• git-annex(1)

💖 AUTHOR 💖

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

okay that's the whole page!! tysm for reading, you ate that 💅

this was git-annex-setpresentkey(1) from the General Commands Manual — go forth and set those present-keys correctly, bestie 🦋🌸✨