shishi_tkts_print_for_service(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_tkts_print_for_service β€” the manual page, but make it cute

okay bestie, so you know the shishi manual (yes, the Kerberos-adjacent GNU one)? this is one of its pages, and it's genuinely so useful. it's an API function, she's giving ✨utility✨, and i'm gonna walk you through it like we're texting. no cap. πŸ¦‹


🌸 NAME 🌸

shishi_tkts_print_for_service β€” API function

like, that's literally her name, and she does exactly what it says on the tin. πŸ‘‘


✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_tkts_print_for_service(Shishi_tkts * tkts, FILE * fh, const
char * service);

three args, one int back. simple. iconic. periodt. πŸ’–


πŸŽ€ ARGUMENTS πŸŽ€

  • Shishi_tkts * tkts β€” the ticket set handle, and you gotta get her from shishi_tkts(). she's the whole vibe, don't just make one up. 🫢
  • FILE * fh β€” the file descriptor you're printing to. yes, a file descriptor, that's what the page says, and we respect her. πŸ“
  • const char * service β€” the service you want to limit the printed tickets to. or you can pass NULL, and then it's a free-for-all. πŸ™ˆ

πŸ’– DESCRIPTION πŸ’–

so what she does is: print a description of the tickets for the specified service, out to the file descriptor you handed her. πŸŽ€

and if service is NULL? bestie, she prints all the tickets. every single one. she's not gatekeeping. 🌈


⭐ RETURN VALUE ⭐

returns SHISHI_OK iff successful. that's the good outcome. that's the slay outcome. anything else, and we're in our feels. 😭


πŸ”₯ REPORTING BUGS πŸ”₯

found a bug? first of all, relatable. second of all, report it to <bug-shishi@gnu.org>. πŸ“§


Copyright Β© 2002-2022 Simon Josefsson.

and here's the legal bit, in full, no edits: 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.

so like, keep the receipt, bestie. that's the deal. πŸ’œ


🌸 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, then this command

info shishi

should give you access to the complete manual. go off, read the whole thing, she's worth it. 🧚


lowkey the most important part: the vibe changes, the facts do not. every flag, every argument, every default, every path β€” all of it stays exactly as it was. iykyk. πŸ’…

okay that's the page!! written by the shishi girlies, version 1.0.3, and this little doc lives under shishi_tkts_print_for_service(3) β€” mwah, go print some tickets, you absolute main character. πŸ¦‹βœ¨πŸ’–