shishi_tkts_get_tgt(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_tkts_get_tgt — from the shishi manual, section 3 🎀

okay bestie, pull up a chair because we're getting into ticket-granting tickets and honestly? it's giving backstage pass energy. this is the shishi_tkts_get_tgt(3) page, and yes it's a whole API function, and yes we're gonna stan it. ✨

🦋 SYNOPSIS

#include <shishi.h>

Shishi_tkt * shishi_tkts_get_tgt(Shishi_tkts * tkts, Shishi_tkts_hint *
hint);

like, that's the whole vibe. two args, one ticket, let's go. 💅

🌸 ARGUMENTS

  • Shishi_tkts * tkts — your ticket set handle, the one you got from shishi_tkts(). this is your little collection of tickets, your purse of passes, your clutch of creds. 🫶
  • Shishi_tkts_hint * hint — a structure describing the characteristics of the ticket you're trying to beget. it's like a wishlist. you tell it what you want and it goes and looks. 😭

👑 DESCRIPTION

so here's the tea: this function gets you a ticket granting ticket (a TGT, obviously, iykyk) that's suitable for acquiring a ticket matching the hint. basically you hand it a hint and it goes "say less" and finds you the right TGT. 🔥

specifically, it gets a TGT for the server realm in the hint structure — that's hint->serverrealm — or, if the serverrealm field is NULL, it falls back to the default realm. either way, it can result in an AS exchange. no cap. ⭐

⚠️ heads up bestie: currently this function do not implement cross realm logic. that's the situation. that's the whole situation. 💀

also, real talk — this function is used by shishi_tkts_get(), which is probably what you actually want to use unless you have special needs. so like, if you're not sure, go touch shishi_tkts_get() instead. this one is for when you know exactly what you're doing. 💅

🍓 RETURN VALUE

returns a ticket granting ticket if it's successful, or NULL if this function is unable to acquire one. so always check your return value, bestie, don't be out here dereferencing NULL and acting surprised. 🙈

🧚 REPORTING BUGS

found a bug? spill. report bugs to <bug-shishi@gnu.org>. 🐛

GNU Shishi home page: http://www.gnu.org/software/shishi/

General help using GNU software: http://www.gnu.org/gethelp/

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 of them honestly. slay.) 👑

🌈 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 right there. 📚

and that's the page, babe. shishi_tkts_get_tgt(3) from shishi version 1.0.3 — that's the source and version, and this whole thing is the shishi_tkts_get_tgt(3) manual. mwah. 💋

📦 where this page comes from