[src/trunk]: src/share/man/man9 IPL-lowering functions are now defined to ret...

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

details:   https://anonhg.NetBSD.org/src/rev/d0e09f9133d3
branches:  trunk
changeset: 487467:d0e09f9133d3
user:      cgd <cgd%NetBSD.org@localhost>
date:      Thu Jun 08 06:45:24 2000 +0000

description:
IPL-lowering functions are now defined to return `void.'  See also my
post to tech-kern about the issue.  No ports updated yet; they should
be updated as time permits.

diffstat:

 share/man/man9/spl.9 |  19 ++++++++++++++++---
 1 files changed, 16 insertions(+), 3 deletions(-)

diffs (41 lines):

diff -r 116b051eed6f -r d0e09f9133d3 share/man/man9/spl.9
--- a/share/man/man9/spl.9      Thu Jun 08 06:01:27 2000 +0000
+++ b/share/man/man9/spl.9      Thu Jun 08 06:45:24 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: spl.9,v 1.6 2000/03/27 09:36:29 soda Exp $
+.\"    $NetBSD: spl.9,v 1.7 2000/06/08 06:45:24 cgd Exp $
 .\"
 .\" Copyright (c) 1997 Michael Long.
 .\" Copyright (c) 1997 Jonathan Stone.
@@ -73,9 +73,9 @@
 .Fn splsoftnet void
 .Ft int
 .Fn splsoftclock void
-.Ft int
+.Ft void
 .Fn spllowersoftclock void
-.Ft int
+.Ft void
 .Fn spl0 void
 .Ft void
 .Fn splx "int s"
@@ -167,6 +167,19 @@
 .Nm
 functions.
 .Pp
+Note that the functions which lower the system priority level
+.Po
+.Fn spllowersoftclock ,
+.Fn spl0 ,
+and
+.Fn splx
+.Pc
+do not return a value.  They should only be used
+in places where the system priority level is being decreased
+permanently.  It is inappropriate to attempt to use them where the
+system priority level is being decreased temporarily, and would
+need to be restored to a previous value before continuing.
+.Pp
 .Sh HISTORY
 .Pp
 Originally,