diff options
author | kib <kib@FreeBSD.org> | 2009-12-12 22:08:37 +0000 |
---|---|---|
committer | kib <kib@FreeBSD.org> | 2009-12-12 22:08:37 +0000 |
commit | 061d83630fb0102adca3019da245fcd087618408 (patch) | |
tree | db39cf28234253ddef5a10c94b6fcaf8d60227a2 | |
parent | 8a52668e18e6e74c298b3a99c3e6f75a5663bf0f (diff) | |
download | FreeBSD-src-061d83630fb0102adca3019da245fcd087618408.zip FreeBSD-src-061d83630fb0102adca3019da245fcd087618408.tar.gz |
Document PBDRY and SLEEPQ_STOP_ON_BDRY.
Requested and reviewed by: attilio
MFC after: 3 days
-rw-r--r-- | share/man/man9/sleep.9 | 14 | ||||
-rw-r--r-- | share/man/man9/sleepqueue.9 | 11 |
2 files changed, 22 insertions, 3 deletions
diff --git a/share/man/man9/sleep.9 b/share/man/man9/sleep.9 index a9f0873..8fb7f88 100644 --- a/share/man/man9/sleep.9 +++ b/share/man/man9/sleep.9 @@ -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 diff --git a/share/man/man9/sleepqueue.9 b/share/man/man9/sleepqueue.9 index bc5acf8..36cab69 100644 --- a/share/man/man9/sleepqueue.9 +++ b/share/man/man9/sleepqueue.9 @@ -23,7 +23,7 @@ .\" .\" $FreeBSD$ .\" -.Dd December 11, 2009 +.Dd December 12, 2009 .Dt SLEEPQUEUE 9 .Os .Sh NAME @@ -198,12 +198,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 |