[src/trunk]: src Describe spllower(9) and splraise(9).

[dyoung <dyoung%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/a75c5fe55d27
branches:  trunk
changeset: 749090:a75c5fe55d27
user:      dyoung <dyoung%NetBSD.org@localhost>
date:      Tue Nov 17 18:36:07 2009 +0000

description:
Describe spllower(9) and splraise(9).

diffstat:

 distrib/sets/lists/comp/mi |   8 +++++++-
 share/man/man9/Makefile    |   6 ++++--
 share/man/man9/spl.9       |  39 +++++++++++++++++++++++++++++++++++++--
 3 files changed, 48 insertions(+), 5 deletions(-)

diffs (133 lines):

diff -r 1352d940b422 -r a75c5fe55d27 distrib/sets/lists/comp/mi
--- a/distrib/sets/lists/comp/mi        Tue Nov 17 18:31:12 2009 +0000
+++ b/distrib/sets/lists/comp/mi        Tue Nov 17 18:36:07 2009 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: mi,v 1.1338 2009/11/06 13:36:01 njoly Exp $
+#      $NetBSD: mi,v 1.1339 2009/11/17 18:36:07 dyoung Exp $
 #
 # Note: don't delete entries from here - mark them as "obsolete" instead.
 #
@@ -9182,8 +9182,10 @@
 ./usr/share/man/cat9/splclock.0                        comp-sys-catman         .cat
 ./usr/share/man/cat9/splhigh.0                 comp-sys-catman         .cat
 ./usr/share/man/cat9/splimp.0                  comp-sys-catman         .cat
+./usr/share/man/cat9/spllower.0                        comp-sys-catman         .cat
 ./usr/share/man/cat9/spllowersoftclock.0       comp-sys-catman         .cat
 ./usr/share/man/cat9/splnet.0                  comp-sys-catman         .cat
+./usr/share/man/cat9/splraise.0                        comp-sys-catman         .cat
 ./usr/share/man/cat9/splraiseipl.0             comp-sys-catman         .cat
 ./usr/share/man/cat9/splsched.0                        comp-sys-catman         .cat
 ./usr/share/man/cat9/splserial.0               comp-sys-catman         .cat
@@ -14585,8 +14587,10 @@
 ./usr/share/man/html9/splclock.html            comp-sys-htmlman        html
 ./usr/share/man/html9/splhigh.html             comp-sys-htmlman        html
 ./usr/share/man/html9/splimp.html              comp-sys-htmlman        html
+./usr/share/man/html9/spllower.html            comp-sys-htmlman        html
 ./usr/share/man/html9/spllowersoftclock.html   comp-sys-htmlman        html
 ./usr/share/man/html9/splnet.html              comp-sys-htmlman        html
+./usr/share/man/html9/splraise.html            comp-sys-htmlman        html
 ./usr/share/man/html9/splraiseipl.html         comp-sys-htmlman        html
 ./usr/share/man/html9/splsched.html            comp-sys-htmlman        html
 ./usr/share/man/html9/splserial.html           comp-sys-htmlman        html
@@ -20193,8 +20197,10 @@
 ./usr/share/man/man9/splclock.9                        comp-sys-man            .man
 ./usr/share/man/man9/splhigh.9                 comp-sys-man            .man
 ./usr/share/man/man9/splimp.9                  comp-sys-man            .man
+./usr/share/man/man9/spllower.9                        comp-sys-man            .man
 ./usr/share/man/man9/spllowersoftclock.9       comp-sys-man            .man
 ./usr/share/man/man9/splnet.9                  comp-sys-man            .man
+./usr/share/man/man9/splraise.9                        comp-sys-man            .man
 ./usr/share/man/man9/splraiseipl.9             comp-sys-man            .man
 ./usr/share/man/man9/splsched.9                        comp-sys-man            .man
 ./usr/share/man/man9/splserial.9               comp-sys-man            .man
diff -r 1352d940b422 -r a75c5fe55d27 share/man/man9/Makefile
--- a/share/man/man9/Makefile   Tue Nov 17 18:31:12 2009 +0000
+++ b/share/man/man9/Makefile   Tue Nov 17 18:36:07 2009 +0000
@@ -1,4 +1,4 @@
-#       $NetBSD: Makefile,v 1.297 2009/11/05 00:20:25 dyoung Exp $
+#       $NetBSD: Makefile,v 1.298 2009/11/17 18:36:07 dyoung Exp $
 
 #      Makefile for section 9 (kernel function and variable) manual pages.
 
@@ -613,7 +613,9 @@
        softintr.9 softint_establish.9 softintr.9 softint_disestablish.9 \
        softintr.9 softint_schedule.9
 MLINKS+=spl.9 spl0.9 spl.9 splbio.9 spl.9 splclock.9 spl.9 splhigh.9 \
-       spl.9 splimp.9 spl.9 spllowersoftclock.9 spl.9 splnet.9 \
+       spl.9 splimp.9 \
+       spl.9 spllower.9 spl.9 spllowersoftclock.9 spl.9 splnet.9 \
+       spl.9 splraise.9 \
        spl.9 splsched.9 spl.9 splserial.9 \
        spl.9 splsoftclock.9 spl.9 splsoftnet.9 spl.9 splsoftserial.9 \
        spl.9 splstatclock.9 spl.9 spltty.9 spl.9 splvm.9 spl.9 splx.9 \
diff -r 1352d940b422 -r a75c5fe55d27 share/man/man9/spl.9
--- a/share/man/man9/spl.9      Tue Nov 17 18:31:12 2009 +0000
+++ b/share/man/man9/spl.9      Tue Nov 17 18:36:07 2009 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: spl.9,v 1.34 2009/05/18 14:01:31 wiz Exp $
+.\"    $NetBSD: spl.9,v 1.35 2009/11/17 18:36:07 dyoung Exp $
 .\"
 .\" Copyright (c) 2000, 2001 Jason R. Thorpe.  All rights reserved.
 .\" Copyright (c) 1997 Michael Long.
@@ -27,11 +27,13 @@
 .\" (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 13, 2008
+.Dd November 17, 2009
 .Dt SPL 9
 .Os
 .Sh NAME
 .Nm spl ,
+.Nm spllower ,
+.Nm splraise ,
 .Nm spl0 ,
 .Nm splhigh ,
 .Nm splvm ,
@@ -45,6 +47,10 @@
 .Sh SYNOPSIS
 .In sys/intr.h
 .Ft void
+.Fn spllower "int s"
+.Ft int
+.Fn splraise "int s"
+.Ft void
 .Fn spl0 void
 .Ft int
 .Fn splhigh void
@@ -207,6 +213,35 @@
 which must be a value previously returned by one of the other
 .Nm
 functions.
+.Pp
+The
+.Fn spllower
+function sets the system priority level to the one encoded in
+.Fa s ,
+if
+.Fa s
+is lower than the current level.
+Otherwise, it does not change the level.
+Use
+.Fn splx
+instead
+of
+.Fn spllower ,
+except in extraordinary circumstances.
+.Pp
+The
+.Fn splraise
+function sets the system priority level to the one encoded in
+.Fa s ,
+if
+.Fa s
+is greater than the current level, and returns the previous level.
+Otherwise, it does not change the level, and it returns the current level.
+Except in extraordinary circumstances, 
+do not use
+.Fn splraise .
+Use one of the priority-raising functions above, instead.
+.Pp
 .Sh SEE ALSO
 .Xr condvar 9 ,
 .Xr mutex 9 ,