shishi_safe_cksum(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_cksum(3) 💖

okay bestie, so this one lives in the shishi manual — third section, library calls, the whole vibe. it's an API function and it's lowkey iconic. let's get into it 🫶

✨ NAME ✨

shishi_safe_cksum — it's an API function, that's the whole name, no notes 💅

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_safe_cksum(Shishi * handle, Shishi_asn1 safe, int32_t *
cksumtype, char ** cksum, size_t * cksumlen);

like yes, that's the whole signature, and yes, you can absolutely copy-paste it, i did it for you 💖

🎀 ARGUMENTS 🎀

  • Shishi * handle — the shishi handle, and it has to be the one you allocated with shishi_init(). no improvising, no bootleg handles, ok? 🙈
  • Shishi_asn1 safe — the safe object, as allocated by shishi_safe(). you gotta have made it first, it's giving prerequisites ✨
  • int32_t * cksumtype — this is an output, bestie. it's where the checksum type comes back to you 🎁
  • char ** cksum — output array holding the newly allocated checksum data from SAFE. brand new buffer, fresh out the function 👑
  • size_t * cksumlen — output size of the output checksum data buffer. so you know exactly how much you got 🍓

🦋 DESCRIPTION 🦋

so what it does is read the checksum value from KRB-SAFE. that's the mission, that's the moment ✨

and here's the part you cannot skip, bestie, because it's the whole ballgame: cksum is allocated by this function, which means it is the responsibility of caller to deallocate it. that's you. you're the caller. you're the main character and the main character frees the memory 💀

not me forgetting to free it… couldn't be me… but fr fr, if you don't free it, that's a leak, and leaks are not slay 🌊

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful. that's it, that's the whole deal. if you see SHISHI_OK you ate 🍽️

💜 REPORTING BUGS 💜

found a bug? don't be shy, don't gatekeep — report it to <bug-shishi@gnu.org> 🐛

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. like, go off, remix 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. it's giving the source of truth, iykyk 📚

okay that's the whole page, bestie, you understood it perfectly, no cap. this was shishi 1.0.3, shishi_safe_cksum(3) — mwah, go free your memory, ily 🫶💖✨

📦 where this page comes from