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

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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/>

Attachment: signature.asc
Description: PGP signature


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux