LSTAT(3P)

💅 LSTAT(3P) — get file status 💅

okay bestie, welcome to the POSIX Programmer's Manual, page lstat(3P). pull up a chair, grab a strawberry 🍓, we're gonna get your file status situation sorted.

✨ PROLOG ✨

so like, real talk first 🫶 this manual page is part of the POSIX Programmer's Manual. meaning: it describes what POSIX says should happen.

⚠️ but here's the tea — the Linux implementation of this interface may differ. so pls consult the corresponding Linux manual page for the deets on Linux behavior. OR, plot twist, the interface might not even be implemented on Linux at all. 💀 no cap.

🌸 NAME 🌸

lstat — get file status

it's giving "tell me everything about this path" energy. ✨

🎀 SYNOPSIS 🎀

#include <sys/stat.h>

int lstat(const char *restrict path, struct stat *restrict buf);

look at that signature. so clean. so iconic. 👑

🦋 DESCRIPTION 🦋

bestie. the description here is literally one line and it's sending us elsewhere: refer to fstatat(). that's it. that's the whole vibe. lstat doesn't want to explain itself, she's a private queen, she points you to fstatat() and says "ask her." 💅

💖 COPYRIGHT 💖

okay legal bestie moment, we gotta be thorough here because the facts do not change, only the vibe. 📜

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.

and like, 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. yes, it's the main character. the original Standard can be obtained online at http://www.opengroup.org/unix/online.html .

also, 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. so don't come for the original authors, it was the conversion process fr fr 😭. to report such errors, see https://www.kernel.org/doc/man-pages/reporting_bugs.html .

aaaand that's the whole page, gorgeous. this one was brought to you by IEEE / The Open Group, 2017 🌈 — the source and date, held up for the record, cute sign-off style. now go forth and lstat something. mwah. 💜