shishi_krberror_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_krberror_client — the manual page, but make it make sense 💖

okay bestie, so this is a page from the shishi manual, section 3 — aka the library-functions section, the land of #include and "please read the return value, I'm begging you". The star of the show today? shishi_krberror_client. It's giving "let me grab that client principal name for you" energy. ✨

🌸 NAME 🌸

shishi_krberror_client — it's an API function, babes. That's the whole vibe. 🎀

🦋 SYNOPSIS 🦋

#include <shishi.h>

int shishi_krberror_client(Shishi * handle, Shishi_asn1 krberror, char
** client, size_t * clientlen);

like, four things go in, one int comes out. standard. 💅

✨ ARGUMENTS ✨

okay so here's who's showing up to the function call:

  • Shishi * handle — the shishi handle, and you gotta get it from shishi_init(). no handcrafting, no vibes-based allocation. 🫶
  • Shishi_asn1 krberror — the krberror, and this one comes from shishi_krberror(). it knows what it is.
  • char ** client — a pointer to a newly allocated zero-terminated string holding the principal name. and here's the cute part: it may be NULL — in which case it just won't be filled, and you only populate clientlen instead. lowkey flexible. 🙈
  • size_t * clientlen — a pointer to the length of client on output, excluding the terminating zero. and guess what, this one may be NULL too — then you only populate client. pick your fighter, you don't have to take both. ⭐

💜 DESCRIPTION 💜

Return the client principal name in KRB-ERROR.

that's it. that's the whole function. it reaches into the KRB-ERROR and hands you the client principal name like a lil gift. no cap. 🎁

👑 RETURN VALUE 👑

Returns SHISHI_OK iff successful. literally the only correct outcome, bestie. anything else and something's off. 😭

🍓 REPORTING BUGS 🍓

found a bug? (rude of it, honestly.) report it to <bug-shishi@gnu.org>. 📧

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 of them, honestly — go forth and copy. 🫶)

🌈 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. iykyk — that's where the real lore lives. 📚

and that's the whole page, bestie!! mwah 💅 this lil masterpiece is from shishi version 1.0.3, and it's the shishi_krberror_client(3) page — so go forth, populate your client and your clientlen, and slay. periodt. 💖✨🦋

📦 where this page comes from