shishi_tkt_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_tkt_server(3) 💖

okay bestie, welcome to the shishi manual, section 3 (that's the library-functions section, iykyk). today's main character is shishi_tkt_server, a whole API function, and she's here to hand you the server principal name out of a ticket. let's get into it 🫶

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_tkt_server(Shishi_tkt * tkt, char ** server, size_t *
serverlen);

yeah she's a three-argument girlie. no cap. 🌸

🎀 ARGUMENTS 🎀

  • Shishi_tkt * tkt — your input variable, holding the ticket info. she's the source of the tea, fr fr.
  • char ** server — a pointer to a newly allocated zero-terminated string containing the principal name. she may be NULL — and if you do that, it's giving "only populate serverlen" energy. 💅
  • size_t * serverlen — a pointer to the length of the server on output, and important: that length excludes the terminating zero. she may also be NULL — in which case, only populate server. pick your fighter. 🦋

🌈 DESCRIPTION 🌈

so what she actually does: she represents the server principal name in the Ticket as a zero-terminated string. iconic behaviour honestly.

the string is allocated by this function, which means — and this is the part you cannot skip, bestie — it is the responsibility of the caller to deallocate it. that's you. you're the caller. you're the main character. you free it. 😭

also, quick reminder since we love a detail: the output length serverlen does not include the terminating zero. she said what she said. periodt.

⭐ RETURN VALUE ⭐

returns SHISHI_OK iff successful. that's the whole vibe check — SHISHI_OK means slay, anything else means we need to have a conversation. 💀

🙈 REPORTING BUGS 🙈

found a bug? not to be dramatic 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. (that's the license, and it ate. no notes.) 💜

🌸 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. so go read it, bestie, the lore is deep. 🧚

and that's the page!! this was the shishi_tkt_server(3) man page from shishi 1.0.3, section 3, and honestly? she served. go free your strings and hydrate. 💅✨🍓💖

📦 where this page comes from