Thread (11 messages) 11 messages, 3 authors, 25d ago

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

From: Dorjoy Chowdhury <hidden>
Date: 2026-04-26 11:17:28
Subsystem: the rest · Maintainer: Linus Torvalds

Signed-off-by: Dorjoy Chowdhury <redacted>
---
 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
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help