summaryrefslogtreecommitdiffstats
path: root/share/man/man9/mutex.9
diff options
context:
space:
mode:
authorchris <chris@FreeBSD.org>2003-02-17 22:31:27 +0000
committerchris <chris@FreeBSD.org>2003-02-17 22:31:27 +0000
commit082ad05a9b09c9435c82cbd90169d5a3b32812ac (patch)
tree3781655c080c1d096fc8d8a0f793be2c1a246df6 /share/man/man9/mutex.9
parent3a720af460414b65327a45f3d500fce76b6b0196 (diff)
downloadFreeBSD-src-082ad05a9b09c9435c82cbd90169d5a3b32812ac.zip
FreeBSD-src-082ad05a9b09c9435c82cbd90169d5a3b32812ac.tar.gz
Back out revision 1.34 until we can come up with a more accurate patch.
Diffstat (limited to 'share/man/man9/mutex.9')
-rw-r--r--share/man/man9/mutex.965
1 files changed, 0 insertions, 65 deletions
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.
OpenPOWER on IntegriCloud