shishi_kdcreq_client(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_kdcreq_client(3) 💖

okay bestie, welcome to the shishi manual, section 3. yes we're in the library pages now, it's giving very "i read header files for fun" energy and honestly? iconic. this one's about shishi_kdcreq_client and it's a little API function that pulls a client principal name out of a KDC-REQ. let's go 🦋

✨ NAME ✨

shishi_kdcreq_client — an API function, fr fr

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_kdcreq_client(Shishi * handle, Shishi_asn1 kdcreq, char **
client, size_t * clientlen);

🎀 ARGUMENTS 🎀

  • Shishi * handle — the Shishi library handle, which you make with shishi_init(). she's the main character, everything runs through her 💅
  • Shishi_asn1 kdcreq — the KDC-REQ variable you want the client name from. yes we're getting it out of there. slay.
  • char ** client — a pointer to a newly allocated zero-terminated string holding the principal name. lowkey flexible: this may be NULL if you only wanna populate clientlen. no cap.
  • size_t * clientlen — pointer to the length of client on output, and note that this does not count the terminating zero. also may be NULL if you only wanna populate client. pick your fighter 🫶

💜 DESCRIPTION 💜

so basically: represent the client principal name in KDC-REQ as a zero-terminated string. that's the vibe. ✨

the string is allocated by this function, and — listen carefully bestie — it is the responsibility of the caller to deallocate it. not me, not shishi, not the universe. you. 😭

also, clientlen output does not include the terminating zero. the way that zero is just out here living its life uncounted... anyway.

🔥 RETURN VALUE 🔥

Returns SHISHI_OK iff successful. that's it, that's the whole condition. if it's not SHISHI_OK, it was not, in fact, successful 💀

🙈 REPORTING BUGS 🙈

found a bug? report it to <bug-shishi@gnu.org>. GNU Shishi home page: http://www.gnu.org/software/shishi/ — general help using GNU software lives at http://www.gnu.org/gethelp/. go tell them, they wanna know 🍓

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.

(that's the license, bestie, it's very generous, we love that for us 💖)

🌈 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 one shipped as part of shishi 1.0.3, and the manual page is shishi_kdcreq_client(3) — go forth and deallocate your strings, i believe in you 🧚💜

📦 where this page comes from