shishi_principal_name_realm(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_principal_name_realm(3) 💖

okay bestie, so this is a page from the shishi manual (section 3, the library-call girlies 💅), and it's all about one little function: shishi_principal_name_realm. yes it's a long name. yes she ate. let's get into it 🫶

✨ NAME ✨

shishi_principal_name_realm — an API function, periodt. that's literally her whole job description 📛

🌸 SYNOPSIS 🌸

like, the actual way you summon her:

#include <shishi.h>

int shishi_principal_name_realm(Shishi * handle, Shishi_asn1 namenode,
const char * namefield, Shishi_asn1 realmnode, const char * realmfield,
char ** out, size_t * outlen);

🎀 ARGUMENTS 🎀

okay so she takes seven things and every single one matters, no skipping 🙈

  • Shishi * handle — the Shishi library handle, and you get her from shishi_init(). she's the main character, everything runs through her 👑
  • Shishi_asn1 namenode — an ASN.1 structure that's holding the principal name in namefield.
  • const char * namefield — the name of the field inside namenode where the principal name is chillin'.
  • Shishi_asn1 realmnode — an ASN.1 structure holding the principal realm in realmfield.
  • const char * realmfield — the name of the field inside realmnode where the principal realm is at.
  • char ** out — pointer to a freshly allocated, null-terminated string with the principal name in it. she can be NULL if you only wanna populate outlen (lowkey iconic behaviour).
  • size_t * outlen — pointer to the length of out on output, and nope, that does not count the terminating null. also may be NULL if you only wanna populate out. balanced queen ⚖️

🦋 DESCRIPTION 🦋

so basically: she takes the principal name and the realm, both living all cozy inside an ASN.1 structure, and represents them as a null-terminated string. cute, right? 🍓

the string? this function allocates it. which means it's your responsibility as the caller to deallocate it — she made it, you clean it up, that's the deal bestie 😭

also heads up: the output length outlen does not include that terminating null character. do not forget. i'm literally begging 🙏

⭐ RETURN VALUE ⭐

returns SHISHI_OK if successful. slay. that's the whole vibe check ✅

💀 REPORTING BUGS 💀

found a bug? not me being the bearer of bad news but — 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. (fr fr, just keep the receipts 🧾)

🌈 SEE ALSO 🌈

the full documentation for shishi lives in a Texinfo manual — very ✨archival✨ of them. if the info and shishi programs are properly installed at your site, this command:

info shishi

should give you access to the complete manual. iykyk 💜

and that's the whole page, bestie!! this was shishi version 1.0.3, page shishi_principal_name_realm(3) — go forth and deallocate your strings, mwah 💅✨

📦 where this page comes from