explain_nice(3)

💖 explain_nice(3) 💖

okay bestie, welcome to the explain_nice(3) page from the Library Functions Manual — we're about to make nice(2) errors make sense, and honestly? it's giving helpful. ✨

---

🌸 NAME 🌸

explain_nice — explain nice(2) errors 🫶

---

🎀 SYNOPSIS 🎀

#include <libexplain/nice.h>
const char *explain_nice(int inc);
const char *explain_errno_nice(int errnum, int inc);
void explain_message_nice(char *message, int message_size, int inc);
void explain_message_errno_nice(char *message, int message_size, int
errnum, int inc);

---

💅 DESCRIPTION 💅

So like, these functions? They're the ones you call when you wanna get actual explanations for errors that the nice(2) system call handed back to you. no cap. 🔥

✨ explain_nice ✨

const char *explain_nice(int inc);

The explain_nice function is your girl for getting an explanation of an error that nice(2) returned. The absolute bare minimum the message will contain is the value of strerror(errno), but usually it does so much better than that and tells you the underlying cause in way more detail. obsessed. 💖

The errno global variable gets used to grab the error value that needs decoding.

• inc — the original inc, exactly as it was passed to the nice(2) system call. don't get cute with it, pass it as-is.

Returns:

The message explaining the error. This message buffer is shared by all libexplain functions that don't supply a buffer in their argument list. It will get overwritten by the next call to any libexplain function that shares this buffer — including calls from other threads. 💀

Note: This function is not thread safe, because it shares a return buffer across all threads, and so do many other functions in this library. like, it's a whole thing.

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

int result = nice(inc);
if (result < 0)
{
    fprintf(stderr, "%s\n", explain_nice(inc));
    exit(EXIT_FAILURE);
}

The above code example is available pre‐packaged as the explain_nice_or_die(3) function. 🎁

---

🌈 explain_errno_nice 🌈

const char *explain_errno_nice(int errnum, int inc);

The explain_errno_nice function is used to obtain an explanation of an error returned by the nice(2) system call. The least the message will contain is the value of strerror(errno), but usually it will do much better, and indicate the underlying cause in more detail. main character energy fr fr. 👑

• errnum — the error value to be decoded, usually grabbed from the errno global variable right before this function gets called. This is necessary if you need to call any code between the system call you're explaining and this function, because a bunch of libc functions will alter the value of errno. yes, they're messy like that. 🙈
• inc — the original inc, exactly as passed to the nice(2) system call.

Returns:

The message explaining the error. This message buffer is shared by all libexplain functions which do not supply a buffer in their argument list. This will be overwritten by the next call to any libexplain function which shares this buffer, including other threads. 💀

Note: This function is not thread safe, because it shares a return buffer across all threads, and many other functions in this library. same vibes as before, sorry bestie.

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

int result = nice(inc);
if (result < 0)
{
    int err = errno;
    fprintf(stderr, "%s\n", explain_errno_nice(err, inc));
    exit(EXIT_FAILURE);
}

The above code example is available pre‐packaged as the explain_nice_or_die(3) function. 🎁

---

🦋 explain_message_nice 🦋

void explain_message_nice(char *message, int message_size, int inc);

The explain_message_nice function is used to obtain an explanation of an error returned by the nice(2) system call. The least the message will contain is the value of strerror(errno), but usually it will do much better, and indicate the underlying cause in more detail. slay. ✨

The errno global variable will be used to obtain the error value to be decoded.

• message — the location in which to store the returned message. If a suitable message return buffer is supplied, this function is thread safe. 🫶
• message_size — the size in bytes of the location in which to store the returned message.
• inc — the original inc, exactly as passed to the nice(2) system call.

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

int result = nice(inc);
if (result < 0)
{
    char message[3000];
    explain_message_nice(message, sizeof(message), inc);
    fprintf(stderr, "%s\n", message);
    exit(EXIT_FAILURE);
}

The above code example is available pre‐packaged as the explain_nice_or_die(3) function. 🎁

---

🧚 explain_message_errno_nice 🧚

void explain_message_errno_nice(char *message, int message_size, int
errnum, int inc);

The explain_message_errno_nice function is used to obtain an explanation of an error returned by the nice(2) system call. The least the message will contain is the value of strerror(errno), but usually it will do much better, and indicate the underlying cause in more detail. ate, no crumbs. 🔥

• message — the location in which to store the returned message. If a suitable message return buffer is supplied, this function is thread safe. 💖
• message_size — the size in bytes of the location in which to store the returned message.
• errnum — the error value to be decoded, usually obtained from the errno global variable just before this function is called. This is necessary if you need to call any code between the system call to be explained and this function, because many libc functions will alter the value of errno. (they really do, keep an eye on them 😭)
• inc — the original inc, exactly as passed to the nice(2) system call.

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

int result = nice(inc);
if (result < 0)
{
    int err = errno;
    char message[3000];
    explain_message_errno_nice(message, sizeof(message), err,
    inc);
    fprintf(stderr, "%s\n", message);
    exit(EXIT_FAILURE);
}

The above code example is available pre‐packaged as the explain_nice_or_die(3) function. 🎁

---

👀 SEE ALSO 👀

• nice(2) — change process priority 🌟
• explain_nice_or_die(3) — change process priority and report errors 💫

---

💜 COPYRIGHT 💜

libexplain version 1.4 Copyright (C) 2009 Peter Miller

---

and that's the whole page bestie, we ate and left zero crumbs 💅✨

iykyk — this was explain_nice(3) from libexplain version 1.4, copyright (C) 2009 Peter Miller. go forth and explain your errors, gorgeous 🎀🦋