shishi_ap_tktoptions(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_tktoptions ✨

okay bestie, so this is a page from the shishi manual, section 3 (that's the library-functions section, iykyk) πŸ’… and it's all about one very specific little function: shishi_ap_tktoptions. she's an API function, she's iconic, she does one job and she does it well 🫢


🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_ap_tktoptions(Shishi * handle, Shishi_ap ** ap, Shishi_tkt *
tkt, int options);

like. look at her. four arguments, one int coming back at you. slay ✨


πŸŽ€ ARGUMENTS πŸŽ€

  • Shishi * handle β€” the shishi handle, and you gotta have gotten it the legit way, i.e. as allocated by shishi_init(). no homemade handles, no knockoffs πŸ’€
  • Shishi_ap ** ap β€” a pointer to the new structure that's gonna hold all the info about the AP exchange. yes, it's a double pointer. yes, that's just how it is. lowkey the vibe.
  • Shishi_tkt * tkt β€” the ticket you want set in your brand-new AP. like, the ticket. the one. 🎟️
  • int options β€” the AP-REQ options you want set in that freshly created AP. options for days.

πŸ’– DESCRIPTION πŸ’–

so here's the tea β˜• β€” this function makes a whole new AP exchange by calling shishi_ap(), and then it sets the ticket and the AP-REQ apoptions using shishi_ap_set_tktoptions(). two-for-one, no cap.

and THEN β€” and this is the part I'm obsessed with β€” a random session key gets added to the authenticator πŸ”₯ using the same keytype as the ticket. same keytype!! matching!! it's giving coordinated outfit energy πŸ‘‘


⭐ RETURN VALUE ⭐

returns SHISHI_OK iff successful. and bestie, "iff" means if and only if β€” that's not a typo, that's math πŸ’€ so if you don't get SHISHI_OK back, something went sideways, periodt.


πŸ™ˆ REPORTING BUGS πŸ™ˆ

found a bug? don't just scream into the group chat, actually report it to <bug-shishi@gnu.org> πŸ›βœ‰οΈ

they literally want to hear from you. main character energy from both sides 🫢


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, go off, remix it, just keep the receipts 🧾✨


🌈 SEE ALSO 🌈

the full documentation for shishi lives in a Texinfo manual (yes, texinfo, she's vintage but she ate) πŸ“š if info and the shishi programs are properly installed at your site, this command:

info shishi

should give you access to the complete manual. iykyk πŸ’œ


okay that's the whole page bestie πŸŽ€ this was shishi 1.0.3, section 3, shishi_ap_tktoptions(3) β€” go forth and build your AP exchange, you've got this πŸ’–πŸ¦‹πŸŒΈ