EXPLAIN_SETTIMEOFDAY_OR_DIE(3)

💖 explain_settimeofday_or_die(3) 💖

okay bestie, so this one lives in the Library Functions Manual section (section 3, the "functions" girlies) and it's literally called explain_settimeofday_or_die. iconic name, no notes. ✨

---

🌸 NAME 🌸

explain_settimeofday_or_die — sets system time and report errors

---

🎀 SYNOPSIS 🎀

#include <libexplain/settimeofday.h>
void explain_settimeofday_or_die(const struct timeval *tv, const struct
timezone *tz);
int explain_settimeofday_on_error(const struct timeval *tv, const struct
timezone *tz);

---

✨ DESCRIPTION ✨

okay so here's the tea 🫖. The explain_settimeofday_or_die function exists to call the settimeofday(2) system call. And like… if that call fails? An explanation gets printed to stderr — and that explanation is obtained from the explain_settimeofday(3) function — and then the process just ✨terminates✨ by calling exit(EXIT_FAILURE). it's giving "no second chances". dramatic? maybe. effective? yes. 💅

The explain_settimeofday_on_error function is the chill sibling 🧚. It also calls the settimeofday(2) system call, and on failure it also prints an explanation to stderr, also obtained from the explain_settimeofday(3) function — but then it just… still returns to the caller. no exit, no drama, we keep it moving. 🌈

• tv — the tv, exactly as to be passed to the settimeofday(2) system call. like, character for character, don't get cute with it.
• tz — the tz, exactly as to be passed to the settimeofday(2) system call. same energy, same rules. 🍓

---

👑 RETURN VALUE 👑

The explain_settimeofday_or_die function only returns on success — see settimeofday(2) for more information. On failure it prints an explanation and exits, so like… it does not return. periodt. 💀

The explain_settimeofday_on_error function always returns the value return by the wrapped settimeofday(2) system call. (yes, "return by" — that's the original wording, we keep the facts exactly as they are, bestie 🫶)

---

🌟 EXAMPLE 🌟

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

explain_settimeofday_or_die(tv, tz);

that's it. that's the whole vibe. one line, main character energy. ✨

---

🔥 SEE ALSO 🔥

• settimeofday(2) — sets system time
• explain_settimeofday(3) — explain settimeofday(2) errors
• exit(2) — terminate the calling process

---

💜 COPYRIGHT 💜

libexplain version 1.4 Copyright (C) 2013 Peter Miller

---

and that's the whole page, bestie!! 🎀 this lil icon is from libexplain version 1.4, copyright held down by Peter Miller in 2013, and yeah the header/footer were literally explain_se...fday_or_die(3) because even the manpage was like "the name is too long, abbreviating, hope that's fine" 😭💖 mwah, go call settimeofday responsibly 🦋