shishi_tkt_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_tkt_realm — the manual page, bestie edition 💖

okay so this is a page from the shishi manual — specifically shishi_tkt_realm(3), section 3, the library-functions section, so you already know it's gonna be a little C-flavored. sit down, grab a strawberry 🍓, we're extracting a realm.

✨ NAME ✨

shishi_tkt_realm — it's an API function, babes. that's the whole name. short, sweet, does exactly one thing.

🎀 SYNOPSIS 🎀

here's how you bring it into your life:

#include <shishi.h>

int shishi_tkt_realm(Shishi_tkt * tkt, char ** realm, size_t *
realmlen);

yes it wraps in the original, no we're not judging, it's just line length 💅

🦋 ARGUMENTS 🦋

three of them. let's meet the cast:

  • Shishi_tkt * tkt — the input variable, and it's carrying the ticket info. this is your main character. 👑
  • char ** realm — a pointer to a newly allocated character array holding the realm name. note the "newly allocated" part, bestie, because that means somebody's gotta free it later. not naming names. 🙈
  • size_t * realmlen — the length of that same newly allocated character array with the realm name. it's the realm's little height measurement. 📏

🌸 DESCRIPTION 🌸

it extracts the realm of the server in the ticket. that's it. that's the vibe. you hand it a ticket, it hands you back the realm name (freshly allocated!) and how long that realm name is. no cap. ✨

⭐ RETURN VALUE ⭐

returns SHISHI_OK iff successful. that's the good one. that's the one you want. if you see anything else, it's giving "not today." 😭

💀 REPORTING BUGS 💀

found a bug? do NOT suffer in silence, tell the people:

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. slay, honestly — that's a genuinely generous license and we respect it. 🫶

🌈 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 the director's cut. 🎬

and that's the whole page, fr fr. this came to you from shishi 1.0.3, manual page shishi_tkt_realm(3) — mwah, take care of your allocated arrays, free your memory, and stay iconic. 💖✨🎀

📦 where this page comes from