SHISHI_AUTHENTICATOR_ADD_RANDOM_SUBKEY(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_add_random_subkey — from the shishi manual, section 3 🎀

okay bestie, pull up a chair, we're getting into the shishi library today and honestly? it's giving cryptographic glow-up ✨

🌸 NAME 🌸

shishi_authenticator_add_random_subkey — lowkey the API function that makes a random subkey appear out of thin air and tucks it into your authenticator 💅

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_authenticator_add_random_subkey(Shishi * handle, Shishi_asn1
authenticator);

like yes, that's the whole thing, two args, one int coming back at you 🫶

🦋 ARGUMENTS 🦋

  • Shishi * handle — the shishi handle, and no you can't just make one up, it's gotta be allocated by shishi_init(). that's the vibe check it has to pass 💜
  • Shishi_asn1 authenticator — the authenticator you're working with, and it must be allocated by shishi_authenticator(). no random structs, bestie 🙈

🎀 DESCRIPTION 🎀

so here's the tea ☕ — this function generates a random subkey, using the default encryption type from configuration, and then it stores that subkey right inside the authenticator. periodt. that's the whole job. it's iconic, it's simple, it slays 🔥

⭐ RETURN VALUE ⭐

returns SHISHI_OK iff successful. iykyk — anything else means it did not go off 💀

💀 REPORTING BUGS 💀

found a bug? not the main character moment anyone wants, but okay, 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. fr fr, 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, bestie, it's giving lore 📚💖

and that's the page!! this is from shishi 1.0.3, section 3 of the shishi manual — mwah, bye, drink water and read your man pages 💅🌸

📦 where this page comes from