shishi_dr(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_dr ✨

okay bestie, buckle up, this is shishi_dr(3) from the shishi manual and it's literally the glow-up of "where do random numbers come from" 💖

🎀 NAME 🎀

shishi_dr — an API function, no cap. that's it, that's the name 💅

🦋 SYNOPSIS 🦋

#include <shishi.h>

int shishi_dr(Shishi * handle, Shishi_key * key, const char *
prfconstant, size_t prfconstantlen, char * derivedrandom, size_t
derivedrandomlen);

look at her. six arguments. main character energy fr fr ✨

🌸 ARGUMENTS 🌸

  • Shishi * handle — the shishi handle, allocated by shishi_init(). she's the one holding everything together, the group chat admin of this whole operation 💖
  • Shishi_key * key — an input array holding the cryptographic key you're gonna use. this is the secret sauce, guard her with your life 🔐
  • const char * prfconstant — an input array with the constant string. the vibes you're deriving from, iykyk
  • size_t prfconstantlen — the size of that input array with the constant string. gotta tell her how long the vibe is 📏
  • char * derivedrandom — an output array with derived random data. this is where the magic lands, she gets filled in 🫶
  • size_t derivedrandomlen — the size of the output array with derived random data. how much magic you want, bestie 💫

👑 DESCRIPTION 👑

so the whole point: derive "random" data from a key and a constant, thusly:

DR(KEY, PRFCONSTANT) = TRUNCATE(DERIVEDRANDOMLEN, SHISHI_ENCRYPT(KEY, PRFCONSTANT))

periodt. you take the key, you encrypt the constant with it, and then you truncate the result down to DERIVEDRANDOMLEN. that's the derived random data. iconic formula, lowkey elegant, highkey the whole function 🔥

note that "random" is in quotes up there, and that's not me being shady — that's the manpage. deterministic derivation, bestie, not a dice roll 🎲

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful. any other value? not successful. that's the vibe check, fr fr 💀

🙈 REPORTING BUGS 🙈

found a bug? don't suffer in silence, tell the girlies (the maintainers):

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. that's it, that's the license, go wild, no royalties, 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 it, it's giving ✨encyclopedia✨ 📚

and that's the whole page, bestie!! this was shishi_dr(3) from shishi version 1.0.3 — mwah, drink your water, call your mom, and may all your derivations return SHISHI_OK 💅💖🎀

📦 where this page comes from