linux-kernel - Re: [PATCH] chmod.2: document fchmodat(AT_EMPTY

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite for Android: free password hash cracker in your pocket

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <k3rytfb6tjnxbwz5bxmj2q5hob6ao2qotyzees37cm36mmf3qq@b64p6fleloft>
Date: Thu, 19 Jun 2025 02:07:17 +0200
From: Alejandro Colomar <alx@...nel.org>
To: Aleksa Sarai <cyphar@...har.com>
Cc: linux-man@...r.kernel.org, Alexey Gladkov <legion@...nel.org>, 
	Christian Brauner <brauner@...nel.org>, linux-fsdevel@...r.kernel.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH] chmod.2: document fchmodat(AT_EMPTY_PATH)

Hi Aleksa,

On Thu, Jun 19, 2025 at 04:34:30AM +1000, Aleksa Sarai wrote:
> The documentation and behaviour is indentical to the equivalent flag for
> fchownat(2).
> 
> Signed-off-by: Aleksa Sarai <cyphar@...har.com>
> ---
> This was added back in 2023, but I forgot to send the documentation
> patch for this and only noticed when I was trying to use it and realised
> it wasn't in the man page -- mea culpa!

Thanks!  I've applied the patch:
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=a4535bb6ddc0c1a060cedaee86430c39f590804e>

Have a lovely day!
Alex

> ---
>  man/man2/chmod.2 | 25 ++++++++++++++++++++++++-
>  1 file changed, 24 insertions(+), 1 deletion(-)
> 
> diff --git a/man/man2/chmod.2 b/man/man2/chmod.2
> index 307589481593..671e256ba525 100644
> --- a/man/man2/chmod.2
> +++ b/man/man2/chmod.2
> @@ -190,7 +190,30 @@ is absolute, then
>  is ignored.
>  .P
>  .I flags
> -can either be 0, or include the following flag:
> +can either be 0, or include the following flags:
> +.TP
> +.BR AT_EMPTY_PATH " (since Linux 6.6)"
> +.\" commit 5daeb41a6fc9d0d81cb2291884b7410e062d8fa1
> +If
> +.I path
> +is an empty string, operate on the file referred to by
> +.I dirfd
> +(which may have been obtained using the
> +.BR open (2)
> +.B O_PATH
> +flag).
> +In this case,
> +.I dirfd
> +can refer to any type of file, not just a directory.
> +If
> +.I dirfd
> +is
> +.BR AT_FDCWD ,
> +the call operates on the current working directory.
> +This flag is Linux-specific; define
> +.B _GNU_SOURCE
> +.\" Before glibc 2.16, defining _ATFILE_SOURCE sufficed
> +to obtain its definition.
>  .TP
>  .B AT_SYMLINK_NOFOLLOW
>  If
> 
> ---
> base-commit: 471c38fb3c5c53c6df2fad4a7353559b330c1323
> change-id: 20250619-fchmod-empty-path-7680e8bb5481
> 
> Best regards,
> -- 
> Aleksa Sarai <cyphar@...har.com>
> 
> 

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

Download attachment "signature.asc" of type "application/pgp-signature" (834 bytes)