Module Name: src
Committed By: martin
Date: Fri Oct 11 17:30:20 UTC 2024
Modified Files:
src/lib/libc/sys [netbsd-10]: poll.2 select.2
Log Message:
Pull up following revision(s) (requested by riastradh in ticket #946):
lib/libc/sys/poll.2: revision 1.38
lib/libc/sys/select.2: revision 1.44
lib/libc/sys/select.2: revision 1.45
lib/libc/sys/select.2: revision 1.46
select(2), poll(2): Clarify return values.
select.2: note when pselect(2) was added
select(2): Cite standards conformance in man page.
(Should we cite the earliest standard, or the most recent standard,
if they're the same as far as anyone has noticed?)
PR standards/49999: the history and standards conformance of
pselect(2) is not documented
To generate a diff of this commit:
cvs rdiff -u -r1.37 -r1.37.6.1 src/lib/libc/sys/poll.2
cvs rdiff -u -r1.43 -r1.43.14.1 src/lib/libc/sys/select.2
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libc/sys/poll.2
diff -u src/lib/libc/sys/poll.2:1.37 src/lib/libc/sys/poll.2:1.37.6.1
--- src/lib/libc/sys/poll.2:1.37 Tue Feb 9 09:01:29 2021
+++ src/lib/libc/sys/poll.2 Fri Oct 11 17:30:20 2024
@@ -1,4 +1,4 @@
-.\" $NetBSD: poll.2,v 1.37 2021/02/09 09:01:29 wiz Exp $
+.\" $NetBSD: poll.2,v 1.37.6.1 2024/10/11 17:30:20 martin Exp $
.\"
.\" Copyright (c) 1998, 2005, 2020 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -210,8 +210,10 @@ Sockets produce POLLIN rather than POLLH
end is closed.
.Sh RETURN VALUES
.Fn poll
-returns the number of descriptors that are ready for I/O, or \-1 if an
-error occurred.
+returns the number of descriptors that are ready for I/O, or returns
+\-1 and sets
+.Dv errno
+if an error occurred.
If the time limit expires,
.Fn poll
returns 0.
Index: src/lib/libc/sys/select.2
diff -u src/lib/libc/sys/select.2:1.43 src/lib/libc/sys/select.2:1.43.14.1
--- src/lib/libc/sys/select.2:1.43 Wed Oct 25 17:39:47 2017
+++ src/lib/libc/sys/select.2 Fri Oct 11 17:30:20 2024
@@ -1,4 +1,4 @@
-.\" $NetBSD: select.2,v 1.43 2017/10/25 17:39:47 abhinav Exp $
+.\" $NetBSD: select.2,v 1.43.14.1 2024/10/11 17:30:20 martin Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\"
.\" @(#)select.2 8.2 (Berkeley) 3/25/94
.\"
-.Dd November 28, 2013
+.Dd September 9, 2024
.Dt SELECT 2
.Os
.Sh NAME
@@ -155,7 +155,9 @@ interface instead, which tends to be mor
.Fn select
returns the number of ready descriptors that are contained in
the descriptor sets,
-or \-1 if an error occurred.
+or returns \-1 and sets
+.Dv errno
+if an error occurred.
If the time limit expires,
.Fn select
returns 0.
@@ -266,11 +268,30 @@ One of its components is negative or too
.Xr send 2 ,
.Xr write 2 ,
.Xr getdtablesize 3
+.Sh STANDARDS
+The
+.Fn select
+function, along with
+.Fn FD_CLR ,
+.Fn FD_ISSET ,
+.Fn FD_SET , and
+.Fn FD_ZERO ,
+conforms to
+.St -xpg4.2 .
+.Pp
+The
+.Fn pselect
+function conforms to
+.St -p1003.1-2004 .
.Sh HISTORY
The
.Fn select
function call appeared in
.Bx 4.2 .
+The
+.Fn pselect
+function call first appeared in
+.Nx 3.0 .
.Sh BUGS
Although the provision of
.Xr getdtablesize 3
