shishi_kdc_sendrecv(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 — the glow-up edition 💖

okay bestie, welcome to the shishi manual, section 3 (that's the library-functions girlies ✨). Today's main character is shishi_kdc_sendrecv, and she is so good at her job. Let's get into it 🫶

🌸 NAME 🌸

shishi_kdc_sendrecv — it's an API function, periodt 💅

✨ SYNOPSIS ✨

#include <shishi.h>

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

look at her. six arguments. absolute icon 👑

🎀 ARGUMENTS 🎀

  • Shishi * handle — the Shishi library handle, the one you made with shishi_init(). your ride-or-die 🦋
  • const char * realm — a string with the realm name. yes, the realm. that one 🏰
  • const char * indata — the packet you're sending to the KDC. the lil message ✉️
  • size_t inlen — how long indata is. gotta know her measurements 📏
  • char ** outdata — a newly allocated string holding the data the KDC sent back. brand new, freshly malloc'd, she's thriving ✨
  • size_t * outlen — how long outdata is. no cap 📐

💜 DESCRIPTION 💜

So basically: you send a packet to the KDC for a realm, and you get the response back. That's the whole vibe 🌈

But how does she find the KDC? Obsessed with her process, actually. The code looks for KDC addresses in this order:

  1. from the configuration file first 📄
  2. then by querying for SRV records for the realm 🔍
  3. and finally, as a last resort, by using the realm name as a hostname 🏠

like she will find that KDC. she always finds that KDC 💅

⭐ RETURNS ⭐

  • SHISHI_OK on success — slay, we ate 🎉
  • SHISHI_KDC_TIMEOUT if a timeout was reached — she waited, she got nothing, tragic 😭
  • or other errors, because life is unpredictable bestie 🙈

🐛 REPORTING BUGS 🐛

Found a bug? not her fault but okay, tell the devs:

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/

they're nice, they'll help you out 🫶

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 yes, you can copy her, just keep the receipts 💖

🌈 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. iykyk 📖✨

and that's the whole page bestie!! this manual is from shishi version 1.0.3, and it's the shishi_kdc_sendrecv(3) page, dated like a fine vintage 🍓 mwah, go send some packets 💅💖🦋

📦 where this page comes from