shishi_authenticator_set_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_set_subkey — like, the manual page, bestie 💖

okay so this is a page from the shishi manual set, and it's the one all about shishi_authenticator_set_subkey(3). yes it's an API function, yes it's a whole vibe, let's go 🫶

✨ NAME ✨

shishi_authenticator_set_subkey — it's an API function, bestie. that's the whole name. iconic.

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_authenticator_set_subkey(Shishi * handle, Shishi_asn1
authenticator, int32_t subkeytype, const char * subkey, size_t
subkeylen);

🎀 ARGUMENTS 🎀

  • Shishi * handle — the shishi handle, the one you got from shishi_init(). you gotta have one, no skipping.
  • Shishi_asn1 authenticator — the authenticator itself, as allocated by shishi_authenticator(). that's the thing we're decorating ✨
  • int32_t subkeytype — the input subkey type you wanna store in the authenticator. tell it what flavor of subkey this is.
  • const char * subkey — the actual input subkey data you're storing in the authenticator. the real one. the main character.
  • size_t subkeylen — the size of that input subkey data you're storing. how many bytes, babe, gotta say.

💅 DESCRIPTION 💅

so what it does is: it stores a subkey value in the authenticator. that's it, that's the job. 💖

ngl, a subkey is usually created by calling shishi_key_random() using the default encryption type of the key from the ticket that's being used. iykyk.

and listen — if you wanna save time, you might wanna use shishi_authenticator_add_subkey() instead, because that one calculates the subkey and calls this function, all in one step. two birds, one slay 🔥

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful. that's the good ending, periodt.

😭 REPORTING BUGS 😭

found a bug? spill. 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. (yes that's the actual license text, i'm not paraphrasing legal stuff, bestie, that's a whole crime 😭)

🦋 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 but make it kerberos 💜

and that's the whole page!! this was shishi version 1.0.3, from the shishi_authenticator_set_subkey(3) era — mwah, no notes, bye bestie 🎀✨

📦 where this page comes from