git: ef86876b846e - main - pselect(2): Document what a null pointer for the signalmask means

From: Warner Losh <imp_at_FreeBSD.org>
Date: Sat, 02 Jul 2022 19:42:30 UTC
The branch main has been updated by imp:

URL: https://cgit.FreeBSD.org/src/commit/?id=ef86876b846e523e7ccc2940c37db4279db95d05

commit ef86876b846e523e7ccc2940c37db4279db95d05
Author:     Warner Losh <imp@FreeBSD.org>
AuthorDate: 2022-07-02 19:39:24 +0000
Commit:     Warner Losh <imp@FreeBSD.org>
CommitDate: 2022-07-02 19:41:46 +0000

    pselect(2): Document what a null pointer for the signalmask means
    
    When pselect is passed a null pointer for the signal mask, the standard
    says it shall behave like select (except for the different timeout
    arg). Make a note of that here.
    
    Sponsored by:           Netflix
---
 lib/libc/sys/pselect.2 | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/lib/libc/sys/pselect.2 b/lib/libc/sys/pselect.2
index 6221c473e7d7..c8104b936319 100644
--- a/lib/libc/sys/pselect.2
+++ b/lib/libc/sys/pselect.2
@@ -28,7 +28,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd August 16, 2013
+.Dd July 2, 2022
 .Dt PSELECT 2
 .Os
 .Sh NAME
@@ -66,7 +66,7 @@ argument in
 .Fn pselect
 points to a
 .Vt "const struct timespec"
-rather than the (modifiable)
+rather than the potentially modifiable
 .Vt "struct timeval"
 used by
 .Fn select ;
@@ -81,6 +81,13 @@ specifies a signal mask which is set while waiting for input.
 When
 .Fn pselect
 returns, the original signal mask is restored.
+If
+.Fa newsigmask
+is a null pointer,
+.Fn pselect
+behaves like
+.Fn select
+with no setting or restoration of the signal mask.
 .Pp
 See
 .Xr select 2