[src/trunk]: src/share/man/man9 bring the section on automatic acquisition of...

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

details:   https://anonhg.NetBSD.org/src/rev/06b8f3531794
branches:  trunk
changeset: 970924:06b8f3531794
user:      jdolecek <jdolecek%NetBSD.org@localhost>
date:      Tue Apr 07 07:25:09 2020 +0000

description:
bring the section on automatic acquisition of kernel_lock up-to-date

diffstat:

 share/man/man9/spl.9 |  15 +++++++++------
 1 files changed, 9 insertions(+), 6 deletions(-)

diffs (40 lines):

diff -r 78f02e55e4c0 -r 06b8f3531794 share/man/man9/spl.9
--- a/share/man/man9/spl.9      Mon Apr 06 20:26:16 2020 +0000
+++ b/share/man/man9/spl.9      Tue Apr 07 07:25:09 2020 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: spl.9,v 1.41 2017/04/06 03:00:13 pgoyette Exp $
+.\"    $NetBSD: spl.9,v 1.42 2020/04/07 07:25:09 jdolecek 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 April 6, 2017
+.Dd April 7, 2020
 .Dt SPL 9
 .Os
 .Sh NAME
@@ -169,14 +169,17 @@
 .Xr pool_cache 9
 interfaces to allocate memory.
 .Pp
-At the time of writing, the global
+The global
 .Dv kernel_lock
-is automatically acquired for interrupts at this level, in order to
+is automatically acquired for interrupts at this level by default,
+in order to
 support device drivers that do not provide their own multiprocessor
 synchronization.
-A future release of the system may allow the automatic acquisition of
+The automatic acquisition of
 .Dv kernel_lock
-to be disabled for individual interrupt handlers.
+can be disabled for individual interrupt handlers by device drivers
+if supported by subsystem, see e.g.
+.Xr pci_intr_establish 9 .
 .Pp
 .Fn splbio ,
 .Fn splnet ,