diff options
author | grog <grog@FreeBSD.org> | 2007-02-27 23:09:31 +0000 |
---|---|---|
committer | grog <grog@FreeBSD.org> | 2007-02-27 23:09:31 +0000 |
commit | 2b6f6866c41d06862fcb4dd802bbb29fc7e0648e (patch) | |
tree | 8fccb644e7bc9488b8416986abedcf07048c4ed4 /share/man/man9/sleep.9 | |
parent | b8fed42140165f2b9f044e46fecd0478f1fd5b22 (diff) | |
download | FreeBSD-src-2b6f6866c41d06862fcb4dd802bbb29fc7e0648e.zip FreeBSD-src-2b6f6866c41d06862fcb4dd802bbb29fc7e0648e.tar.gz |
Furhter clarifications:
- the issues with wakeup_one are due to address space clashes between
unrelated groups of threads.
- sleep() was removed in FreeBSD 2.2.
- date the page today, not 4 days ago.
- replace grammatically correct "woken" with "woken up" for
consistency with the function name.
Diffstat (limited to 'share/man/man9/sleep.9')
-rw-r--r-- | share/man/man9/sleep.9 | 21 |
1 files changed, 15 insertions, 6 deletions
diff --git a/share/man/man9/sleep.9 b/share/man/man9/sleep.9 index 89b22b1..8fd7af0 100644 --- a/share/man/man9/sleep.9 +++ b/share/man/man9/sleep.9 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd February 23, 2007 +.Dd February 27, 2007 .Os .Dt SLEEP 9 .Sh NAME @@ -99,11 +99,16 @@ runnable. .Pp The .Fn wakeup_one -function -does not work reliably if more than one thread is sleeping on the same address; -in this case it is possible for an unrelated thread to be woken. -This thread will ignore the wakeup, and the correct process will never be -woken. +function does not work reliably if unrelated threads are sleeping on the same +address. +In this case, if a wakeup for one group of threads is delivered to a member of +another group, that thread will ignore the wakeup, and the correct thread will +never be woken up. +It is the programmer's responsibility to choose a unique +.Fa chan +value. +In case of doubt, do not use +.Fn wakeup_one . .Pp The .Fn msleep @@ -234,6 +239,10 @@ and added the parameters and .Fa timo . The +.Fn sleep +function was removed in +.Fx 2.2 . +The .Fn wakeup_one function appeared in .Fx 2.2 . |