Module Name: src
Committed By: pgoyette
Date: Thu Dec 12 02:34:55 UTC 2019
Modified Files:
src/share/man/man9: condvar.9
Log Message:
Point out that spurious wake-ups are possible, and that an LWP should
check for resource availability after being awoken.
To generate a diff of this commit:
cvs rdiff -u -r1.20 -r1.21 src/share/man/man9/condvar.9
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man9/condvar.9
diff -u src/share/man/man9/condvar.9:1.20 src/share/man/man9/condvar.9:1.21
--- src/share/man/man9/condvar.9:1.20 Fri Apr 12 11:02:22 2019
+++ src/share/man/man9/condvar.9 Thu Dec 12 02:34:55 2019
@@ -1,4 +1,4 @@
-.\" $NetBSD: condvar.9,v 1.20 2019/04/12 11:02:22 abhinav Exp $
+.\" $NetBSD: condvar.9,v 1.21 2019/12/12 02:34:55 pgoyette Exp $
.\"
.\" Copyright (c) 2006, 2007, 2008 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -27,7 +27,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd November 12, 2017
+.Dd December 12, 2019
.Dt CONDVAR 9
.Os
.Sh NAME
@@ -144,6 +144,13 @@ as available until the calling LWP has b
.Pp
Non-interruptable waits have the potential to deadlock the system, and so must
be kept short (typically, under one second).
+.Pp
+Upon being awakened, the calling LWP should verify the availability
+of the resource (or other condition).
+It should not blindly assume that the resource is now available.
+If the resource is still not available, the calling LWP may call
+.Fn cv_wait
+again to continue waiting.
.It Fn cv_wait_sig "cv" "mtx"
.Pp
As per
