shishi_key_print(3)

📦
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

💖 NAME 💖

shishi_key_print — it's an API function, bestie. That's the whole name. Short, sweet, iconic.

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_key_print(Shishi * handle, FILE * fh, const Shishi_key * key);

🎀 ARGUMENTS 🎀

  • Shishi * handle — your Shishi handle, the one you got from shishi_init(). Yes, that exact one. Don't be weird about it.
  • FILE * fh — a file handle that's open for writing. Open for writing, okay? It's giving "please have somewhere to put this."
  • const Shishi_key * key — the key we're printing. That's it. That's the girl.

🦋 DESCRIPTION 🦋

Okay so this function prints an ASCII representation of a key structure, key, and sends it straight to the file descriptor fh. It's literally just "make the key readable, put it in the file." Simple. Elegant. No notes.

Here's what the output looks like, bestie:

-----BEGIN SHISHI KEY-----

KEYTYPE
18 (aes256-cts-hmac-sha1-96)

PRINCIPAL
host/latte.josefsson.org

REALM
JOSEFSSON.ORG Key-Version-Number: 1

TIMESTAMP
20130420150337Z

P1QdeW/oSiag/bTyVEBAY2msiGSTmgLXlopuCKoppDs= -----END SHISHI KEY-----

Not me getting emotional over a -----BEGIN SHISHI KEY----- header. It's giving ✨certificate core✨ and honestly? Slay.

⭐ RETURN VALUE ⭐

Returns SHISHI_OK when it works — which it will, because she's a good function. The only failure mode is SHISHI_MALLOC_ERROR, so like... if it breaks, it's the memory's fault, not hers. Periodt.

💀 REPORTING BUGS 💀

Found a bug? Do NOT suffer in silence, go tell someone. Report bugs to <bug-shishi@gnu.org>.

GNU Shishi home page: http://www.gnu.org/software/shishi/

General help using GNU software: http://www.gnu.org/gethelp/

Copyright © 2002-2022 Simon Josefsson.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

(No cap — you really can copy and distribute it, no royalty, just keep the notice. Respect the rules and you're golden. 🫶)

🌈 SEE ALSO 🌈

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

info shishi

should give you access to the complete manual. iykyk — go read the manual, it's the main character for a reason. 👑

And that's the whole page, bestie!! This was shishi_key_print(3), living in shishi version 1.0.3, and the date on her birth certificate is... also part of the footer vibe. Anyway, ily, go print some keys. 💅✨🎀

📦 where this page comes from