shishi_asreq_clientrealm(3)

💖 NAME 💖

shishi_asreq_clientrealm — bestie, it's an API function ✨ (from the shishi manual, section 3, iykyk)

---

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_asreq_clientrealm(Shishi * handle, Shishi_asn1 asreq, char **
client, size_t * clientlen);

---

🎀 ARGUMENTS 🎀

• Shishi * handle — the Shishi library handle, the one you made with shishi_init(). Your main character, honestly.
• Shishi_asn1 asreq — the AS-REQ variable we're pulling the client name and realm out of. That's the assignment, periodt.
• char ** client — a pointer to a freshly allocated, zero-terminated string holding the principal name and the realm. It can be NULL — and if you do that, it just populates clientlen only. Choose your fighter 💅
• size_t * clientlen — pointer to the length of client on output, and nope, that length does not count the terminating zero. Can also be NULL — in which case it only populates client. Either/or energy 🦋

---

✨ DESCRIPTION ✨

Okay so here's the vibe: this function converts the cname and realm fields out of the AS-REQ into a printable principal name format. Glow up, lowkey 🌈

The string? This function allocates it. Which means — and I need you to hear me on this — it is the caller's responsibility to deallocate it. Not the library's. Yours. Free it. Don't be the friend who leaves the group chat on read 🫶

Also, heads up bestie: the output length clientlen does not include the terminating zero. No cap.

---

👑 RETURN VALUE 👑

Returns SHISHI_OK iff successful. That's it, that's the whole thing. Slay 💅

---

💀 REPORTING BUGS 💀

Found a bug? Not the vibe, but okay, report it 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. Iconic behaviour honestly, we love a permissive license ✨

---

🌟 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 off, read the whole thing 📖💖

---

That was the whole page, bestie — written for shishi version 1.0.3, the shishi_asreq_clientrealm(3) manual page. Bye, ily, free your strings 💜