[src/trunk]: src/share/man/man9 Document splbio() as a deprecated synonym for...

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

details:   https://anonhg.NetBSD.org/src/rev/0b6d115656a6
branches:  trunk
changeset: 352512:0b6d115656a6
user:      pgoyette <pgoyette%NetBSD.org@localhost>
date:      Thu Apr 06 02:23:26 2017 +0000

description:
Document splbio() as a deprecated synonym for splvm().

diffstat:

 share/man/man9/Makefile |   4 ++--
 share/man/man9/spl.9    |  13 +++++++++++--
 2 files changed, 13 insertions(+), 4 deletions(-)

diffs (66 lines):

diff -r a8f74e0c278d -r 0b6d115656a6 share/man/man9/Makefile
--- a/share/man/man9/Makefile   Thu Apr 06 02:22:52 2017 +0000
+++ b/share/man/man9/Makefile   Thu Apr 06 02:23:26 2017 +0000
@@ -1,4 +1,4 @@
-#       $NetBSD: Makefile,v 1.404 2017/04/06 01:54:17 pgoyette Exp $
+#       $NetBSD: Makefile,v 1.405 2017/04/06 02:23:26 pgoyette Exp $
 
 #      Makefile for section 9 (kernel function and variable) manual pages.
 
@@ -851,7 +851,7 @@
        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 \
-       spl.9 splsoftbio.9
+       spl.9 splsoftbio.9 spl.9 splbio.9
 MLINKS+=store.9 subyte.9 store.9 suibyte.9 store.9 susword.9 \
        store.9 suswintr.9 store.9 suword.9 store.9 suiword.9
 MLINKS+=sysctl.9 old_sysctl.9 \
diff -r a8f74e0c278d -r 0b6d115656a6 share/man/man9/spl.9
--- a/share/man/man9/spl.9      Thu Apr 06 02:22:52 2017 +0000
+++ b/share/man/man9/spl.9      Thu Apr 06 02:23:26 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: spl.9,v 1.39 2010/02/16 19:21:30 rmind Exp $
+.\"    $NetBSD: spl.9,v 1.40 2017/04/06 02:23:26 pgoyette 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 16, 2010
+.Dd April 6, 2017
 .Dt SPL 9
 .Os
 .Sh NAME
@@ -35,6 +35,7 @@
 .Nm spl0 ,
 .Nm splhigh ,
 .Nm splvm ,
+.Nm splbio ,
 .Nm splsched ,
 .Nm splsoftbio ,
 .Nm splsoftclock ,
@@ -51,6 +52,8 @@
 .Ft int
 .Fn splsched void
 .Ft int
+.Fn splbio void
+.Ft int
 .Fn splvm void
 .Ft int
 .Fn splsoftbio void
@@ -168,6 +171,12 @@
 A future release of the system may allow the automatic acquisition of
 .Dv kernel_lock
 to be disabled for individual interrupt handlers.
+.Pp
+.Fn splbio
+is a synonym for
+.Fn splvm .
+Its use is deprecated; all new code should use
+.Fn splvm .
 .It Fn splsoftserial , IPL_SOFTSERIAL
 .Pp
 Blocks soft interrupts at the IPL_SOFTSERIAL symbolic level.