[PATCH v3 0/6] manual: Document several *at file system interface functions
Arjun Shankar
arjun@redhat.com
Wed Jun 4 11:08:52 GMT 2025
This patch series adds info documentation for faccessat, mkdirat, renameat,
unlinkat, and utimensat (along with the related futimens).
They are marked AC-Unsafe and AS-Unsafe since they have not been audited for
these properties.
v2: https://sourceware.org/pipermail/libc-alpha/2025-January/163522.html
Changes in v3:
* Address Florian's comments:
* Add a list of common errors in the "Descriptor-Relative Access" section.
* Drop EBADF, EINVAL (specifically caused by invalid flags) and ENOTDIR
error descriptions from the function entries and refer to the
"Descriptor-Relative Access" section instead.
* Clarify EISDIR for unlinkat.
* Use correct (xref) reference to Time Types in futimens.
* Document an futimens equivalent utimensat call.
* Correct EINVAL description for utimensat (I tested this a bit).
* Correct ENOENT description for utimensat.
Arjun Shankar (6):
manual: Expand Descriptor-Relative Access section
manual: Document faccessat
manual: Document mkdirat
manual: Document renameat
manual: Document unlinkat
manual: Document futimens and utimensat
manual/filesys.texi | 176 +++++++++++++++++++++++++++++++++++++++++---
1 file changed, 165 insertions(+), 11 deletions(-)
--
2.49.0
More information about the Libc-alpha
mailing list