Re: [PATCH v2 2/2] man/man2/openat2.2: Document OPENAT2_REGULAR flag

Alejandro Colomar <[email protected]> Thu, 2 Jul 2026 13:47:01 +0200

Newsgroups	org.kernel.vger.linux-man
Message-ID	<akZPkMmKbyKsn3Jh@devuan>

Hi Dorjoy,

On 2026-04-26T17:14:26+0600, Dorjoy Chowdhury wrote:
> Signed-off-by: Dorjoy Chowdhury <[email protected]>

Thanks!  I've applied the patch, with some minor changes and removals in
the wording.  It's already pushed.


Have a lovely day!
Alex

> ---
>  man/man2/openat2.2 | 20 ++++++++++++++++++++
>  1 file changed, 20 insertions(+)
> 
> diff --git a/man/man2/openat2.2 b/man/man2/openat2.2
> index f0770f3a0..ea3d9ac7b 100644
> --- a/man/man2/openat2.2
> +++ b/man/man2/openat2.2
> @@ -133,6 +133,20 @@ argument,
>  .BR openat2 ()
>  returns an error if unknown or conflicting flags are specified in
>  .IR how.flags .
> +.IP
> +.BR openat2 ()
> +also supports the below additional flags:
> +.RS
> +.TP
> +.BR OPENAT2_REGULAR " (since Linux 7.2)"
> +Only open the file specified by
> +.I path
> +if it is a regular file.
> +If it is not a regular file,
> +.BR openat2 ()
> +fails with the error
> +.BR EFTYPE .
> +.RE
>  .TP
>  .I mode
>  This field specifies the
> @@ -471,6 +485,12 @@ and an escape from the root during path resolution was detected.
>  contains
>  .BR RESOLVE_NO_XDEV ,
>  and a path component crosses a mount point.
> +.TP
> +.B EFTYPE
> +.I how.flags
> +contains
> +.B OPENAT2_REGULAR
> +flag and the path is not a regular file.
>  .SH STANDARDS
>  Linux.
>  .SH HISTORY
> -- 
> 2.53.0
> 
> 

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

signature.asc (application/pgp-signature, 833 B)