aboutsummaryrefslogtreecommitdiff
path: root/lib/libsys/open.2
diff options
context:
space:
mode:
Diffstat (limited to 'lib/libsys/open.2')
-rw-r--r--lib/libsys/open.223
1 files changed, 20 insertions, 3 deletions
diff --git a/lib/libsys/open.2 b/lib/libsys/open.2
index a0e905a8f375..4527100252eb 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 a directory, and the
+.Va O_EMPTY_PATH
+flag is not specified,
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