shishi_keys_fo...errealm_in_file(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_keys_fo...errealm_in_file(3) 💖

okay bestie, welcome to section 3 of the shishi manual — yes, the manual name is literally shishi, we're in the deep lore now. this one is an API function, and it's a whole vibe. let's get into it 🦋

✨ NAME ✨

shishi_keys_for_serverrealm_in_file — it's an API function, periodt.

🌸 SYNOPSIS 🌸

#include <shishi.h>

Shishi_key * shishi_keys_for_serverrealm_in_file(Shishi * handle, const
char * filename, const char * server, const char * realm);

🎀 ARGUMENTS 🎀

  • Shishi * handle — the Shishi library handle, made by shishi_init(). it's giving "the main character" of every call fr fr 💅
  • const char * filename — the file we're reading keys from. that's the whole assignment bestie 🗂️
  • const char * server — the server name you want a key for 👑
  • const char * realm — the realm of that server you want a key for 🌈

🫶 DESCRIPTION 🫶

so like, this function gets the keys that match the server and realm you specified, pulling them out of the key set file called filename. that's it, that's the job, and it does it flawlessly no cap ✨

⭐ RETURN VALUE ⭐

it returns the key for that specific server and realm, read straight out of the file you pointed at. OR — and this is the part we don't love — it returns NULL if no key could be found, or if an error got encountered along the way 😭 so always check, bestie, don't just assume.

🙈 REPORTING BUGS 🙈

found a bug? not the vibe. 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 behaviour honestly, slay.

🧚 SEE ALSO 🧚

the full documentation for shishi is maintained as a Texinfo manual — yes, a whole Texinfo manual, it's a lot, we respect it 💜. if the info and shishi programs are properly installed at your site, this command:

info shishi

should give you access to the complete manual. iykyk 📖✨

and that's the whole page, bestie!! nothing skipped, every last flag and fact accounted for 🍓

signing off from the shishi manual, version 1.0.3, page shishi_keys_fo...errealm_in_file(3) — go read your keys, stay hydrated, and don't forget to check for NULL 💅💖

📦 where this page comes from