Module Name: src
Committed By: rmind
Date: Tue Feb 16 19:21:30 UTC 2010
Modified Files:
src/share/man/man9: kpreempt.9 mutex.9 spl.9
Log Message:
kpreempt(9): add a note when kernel preemption is disabled/deferred.
Sprinkle cross-links, bump dates.
To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/share/man/man9/kpreempt.9
cvs rdiff -u -r1.21 -r1.22 src/share/man/man9/mutex.9
cvs rdiff -u -r1.38 -r1.39 src/share/man/man9/spl.9
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man9/kpreempt.9
diff -u src/share/man/man9/kpreempt.9:1.2 src/share/man/man9/kpreempt.9:1.3
--- src/share/man/man9/kpreempt.9:1.2 Sun Dec 21 10:32:56 2008
+++ src/share/man/man9/kpreempt.9 Tue Feb 16 19:21:30 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: kpreempt.9,v 1.2 2008/12/21 10:32:56 ad Exp $
+.\" $NetBSD: kpreempt.9,v 1.3 2010/02/16 19:21:30 rmind Exp $
.\"
.\" Copyright (c)2008 YAMAMOTO Takashi,
.\" All rights reserved.
@@ -25,7 +25,7 @@
.\" SUCH DAMAGE.
.\"
.\" ------------------------------------------------------------
-.Dd December 21, 2008
+.Dd February 16, 2010
.Dt KPREEMPT 9
.Os
.\" ------------------------------------------------------------
@@ -52,6 +52,13 @@
On architectures where kernel preemption is not supported natively, these
functions may still be used.
.Pp
+It should be noted that kernel preemption is also disabled when holding
+the interrupt priority level above IPL_NONE, e.g. using
+.Xr spl 9
+or spinning
+.Xr mutex 9
+calls or holding kernel_lock (indicating that the code is not MT safe).
+.Pp
.Fn kpreempt_disable
disables kernel preemption of the calling LWP.
Note that disabling kernel preemption can prevent LWPs with higher priorities
@@ -70,10 +77,11 @@
returns
.Dv true
if preemption of the calling LWP is disabled.
-It's for diagnostic purpose.
+It is only for diagnostic purpose.
.\" ------------------------------------------------------------
.\" .Sh RETURN VALUES
.\" ------------------------------------------------------------
.Sh SEE ALSO
.Xr intro 9 ,
+.Xr mutex 9 ,
.Xr spl 9
Index: src/share/man/man9/mutex.9
diff -u src/share/man/man9/mutex.9:1.21 src/share/man/man9/mutex.9:1.22
--- src/share/man/man9/mutex.9:1.21 Mon Jan 25 17:27:41 2010
+++ src/share/man/man9/mutex.9 Tue Feb 16 19:21:30 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: mutex.9,v 1.21 2010/01/25 17:27:41 jruoho Exp $
+.\" $NetBSD: mutex.9,v 1.22 2010/02/16 19:21:30 rmind Exp $
.\"
.\" Copyright (c) 2007, 2009 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -27,7 +27,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd November 22, 2009
+.Dd February 16, 2010
.Dt MUTEX 9
.Os
.Sh NAME
@@ -251,6 +251,7 @@
.Xr membar_ops 3 ,
.Xr lockstat 8 ,
.Xr condvar 9 ,
+.Xr kpreempt 9 ,
.Xr rwlock 9 ,
.Xr spl 9
.Pp
Index: src/share/man/man9/spl.9
diff -u src/share/man/man9/spl.9:1.38 src/share/man/man9/spl.9:1.39
--- src/share/man/man9/spl.9:1.38 Sun Feb 7 10:49:35 2010
+++ src/share/man/man9/spl.9 Tue Feb 16 19:21:30 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: spl.9,v 1.38 2010/02/07 10:49:35 wiz Exp $
+.\" $NetBSD: spl.9,v 1.39 2010/02/16 19:21:30 rmind Exp $
.\"
.\" Copyright (c) 2000, 2001 Jason R. Thorpe. All rights reserved.
.\" Copyright (c) 1997 Michael Long.
@@ -27,7 +27,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd February 6, 2010
+.Dd February 16, 2010
.Dt SPL 9
.Os
.Sh NAME
@@ -210,6 +210,7 @@
.Sh SEE ALSO
.Xr condvar 9 ,
.Xr i386/splraise 9 ,
+.Xr kpreempt 9 ,
.Xr mutex 9 ,
.Xr rwlock 9
.Sh HISTORY
