shishi_ticket_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_ticket_server ✨

okay bestie, welcome to shishi_ticket_server(3) — it's a lil API function from the shishi manual (section 3, library calls, you know the vibe 💅) and it's here to pull a server principal name out of a Ticket. very demure, very mindful, let's get into it 🎀

🌸 NAME 🌸

shishi_ticket_server — an API function, periodt. that's the whole name, no notes 💖

🦋 SYNOPSIS 🦋

#include <shishi.h>

int shishi_ticket_server(Shishi * handle, Shishi_asn1 ticket, char **
server, size_t * serverlen);

literally just copy that into your file and you're so back 🫶

🍓 ARGUMENTS 🍓

  • Shishi * handle — the Shishi library handle, and you get it from shishi_init(). it's the main character of your whole session, no cap 👑
  • Shishi_asn1 ticket — the ASN.1 Ticket variable you're stealing the server name out of. the source of truth, the blueprint, the moment 🔥
  • char ** server — a pointer to a newly allocated zero-terminated string holding the principal name. and listen, you can pass NULL here if you only want to populate serverlen — it's giving "I only need the length bestie" 🙈
  • size_t * serverlen — pointer to the length of server on output, and that length does not include the terminating zero. also can be NULL (so you only populate server). the duality, the flexibility, we love to see it 💅

💖 DESCRIPTION 💖

so basically: this function represents the server principal name in Ticket as a zero-terminated string. slay ✨

the string is allocated by this function, which means — and I need you to hear me on this — it is the caller's responsibility to deallocate it. that's your job, not shishi's. free it. don't leak it. leaking is not the vibe 😭

also important, tiny detail but it matters: the output length serverlen does not include the terminating zero. like, it's the length of the actual content, not content-plus-null. noted 📝

🌈 RETURN VALUE 🌈

returns SHISHI_OK iff successful. that's it. that's the whole condition. iff. successful. iconic ⭐

🐛 REPORTING BUGS 🐛

found a bug? don't suffer in silence bestie, report it to <bug-shishi@gnu.org> 💌

go tell them, they wanna know 🫶

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. like, go off, redistribute responsibly, no royalty required 🎀

🌟 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 if you're nosy (respectfully), that's where the deep lore lives 🧚

and that's the whole page, bestie!! 💖 this was shishi version 1.0.3, page shishi_ticket_server(3). mwah, go free your strings, stay hydrated, and don't forget the terminating zero is never in serverlen 💅✨🦋

📦 where this page comes from