trocla(1)

✨ NAME ✨

trocla — the trocla executable, bestie 💖 (yes that's literally the whole name section, the manpage said "trocla executable" and I'm not gonna lie to you)

This is the manual page for trocla, from the General Commands Manual, and we're about to make it make sense 🫶

---

🌸 SYNOPSIS 🌸

okay so here's the whole vibe in two lines:

trocla (--help | --version)
trocla [--config | --trace] SUBCOMMAND [ARGS]

Like — either you're asking for help/version, or you're passing an optional config/trace flag and then a subcommand plus its args. That's it. That's the shape of it. 💅

---

💜 DESCRIPTION 💜

trocla is a password store for password creation and retrieval. 🎀

That's the whole thing, no cap — it keeps your passwords, it makes new ones, it hands them back when you ask nicely. Main character energy fr fr ✨

---

👑 OPTIONS 👑

these are the top-level flags, they go before your subcommand:

• -c, --config — path to the configuration file 🗂️
• -h, --help — show the help message and then dip out 👋
• --trace — show a stack trace when things fail (so you can actually see where it went wrong) 💀
• -V, --version — show the version number and exit, iconic ⭐

---

🦋 SUBCOMMANDS 🦋

this is where the actual work happens, babes 🧚

• create [--length | --no-random ] <key> <format> — makes a random password (only if one isn't already stored in trocla for that key) and stores its plain text under the key you specified. Heads up: some formats need extra options to work 😭
  • use --length to set how long the generated password should be 📏
  • use --no-random to skip generating a random password when there's no plain password already available for this key 🚫
• get <key> <format> — returns a stored password. And like, that's all it does — if there's nothing there, it will not create one for you 🙈
• set [--no-format | (-p | --password) <password>] <key> <format> — prompts you for a plain password and saves it under the right key/format. Alternatively you can feed the password in through standard input or with file redirection 🍓
  • use --no-format to hand over an already-formatted password and store it without a matching plain password 🎀
  • use --password to put the password straight on the command-line, no prompting 💅
• reset <key> <format> — recreates a salted shadow-style hash without creating a new plain text password. And lowkey important: if a plain password exists for this key, all the previously hashed passwords get deleted 🔥
• delete <key> [format] — deletes the passwords at the given key, and optionally at a specific format too 🗑️
• formats — lists all the available, supported formats 🌈
• search <string> — searches your password store keys for the given string. Heads up: this one only works with the Sequel and YAML backends! The string can be a regular expression 👀

---

💀 BUGS 💀

found a bug? rude. but okay, report it to your distribution's bug tracker, or upstream at <https://github.com/duritong/trocla/issues> 🐛

---

🌟 SEE ALSO 🌟

for more info, go read /usr/share/doc/trocla/README.md — it's giving required reading, iykyk 📖

---

💖 AUTHOR 💖

Jérôme Charaoui ✨

---

and that's the whole page, bestie!! this one's from 2023, it's the trocla(1) page under the General Commands Manual, and you absolutely ate reading the whole thing 🫶💅 mwah, go store some passwords 💜