shishi_ap_tktoptionsraw(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_ap_tktoptionsraw — the vibe ✨

okay bestie, so this is a page from the shishi manual, section 3 (that's the library-functions section, iykyk). It's called shishi_ap_tktoptionsraw and it is, in the official words, an API function. Yes queen, we're in the C library now 💅

🎀 SYNOPSIS 🎀

Like, here's the whole entire vibe, verbatim, don't @ me:

#include <shishi.h>

int shishi_ap_tktoptionsraw(Shishi * handle, Shishi_ap ** ap, Shishi_tkt
* tkt, int options, int32_t cksumtype, const char * data, size_t len);

🦋 ARGUMENTS 🦋

so many little guys. let's go one by one, no skips, periodt.

  • Shishi * handle — your shishi handle, bestie. The one you got from shishi_init(). Can't do anything without her 🫶
  • Shishi_ap ** ap — a pointer to the new structure that's gonna hold all the info about the AP exchange. she's brand new, she's got main character energy 👑
  • Shishi_tkt * tkt — the ticket you wanna set in your newly created AP. the ticket. THE ticket 💖
  • int options — the AP-REQ options to set in your newly created AP. (yes, AP-REQ, not AP-REP, pay attention bestie)
  • int32_t cksumtype — the authenticator checksum type to set in the AP. it's giving very specific energy ✨
  • const char * data — the input array holding the data you wanna store in the checksum field in the Authenticator. raw data, raw vibes 🌈
  • size_t len — the length of that input array with the data you're storing in the checksum field in the Authenticator. gotta know how long she is or she's just chaos 💀

🌸 DESCRIPTION 🌸

okay so here's the whole plot:

You're creating a brand new AP exchange using shishi_ap(). Then you set the ticket, the AP-REQ apoptions, and the raw Authenticator checksum data field using shishi_ap_set_tktoptionsraw().

Also — and this is lowkey important — a random session key gets added to the authenticator, and it uses the same keytype as the ticket. Matching keytypes, matching energy, we love a consistent queen 🎀

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful. that's it, that's the tea. anything else and, well… it's not SHISHI_OK, bestie 😭

🙈 REPORTING BUGS 🙈

Found a bug? Not the cute kind? Then pls report it to:

<bug-shishi@gnu.org>

they wanna hear from you fr fr 💜

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.

(so like… you can share her, 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, this command:

info shishi

should give you access to the complete manual. go read it, it's giving ✨educated✨

and that's the whole page, bestie!! this was shishi version 1.0.3, section 3, shishi_ap_tktoptionsraw — go forth and create AP exchanges, you absolute icon 💅💖✨

📦 where this page comes from