shishi_kdc_sendrecv_hint(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_kdc_sendrecv_hint 💖

okay bestie, so this is a page from the shishi manual, section 3 — it's a library function, not a command you type in your shell, so no cap, you're calling this from C code. it's called shishi_kdc_sendrecv_hint and it's literally the "go talk to the KDC and come back with the tea" function. let's get into it 🫶

✨ NAME ✨

shishi_kdc_sendrecv_hint — it's an API function, periodt.

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_kdc_sendrecv_hint(Shishi * handle, const char * realm, const
char * indata, size_t inlen, char ** outdata, size_t * outlen,
Shishi_tkts_hint * hint);

🎀 ARGUMENTS 🎀

  • Shishi * handle — the Shishi library handle, and you gotta make it with shishi_init() first, bestie, don't skip that step 💅
  • const char * realm — a string holding the realm name.
  • const char * indata — the packet you're sending over to the KDC.
  • size_t inlen — how long indata is.
  • char ** outdata — a newly allocated string with the data that came back from the KDC. fresh out the oven ✨
  • size_t * outlen — how long outdata is.
  • Shishi_tkts_hint * hint — a Shishi_tkts_hint structure with flags in it.

🦋 DESCRIPTION 🦋

so what it does is: it sends a packet to the KDC for the realm, and receives the response back. that's the whole vibe. 💖

and the way it hunts down KDC addresses? it's giving detective energy, in this exact order:

  1. it finds KDC addresses from the configuration file,
  2. then by querying for SRV records for the realm,
  3. and finally by just using the realm name as a hostname.

like, plan A, plan B, plan C. she's resourceful. 👑

⭐ RETURNS ⭐

  • SHISHI_OK on success — we love a happy ending 😭
  • SHISHI_KDC_TIMEOUT if a timeout was reached — rip, she waited and nobody answered 💀
  • or other errors.

🐛 REPORTING BUGS 🐛

found a bug? don't be shy, report it to <bug-shishi@gnu.org>.

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, keep the receipt, that's all she asks 🧾)

🌈 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, then this command:

info shishi

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

and that's the whole page, bestie!! this was pulled from shishi version 1.0.3 — that's the source and version, so you know exactly which era of the manual you're reading. slay, go forth, send those packets 🎀💜

📦 where this page comes from