EXPLAIN_FUTIMESAT_OR_DIE(3)

💖 explain_futimesat_or_die(3) 💖

okay bestie, sit down, we're doing a Library Functions Manual moment and honestly? this one is a bop. it's from the libexplain family, she's giving "wrapped syscall but make it chatty", and i'm obsessed. 🫶

---

✨ NAME ✨

explain_futimesat_or_die — change timestamps of a file relative to a directory and report errors

like. the name is the whole personality. it does the thing, and if the thing fails, it tells you why and then dramatically exits. main character energy fr fr. 💅

---

🌸 SYNOPSIS 🌸

#include <libexplain/futimesat.h>
void explain_futimesat_or_die(int fildes, const char *pathname, const
struct timeval *data);
int explain_futimesat_on_error(int fildes, const char *pathname, const
struct timeval *data);

two functions, two vibes. one of them is a lil dramatic (dies on failure), one of them is chill (comes back and tells you what happened). pick your fighter. 🥊

---

🦋 DESCRIPTION 🦋

so, explain_futimesat_or_die is the function you call when you want to call the futimesat(2) system call. and when it fails? no cap, an explanation gets printed to stderr, and that explanation comes straight from the explain_futimesat(3) function. and then, the process terminates by calling exit(EXIT_FAILURE). she said "we're not doing this today" and left. 💀

meanwhile, explain_futimesat_on_error is her calmer sibling. same energy, same call to futimesat(2), same explanation printed to stderr (again obtained from the explain_futimesat(3) function) — but instead of exiting, it still returns to the caller. respectful. mature. we love her. 🌈

now, the arguments, because details matter:

• fildes — the fildes, exactly as to be passed to the futimesat(2) system call. no extra seasoning, no notes, pass it through as-is. ✨
• pathname — the pathname, exactly as to be passed to the futimesat(2) system call. same deal, you're just the messenger. 🎀
• data — the data, exactly as to be passed to the futimesat(2) system call. you guessed it, verbatim, character for character. 🍓

---

👑 RETURN VALUE 👑

• explain_futimesat_or_die — only returns on success, and honestly? check futimesat(2) for more info on that. on failure it prints an explanation and exits, it does not return. like, at all. not even a little. 😭
• explain_futimesat_on_error — always returns the value returned by the wrapped futimesat(2) system call. consistent queen. 💜

---

🧚 EXAMPLE 🧚

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

explain_futimesat_or_die(fildes, pathname, data);

that's it. that's the whole glow-up. short, sweet, slays. ⭐

---

🔥 SEE ALSO 🔥

• futimesat(2) — change timestamps of a file relative to a directory
• explain_futimesat(3) — explain futimesat(2) errors
• exit(2) — terminate the calling process

go read these if you want the full lore, iykyk. 📚

---

💖 COPYRIGHT 💖

libexplain version 1.4 Copyright (C) 2013 Peter Miller

---

okay that's the whole page bestie, you ate, go call your syscalls responsibly 🌸💅 and remember: libexplain version 1.4, Copyright (C) 2013 Peter Miller, and the page is literally called explain_futimesat_or_die(3) — periodt. 🫶✨