Module Name: src
Committed By: riastradh
Date: Fri Jul 7 01:31:25 UTC 2023
Modified Files:
src/lib/libc/sys: poll.2 select.2
Log Message:
select(2), poll(2): Clarify return values.
To generate a diff of this commit:
cvs rdiff -u -r1.37 -r1.38 src/lib/libc/sys/poll.2
cvs rdiff -u -r1.43 -r1.44 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.38
--- src/lib/libc/sys/poll.2:1.37 Tue Feb 9 09:01:29 2021
+++ src/lib/libc/sys/poll.2 Fri Jul 7 01:31:25 2023
@@ -1,4 +1,4 @@
-.\" $NetBSD: poll.2,v 1.37 2021/02/09 09:01:29 wiz Exp $
+.\" $NetBSD: poll.2,v 1.38 2023/07/07 01:31:25 riastradh 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.44
--- src/lib/libc/sys/select.2:1.43 Wed Oct 25 17:39:47 2017
+++ src/lib/libc/sys/select.2 Fri Jul 7 01:31:25 2023
@@ -1,4 +1,4 @@
-.\" $NetBSD: select.2,v 1.43 2017/10/25 17:39:47 abhinav Exp $
+.\" $NetBSD: select.2,v 1.44 2023/07/07 01:31:25 riastradh Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -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.
