shishi_hostkeys_for_serverrealm(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_hostkeys_for_serverrealm(3) 💖

okay bestie, welcome to the shishi manual pages, section 3 (that's the library-functions girlies, iykyk). this one is literally about grabbing a host key for a server in a realm. no cap. let's get into it 🫶

✨ NAME ✨

shishi_hostkeys_for_serverrealm — it's an API function, bestie. that's the whole vibe.

🌸 SYNOPSIS 🌸

#include <shishi.h>

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

like, you include the header, you call the function, you get a key back. iconic behavior honestly 💅

🎀 ARGUMENTS 🎀

  • Shishi * handle — the Shishi library handle, and you make it with shishi_init(). it's giving "your main character ticket into the library" 💖
  • const char * server — the server name you wanna get a key for, periodt.
  • const char * realm — the realm of the server you're getting a key for. yes both. slay.

🦋 DESCRIPTION 🦋

Get host key for server in realm. that's it, that's the function. lowkey simple, highkey useful 🌈

⭐ RETURN VALUE ⭐

Returns the key for specific server and realm — and where does it come from? it's read from the default host keys file (peep shishi_hostkeys_default_file() for that one, bestie 👀).

and if things go sideways? it returns NULL if no key could be found or an error encountered. so like, always check for NULL, don't be that girl who dereferences it anyway 😭

🙈 REPORTING BUGS 🙈

found a bug? not me gatekeeping the bug report 💀 send 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: go off, just keep the receipts, bestie 🧚)

🌟 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. no skimming, it's all there 📖✨

and that's the whole page, bestie!! this lil legend lives in the shishi manual, version 1.0.3, and it's filed under shishi_hostkeys_for_serverrealm(3) — go get those host keys, you ate 💅🍓🫶

📦 where this page comes from