shishi_authenticator_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_authenticator_cksum ✨

okay bestie, so this one is a function from the shishi library — section 3, the library-calls girlies 💅. It's called shishi_authenticator_cksum, and no cap, it's the one that goes digging through your authenticator for the checksum and hands it back to you. Let's get into it 🫶

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_authenticator_cksum(Shishi * handle, Shishi_asn1
authenticator, int32_t * cksumtype, char ** cksum, size_t * cksumlen);

like... it's giving "one function, five arguments, zero drama" ✨

🎀 ARGUMENTS 🎀

  • Shishi * handle — the shishi handle, the one you got from shishi_init(). Your whole main character, fr.
  • Shishi_asn1 authenticator — the authenticator, as allocated by shishi_authenticator(). She's the one we're snooping through 🔍
  • int32_t * cksumtype — output checksum type. We write the type in here for you 💖
  • char ** cksum — newly allocated output checksum data from the authenticator. Fresh out the function, just for you 🎁
  • size_t * cksumlen — on output, the actual size of the allocated output checksum data buffer. She's telling you how much you got, periodt.

💫 DESCRIPTION 💫

So basically: it reads the checksum value out of the authenticator. That's it, that's the whole vibe.

Now listen carefully because this is the part that matters 👑 — cksum gets allocated by this function, and it is the responsibility of the caller to deallocate it. Translation bestie: she made you a gift, you gotta throw out the wrapping yourself. Don't leave that memory just vibing in your process forever 😭

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful. That's the good ending, the slay ending, the one we want 🌈

🦋 REPORTING BUGS 🦋

Found a bug? Not the cute kind? 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. (iconic, honestly — free to copy, 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. go read her, she's thorough 📚

okay and that's the whole page!! written for shishi version 1.0.3 — section 3 of the manual, bestie, and yes this is the last line so this is me signing off 💅✨ bye ily, go deallocate your cksum 🫶

📦 where this page comes from