utimensat(2) and faccessat(2): man pages do not mention AT_EMPTY_PATH flag

Renzo Davoli
2023-12-06T11:12:46Z

[-- Attachment #1: Type: text/plain, Size: 794 bytes --]

Dear Alejandro,

utimensat and faccessat support the flag AT_EMPTY_PATH since Linux 5.8 but
this option is still missing in the man pages.

(actually Linux 5.8 added faccessat2: glibc wrapper for faccessat
uses faccessat2, and faccessat2 does support AT_EMPTY_PATH).

I think the standard text used in many other -at man page could fit
for these system calls, too.

AT_EMPTY_PATH (since Linux 5.8)
If pathname is an empty string, operate on the file referred to
by dirfd (which may have been obtained using the open(2) O_PATH
flag). In this case, dirfd can refer to any type of file, not
just a directory. If dirfd is AT_FDCWD, the call operates on
the current working directory. This flag is Linux-specific;
define _GNU_SOURCE to obtain its definition.

All the best,