shishi_random_to_key(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_random_to_key(3) 💖

okay bestie, welcome to the shishi manual, page shishi_random_to_key(3). this is an API function and it's lowkey iconic. sit down, grab a boba, we're doing this. 🧋✨

🌸 NAME 🌸

shishi_random_to_key — it's an API function, bestie. that's the whole name. short. sweet. main character. 💅

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_random_to_key(Shishi * handle, int32_t keytype, const char *
rnd, size_t rndlen, Shishi_key * outkey);

like. look at her. five arguments. slay. 🫶

🎀 ARGUMENTS 🎀

  • Shishi * handle — the shishi handle, and you get it from shishi_init(). that's the vibe, that's the source, that's where it comes from fr fr.
  • int32_t keytype — the cryptographic encryption type. if you wanna know your options, go look at Shishi_etype. iykyk. 🔥
  • const char * rnd — an input array stuffed with random data. chaotic energy, but make it on purpose.
  • size_t rndlen — the length of that input array of random data. yes bestie, we measure. we always measure. 📏
  • Shishi_key * outkey — an allocated key handle that is gonna contain the new key. she's empty rn, she's about to be ✨fulfilled✨.

🦋 DESCRIPTION 🦋

so the way this works: it derives a key from random data, for the key type you specified, and then it sets the type and the value in the given key to the computed values.

that's it. that's the whole thing. derive → set type → set value. the key you passed in comes out transformed. no cap. 💜

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful. and only iff. conditional queen. 👑

🙈 REPORTING BUGS 🙈

found a bug? not me gatekeeping — go tell someone! report bugs 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.

(translation: take 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. go off, read the whole thing, it's giving thorough. 📚✨

k bye bestie, this was shishi manual, version 1.0.3, and that's the whole page. mwah. 💋🦋💅

📦 where this page comes from