summaryrefslogtreecommitdiffstats
path: root/share/man/man9/sleepqueue.9
diff options
context:
space:
mode:
authorjhb <jhb@FreeBSD.org>2004-08-19 12:46:02 +0000
committerjhb <jhb@FreeBSD.org>2004-08-19 12:46:02 +0000
commit4d6734a68bf8a654de25adb01481d195cf9ce0a7 (patch)
treee79abd6e4cfdfdeb88cdfb4878ab5c4475aab5b9 /share/man/man9/sleepqueue.9
parent7f135ded9ac67df62e33fc83837d72cfae3f72f4 (diff)
downloadFreeBSD-src-4d6734a68bf8a654de25adb01481d195cf9ce0a7.zip
FreeBSD-src-4d6734a68bf8a654de25adb01481d195cf9ce0a7.tar.gz
Catch up to recent API changes including the removal of the signal_caught
argument to sleepq_timedwait() and the enhancements to the flags argument passed to sleepq_add().
Diffstat (limited to 'share/man/man9/sleepqueue.9')
-rw-r--r--share/man/man9/sleepqueue.937
1 files changed, 25 insertions, 12 deletions
diff --git a/share/man/man9/sleepqueue.9 b/share/man/man9/sleepqueue.9
index 5ac0b6c..8441048 100644
--- a/share/man/man9/sleepqueue.9
+++ b/share/man/man9/sleepqueue.9
@@ -75,7 +75,7 @@
.Ft void
.Fn sleepq_set_timeout "void *wchan" "int timo"
.Ft int
-.Fn sleepq_timedwait "void *wchan" "int signal_caught"
+.Fn sleepq_timedwait "void *wchan"
.Ft int
.Fn sleepq_timedwait_sig "void *wchan" "int signal_caught"
.Ft void
@@ -152,15 +152,26 @@ parameter should be a short description of
.Fa wchan .
The
.Fa flags
-parameter currently only specifies the type of sleep queue being slept on.
-A value of
-0
-indicates a sleep queue used by
-.Xr msleep 9
-and a value of
-.Dv SLEEPQ_CONDVAR
-indicates a sleep queue used by
-.Xr condvar 9 .
+parameter is a bitmask consisting of the type of sleep queue being slept on
+and zero or more optional flags.
+There are currently two types of sleep queues:
+.Bl -tag -width SLEEPQ_CONDVAR
+.It Dv SLEEPQ_CONDVAR
+A sleep queue used to implement condition variables.
+.It Dv SLEEPQ_MSLEEP
+A sleep queue used to implement
+.Xr msleep 9 ,
+.Xr wakeup 9
+and
+.Xr wakeup_one 9 .
+.El
+.Pp
+There is currently only one optional flag:
+.Bl -tag -width SLEEPQ_INTERRUPTIBLE
+.It Dv SLEEPQ_INTERRUPTIBLE
+The current thread is entering an interruptible sleep.
+.El
+.Pp
A timeout on the sleep may be specified by calling
.Fn sleepq_set_timeout
after
@@ -201,7 +212,9 @@ The
argument to all of the wait functions is the wait channel being slept on.
The
.Fa signal_caught
-parameter to the timed wait functions specifies if a previous call to
+parameter to
+.Fn sleepq_timedwait_sig
+specifies if a previous call to
.Fn sleepq_catch_signals
found a pending signal.
.Pp
@@ -243,7 +256,7 @@ The
argument specifics which wait channel to awaken.
The
.Fa flags
-argument should match the
+argument must match the sleep queue type contained in the
.Fa flags
argument passed to
.Fn sleepq_add
OpenPOWER on IntegriCloud