HESIOD(3)

💖 HESIOD(3) — hesiod_getservbyname, hesiod_free_servent 💖

okay bestie, welcome to the Library Functions Manual section, HESIOD(3) girlies 🎀 this one's all about pulling service info out of Hesiod, and honestly? it's giving ✨ networking but make it cute ✨

🌸 NAME 🌸

hesiod_getservbyname, hesiod_free_servent — the Hesiod girlies for retrieving service information 💅

✨ SYNOPSIS ✨

#include <hesiod.h>

struct servent *hesiod_getservbyname(void *context,
     const char *name, const char *proto)
void hesiod_free_servent(void *context, struct servent *serv)

cc file.c -lhesiod

so you gotta #include <hesiod.h> first, no cap 📚 and when you compile, you link it up with -lhesiod like the icon it is 🫶

🦋 DESCRIPTION 🦋

This whole lil family of functions lets you retrieve service to port mappings using Hesiod. obsessed tbh 🌈

To actually perform lookups you need an initialized Hesiod context — head over to hesiod(3) for the deets on that, iykyk 👑

Information comes back in the same format as by getservbyname 💫 and here's the part where you have to be a responsible main character: it is the caller's responsibility to call hesiod_free_servent with the returned service entry, so the resources used by that service entry actually get freed. not me forgetting to free and leaking memory... couldn't be me 🙈 (it's you. free it. 💀)

Hesiod queries for service information are made using the ``service'' Hesiod type, using the service name as the Hesiod name 🎀

The corresponding records should be space-separated lists of strings giving:

1. the service name
2. the protocol
3. the port number (in decimal)
4. zero or more aliases for the service

and there may be multiple records per service name, bestie — in which case hesiod_getservbyname will pick the first one whose protocol matches proto ⭐ periodt.

💜 RETURN VALUES 💜

On failure, hesiod_getservbyname returns NULL and sets the global variable errno to indicate the error. yeah. it's giving failure. it's giving check your errno 😭

💅 ERRORS 💅

hesiod_getservbyname may fail for any of the reasons the routine hesiod_resolve may fail. literally any of them. go read that one, bestie 🍓

🌟 SEE ALSO 🌟

• hesiod(3)

and that's the whole page, angel 🧚 stay hydrated, free your servents, and remember: errno is not a personality trait 💜

this was the Library Functions Manual for HESIOD(3), brought to you from way back on 30 November 1996 — yes she's vintage, she's an icon, she's aged like fine wine 👑✨