From 082ad05a9b09c9435c82cbd90169d5a3b32812ac Mon Sep 17 00:00:00 2001 From: chris Date: Mon, 17 Feb 2003 22:31:27 +0000 Subject: Back out revision 1.34 until we can come up with a more accurate patch. --- share/man/man9/mutex.9 | 65 -------------------------------------------------- 1 file changed, 65 deletions(-) (limited to 'share') diff --git a/share/man/man9/mutex.9 b/share/man/man9/mutex.9 index dcc0192..50bb085 100644 --- a/share/man/man9/mutex.9 +++ b/share/man/man9/mutex.9 @@ -477,66 +477,7 @@ access memory in userspace, such as .Xr fuword 9 , etc. No locks are needed when calling these functions. -.Ss Giant Lock Manipulation Macros -The following macros are useful when dealing with the Giant -lock: -.Bl -tag -width GIANT_REQUIRED -.It Dv GIANT_REQUIRED -Macro used for a routine that wants to assert the Giant lock. -.It Dv PICKUP_GIANT -Allows a routine to hold the Giant lock and save it's -.Xr witness 4 -lock order. -.It Dv DROP_GIANT -Allows a routine to drop the Giant lock and restore it's -.Xr witness 4 -lock order. -.El -.Pp -It should be noted that -.Dv PICKUP_GIANT -and -.Dv DROP_GIANT -have to be paired together and cannot operate on seperate levels, -i.e. the following is incorrect and not possible: -.Bd -literal -void incorrect() -{ - initialization; - - PICKUP_GIANT; - - if (condition) { - /* stuff ... */ - - DROP_GIANT; - } -} -.Ed -.Pp -A correct way of calling -.Dv PICKUP_GIANT -and -.Dv DROP_GIANT : -.Bd -literal -void correct() -{ - initialization; - - PICKUP_GIANT; - - if (condition) { - /* stuff ... */ - - /* more stuff ... */ - } - - DROP_GIANT; -} -.Ed .Sh SEE ALSO -.Xr ddb 4 , -.Xr witness 4 , .Xr condvar 9 , .Xr msleep 9 , .Xr mtx_pool 9 , @@ -548,9 +489,3 @@ functions appeared in .Bsx 4.1 and .Fx 5.0 . -.Sh AUTHORS -This manual page is partially derived from its -.Bsx -counterpart with parts written by Jason Evans and improvements from -Chuck Paterson, Doug Rabson, Matthew Dillon, Greg Lehey, Jake Burkholder -and Sheldon Hearn. -- cgit v1.1