explain_ge...ame_or_die(3)

💅 explain_ge...ame_or_die(3) — Library Functions Manual ✨

okay bestie, welcome to explain_ge...ame_or_die(3), the page where we talk about looking up a host by its name and not being dramatic when it goes wrong. well. not being dramatic about it silently, anyway. 🦋

---

🌸 NAME 🌸

explain_gethostbyname_or_die — get host address by host name and report errors 🎀

---

✨ SYNOPSIS ✨

#include <libexplain/gethostbyname.h>
struct hostent *explain_gethostbyname_or_die(const char *name);
struct hostent *explain_gethostbyname_on_error(const char *name);

---

🫶 DESCRIPTION 🫶

so here's the tea, fr fr. there are two functions on this page and they're like siblings — same energy, different vibes at the end. 💖

The explain_gethostbyname_or_die function is used to call the gethostbyname(3) system call. On failure an explanation will be printed to stderr, obtained from the explain_gethostbyname(3) function, and then the process terminates by calling exit(EXIT_FAILURE). like. it's giving "we tried, we explained, we left." 💀

The explain_gethostbyname_on_error function is used to call the gethostbyname(3) system call. On failure an explanation will be printed to stderr, obtained from the explain_gethostbyname(3) function, but still returns to the caller. lowkey the more emotionally mature one tbh — it tells you what happened and then just. stays. 🌈

• name — The name, exactly as to be passed to the gethostbyname(3) system call. no edits, no cute little tweaks, just hand it over exactly as-is, periodt. 💅

---

⭐ RETURN VALUE ⭐

The explain_gethostbyname_or_die function only returns on success, see gethostbyname(3) for more information. On failure, prints an explanation and exits, it does not return. so like, if you got a value back? slay, it worked. if not? you're not getting anything back, because you're not there anymore. 😭

The explain_gethostbyname_on_error function always returns the value return by the wrapped gethostbyname(3) system call. every single time, no exceptions, iconic behavior honestly. 👑

---

🎀 EXAMPLE 🎀

The explain_gethostbyname_or_die function is intended to be used in a fashion similar to the following example:

struct hostent *result = explain_gethostbyname_or_die(name);

one line. that's the whole vibe. eat it up. 🍓

---

💜 SEE ALSO 💜

• gethostbyname(3) — get host address given host name
• explain_gethostbyname(3) — explain gethostbyname(3) errors
• exit(2) — terminate the calling process

---

🌟 COPYRIGHT 🌟

libexplain version 1.4 Copyright (C) 2013 Peter Miller

---

and that's the whole page bestie, we ate and left no crumbs 🧚💖 this has been explain_ge...ame_or_die(3) from the libexplain crew — libexplain version 1.4, lovingly copyright Peter Miller, 2013. take care of her, she's a classic. 🎀✨