explain_usleep_or_die(3)

💖 explain_usleep_or_die — the libexplain girlies' guide 💖

okay so bestie, you're in the Library Functions Manual section, page explain_usleep_or_die(3), and honestly? this one is a whole mood. it's giving "sleep on purpose, but make it ✨accountable✨". let's go 🫶

---

✨ NAME ✨

explain_usleep_or_die — suspend execution for ms intervals and report errors 🌸

---

🎀 SYNOPSIS 🎀

#include <libexplain/usleep.h>
void explain_usleep_or_die(long long usec);
int explain_usleep_on_error(long long usec);

---

🦋 DESCRIPTION 🦋

so here's the tea, bestie. there are two functions in this house and they both call usleep(3), but they handle the drama very differently.

💅 explain_usleep_or_die

the explain_usleep_or_die function is used to call the usleep(3) system call. if it fails, an explanation gets printed to stderr — that explanation is obtained from the explain_usleep(3) function — and then, and I cannot stress this enough, the process terminates by calling exit(EXIT_FAILURE). like. it's literally in the name, babe. it dies. 💀

🌸 explain_usleep_on_error

the explain_usleep_on_error function is also used to call the usleep(3) system call. on failure an explanation gets printed to stderr too, also obtained from the explain_usleep(3) function — but this one still returns to the caller. it's the chill one. it tells you what went wrong and then lets you keep living your life. no cap. 🙈

🍓 the argument

• usec — the usec, exactly as to be passed to the usleep(3) system call. no remixing, no editing, exactly. periodt.

---

⭐ RETURN VALUE ⭐

the explain_usleep_or_die function only returns on success — see usleep(3) for more information. on failure, it prints an explanation and exits, so yeah, it does not return. like at all. it's gone. 🧚

the explain_usleep_on_error function always returns the value return by the wrapped usleep(3) system call. every single time. iconic behaviour honestly.

---

🔥 EXAMPLE 🔥

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

explain_usleep_or_die(usec);

that's it. that's the whole vibe. chef's kiss. 👑

---

🌈 SEE ALSO 🌈

• usleep(3) — suspend execution for microsecond intervals
• explain_usleep(3) — explain usleep(3) errors
• exit(2) — terminate the calling process

---

👑 COPYRIGHT 👑

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

---

okay so real talk: if you're reaching for explain_usleep_or_die, you already know the failure path is gonna be loud. that's the whole point, bestie. it tells you what happened and then it's lights out. use it when you genuinely cannot continue. 💜

and that's the page, fr fr — we were chilling in the Library Functions Manual, hanging out on the explain_usleep_or_die(3) page, with libexplain version 1.4 and that Copyright (C) 2013 Peter Miller energy. slay, bye 💖✨🎀