shishi_ticket_realm_get(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_ticket_realm_get β€” the NAME section, bestie

okay so literally the whole vibe of this page is: shishi_ticket_realm_get β€” an API function πŸŽ€

it lives in the shishi manual, section 3 (that's the library-calls girlies, iykyk).


✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_ticket_realm_get(Shishi * handle, Shishi_asn1 ticket, char **
realm, size_t * realmlen);

that's the whole thing. one function. she's small but she's mighty πŸ’…


🌸 ARGUMENTS 🌸

  • Shishi * handle β€” your shishi handle, the one you got from shishi_init(). like, the main character of the whole operation, no handle no service 🫢
  • Shishi_asn1 ticket β€” an input variable holding the ticket info. this is the ticket you're snooping the realm out of πŸ‘€
  • char ** realm β€” an output array that gets filled with a newly allocated name of the realm in the ticket. note that word: newly allocated. somebody's gotta free that, and it's you, bestie 😭
  • size_t * realmlen β€” the size of that output array. gotta know how long the thing is fr fr

πŸ¦‹ DESCRIPTION πŸ¦‹

Extract realm from ticket.

that's it. that's the description. she does one thing and she ate, periodt ✨

you hand her a ticket, she hands you back the realm. no drama, no extra steps, just pure realm-extraction energy πŸ’œ


πŸ‘‘ RETURN VALUE πŸ‘‘

Returns SHISHI_OK iff successful.

iff</p紫色> β€” that's "if and only if", for the math girlies. so: if you get SHISHI_OK, it worked. if you get literally anything else, it did not, and you should probably look at that 😬


πŸ’€ REPORTING BUGS πŸ’€

found a bug? first of all, not me being the one to find out πŸ™ˆ β€” but fr, report bugs to <bug-shishi@gnu.org>.

go tell them, they wanna know, that's the whole point of the address πŸ’Œ


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.

so like, yes you can copy it, yes you can change it, yes you can put it literally anywhere, no you don't gotta pay β€” you just have to keep the copyright notice and this notice. that's the deal, and it's a good deal, 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.

like, that's the mothership. this page is the little teaser trailer, the info manual is the whole three-hour director's cut. go there if you want the full lore πŸ“šβœ¨


quick reminder bestie: the realm output is freshly allocated memory, so don't just vibe past it β€” free it when you're done. no leaks in this house πŸ’…

and that's the page!! shishi 1.0.3, page shishi_ticket_realm_get(3) β€” mwah, go forth and extract realms responsibly πŸ’–πŸ¦‹πŸŒΈ