[src/trunk]: src/share/man/man9 Update to reflect reality.

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

details:   https://anonhg.NetBSD.org/src/rev/623073b11c8d
branches:  trunk
changeset: 508577:623073b11c8d
user:      thorpej <thorpej%NetBSD.org@localhost>
date:      Sat Apr 14 00:15:41 2001 +0000

description:
Update to reflect reality.

diffstat:

 share/man/man9/spl.9 |  33 +++++++++++++++++++++++++--------
 1 files changed, 25 insertions(+), 8 deletions(-)

diffs (84 lines):

diff -r fedd19b80def -r 623073b11c8d share/man/man9/spl.9
--- a/share/man/man9/spl.9      Sat Apr 14 00:01:28 2001 +0000
+++ b/share/man/man9/spl.9      Sat Apr 14 00:15:41 2001 +0000
@@ -1,6 +1,6 @@
-.\"    $NetBSD: spl.9,v 1.11 2000/08/22 19:56:08 thorpej Exp $
+.\"    $NetBSD: spl.9,v 1.12 2001/04/14 00:15:41 thorpej Exp $
 .\"
-.\" Copyright (c) 2000 Jason R. Thorpe.  All rights reserved.
+.\" Copyright (c) 2000, 2001 Jason R. Thorpe.  All rights reserved.
 .\" Copyright (c) 1997 Michael Long.
 .\" Copyright (c) 1997 Jonathan Stone.
 .\" All rights reserved.
@@ -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 August 21, 2000
+.Dd April 13, 2001
 .Dt SPL 9
 .Os
 .Sh NAME
@@ -36,7 +36,7 @@
 .Nm splbio ,
 .Nm splclock ,
 .Nm splhigh ,
-.Nm splimp ,
+.Nm splvm ,
 .Nm spllock ,
 .Nm spllowersoftclock ,
 .Nm splnet ,
@@ -64,7 +64,7 @@
 .Ft int
 .Fn splstatclock void
 .Ft int
-.Fn splimp void
+.Fn splvm void
 .Ft int
 .Fn spltty void
 .Ft int
@@ -146,7 +146,7 @@
 Generally, all code run at this level must schedule additional
 processing to run in a software interrupt.  Note that code running
 at this priority is not blocked by
-.Fn splimp
+.Fn splvm
 (described below), and is therefore prohibited from using the
 kernel memory allocators.
 .It Fn splsched
@@ -180,12 +180,16 @@
 scheduling.  This level is identical to
 .Fn splclock
 if there is no separate statistics clock.
-.It Fn splimp
+.It Fn splvm
 blocks hard interrupts from all devices that are allowed to use the
 kernel
 .Xr malloc 9 ,
 or any virtual memory operations.
-That includes all disk, network, and tty device interrupts.
+That includes all disk, network, and tty device interrupts.  The
+temptation to abuse the semantics of
+.Fn splvm
+should be avoided; if you feel as if you need to block more than
+one class of interrupts at a time, use software interrupts instead.
 .It Fn spltty
 blocks hard and soft interrupts from TTY devices (IPL_TTY).  This
 must also block soft serial interrupts.
@@ -252,3 +256,16 @@
 .Fn splsoftclock
 were changed.
 .Pp
+The
+.Fn splimp
+call was removed from the kernel between
+.Nx 1.5
+and
+.Nx 1.6 .
+The function of
+.Fn splimp
+was replaced by
+.Fn splvm
+and code which abused the semantics of
+.Fn splimp
+was changed to not mix interrupt priority levels.