shishi_kdcreq_sendrecv(3)

📦 version 1.0.3, in debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 shishi_kdcreq_sendrecv(3) — the shishi manual, bestie edition 💖

okay so. this is a page from the shishi manual, section 3 (library calls, for the uninitiated ✨). and it's about shishi_kdcreq_sendrecv — the little function that slides your request over to the KDC and catches the reply like it's catching feelings. no cap, it's giving errand-runner energy and honestly? we're obsessed. 🎀

✨ NAME ✨

shishi_kdcreq_sendrecv — API function 💅

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_kdcreq_sendrecv(Shishi * handle, Shishi_asn1 kdcreq,
       Shishi_asn1 * kdcrep);

like. that's the whole vibe right there. 🦋

🫶 ARGUMENTS 🫶

  • Shishi * handle — your Shishi library handle, the one you already made with shishi_init(). it's the main character of the whole operation, lowkey. 👑
  • Shishi_asn1 kdcreq — an input variable holding a prepared AS-REQ. you gotta bring the request, bestie, she doesn't make it for you. 💜
  • Shishi_asn1 * kdcrep — an output pointer variable that comes back holding the received AS-REP. yes, a pointer to a pointer situation, we love a little indirection moment. ⭐

💫 DESCRIPTION 💫

Sends a request to the KDC, and receives the response. that's the whole job description, fr fr.

the AS-REQ you hand over in kdcreq sets all the data for the request — every bit of it, no crumbs left behind. 🍓

and on reception? the reply gets decoded as an AS-REP into kdcrep. decoded, translated, delivered. iconic behaviour honestly. ✨

🔥 RETURN VALUE 🔥

the return code tells you which timeline you're in:

  • SHISHI_OK — success. slay. everything ate. 💅
  • SHISHI_KDC_TIMEOUT — it timed out. the KDC was not replying and we felt that. 😭
  • SHISHI_ASN1_ERROR — translation errors happened. the ASN.1 was not translating, bestie. 💀
  • SHISHI_GOT_KRBERROR — for other corruptions. yeah. other corruptions. we don't talk about those. 🙈

🌈 REPORTING BUGS 🌈

found a bug? do NOT suffer in silence, tell the people:

be a good citizen and actually report it, okay? the maintainers are people too 🫶

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.

(translation: you can copy it, you can remix it, just keep the receipts. periodt. 💖)

🧚 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 giving encyclopedia but make it cute. 📚✨

and that's the page!! this was shishi version 1.0.3, page shishi_kdcreq_sendrecv(3) in section 3 of the manual. mwah, bye bestie 💋🦋🌸

📦 where this page comes from