diff options
author | ru <ru@FreeBSD.org> | 2003-05-21 15:49:01 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2003-05-21 15:49:01 +0000 |
commit | aaa0f05b8038505fb90ace42372bb0a51e25cf11 (patch) | |
tree | 58f4b7ce9201704305853728000bcd105bb708b4 /share/man/man9/mutex.9 | |
parent | 1566e448bd374392c3a70f5079be88e7144b44a6 (diff) | |
download | FreeBSD-src-aaa0f05b8038505fb90ace42372bb0a51e25cf11.zip FreeBSD-src-aaa0f05b8038505fb90ace42372bb0a51e25cf11.tar.gz |
Assorted mdoc(7), grammar, spelling, and punctuation fixes.
Approved by: re (blanket)
Diffstat (limited to 'share/man/man9/mutex.9')
-rw-r--r-- | share/man/man9/mutex.9 | 23 |
1 files changed, 17 insertions, 6 deletions
diff --git a/share/man/man9/mutex.9 b/share/man/man9/mutex.9 index 50bb085..c3a4cfa 100644 --- a/share/man/man9/mutex.9 +++ b/share/man/man9/mutex.9 @@ -458,18 +458,29 @@ operations. This can be used to trim superfluous logging messages for debugging purposes. .El .Ss Giant -If Giant must be acquired, it must be acquired prior to acquiring +If +.Va Giant +must be acquired, it must be acquired prior to acquiring other mutexes. -Put another way: it is impossible to acquire Giant non-recursively while +Put another way: it is impossible to acquire +.Va Giant +non-recursively while holding another mutex. -It is possible to acquire other mutexes while holding Giant, and it is -possible to acquire Giant recursively while holding other mutexes. +It is possible to acquire other mutexes while holding +.Va Giant , +and it is possible to acquire +.Va Giant +recursively while holding other mutexes. .Ss Sleeping -Sleeping while holding a mutex (except for Giant) is almost never safe +Sleeping while holding a mutex (except for +.Va Giant ) +is almost never safe and should be avoided. There are numerous assertions which will fail if this is attempted. .Ss Functions Which Access Memory in Userspace -No mutexes should be held (except for Giant) across functions which +No mutexes should be held (except for +.Va Giant ) +across functions which access memory in userspace, such as .Xr copyin 9 , .Xr copyout 9 , |