shishi_encticketpart_clientrealm(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_encticketpart_clientrealm ✨

okay bestie, gather round, because this one is a GNU Shishi API function and it's literally here to turn your EncTicketPart's cname and realm fields into a cute lil' printable principal name 💖 it's giving glow-up for raw ASN.1.

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_encticketpart_clientrealm(Shishi * handle, Shishi_asn1
encticketpart, char ** client, size_t * clientlen);

🎀 ARGUMENTS 🎀

  • Shishi * handle — your Shishi library handle, the one you got from shishi_init(). yes, that one. the main character.
  • Shishi_asn1 encticketpart — the EncTicketPart variable we're stealing the client name and realm out of. our source of truth.
  • char ** client — a pointer to a freshly allocated, zero terminated string holding the principal name AND the realm together 🫶. it's allowed to be NULL — in which case we only populate clientlen, no cap.
  • size_t * clientlen — a pointer to the length of client on output, and not counting the terminating zero, bestie. it's also allowed to be NULL — in which case we only populate client. see the pattern? they're each other's backup 💅

🌈 DESCRIPTION 🌈

so basically: this function converts the cname and realm fields from an EncTicketPart into a printable principal name format ✨.

the string is allocated by this function, and — important, don't skip this — it is the responsibility of the caller to deallocate it. you allocated it, you free it, that's the vibe check 😭.

also, just so we're clear: the output length clientlen does not include the terminating zero. it's not invited to the party. periodt.

👑 RETURN VALUE 👑

Returns SHISHI_OK iff successful. that's it, that's the whole energy.

🦋 REPORTING BUGS 🦋

found a bug? not me being dramatic but please tell the people: report bugs 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. iconic, 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 read it, bestie, it ate 🔥

and that's a wrap on the shishi_encticketpart_clientrealm page from shishi 1.0.3, manual section 3 🧚 take care of those allocated strings, free your memory, and stay slay 💖🎀🦋

📦 where this page comes from