shishi_tkts_get(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 — the manual page bestie 💖

okay so this is shishi_tkts_get(3), a page from the shishi manual, and I'm gonna walk you through it like we're texting at 2am. stay with me, it's actually so good.

✨ NAME ✨

shishi_tkts_get — it's an API function, bestie. that's the whole name. no notes. 💅

🌸 SYNOPSIS 🌸

like, here's the vibe. include the header, call the function:

#include <shishi.h>

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

it gives you back a Shishi_tkt *, and honestly? iconic. 👑

🎀 ARGUMENTS 🎀

  • Shishi_tkts * tkts — the ticket set handle, and no you can't just make one up, it has to be allocated by shishi_tkts() first. that's its origin story fr fr.
  • Shishi_tkts_hint * hint — a structure stuffed with the characteristics of the ticket you're tryna find. it's giving "here's my shopping list, go get it." 🛍️

🦋 DESCRIPTION 🦋

so the whole point: get a ticket matching the characteristics you gave it. literally that's the mission.

here's the tea on how it actually does it, step by step:

  1. first it looks in the ticket set for a ticket. like, checking your bag before you buy a new one. smart.
  2. if that doesn't pan out, it tries to find a suitable TGT — possibly via an AS exchange — using shishi_tkts_get_tgt(). bestie's networking. 🤝
  3. then it takes that TGT and uses it in a TGS exchange to get the ticket. slay.
⚠️ and now the part we don't gatekeep: currently this function does not implement cross realm logic. so like, no hopping between realms. it stays in its lane. periodt.

🌈 RETURN VALUE 🌈

  • you get a ticket if it finds one 🎉
  • or you get NULL if this function is unable to get the ticket 😭

that's it. that's the whole deal.

🐛 REPORTING BUGS 🐛

found a bug? not me manifesting one, but if you did, report it to <bug-shishi@gnu.org>. they want to hear it, 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.

(that's the license line, keep it, don't touch it, it's sacred. 🫶)

💜 SEE ALSO 💜

the full documentation for shishi lives in a Texinfo manual. so if the info and shishi programs are properly installed at your site, this command:

info shishi

should give you access to the complete manual. iykyk. ✨

and that's the whole page, bestie. we ate. 💅🌸 this was shishi_tkts_get(3) from shishi 1.0.3 — mwah, go forth and get those tickets. 🎟️💖🦋

📦 where this page comes from