shishi_authenticator_add_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_add_cksum — the girlies' guide to slapping a checksum on your authenticator 💖

okay so bestie, you're in the shishi manual, section 3, and this little function is the one that goes checksum goes brrr and tucks it right into your authenticator. no cap. let's get into it 🫶

✨ NAME ✨

shishi_authenticator_add_cksum — API function

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_authenticator_add_cksum(Shishi * handle, Shishi_asn1
authenticator, Shishi_key * key, int keyusage, char * data, size_t
datalen);

like, it takes a whole little entourage of args and returns an int. iconic behavior tbh 💅

🎀 ARGUMENTS 🎀

  • Shishi * handle — your shishi handle, the one you already got from shishi_init(). she's the main character, everything runs through her.
  • Shishi_asn1 authenticator — the authenticator, as allocated by shishi_authenticator(). this is the baddie we're decorating ✨
  • Shishi_key * key — the key to use for encryption. (the original says "key to to use for encryption" — yes, to to, we're keeping that typo fr fr, it's part of the lore 🫶)
  • int keyusage — the cryptographic key usage value to use in encryption. very "know your role" energy.
  • char * data — input array with the data you wanna calculate a checksum on.
  • size_t datalen — the size of that input array with the data you wanna calculate a checksum on. her twin, basically 👯

🦋 DESCRIPTION 🦋

Calculate checksum for data and store it in the authenticator.

that's it. that's the whole vibe. you bring the data, she does the math, the authenticator gets the receipts 💖

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful.

and bestie, notice that "iff" — that's if and only if. so if you see SHISHI_OK, you ate. anything else and we need to have a conversation 😭

🙈 REPORTING BUGS 🙈

found a bug? not cute. 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.

(translation: go off, share it, remix it, just keep the receipts. periodt. 💅)

🌈 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.

like, that's the whole encyclopedia, not just this one page. go read it, you'll be obsessed 📚✨

and that's the tea, bestie — this page came straight out of the shishi 1.0.3 manual, section 3, under shishi_authenticator_add_cksum(3). now go checksum something and slay 💖✨🦋

📦 where this page comes from