shishi_dk(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_dk — the API function that derives a key from a key, bestie 💖

okay so like, this is shishi_dk(3) from the shishi manual, and it is genuinely one of those little functions that's doing a LOT behind the scenes. it's an API function, and if you're in the shishi universe you already know what that means. come on, let's go 🦋

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_dk(Shishi * handle, Shishi_key * key, const char *
prfconstant, size_t prfconstantlen, Shishi_key * derivedkey);

look at her. five arguments. no notes. 💅

🎀 ARGUMENTS 🎀

  • Shishi * handle — the shishi handle, and yes it has to be the one you got from shishi_init(). no bootleg handles, bestie. 🙈
  • Shishi_key * key — the input cryptographic key you're gonna use. your raw material, your main character. 👑
  • const char * prfconstant — an input array holding the constant string. this is the lil flavor packet you're stirring in. 🌸
  • size_t prfconstantlen — the size of that input array with the constant string. yes, you have to tell it how big it is. it's not gonna guess. 💀
  • Shishi_key * derivedkey — pointer to the derived key, and heads up: the caller allocates this. that's you. you're the caller. you're the one allocating. 🫶

🌈 DERIVE A KEY FROM A KEY AND A CONSTANT THUSLY 🌈

here's the whole vibe, mathematically, no cap:

DK(KEY, PRFCONSTANT) = SHISHI_RANDOM-TO-KEY(SHISHI_DR(KEY,
PRFCONSTANT)).

it's giving nested. it's giving two-step. first SHISHI_DR, then SHISHI_RANDOM-TO-KEY on top of that result. iconic behavior fr fr. ⭐

🔥 RETURN VALUE 🔥

returns SHISHI_OK iff successful. that's the only outcome we accept. anything else? we don't know her. 😭

🐛 REPORTING BUGS 🐛

found a bug? (rude, but okay.) report it to <bug-shishi@gnu.org>.

GNU Shishi home page: http://www.gnu.org/software/shishi/

General help using GNU software: http://www.gnu.org/gethelp/

go tell the maintainers, they actually want to know. don't suffer in silence, babe. 💜

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 the legal slay. keep the notice, keep the notice. 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. iykyk. 🧚

that's the whole page, bestie. you understood it, you ate it, no crumbs. 💖

sending you off with the official receipt: this was shishi version 1.0.3, page shishi_dk(3), and it's giving very much 1.0.3 energy. mwah. 🎀✨

📦 where this page comes from