UTIMENSAT(3POSIX)

💖 UTIMENSAT(3POSIX) 💖

okay bestie, so this one's from the POSIX Programmer's Manual — it's the utimensat(3POSIX) page, and it's short but she's cute, let's go 🎀

✨ PROLOG ✨

so like, real talk before we even start: this manual page is part of the POSIX Programmer's Manual. The Linux implementation of this interface may differ — so if you're on Linux, go consult the corresponding Linux manual page for the deets on how Linux actually behaves, bestie, don't come for me 🙈.

and also 👀 the interface may not be implemented on Linux at all. vibe check: could be there, could not be. check your system, not me.

🌸 NAME 🌸

utimensat, utimes — set file access and modification times ✨

🦋 SYNOPSIS 🦋

okay here's the whole shape of it, copy it exactly bestie:

#include <sys/stat.h>

int utimensat(int fd, const char *path, const struct timespec times[2],
    int flag);

#include <sys/time.h>

int utimes(const char *path, const struct timeval times[2]);

like, two different headers, two different functions, one mission 💅

💜 DESCRIPTION 💜

Refer to futimens().

that's it. that's the whole description. she's giving "go read your sister's page" energy and honestly? iconic. go check out futimens() 👑

👑 COPYRIGHT 👑

okay so legal girlie moment, but I'm keeping every word of this because rules are rules 🫶:

Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group.

In the event of any discrepancy between this version and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. No cap, that's the one that counts.

The original Standard can be obtained online at http://www.opengroup.org/unix/online.html .

Any typographical or formatting errors that appear in this page are most likely to have been introduced during the conversion of the source files to man page format. To report such errors, see https://www.kernel.org/doc/man-pages/reporting_bugs.html .

and that's the whole page, bestie!! this one came to you straight from IEEE/The Open Group, dated 2017, and you found her filed under UTIMENSAT(3POSIX) 💖 mwah, go touch some timestamps (the file kind, not the parasocial kind) ✨🦋🌸