shishi_tkt_client(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_client(3) — the shishi manual, bestie edition 💖

okay so welcome to the shishi manual page for shishi_tkt_client, and yes this is section 3 because we're in library-call territory 🎀 pull up a chair, grab a snack, we're gonna get your client principal name out of a ticket and it's gonna be so clean.

✨ NAME ✨

shishi_tkt_client — literally an API function, that's the whole name, she's simple and she's iconic 💅

🦋 SYNOPSIS 🦋

#include <shishi.h>

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

yes bestie, that's the whole vibe check right there. three arguments, one int coming back at you 🫶

🌸 ARGUMENTS 🌸

  • Shishi_tkt * tkt — the input variable holding your ticket info. this is the ticket we're gonna peek inside, no cap 👀
  • char ** client — a pointer to a newly allocated, zero-terminated string that's gonna hold the principal name. and listen: it can be NULL if you only want to populate clientlen (yes, you can ghost this one and she won't be mad 🙈).
  • size_t * clientlen — a pointer that gets the length of client on output, and excluding the terminating zero, okay?? also may be NULL (to only populate client). so basically these two are a duo and either one can sit this one out 💫

💜 DESCRIPTION 💜

So what does she actually do? She represents the client principal name in the Ticket KDC-REP as a zero-terminated string. Periodt.

The string is allocated by this function — so the memory is on you, babe. It is the responsibility of the caller to deallocate it. Don't forget, we don't leak in this house 💀

And a lil note that matters: the output length clientlen does not include the terminating zero. so if you're doing math with it, subtract accordingly, iykyk 🧚

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful. that's it, that's the whole personality. anything else and something went sideways 😭

🐛 REPORTING BUGS 🐛

found a bug? don't suffer in silence, tell the people:

they wanna hear from you fr fr 🫶

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 behavior honestly, slay ✨)

🌈 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 scholarly 📚

and that's the whole page bestie 💖 this was shishi_tkt_client(3) from shishi version 1.0.3 — mwah, go deallocate that string, love you, bye 👑🎀🦋

📦 where this page comes from