shishi_priv_process(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

💖 shishi_priv_process(3) — the glow-up edition 💖

okay bestie, welcome to section 3 of the shishi manual, where we handle library functions and the ✨cryptographic✨ side of life. this one's called shishi_priv_process, and no, it's not about your priv(ate) business, it's about KRB-PRIV. close enough tho 🎀

🌸 NAME 🌸

shishi_priv_process — an API function, periodt. it does one job and it does it well 💅

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_priv_process(Shishi_priv * priv, Shishi_key * key);

like, that's it. two args, one int back. lowkey elegant fr fr 🦋

🫶 ARGUMENTS 🫶

  • Shishi_priv * priv — the priv thingy, and you gotta get it from shishi_priv() first. it's not something you just manifest out of thin air, bestie 😭
  • Shishi_key * key — the key that's gonna do the decrypting of the EncPrivPart. this is the main character of the operation, no cap 🔑

💜 DESCRIPTION 💜

so here's the vibe: this function decrypts the encrypted data inside a KRB-PRIV message, and then it sets the EncPrivPart in the PRIV exchange. that's the whole storyline, and honestly? iconic.

you bring the priv, you bring the key, it handles the rest. slay ✨

🌈 RETURN VALUE 🌈

it comes back with one of these, so listen up:

  • SHISHI_OK — the good ending 💖 success, we ate, no crumbs
  • SHISHI_PRIV_BAD_KEYTYPE — the key type you used is incompatible. wrong key, bestie, it's giving mismatch 😭
  • SHISHI_CRYPTO_ERROR — the actual decryption itself failed. not a vibe. not a slay. 💀
ok but real talk: check that return value. don't just assume it worked and move on, that's how you end up in the group chat asking why nothing works 🙈

🐛 REPORTING BUGS 🐛

found a bug? first of all, rude, second of all, tell the devs:

they genuinely wanna hear it, so don't be shy 🫶

Copyright © 2002-2022 Simon Josefsson.

and the licensing tea: 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. so like, go off, just keep the receipts 🧚

🦋 SEE ALSO 🦋

the full documentation for shishi lives in a Texinfo manual. if the info and shishi programs are properly installed at your site, this command:

info shishi

should give you access to the complete manual. iykyk 📖✨

ok that's the whole page bestie, you're officially educated 💅

shishi version 1.0.3, manual page shishi_priv_process(3) — mwah, go forth and decrypt responsibly 💖✨🎀

📦 where this page comes from