OPENAT(3POSIX)

💖 openat(3POSIX) 💖

okay bestie, so this one's from the POSIX Programmer's Manual — that's the manual name right there in the corner, 3POSIX and all — and it's the tiniest little diva of a page, so let's just vibe through it together 🦋

✨ PROLOG ✨

so like, this manual page is part of the POSIX Programmer's Manual, and ngl there's some fine print you need to know:

• the Linux implementation of this interface may differ — so go check the corresponding Linux manual page for the deets on Linux behavior, fr fr
• or, plot twist 😭, the interface may not be implemented on Linux at all

that's it. that's the prolog. no cap.

🌸 NAME 🌸

openat — open file relative to directory file descriptor

like… open a file, but the path is resolved relative to a directory file descriptor instead of your current working directory. it's giving "everything is relative, bestie" 💅

✨ SYNOPSIS ✨

#include <fcntl.h>

int openat(int fd, const char *path, int oflag, ...);

look at that signature. <fcntl.h> header, fd first, path next, oflag after that, and then ... — the vibes are variadic, iykyk 🌈

💜 DESCRIPTION 💜

Refer to open().

that's it. that's the whole description. iconic, honestly. the POSIX girlies said "go read open(), this one's the same story with an fd" and went to get a strawberry matcha 🍓

👑 COPYRIGHT 👑

okay so legal time, but make it cute — some of this text is 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.

and if there's ever 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 arguments, the original wins, periodt. 💀

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

also!! any typographical or formatting errors that show up in this page are most likely to have been introduced during the conversion of the source files to man page format 🙈 (not our fault, we just work here). to report such errors, go to https://www.kernel.org/doc/man-pages/reporting_bugs.html .

and that's the whole page, bestie 🎀 shoutout to IEEE/The Open Group for putting this out in 2017 — that's the source, the version and the date, all wrapped up in one little footer, and I'm giving it a little curtsy on the way out 💖✨🫶