shishi_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_verify(3) — the shishi manual, bestie edition 💖

okay so you're in the shishi manual pages, section 3, and today's main character is shishi_verify. she checks whether a checksum actually matches the data, no cap. let's get into it 🫶

✨ NAME ✨

shishi_verify — literally an API function, that's her whole job description 💅

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_verify(Shishi * handle, Shishi_key * key, int keyusage, int
cksumtype, const char * in, size_t inlen, const char * cksum, size_t
cksumlen);

✨ ARGUMENTS ✨

  • Shishi * handle — your shishi handle, the one you got from shishi_init(). she's the whole vibe, everything runs through her 🎀
  • Shishi_key * key — the key we're verifying the checksum with. yes queen, bring your own key 🔑
  • int keyusage — an integer saying what this key is actually used for. context matters bestie ✨
  • int cksumtype — which checksum algorithm we're using. pick your fighter 💅
  • const char * in — input array holding the data that got integrity protected. the protected data, periodt 🛡️
  • size_t inlen — how big that input array with the integrity-protected data is. size check 📏
  • const char * cksum — input array with the alleged checksum of the data. alleged!! we're investigating 🔍
  • size_t cksumlen — size of that input array with the alleged checksum. 📏

✨ DESCRIPTION ✨

so basically: verify the checksum of your data using key, and it might get altered by the supplied key usage. 🌸

important one, bestie: if key usage is 0, no key derivation is used. that's the rule, fr fr.

✨ RETURN VALUE ✨

Returns SHISHI_OK iff it worked. iff!! so if you don't get SHISHI_OK, something is giving ✨not ok✨ 😭

✨ REPORTING BUGS ✨

found a bug? don't suffer in silence, tell the devs 💌

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 👑

✨ 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 it, iykyk 📖✨

and that's the whole page bestie 💖 this was shishi version 1.0.3, page shishi_verify(3), and you absolutely ate this read-through. go verify some checksums, you've got this 🦋🌸💅

📦 where this page comes from