SHISA(1)

📦
version 1.0.3 · 2 versions
  • 1.0.3 · debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.0.2 · ubuntu jammy
, in debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

👑 SHISA — the Shishi database interface, bestie edition

okay so hi!! you found shisa(1), which lives in the User Commands corner of the manual-verse. it's the little tool that lets you poke at the Shishi user database and honestly? it's giving main character energy. let's go 💅

✨ NAME ✨

shisa — Shishi database interface

no cap, that's the whole name. short, iconic, done.

🌸 SYNOPSIS 🌸

shisa [OPTION]... [REALM [PRINCIPAL]]...

so you hand it some options, and optionally a REALM, and optionally a PRINCIPAL, and it just... does the thing. periodt.

💖 DESCRIPTION 💖

Manipulate information stored in the Shisa user database. that's the vibe. you're literally rearranging the little filing cabinet of realms, principals and keys. 🗂️✨

  • -h, --help — Print help and exit. your "what do I do now" button 🫶
  • -V, --version — Print version and exit. show me the numbers, bestie 📢

🧚 Operations:

these are the do the thing flags. pick your fighter:

  • -a, --add — Add realm or principal to database. new friend unlocked 🔓
  • -d, --dump — Dump entries in database. spill the whole tea pot ☕
  • -n, --key-add — Add new key to a principal in database. key #2 just dropped 🔑
  • --key-remove — Remove a key from a principal in database. bye key, hope you had a nice life 👋
  • -l, --list — List entries in database. the receipts, laid out neatly 📋
  • -m, --modify — Modify principal entry in database. glow-up time 💅
  • -r, --remove — Remove realm or principal from database. blocked and reported 🚫

🎀 Parameters:

the mood-setters, the little toggles that change how the operation behaves:

  • -f, --force — Allow removal of non-empty realms. (default=off). dangerous girlie behaviour, use with intention 🔥
  • --enabled — Only dump or list enabled principals. (default=off)
  • --disabled — Only dump or list disabled principals. (default=off)
  • --keys — Print cryptographic key and password in hostkey format. (default=off)

⭐ Values:

the actual stuff you feed in. copy these exactly, no improvising:

  • -E, --encryption-type=STRING — Override default key encryption type. Valid values include 'aes128', 'aes256', 'aes' (same as 'aes256'), '3des', 'des-md5', 'des-md4', 'des-crc', 'des' (same as 'des-md5'), and 'arcfour'.
  • --key-version=NUMBER — Version of key.
  • --password[=STRING] — Derive key from this password.
  • --priority=NUMBER — Specify key priority, used to differentiate between keys when multiple keys are eligible for use. Higher value means higher priority. (default is 0, which mean a random key of the best etype is chosen)
  • --random — Use a random key. (default)
  • --salt=STRING — Use specified salt for deriving key. Defaults to concatenation of realm and (unwrapped) principal name.
  • --string-to-key-parameter=HEX — Encryption algorithm specific parameter for password derivation. Currently only the AES algorithm can utilize this, where it is interpreted as the iteration count of the PKCS#5 PBKDF2 key deriver.
lowkey obsessed with that last one tbh. AES said "I'll take the PKCS#5 PBKDF2 iteration count, thanks" and nobody else showed up. 🧂

🌈 Other options:

  • -c, --configuration-file=FILE — Use specified configuration file.
  • -o, --library-options=STRING — Parse string as configuration file statement.
  • -v, --verbose — Produce verbose output. (default=off). yapper mode: ON 🗣️
  • -q, --quiet — Don't produce any diagnostic output. (default=off). silent treatment, but productive 🤫

Mandatory arguments to long options are mandatory for short options too. yes bestie, it's real, the rules apply to the short ones too 😭

🫶 AUTHOR 🫶

Written by Simon Josefsson. king behaviour, we stan 👑

🐛 REPORTING BUGS 🐛

found a glitch? not the cute kind? tell them:

Copyright © 2022 Simon Josefsson. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.

This is free software: you are free to change and redistribute it.

There is NO WARRANTY, to the extent permitted by law. (like, none. zero. don't come for them if it goes sideways 💀)

🔍 SEE ALSO 🔍

The full documentation for shisa is maintained as a Texinfo manual. If the info and shisa programs are properly installed at your site, the command

info shishi

should give you access to the complete manual. iykyk 🦋

and that's the whole page, bestie!! ✨ GNU Shishi 1.0.3, August 2022, and it's still slaying to this very day. go forth and manipulate that database responsibly 💖🎀🫶

📦 where this page comes from