summaryrefslogtreecommitdiffstats
path: root/share/man/man9/mutex.9
diff options
context:
space:
mode:
authorsheldonh <sheldonh@FreeBSD.org>2000-10-30 19:49:26 +0000
committersheldonh <sheldonh@FreeBSD.org>2000-10-30 19:49:26 +0000
commit4b00fdc3f68ef3b5b444b55f6c45e6c426c4262d (patch)
treec30d51ed00ddcfa74269a9e82f9dadd184a80877 /share/man/man9/mutex.9
parentef41f174d66d1230c223c1faf451806666071535 (diff)
downloadFreeBSD-src-4b00fdc3f68ef3b5b444b55f6c45e6c426c4262d.zip
FreeBSD-src-4b00fdc3f68ef3b5b444b55f6c45e6c426c4262d.tar.gz
Whitespace only:
* Remove hard sentence breaks. * Remove trailing whitespace. * Separate macro arguments from trailing punctuation with whitespace.
Diffstat (limited to 'share/man/man9/mutex.9')
-rw-r--r--share/man/man9/mutex.929
1 files changed, 16 insertions, 13 deletions
diff --git a/share/man/man9/mutex.9 b/share/man/man9/mutex.9
index 4d58ceb..2bbfaeb 100644
--- a/share/man/man9/mutex.9
+++ b/share/man/man9/mutex.9
@@ -31,14 +31,14 @@
.Dd April 20, 1998
.Dt MUTEX 9
.Sh NAME
-.Nm mutex,
-.Nm mtx_init,
-.Nm mtx_enter,
-.Nm mtx_try_enter,
-.Nm mtx_exit,
-.Nm mtx_destroy,
-.Nm mtx_owned,
-.Nm mtx_assert,
+.Nm mutex ,
+.Nm mtx_init ,
+.Nm mtx_enter ,
+.Nm mtx_try_enter ,
+.Nm mtx_exit ,
+.Nm mtx_destroy ,
+.Nm mtx_owned ,
+.Nm mtx_assert ,
.Nm MUTEX_DECLARE
.Nd kernel synchronization primitives
.Sh SYNOPSIS
@@ -90,7 +90,8 @@ uncontested spin mutex is more expensive than the same operation
on a non spin mutex.
In order to protect an interrupt service routine from blocking
against itself all interrupts are blocked on a processor while
-holding a spin lock. It is permissible to hold multiple spin mutexes.
+holding a spin lock.
+It is permissible to hold multiple spin mutexes.
In this case it is a required that they be released in the opposite
order to that which they were acquired.
.Pp
@@ -146,7 +147,7 @@ with no ill effects;
if recursion on a given mutex can be avoided,
faster and smaller code will usually be generated.
.Pp
-The
+The
.Fn mtx_try_enter
function is used to acquire exclusive access
to those objects protected by the mutex
@@ -220,15 +221,17 @@ The
.Fn MUTEX_DECLARE
macro is used to declare a mutex that is initialized before
.Xr malloc 9
-is operating. Unfortunately, mutex initialization may require
+is operating.
+Unfortunately, mutex initialization may require
.Xr malloc 9 .
However, some mutexes are intialized and used before
.Xr malloc 9
-can be used. Declaring these mutexes with the
+can be used.
+Declaring these mutexes with the
.Fn MUTEX_DECLARE
macro and then using the
.Dv MTX_COLD
-flag when calling
+flag when calling
.Fn mtx_init
allows these early mutexes to be initialized and used before
.Xr malloc 9
OpenPOWER on IntegriCloud