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

Alejandro Colomar
2023-12-09T12:00:11Z

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

Dear Renzo,

On Wed, Dec 06, 2023 at 12:04:07PM +0100, Renzo Davoli wrote:
> 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.

Thanks for reporting that. Would you mind preparing a patch updating
the page? If you need any help, just ask for it.

Cheers,
Alex

--
<https://www.alejandro-colomar.es/>