EXPLAIN_GETRUSAGE_OR_DIE(3)

✨ explain_getrusage_or_die(3) ✨

okay so bestie, this one lives in the Library Functions Manual, and it's literally called explain_getrusage_or_die — yes the name is dramatic, no we are not sorry 💅

---

🎀 NAME 🎀

explain_getrusage_or_die — get resource usage and report errors

like. it gets your resource usage. and if it can't? it reports the errors. main character behaviour fr fr.

---

🌸 SYNOPSIS 🌸

#include <libexplain/getrusage.h>
void explain_getrusage_or_die(int who, struct rusage *usage);
int explain_getrusage_on_error(int who, struct rusage *usage);

two functions, one header, zero vibes wasted ✨

---

💖 DESCRIPTION 💖

so. the explain_getrusage_or_die function is used to call the getrusage(2) system call. and if that call fails? an explanation gets printed to stderr — grabbed from the explain_getrusage(3) function — and then the process terminates by calling exit(EXIT_FAILURE). like it's done. it's over. no coming back from that one 😭

meanwhile the explain_getrusage_on_error function also calls the getrusage(2) system call, and on failure it also prints an explanation to stderr from explain_getrusage(3) — but this one is chill, it still returns to the caller. it does not exit. it stays. 🫶

• who — the who, exactly as to be passed to the getrusage(2) system call. like, don't get creative with it, pass it through as-is 💫
• usage — the usage, exactly as to be passed to the getrusage(2) system call. same energy. verbatim. no edits, no remixes 👑

---

⭐ RETURN VALUE ⭐

explain_getrusage_or_die only returns on success — peep getrusage(2) for more info on that. on failure? it prints an explanation and exits. it does not return. it is gone. not me waiting for a return value that is never coming 💀

explain_getrusage_on_error always returns the value returned by the wrapped getrusage(2) system call. every single time. consistent queen 👑

---

🦋 EXAMPLE 🦋

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

explain_getrusage_or_die(who, usage);

that's it. that's the whole example. short, sweet, iconic 🎀

---

🌈 SEE ALSO 🌈

• getrusage(2) — get resource usage
• explain_getrusage(3) — explain getrusage(2) errors
• exit(2) — terminate the calling process

iykyk, the whole little family 💜

---

👑 COPYRIGHT 👑

libexplain version 1.4 Copyright (C) 2013 Peter Miller

---

and that's the whole page bestie!! 💖 this was explain_getrusage_or_die(3) from libexplain version 1.4, copyright (C) 2013 Peter Miller — go forth and get that resource usage, you absolute legend 🦋✨ periodt.