git: 4338c437910b - stable/15 - open.2: stop making impression that fd must be directory

The branch stable/15 has been updated by kib:

URL: https://cgit.FreeBSD.org/src/commit/?id=4338c437910bfd3ab262e4f4f544590f968b8d30

commit 4338c437910bfd3ab262e4f4f544590f968b8d30
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2026-02-16 07:28:22 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2026-02-18 08:00:04 +0000

    open.2: stop making impression that fd must be directory
    
    (cherry picked from commit 5bcccc702b29a0e173a5916b001771dd7b280c7c)
---
 lib/libsys/open.2 | 23 ++++++++++++++++++++---
 1 file changed, 20 insertions(+), 3 deletions(-)

diff --git a/lib/libsys/open.2 b/lib/libsys/open.2
index a0e905a8f375..b4463180e4bc 100644
--- a/lib/libsys/open.2
+++ b/lib/libsys/open.2
@@ -72,11 +72,18 @@ function is equivalent to the
 .Fn open
 function except in the case where the
 .Fa path
-specifies a relative path.
+specifies a relative path or the
+.Va O_EMPTY_PATH
+flag is specified.
 For
 .Fn openat
 and relative
 .Fa path ,
+when
+.Fa fd
+references directory and without the
+.Va O_EMPTY_PATH
+flag,
 the file to be opened is determined relative to the directory
 associated with the file descriptor
 .Fa fd
@@ -104,6 +111,14 @@ it ignores the
 .Fa fd
 argument.
 .Pp
+When
+.Fn openat
+is called with the
+.Fa fd
+argument that does not reference a directory, the call fails unless
+.Va O_EMPTY_PATH
+flag is specified, see below.
+.Pp
 In
 .Xr capsicum 4
 capability mode,
@@ -421,9 +436,11 @@ by the descriptor at the time of the
 call.
 .Pp
 .Dv O_PATH
-returns a file descriptor that can be used as a directory file descriptor for
+returns a file descriptor that can be used as the first argument for
 .Fn openat
-and other system calls taking a file descriptor argument, like
+and other filesystem-related system calls collectively named
+.Fn *at
+taking a file descriptor argument, like
 .Xr fstatat 2
 and others.
 The other functionality of the returned file descriptor is limited to