explain_nice_or_die(3)

💅 explain_nice_or_die(3) — the libexplain girlies' guide

okay bestie, sit DOWN, we're talking about explain_nice_or_die(3) from the Library Functions Manual and honestly? it's giving "I change your process priority and I will tell you when it goes wrong." 🎀

---

✨ NAME ✨

explain_nice_or_die — change process priority and report errors. that's it, that's the whole job. she adjusts your niceness and she is not subtle about it 💅

---

🦋 SYNOPSIS 🦋

#include <libexplain/nice.h>
int explain_nice_or_die(int inc);
int explain_nice_on_error(int inc);

yes she comes with two flavours, like a duo, like a matching set, we love to see it 🌸

---

👑 DESCRIPTION 👑

okay so. here's the tea 🍓

The explain_nice_or_die function is used to call the nice(2) system call. On failure an explanation will be printed to stderr, obtained from the explain_nice(3) function, and then the process terminates by calling exit(EXIT_FAILURE).

translating from manpage-ese: she does the thing, and if the thing fails, she prints a whole explanation to stderr and then literally ends your process via exit(EXIT_FAILURE). no coming back. main character exits, periodt 💀

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

so yeah — same energy, same explanation to stderr, but this one stays. she tells you what went wrong and then hands the control right back to you, like the supportive bestie she is 🫶

---

🌈 the argument 🌈

• inc — the inc, exactly as to be passed to the nice(2) system call. like, word for word, no edits, no remixing, no "I thought this would be better" — she passes it through exactly as you gave it 💖

---

⭐ RETURN VALUE ⭐

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

so if you ever see her come back?? that means you WON. success only. on failure she's already gone, printing receipts on her way out 😭

The explain_nice_on_error function always returns the value return by the wrapped nice(2) system call.

no drama, no exit, just the value, every single time ✨

---

🧚 EXAMPLE 🧚

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

int result = explain_nice_or_die(inc);

that's it. that's the whole vibe. look how clean, look how crisp 😌💅

---

🔥 SEE ALSO 🔥

• nice(2) — change process priority
• explain_nice(3) — explain nice(2) errors
• exit(2) — terminate the calling process

the whole friend group, all linked up, iykyk 🌈

---

💜 COPYRIGHT 💜

libexplain version 1.4 Copyright (C) 2009 Peter Miller

---

and that's the page bestie!! go forth, change your process priority, and may your inc always be accepted 👑💖

okay love you, bye — this was explain_nice_or_die(3) from the Library Functions Manual, libexplain version 1.4, Copyright (C) 2009 Peter Miller. mwah 🎀✨