shishi_safe_verify(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_safe_verify(3) ✨

okay bestie, pull up a chair 🫶 this one is shishi_safe_verify from the shishi manual, section 3, and it's literally just here to check a checksum for you. let's get into it 💅

💖 NAME 💖

shishi_safe_verify — it's an API function, bestie. that's the whole name. no cap.

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_safe_verify(Shishi_safe * safe, Shishi_key * key);

🎀 ARGUMENTS 🎀

  • Shishi_safe * safe — the safe, as allocated by shishi_safe(). like, the one you already made earlier. don't come at me with a random pointer, she needs to be a real one 🦋
  • Shishi_key * key — the key for the session, used to verify the checksum. yes, this key. the session one. she's doing the verifying 👑

💫 DESCRIPTION 💫

so what does she actually do? she verifies the checksum in KRB-SAFE. that's it. that's the job. iconic.

⚠️ okay important — this follows RFC 1510bis and is incompatible with RFC 1510. like, genuinely incompatible. the manpage says "presumably few implementations use the RFC1510 algorithm", so it's probably fine, but girl. be aware. 🙈

🔥 RETURN VALUE 🔥

here's the tea on what she hands back:

  • SHISHI_OK — returns this iff successful. slay ✨
  • SHISHI_SAFE_BAD_KEYTYPE — if an incompatible key type is used. wrong key type bestie, it's giving mismatch 💀
  • SHISHI_SAFE_VERIFY_FAILED — if the actual verification failed. the verify did not verify. 😭

🌈 REPORTING BUGS 🌈

found a bug? don't suffer in silence, tell the girlies (the maintainers):

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.

(translation: go off, copy it, just keep the receipts 🧚)

🍓 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 📖

mwah 💜 that's the whole page. this was shishi version 1.0.3, page shishi_safe_verify(3) — stay safe out there and verify those checksums, bestie. periodt. 💅✨

📦 where this page comes from