shishi_kdcreq_server(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_server ✨

okay bestie, gather round, because we're doing a shishi deep dive and this one is a lil library function called shishi_kdcreq_server 💖 it lives in the shishi manual, section 3 (that's the library-call girlies, not the command-line ones) 🎀

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_kdcreq_server(Shishi * handle, Shishi_asn1 kdcreq, char **
server, size_t * serverlen);

like, yes, the signature wraps across two lines, that's just how it's written, we don't question it 💅

🦋 ARGUMENTS 🦋

  • Shishi * handle — the Shishi library handle, and you get one by calling shishi_init(). no handle, no vibes 🫶
  • Shishi_asn1 kdcreq — the KDC-REQ variable we're pulling the server name out of. it's giving "the source material" ✨
  • char ** server — a pointer to a newly allocated, zero-terminated string holding the principal name. it can be NULL, but only if you literally just want serverlen filled in and nothing else 🙈
  • size_t * serverlen — pointer to the length of server on output, and heads up, that length excludes the terminating zero. it can also be NULL, in which case you're only populating server 💜

👑 DESCRIPTION 👑

so what this does is represent the server principal name in the KDC-REQ as a zero-terminated string 🌈

this function is the one that allocates that string, and — important, no cap — it is the responsibility of the caller to deallocate it. it's yours now, you own it, you free it 🔥

and again, because it matters: the output length serverlen does not include the terminating zero. the zero is a lil ghost that doesn't get counted 💀

⭐ RETURN VALUE ⭐

returns SHISHI_OK iff successful. that's the whole thing. iff, bestie, iff 😌

😭 REPORTING BUGS 😭

found a bug? don't just scream into the group chat, report it to <bug-shishi@gnu.org> 📧

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. slay, honestly 🎀

🧚 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 iconic ✨

and that's the whole page, bestie 💜 this was shishi version 1.0.3, filed under shishi_kdcreq_server(3), mwah 🫶

📦 where this page comes from