shishi_kdcreq_realm(3)

✨ shishi_kdcreq_realm ✨

okay bestie, so this is a page from the shishi manual — section 3, the library-function corner of the world 💅. It's called shishi_kdcreq_realm, and it's literally just here to hand you the realm out of a KDC-REQ. Cute, simple, iconic. Let's go 🦋

---

🌸 NAME 🌸

shishi_kdcreq_realm — an API function, no cap.

---

🎀 SYNOPSIS 🎀

#include <shishi.h>

int shishi_kdcreq_realm(Shishi * handle, Shishi_asn1 kdcreq, char **
realm, size_t * realmlen);

---

💖 ARGUMENTS 💖

• Shishi * handle — the Shishi library handle, the one you got from shishi_init(). Your whole vibe lives in here.
• Shishi_asn1 kdcreq — the KDC-REQ variable you're pulling the client name out of.
• char ** realm — a pointer to a freshly allocated, zero-terminated string holding the realm. It's allowed to be NULL — in which case you're just populating realmlen and nothing else, and honestly, valid.
• size_t * realmlen — a pointer to the length of the realm on output, and that length does not count the terminating zero. Also may be NULL (to only populate realmlen) — yes, the original says it that way, and yes, we're keeping it exactly like that, fr fr 🙈.

---

🫶 DESCRIPTION 🫶

So the whole point: grab the realm field inside a KDC-REQ and give it back to you as a zero-terminated string. That's it, that's the function ✨

The string is allocated by this function, and — listen up, this part matters — it is the responsibility of the caller to deallocate it. So you free it. Not us. You. Don't forget, bestie, or that's a leak 😭

Also, quick note: the output length realmlen does not include the terminating zero. So if it says 5, it's 5 characters plus the little zero at the end. Periodt.

---

🔥 RETURN VALUE 🔥

Returns SHISHI_OK iff successful. That's the whole return value story. Slay.

---

💀 REPORTING BUGS 💀

Found a bug? Don't suffer in silence, tell the people:

• 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 👑

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. (Yes, really — go wild, 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 page, bestie 💅 — brought to you by shishi, version 1.0.3, in the shishi_kdcreq_realm(3) era. go forth, get that realm, and free your strings 🎀🦋⭐