[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