explain_futimes_or_die(3)

💖 explain_futimes_or_die(3) 💖

okay bestie, welcome to the Library Functions Manual page for explain_futimes_or_die — yes that's the whole name, yes it's a mouthful, no we're not shortening it, it's iconic 💅

---

✨ NAME ✨

explain_futimes_or_die — change file timestamps and report errors 🕰️

---

🌸 SYNOPSIS 🌸

#include <libexplain/futimes.h>
void explain_futimes_or_die(int fildes, const struct timeval *tv);

---

🦋 DESCRIPTION 🦋

so the explain_futimes_or_die function is literally just here to call the futimes(3) system call for you. and if things go sideways? an explanation gets printed to stderr, grabbed from explain_futimes(3), and then the process terminates by calling exit(EXIT_FAILURE). no cap, it just ends it right there 😭

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

explain_futimes_or_die(fildes, tv);

• fildes — the fildes, exactly as to be passed to the futimes(3) system call. no notes, pass it through as-is 💫
• tv — the tv, exactly as to be passed to the futimes(3) system call. same energy, straight through 🫶

Returns:

this function only returns on success. on failure, it prints an explanation and exits. that's it, that's the deal 🙈

---

👀 SEE ALSO 👀

• futimes(3) — change file timestamps
• explain_futimes(3) — explain futimes(3) errors
• exit(2) — terminate the calling process

---

👑 COPYRIGHT 👑

libexplain version 1.4 Copyright (C) 2008 Peter Miller

---

and that's the whole page, bestie, we ate 🍓✨ this was explain_futimes_or_die(3) from the Library Functions Manual, brought to you by libexplain version 1.4, copyright (C) 2008 Peter Miller — periodt 💜🧚