summaryrefslogtreecommitdiff
path: root/lib/libc/sys
diff options
context:
space:
mode:
authorriastradh <riastradh@NetBSD.org>2020-11-30 00:21:35 +0000
committerriastradh <riastradh@NetBSD.org>2020-11-30 00:21:35 +0000
commit0b6ca9db8bc128bb6b54cb27ab7bd987632a951f (patch)
tree13cf71113e7f5f402823d9f1d7f1a3b0c29b0589 /lib/libc/sys
parent28c461d2c3e5f3e9c21b0eb9daf937a9f0fc330e (diff)
Note that open(O_ASYNC) does not work as advertised.
This matches Linux, which also advertises the same semantics and fails to implement it, according to: https://man7.org/linux/man-pages/man2/fcntl.2.html (At what point should we collectively stop advertising the semantics that doesn't work and call the bug a feature?)
Diffstat (limited to 'lib/libc/sys')
-rw-r--r--lib/libc/sys/open.219
1 files changed, 18 insertions, 1 deletions
diff --git a/lib/libc/sys/open.2 b/lib/libc/sys/open.2
index b5151e1ce25..99906dc39ba 100644
--- a/lib/libc/sys/open.2
+++ b/lib/libc/sys/open.2
@@ -1,4 +1,4 @@
-.\" $NetBSD: open.2,v 1.62 2019/09/16 04:59:32 wiz Exp $
+.\" $NetBSD: open.2,v 1.63 2020/11/30 00:21:35 riastradh Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -217,6 +217,13 @@ Enable the
signal to be sent to the process group
when I/O is possible, e.g.,
upon availability of data to be read.
+.Pp
+Note: This is broken in
+.Fn open ;
+it must be set explicitly with the
+.Dv F_SETFL
+command to
+.Xr fcntl 2 .
.\" (This block awaits a decision about the semantics of O_SEARCH)
.\" .It Dv O_SEARCH
.\" If opening a directory, search permission checks will not be performed on
@@ -509,3 +516,13 @@ An
.Fn open
function call appeared in
.At v1 .
+.Sh BUGS
+.Dv O_ASYNC
+doesn't actually work as advertised with
+.Nm ;
+you must set
+.Dv O_ASYNC
+explicitly with the
+.Dv F_SETFL
+command to
+.Xr fcntl 2 .