shisa_principal_find(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

💖 shisa_principal_find(3) 💖

okay bestie, so this is a page from the shishi manual (section 3, the library-call girlies) and it's all about shisa_principal_find — the function that goes and finds your principal for you. it's giving librarian energy but for realms. let's get into it 🫶

✨ NAME ✨

shisa_principal_find — an API function, and yes that's literally all the original says, so that's all I'm saying too 💅

🌸 SYNOPSIS 🌸

#include <shisa.h>

int shisa_principal_find(Shisa * dbh, const char * realm, const char *
principal, Shisa_principal * ph);

like, that's the whole vibe. one include, one function call, four args. easy 💖

🎀 ARGUMENTS 🎀

  • Shisa * dbh — the Shisa library handle, and you get it from shisa(). it's your little dbh bestie, the thing that holds everything together.
  • const char * realm — the name of the realm that your principal belongs to. like the group chat your principal is in ✨
  • const char * principal — the name of the principal you want the tea about. that's who we're investigating 🔍
  • Shisa_principal * ph — a pointer to a principal structure that you already allocated earlier (yes, before you called this, bestie — do not show up empty-handed). all the info about the principal gets stored in there. 👑

🦋 DESCRIPTION 🦋

so basically it extracts the info about the given PRINCIPAL@REALM pair — the one you picked out with principal and realm. that's it, that's the job. no cap, it just goes and pulls up the receipts for that pair. 🍓

⭐ RETURN VALUE ⭐

here's the vibe check on what comes back:

  • SHISA_OK — slay, it worked 💖
  • SHISA_NO_REALM — the realm you named doesn't exist 😭
  • SHISA_NO_PRINCIPAL — the principal you named doesn't exist 😭
  • or, you know, some other error code. generic L, sorry bestie 💀

🌈 REPORTING BUGS 🌈

found a bug? not the moment we wanted, but okay — 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.

(translation: use it, share it, remix it, just keep the receipts. iconic behavior honestly ✨)

🌸 SEE ALSO 🌸

the full documentation for shishi lives in a Texinfo manual, and if info and the shishi programs are properly installed at your site, this command:

info shishi

should give you access to the complete manual. go read it, i know you want to 📖💅

anyway that's the whole page, bestie — every flag, every arg, every return code, nothing skipped, we ate and left no crumbs 🎀✨

shishi, version 1.0.3, and this little shisa_principal_find(3) page is officially a wrap. mwah 💖 bye!! 🦋

📦 where this page comes from