diff options
| author | riastradh <riastradh@NetBSD.org> | 2020-11-30 00:21:35 +0000 |
|---|---|---|
| committer | riastradh <riastradh@NetBSD.org> | 2020-11-30 00:21:35 +0000 |
| commit | 0b6ca9db8bc128bb6b54cb27ab7bd987632a951f (patch) | |
| tree | 13cf71113e7f5f402823d9f1d7f1a3b0c29b0589 /lib/libc/sys | |
| parent | 28c461d2c3e5f3e9c21b0eb9daf937a9f0fc330e (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.2 | 19 |
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 . |
