shishi_tkt_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_tkt_clientrealm ✨

okay so bestie, welcome to the shishi_tkt_clientrealm(3) page 💖 this one lives in the shishi manual (yes, section 3, the library-functions section, we love a 3) and it's genuinely one of those little helper functions that just does its thing and hands you a string. no cap.

🎀 NAME 🎀

shishi_tkt_clientrealm — API function ✨

(it's literally an API function, that's the whole name section, we keep it real)

🦋 SYNOPSIS 🦋

#include <shishi.h>

int shishi_tkt_clientrealm(Shishi_tkt * tkt, char ** client, size_t *
clientlen);

🌸 ARGUMENTS 🌸

  • Shishi_tkt * tkt — input variable with ticket info. that's your ticket, she's the main character here 👑
  • char ** client — pointer to a newly allocated zero terminated string containing the principal name and realm. she may be NULL (and that's fine! it's so you can only populate clientlen instead, iykyk) 💅
  • size_t * clientlen — pointer to the length of client on output, excluding the terminating zero. also may be NULL (in which case you just populate client, the swap is real) 🙈

💜 DESCRIPTION 💜

so what does she even do?? she converts the cname and realm fields from the AS-REQ into printable principal name format ✨ that's it. that's the vibe.

the string is allocated by this function, and — listen up — it is the responsibility of the caller to deallocate it. so if you don't free it, that's a leak bestie, and leaks are not giving main character energy 😭

also note that the output length clientlen does not include the terminating zero. it's the length of the actual content, not the null. periodt.

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful. that's the only success token, no in-between, she's either slaying or she's not 💅

😭 REPORTING BUGS 😭

found a bug? 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.

(iconic licensing behaviour, 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 giving ✨

💖 cute sign-off: this page is from shishi version 1.0.3, and the footer date stamp on the original says shishi_tkt_clientrealm(3). stay hydrated, free your strings, and go read the Texinfo manual bestie 🌸🦋💅
📦 where this page comes from