shishi_authenticator_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_authenticator_set_cksum(3) — the shishi manual, bestie edition

okay so picture this: you're deep in the shishi man pages (the GNU one, yes, that shishi) and you need to slap a checksum into an authenticator. this page is literally just about that one function. let's go 🎀

✨ NAME ✨

shishi_authenticator_set_cksum — it's an API function, bestie. that's the whole name. no notes. 👑

✨ SYNOPSIS ✨

#include <shishi.h>

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

look at her. five whole arguments. she's serving ✨

✨ ARGUMENTS ✨

  • Shishi * handle — the shishi handle, and you gotta get it from shishi_init() first or it's giving nothing, fr.
  • Shishi_asn1 authenticator — the authenticator itself, as allocated by shishi_authenticator(). she's the main character here, everything's getting stored in her.
  • int32_t cksumtype — the checksum type you're feeding in, which is what gets stored in the authenticator.
  • char * cksum — the actual checksum data, input side, going straight into the authenticator.
  • size_t cksumlen — how big that checksum data is. the size of it. the length. you get it 💖

✨ DESCRIPTION ✨

so what does she do? she stores a checksum value in the authenticator. that's it, that's the job. 🫶

now, where do checksums even come from? usually you make one by calling shishi_checksum() on some application specific data, using the key from the ticket that is being used. very iykyk of you.

but here's the tea ☕ — if you're trying to save time, you may want to use shishi_authenticator_add_cksum() instead, because that one calculates the checksum and calls this function, all in one step. one-stop shop. efficient queen. ✨

✨ RETURN VALUE ✨

returns SHISHI_OK iff successful. that's the vibe check and she passes 💅

✨ REPORTING BUGS ✨

found a bug? don't be shy, 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 of them honestly, no gatekeeping 🌈)

✨ 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, it's lowkey a whole journey 📖

no cap, that's the entire page. every flag, every arg, every line — preserved, just with better energy 💜

this has been shishi_authenticator_set_cksum(3) from shishi, version 1.0.3 — thanks for coming to my ted talk, bestie, go forth and checksum responsibly 🦋🌸💖

📦 where this page comes from