svn commit: r200642 - stable/8/share/man/man9
Konstantin Belousov
kib at FreeBSD.org
Thu Dec 17 18:43:34 UTC 2009
Author: kib
Date: Thu Dec 17 18:43:34 2009
New Revision: 200642
URL: http://svn.freebsd.org/changeset/base/200642
Log:
MFC r200450:
Document PBDRY and SLEEPQ_STOP_ON_BDRY.
Modified:
stable/8/share/man/man9/sleep.9
stable/8/share/man/man9/sleepqueue.9
Directory Properties:
stable/8/share/man/man9/ (props changed)
Modified: stable/8/share/man/man9/sleep.9
==============================================================================
--- stable/8/share/man/man9/sleep.9 Thu Dec 17 18:37:11 2009 (r200641)
+++ stable/8/share/man/man9/sleep.9 Thu Dec 17 18:43:34 2009 (r200642)
@@ -25,7 +25,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd April 4, 2008
+.Dd December 12, 2009
.Os
.Dt SLEEP 9
.Sh NAME
@@ -97,6 +97,7 @@ when it resumes.
should never be used, as it is for compatibility only.
A new priority of 0 means to use the thread's current priority when
it is made runnable again.
+.Pp
If
.Fa priority
includes the
@@ -113,6 +114,17 @@ possible, and
is returned if the system call should be interrupted by the signal
(return
.Er EINTR ) .
+If
+.Dv PBDRY
+flag is specified in addition to
+.Dv PCATCH ,
+then the sleeping thread is not stopped while sleeping upon delivery of
+.Dv SIGSTOP
+or other stop action.
+Instead, it is waken up, assuming that stop occurs on reaching a stop
+point when returning to usermode.
+The flag should be used when sleeping thread owns resources, for instance
+vnode locks, that should be freed timely.
.Pp
The parameter
.Fa wmesg
Modified: stable/8/share/man/man9/sleepqueue.9
==============================================================================
--- stable/8/share/man/man9/sleepqueue.9 Thu Dec 17 18:37:11 2009 (r200641)
+++ stable/8/share/man/man9/sleepqueue.9 Thu Dec 17 18:43:34 2009 (r200642)
@@ -23,7 +23,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd August 13, 2007
+.Dd December 12, 2009
.Dt SLEEPQUEUE 9
.Os
.Sh NAME
@@ -195,12 +195,19 @@ A sleep queue used to implement
.Xr pause 9 .
.El
.Pp
-There is currently only one optional flag:
+There are currently two optional flag:
.Pp
.Bl -tag -width ".Dv SLEEPQ_INTERRUPTIBLE" -compact
.It Dv SLEEPQ_INTERRUPTIBLE
The current thread is entering an interruptible sleep.
.El
+.Bl -tag -width ".Dv SLEEPQ_STOP_ON_BDRY" -compact
+.It Dv SLEEPQ_STOP_ON_BDRY
+When thread is entering an interruptible sleep, do not stop it upon
+arrival of stop action, like
+.Dv SIGSTOP .
+Wake it up instead.
+.El
.Pp
A timeout on the sleep may be specified by calling
.Fn sleepq_set_timeout
More information about the svn-src-stable
mailing list