shishi_ap_tktoptionsdata(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_tktoptionsdata β€” the glow-up page πŸ’–

okay bestie, so this is a page from the shishi manual (yes, section 3, library-call territory πŸŽ€), and it's all about shishi_ap_tktoptionsdata. it's giving "one function, whole lot of vibes". let's go πŸ’…


✨ SYNOPSIS ✨

#include <shishi.h>

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

like, that's the whole signature, no cap. five args plus the handle, and she's thriving πŸ¦‹


🌸 ARGUMENTS 🌸

so here's who's who in the group chat:

  • Shishi * handle β€” the shishi handle, and you gotta get it the legit way, as allocated by shishi_init(). no DIY handles, bestie πŸ™ˆ
  • Shishi_ap ** ap β€” pointer to the new structure that's gonna hold all the info about the AP exchange. this is the baby you're creating ✨
  • Shishi_tkt * tkt β€” the ticket to set in the newly created AP. yes, that ticket. the main character πŸ‘‘
  • int options β€” AP-REQ options to set in the newly created AP. it's giving "settings but make it Kerberos" πŸ’…
  • const char * data β€” input array with the data to checksum in the Authenticator. so like, the stuff you want checked πŸ”₯
  • size_t len β€” length of that input array with data to checksum in the Authenticator. don't lie about the length, she'll know 😭

πŸ’œ DESCRIPTION πŸ’œ

okay so here's the tea, fr fr:

this function creates a new AP exchange using shishi_ap(), and then it sets the ticket, the AP-REQ apoptions, and the Authenticator checksum data β€” all of that β€” using shishi_ap_set_tktoptionsdata(). three-for-one deal, we love efficiency 🫢

and THEN, plot twist, a random session key gets added to the authenticator, using the same keytype as the ticket. iconic behaviour honestly, matching keytypes is self-care 🌈


⭐ RETURN VALUE ⭐

returns SHISHI_OK iff successful. that's it. that's the whole criteria. if you see SHISHI_OK, you ate πŸ’…βœ¨


😭 REPORTING BUGS 😭

found a bug? don't just scream into the void, bestie, report it to <bug-shishi@gnu.org> πŸ’Œ

also for the record:

go be a good citizen πŸŽ€


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.

(that's the legal bit and we respect it, periodt πŸ‘‘)


πŸ¦‹ 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 forth and info shishi, it's lowkey a whole journey 🌸


not me ending the page but keeping every single detail intact. iykyk πŸ’–

and that's a wrap, bestie β€” this page is from shishi version 1.0.3, with all the love from the shishi crew. stay slay, stay checksummed βœ¨πŸ’…πŸ«Ά