d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document PBDRY and SLEEPQ_STOP_ON_BDRY.

Browse Source 
Requested and reviewed by:	attilio
MFC after:	3 days
This commit is contained in:
Konstantin Belousov 2009-12-12 22:08:37 +00:00
parent 4576bbe233
commit ec897c886d
2 changed files with 22 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
share/man/man9/sleep.9
View File

@ -25,7 +25,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd April 4, 2008 .Dd December 12, 2009
.Os .Os
.Dt SLEEP 9 .Dt SLEEP 9
.Sh NAME .Sh NAME
@ -97,6 +97,7 @@ when it resumes.
should never be used, as it is for compatibility only. should never be used, as it is for compatibility only.
A new priority of 0 means to use the thread's current priority when A new priority of 0 means to use the thread's current priority when
it is made runnable again. it is made runnable again.
.Pp
If If
.Fa priority .Fa priority
includes the includes the
@ -113,6 +114,17 @@ possible, and
is returned if the system call should be interrupted by the signal is returned if the system call should be interrupted by the signal
(return (return
.Er EINTR ) . .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 .Pp
The parameter The parameter
.Fa wmesg .Fa wmesg

11
share/man/man9/sleepqueue.9
View File

@ -23,7 +23,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd December 11, 2009 .Dd December 12, 2009
.Dt SLEEPQUEUE 9 .Dt SLEEPQUEUE 9
.Os .Os
.Sh NAME .Sh NAME
@ -198,12 +198,19 @@ A sleep queue used to implement
.Xr pause 9 . .Xr pause 9 .
.El .El
.Pp .Pp
There is currently only one optional flag: There are currently two optional flag:
.Pp .Pp
.Bl -tag -width ".Dv SLEEPQ_INTERRUPTIBLE" -compact .Bl -tag -width ".Dv SLEEPQ_INTERRUPTIBLE" -compact
.It Dv SLEEPQ_INTERRUPTIBLE .It Dv SLEEPQ_INTERRUPTIBLE
The current thread is entering an interruptible sleep. The current thread is entering an interruptible sleep.
.El .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 .Pp
A timeout on the sleep may be specified by calling A timeout on the sleep may be specified by calling
.Fn sleepq_set_timeout .Fn sleepq_set_timeout