explain_futimens_or_die(3)

💅 explain_futimens_or_die — Library Functions Manual 💅

okay bestie, sit down, hydrate, and let me tell you about explain_futimens_or_die(3) 🫶

---

✨ NAME ✨

explain_futimens_or_die — change file timestamps and report errors 💖

---

🎀 SYNOPSIS 🎀

#include <libexplain/futimens.h>
void explain_futimens_or_die(int fildes, const struct time_spec *data);
int explain_futimens_on_error(int fildes, const struct time_spec *data);

---

🌸 DESCRIPTION 🌸

okay so, explain_futimens_or_die is the function you call when you want to call the futimens(3) system call, except you're not in the mood to be left confused when it goes wrong. 🦋

If it fails, an explanation gets printed to stderr, and that explanation comes from the explain_futimens(3) function. Then the process terminates by calling exit(EXIT_FAILURE). yeah. it really said "we're done here." 💀

Meanwhile, explain_futimens_on_error is the softer sibling 🧚 — it also calls the futimens(3) system call, and on failure it also prints an explanation to stderr obtained from explain_futimens(3), but it still returns to the caller instead of nuking your whole process. lowkey the responsible one.

• fildes — the fildes, exactly as to be passed to the futimens(3) system call. no editing, no vibes-based remixing, just pass it through. ✨
• data — the data, exactly as to be passed to the futimens(3) system call. same energy. 💜

---

👑 RETURN VALUE 👑

explain_futimens_or_die only returns on success — see futimens(3) for more info, bestie. On failure, it prints an explanation and exits, so like… it does not return. at all. it's giving "no notes, goodbye." 💅

explain_futimens_on_error always returns the value returned by the wrapped futimens(3) system call. periodt. 🌟

---

🌈 EXAMPLE 🌈

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

explain_futimens_or_die(fildes, data);

that's it, that's the whole thing, and it ate. 🔥

---

🍓 SEE ALSO 🍓

• futimens(3) — change file timestamps with nanosecond precision ⭐
• explain_futimens(3) — explain futimens(3) errors 💖
• exit(2) — terminate the calling process 💀

---

💜 COPYRIGHT 💜

libexplain version 1.4 Copyright (C) 2013 Peter Miller

---

and that's the whole page bestie!! 🎀 thanks for reading all the way to the bottom, you're literally the main character. mwah. 💅✨🦋

libexplain version 1.4 · Copyright (C) 2013 Peter Miller · explain_futimens_or_die(3)