git-annex-calckey(1)

🌸 NAME 🌸

git-annex-calckey — calculate key for a file 💫

✨ SYNOPSIS ✨

git annex calckey [file ...]

💖 DESCRIPTION 💖

okay bestie, listen up, because this one is plumbing-level, which basically means it's the behind-the-scenes machinery kind of command, not the pretty front-door one. 🎀

What it does: it calculates the key that would be used to refer to a file. And here's the important part — the file is not added to the annex by this command. It's just doing the math, being a lil calculator, no commitment, no strings. 🧮✨

The key gets output to stdout. That's it. That's the whole vibe.

So which backend is doing the keying? It's the one from the annex.backend configuration setting. But (and this is the fun part) you can override that with the --backend option. Like, say you wanna force use of the SHA1 backend:

git annex calckey --backend=SHA1 file

slay. 💅

👑 OPTIONS 👑

• --backend=name — Specifies which key-value backend to use. that's the override, the "actually, I want this one" move 🫶
• --batch — Enable batch mode, bestie. In this mode a line containing the filename gets read from stdin, then the key is output to stdout (with a trailing newline, don't forget the newline, she's important), and then it repeats. over and over. iconic loop behavior. 🔁
• -z — Makes the --batch input be delimited by nulls instead of the usual newlines. yeah. nulls. for when newlines are simply not the moment. 🌈

Also the git-annex-common-options(1) can be used. those are always invited to the party. 🎉

🦋 SEE ALSO 🦋

git-annex(1)

💜 AUTHOR 💜

Joey Hess <id@joeyh.name>

and that's the whole page, no cap. this was the git-annex-calckey(1) manual page from the General Commands Manual — part of git-annex, written by Joey Hess, and the footer just says git-annex-calckey(1) right back at you like a little mirror. mwah. 💋