shishi_hostkey...calservicerealm(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_localservicerealm — the manual page, bestie edition 💖

okay so you're reading the manpage for shishi_hostkey...calservicerealm(3) (yes the title got truncated, it's giving mysterious, it's fine). This is part of the shishi manual, section 3, and it's about grabbing host keys. Sit down, hydrate, let's go 🫶

✨ NAME ✨

shishi_hostkeys_for_localservicerealm — it's an API function, no cap 💅

🌸 SYNOPSIS 🌸

#include <shishi.h>

Shishi_key * shishi_hostkeys_for_localservicerealm(Shishi * handle,
const char * service, const char * realm);

like, that's the whole vibe. one function, three args, returns a key pointer 🔑

🎀 ARGUMENTS 🎀

  • Shishi * handle — the Shishi library handle, created by shishi_init(). it's the main character of the whole operation, everything flows through it ✨
  • const char * service — the service you want the key for. tell it what you're trying to talk to 💖
  • const char * realm — the realm of the server you want the key for. or pass NULL if you just want the default realm, no stress, she'll handle it 🧚

🦋 DESCRIPTION 🦋

Get the host key for a service on the current host, in the realm you asked for. That's it, that's the job. Simple, elegant, iconic. 👑

🔥 RETURN VALUE 🔥

Returns the key for the server "SERVICE/HOSTNAME@REALM" — and yes, HOSTNAME there means the current system's actual hostname, not a placeholder you fill in yourself, she figures it out 💅

That key gets read from the default host keys file (peep shishi_hostkeys_default_file() if you wanna know which file that even is, iykyk).

And if things go sideways? You get NULL. That happens when no key could be found, or when an error was encountered. So like... always check for NULL, bestie, don't be out here dereferencing nothing 😭💀

🙈 REPORTING BUGS 🙈

Found a bug? Not you being a hero 🫶 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: share it, remix it, just keep the receipts, periodt ✨)

🌈 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, this command:

info shishi

should give you access to the complete manual. go read it, it's a whole vibe 📚💜

okay that's the whole page, thanks for coming to my TED talk 💖

this was shishi version 1.0.3, and yeah the page title in the footer is still that truncated shishi_hostkey...calservicerealm(3) situation — we love a consistent aesthetic 🎀✨ bye bestie, stay keyed 🦋

📦 where this page comes from