shishi_authenticator_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_subkey 💖

okay bestie, welcome to the shishi manual, section 3 (that's the library-functions girlypop section, iykyk), and today's main character is shishi_authenticator_subkey. it's an API function ✨. yes, literally just that. she's a builder, she's a little factory, and she's about to hand you a whole Authenticator. let's get into it 🎀

🌸 SYNOPSIS 🌸

#include <shishi.h>

Shishi_asn1 shishi_authenticator_subkey(Shishi * handle);

one header, one function, zero drama. slay.

🦋 ARGUMENTS 🦋

  • Shishi * handle — the shishi handle, bestie. the one you got handed to you when you called shishi_init(). no handle, no party 💅

✨ DESCRIPTION ✨

so here's the vibe: this function creates a new Authenticator, and she comes pre-populated with some default values, like she got dressed before you even asked 🫶

for the ctime and cusec fields, she uses the current time as returned by the system. so yes, it's giving "right now", not "whenever you feel like it".

and then — the part the function is literally named after — she adds a random subkey. random!! 🎲 no cap.

💜 RETURN VALUE 💜

returns the authenticator, or NULL on failure 😭

so like, fr fr, check for NULL. don't be out here using a NULL authenticator and then acting surprised. the vibes will NOT be immaculate.

🙈 REPORTING BUGS 🙈

found a bug? don't gatekeep, tell the devs:

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 behavior honestly, we love a permissive queen 🌈

🔥 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, this command

info shishi

should give you access to the complete manual. periodt. 💅

and that's the whole page, bestie!! this little gem lives in shishi, version 1.0.3 — go forth and build authenticators, and remember: the subkey is random, the time is now, and the NULL check is non-negotiable. mwah 💖🎀🦋

📦 where this page comes from