explain_se...ame_or_die(3)

✨ NAME ✨

hi bestie, welcome to explain_sethostname_or_die — she's a Library Functions Manual girly, section 3, and she does exactly one thing and she does it flawlessly.

• explain_sethostname_or_die — get/set hostname and report errors

Like, that's it. That's the whole job description. get/set hostname and report errors 💖

---

🎀 SYNOPSIS 🎀

the receipts, verbatim, no notes:

#include <libexplain/sethostname.h>
void explain_sethostname_or_die(const char *name, size_t name_size);
intexplain_sethostname_on_error(const char *name, size_t name_size);

---

💅 DESCRIPTION 💅

okay so here's the tea. The explain_sethostname_or_die function is used to call the sethostname(2) system call. On failure an explanation will be printed to stderr, obtained from the explain_sethostname(3) function, and then the process terminates by calling exit(EXIT_FAILURE).

so like. it does NOT do gentle. it does not do "oops let me tell you softly." it explains the problem and then it ends the process. dramatic? yes. effective? also yes. 💀

The explain_sethostname_on_error function is used to call the sethostname(2) system call. On failure an explanation will be printed to stderr, obtained from the explain_sethostname(3) function, but still returns to the caller.

so she's the chill one. same explanation, same stderr glow-up, but she comes back to you. she returns to the caller. she's not leaving you like that. 🫶

the args, bestie 🌸

• name — The name, exactly as to be passed to the sethostname(2) system call. exactly exactly. no remixing, no editing, no "I improved it a little."
• name_size — The name_size, exactly as to be passed to the sethostname(2) system call. same energy, same rule, exactly as-is.

---

🔥 RETURN VALUE 🔥

The explain_sethostname_or_die function only returns on success, see sethostname(2) for more information. On failure, prints an explanation and exits, it does not return.

ngl bestie, read that again: on failure it does not return. there is no "after failure" for her. she is gone. do not write code that assumes she comes back, she will not, she's not like that. 😭

The explain_sethostname_on_error function always returns the value return by the wrapped sethostname(2) system call. always. every single time. she's reliable like that 💜

---

🌸 EXAMPLE 🌸

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

explain_sethostname_or_die(name, name_size);

iconic. one line. no fuss. she understood the assignment. slay ✨

---

🦋 SEE ALSO 🦋

the whole friend group, go say hi:

• sethostname(2) — get/set hostname
• explain_sethostname(3) — explain sethostname(2) errors
• exit(2) — terminate the calling process

---

👑 COPYRIGHT 👑

• libexplain version 1.4
• Copyright (C) 2009 Peter Miller

---

and that's the whole page bestie, you ate, go set a hostname responsibly 💖✨

libexplain version 1.4 · Copyright (C) 2009 Peter Miller · and yes, the footer says explain_se...ame_or_die(3) because the title got a little truncated, she's still that girl 🌈🎀🦋