shishi_realm_for_server(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_realm_for_server ✨

okay bestie so this is a page from the shishi manual — section 3, the library-calls section, iykyk — and it's all about shishi_realm_for_server, which is literally the girl whose whole job is finding you a realm. let's get into it 💅

🌸 NAME 🌸

shishi_realm_for_server — it's an API function, babe. that's the whole name. short, sweet, does exactly what it says on the tin 🎀

🦋 SYNOPSIS 🦋

#include <shishi.h>

char * shishi_realm_for_server(Shishi * handle, char * server);

like... include the header, call the function, get a realm. slay. ✨

💖 ARGUMENTS 💖

  • Shishi * handle — this is your Shishi library handle, and you get it by calling shishi_init(). no handle, no service, periodt. it's the little ✨entry pass✨ to the whole library.
  • char * server — the hostname you want a realm for. just hand her the name and she'll go find out what realm it belongs to 🫶

👑 DESCRIPTION 👑

so here's the tea: shishi_realm_for_server finds a realm for the host server, and it does that using various methods. it's giving resourceful. it's giving main character energy. 💅

currently — and yes, "currently" is doing real work in that sentence, the methods can grow — those methods are:

  1. static configuration files, via the library call shishi_realm_for_server_file(), and
  2. DNS lookup, via shishi_realm_for_server_dns().

and the order matters, bestie: they are attempted in the stated order. so the file one gets first dibs, then DNS steps in. 🌈

if you want the actual details on either of those, go read the documentation of whichever function you're curious about — this page is not gonna steal their spotlight. 🙈

⭐ RETURN VALUE ⭐

you get back the realm for the host you asked about. 💖

and if nothing is known about server? you get NULL. that's it, that's the whole story. no realm, no vibes, NULL. 😭

💀 REPORTING BUGS 💀

found a bug? first of all, not the vibe, but also — please tell the people who can fix it. report bugs 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. 💜 (yes, that's the actual legal permission, and it's honestly kind of generous of them. iconic behavior.)

🔥 SEE ALSO 🔥

the full documentation for shishi is maintained as a Texinfo manual — that's the big one, the whole encyclopedia. 🧚

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 forth and read, bestie 📚✨

and that's the page!! 🌸 this was shishi_realm_for_server(3), shipped as part of shishi 1.0.3 — mwah, no notes, go find your realms 🫶💖💅

📦 where this page comes from