EXPLAIN_GETRLIMIT_OR_DIE(3)

💖 explain_getrlimit_or_die(3) 💖

okay bestie, gather round, because this one is a library function from the Library Functions Manual and she is here to hold your hand while you ask the kernel for your resource limits 🫶

---

✨ NAME ✨

explain_getrlimit_or_die — get resource limits and report errors 💅

---

🌸 SYNOPSIS 🌸

#include <libexplain/getrlimit.h>
void explain_getrlimit_or_die(int resource, struct rlimit *rlim);

---

🦋 DESCRIPTION 🦋

so like, the explain_getrlimit_or_die function is what you call when you wanna hit up the getrlimit(2) system call, but you also want someone to narrate the tragedy if it goes wrong 😭

if it fails? an explanation gets printed to stderr, sourced straight from explain_getrlimit(3), and then the process literally terminates by calling exit(EXIT_FAILURE). it's giving "we die with receipts" 💀

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

explain_getrlimit_or_die(resource, rlim);

the parameters, queen 👑

• resource — the resource, exactly as to be passed to the getrlimit(2) system call. no extra seasoning, no substitutions, copy her over verbatim.
• rlim — the rlim, exactly as to be passed to the getrlimit(2) system call. same deal, bestie.

Returns: 💌

this function only returns on success. on failure, it prints an explanation and exits. that's it, that's the whole vibe. she does not do "returns with an error code", she does "we're done here" 🎀

fr fr, don't be out here expecting a return value on failure. there isn't one. there's just the exit. periodt.

---

👑 SEE ALSO 👑

• getrlimit(2) — get resource limits
• explain_getrlimit(3) — explain getrlimit(2) errors
• exit(2) — terminate the calling process

---

🎀 COPYRIGHT 🎀

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

---

and that's the whole page, bestie 🌈 this was libexplain version 1.4, with the copyright held by Peter Miller, 2008 — go forth and get those resource limits, you absolute icon 💜✨