shishi_safe_set_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_set_cksum — like, the SAFE checksum setter, bestie 💖

okay so bestie, welcome to shishi_safe_set_cksum(3), a page from the shishi manual. yes it's a C API thing. yes you're gonna slay it. let's go 🦋

✨ NAME ✨

shishi_safe_set_cksum — API function. that's it. that's the whole name section. short king 👑

🌸 SYNOPSIS 🌸

#include <shishi.h>

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

look at her. iconic signature. no notes 💅

🎀 ARGUMENTS 🎀

  • Shishi * handle — the shishi handle, as allocated by shishi_init(). like, you gotta have one of these or we're not doing anything, fr fr.
  • Shishi_asn1 safe — the safe, as allocated by shishi_safe(). your little SAFE object, the main character of this whole function 💖
  • int32_t cksumtype — input checksum type to store in SAFE. yep, the type. which flavour of checksum we're putting in there.
  • const char * cksum — input checksum data to store in SAFE. the actual bytes, bestie, the good stuff ✨
  • size_t cksumlen — size of input checksum data to store in SAFE. how many bytes of cksum we're actually using. don't lie about this one 🙈

💜 DESCRIPTION 💜

so what are we doing? we're storing a checksum value in SAFE. that's the vibe. that's the assignment. 📝

a checksum is usually created by calling shishi_checksum() on some application specific data, using the key from the ticket that is being used. iykyk 🔑

and listen — if you're in your efficiency era and wanna save time, you may want to use shishi_safe_build() instead. that one calculates the checksum and calls this function in one step. two birds, one gorgeous function call 🐦🐦 no cap.

👑 RETURN VALUE 👑

Returns SHISHI_OK iff successful. and like, that's the only good outcome here. if you don't get SHISHI_OK, something's giving... not it. 😭

🫶 REPORTING BUGS 🫶

found a bug? not me being the one to find bugs, but okay, if you did — report bugs to <bug-shishi@gnu.org>.

they wanna hear from you, bestie. spill 🍓

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: use it, share 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.

like, go read it. it's giving ✨comprehensive✨ 🧚

reminder bestie: every flag, every arg, every byte stayed exactly where it was. the vibe is new, the facts are not. periodt 💅

mwah 💋 that was shishi_safe_set_cksum(3) from shishi version 1.0.3 — tysm for reading, go forth and checksum responsibly, ily, bye!! 💖🦋🌸

📦 where this page comes from