explain_fstatfs_or_die(3)

✨ explain_fstatfs_or_die(3) ✨

okay so bestie, buckle up, this is a page from the Library Functions Manual and it's literally all about grabbing file system stats and then being super dramatic when things go wrong. 🎀

---

💖 NAME 💖

explain_fstatfs_or_die — get file system statistics and report errors 🦋

---

🌸 SYNOPSIS 🌸

#include <libexplain/fstatfs.h>
void explain_fstatfs_or_die(int fildes, struct statfs *data);
int explain_fstatfs_on_error(int fildes, struct statfs *data);

---

👑 DESCRIPTION 👑

so there's these two functions and they're basically the same vibe, except one of them is a main character who cannot handle failure and the other one is chill about it. 💅

The explain_fstatfs_or_die function is used to call the fstatfs(2) system call. On failure an explanation will be printed to stderr, obtained from the explain_fstatfs(3) function, and then the process terminates by calling exit(EXIT_FAILURE). 😭 like, it does not come back. it's giving "we die like men". periodt.

The explain_fstatfs_on_error function is used to call the fstatfs(2) system call. On failure an explanation will be printed to stderr, obtained from the explain_fstatfs(3) function, but still returns to the caller. so it tells you what went wrong and then just... hands you back the L and lets you keep going. iconic behavior honestly. 🫶

• fildes — The fildes, exactly as to be passed to the fstatfs(2) system call. no notes, no changes, hand it over exactly like that fr fr.
• data — The data, exactly as to be passed to the fstatfs(2) system call. same deal, verbatim, don't be weird about it. ✨

---

🌈 RETURN VALUE 🌈

The explain_fstatfs_or_die function only returns on success, see fstatfs(2) for more information. On failure, prints an explanation and exits, it does not return. like at all. never. 💀

The explain_fstatfs_on_error function always returns the value return by the wrapped fstatfs(2) system call. so you always get something back, bestie. 🍓

---

🧚 EXAMPLE 🧚

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

explain_fstatfs_or_die(fildes, data);

that's it. that's the whole vibe. lowkey gorgeous. 🌸

---

⭐ SEE ALSO ⭐

• fstatfs(2) — get file system statistics
• explain_fstatfs(3) — explain fstatfs(2) errors
• exit(2) — terminate the calling process

---

💜 COPYRIGHT 💜

libexplain version 1.4 Copyright (C) 2009 Peter Miller

---

okay that's the whole page bestie, go forth and get those file system statistics responsibly 🦋✨ and yeah — this was explain_fstatfs_or_die(3) from the Library Functions Manual, running libexplain version 1.4, with the copyright sitting pretty at Copyright (C) 2009 Peter Miller. love that for us. no cap. 💖👑