Module Name: src
Committed By: knakahara
Date: Mon Aug 17 06:28:11 UTC 2015
Modified Files:
src/distrib/sets/lists/comp: mi
src/share/man/man9: Makefile
Added Files:
src/share/man/man9: interrupt_distribute.9
Removed Files:
src/share/man/man9: pci_intr_distribute.9
Log Message:
Add man about kernel APIs to support intrctl(8).
To generate a diff of this commit:
cvs rdiff -u -r1.1979 -r1.1980 src/distrib/sets/lists/comp/mi
cvs rdiff -u -r1.390 -r1.391 src/share/man/man9/Makefile
cvs rdiff -u -r0 -r1.1 src/share/man/man9/interrupt_distribute.9
cvs rdiff -u -r1.2 -r0 src/share/man/man9/pci_intr_distribute.9
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/distrib/sets/lists/comp/mi
diff -u src/distrib/sets/lists/comp/mi:1.1979 src/distrib/sets/lists/comp/mi:1.1980
--- src/distrib/sets/lists/comp/mi:1.1979 Fri Aug 14 02:35:32 2015
+++ src/distrib/sets/lists/comp/mi Mon Aug 17 06:28:11 2015
@@ -1,4 +1,4 @@
-# $NetBSD: mi,v 1.1979 2015/08/14 02:35:32 knakahara Exp $
+# $NetBSD: mi,v 1.1980 2015/08/17 06:28:11 knakahara Exp $
#
# Note: don't delete entries from here - mark them as "obsolete" instead.
#
@@ -9953,6 +9953,7 @@
./usr/share/man/cat9/in_getifa.0 comp-sys-catman .cat
./usr/share/man/cat9/incore.0 comp-sys-catman .cat
./usr/share/man/cat9/inittodr.0 comp-sys-catman .cat
+./usr/share/man/cat9/interrupt_distribute.0 comp-sys-catman .cat
./usr/share/man/cat9/intro.0 comp-sys-catman .cat
./usr/share/man/cat9/ioasic.0 comp-sys-catman .cat
./usr/share/man/cat9/ioasic_attach_devs.0 comp-sys-catman .cat
@@ -10192,7 +10193,6 @@
./usr/share/man/cat9/pci_intr.0 comp-sys-catman .cat
./usr/share/man/cat9/pci_intr_alloc.0 comp-sys-catman .cat
./usr/share/man/cat9/pci_intr_disestablish.0 comp-sys-catman .cat
-./usr/share/man/cat9/pci_intr_distribute.0 comp-sys-catman .cat
./usr/share/man/cat9/pci_intr_establish.0 comp-sys-catman .cat
./usr/share/man/cat9/pci_intr_evcnt.0 comp-sys-catman .cat
./usr/share/man/cat9/pci_intr_map.0 comp-sys-catman .cat
@@ -16768,6 +16768,7 @@
./usr/share/man/html9/in_getifa.html comp-sys-htmlman html
./usr/share/man/html9/incore.html comp-sys-htmlman html
./usr/share/man/html9/inittodr.html comp-sys-htmlman html
+./usr/share/man/html9/interrupt_distribute.html comp-sys-htmlman html
./usr/share/man/html9/intro.html comp-sys-htmlman html
./usr/share/man/html9/ioasic.html comp-sys-htmlman html
./usr/share/man/html9/ioasic_attach_devs.html comp-sys-htmlman html
@@ -17001,7 +17002,6 @@
./usr/share/man/html9/pci_intr.html comp-sys-htmlman html
./usr/share/man/html9/pci_intr_alloc.html comp-sys-htmlman html
./usr/share/man/html9/pci_intr_disestablish.html comp-sys-htmlman html
-./usr/share/man/html9/pci_intr_distribute.html comp-sys-htmlman html
./usr/share/man/html9/pci_intr_establish.html comp-sys-htmlman html
./usr/share/man/html9/pci_intr_evcnt.html comp-sys-htmlman html
./usr/share/man/html9/pci_intr_map.html comp-sys-htmlman html
@@ -23733,6 +23733,7 @@
./usr/share/man/man9/in_getifa.9 comp-sys-man .man
./usr/share/man/man9/incore.9 comp-sys-man .man
./usr/share/man/man9/inittodr.9 comp-sys-man .man
+./usr/share/man/man9/interrupt_distribute.9 comp-sys-man .man
./usr/share/man/man9/intro.9 comp-sys-man .man
./usr/share/man/man9/ioasic.9 comp-sys-man .man
./usr/share/man/man9/ioasic_attach_devs.9 comp-sys-man .man
@@ -23972,7 +23973,6 @@
./usr/share/man/man9/pci_intr.9 comp-sys-man .man
./usr/share/man/man9/pci_intr_alloc.9 comp-sys-man .man
./usr/share/man/man9/pci_intr_disestablish.9 comp-sys-man .man
-./usr/share/man/man9/pci_intr_distribute.9 comp-sys-man .man
./usr/share/man/man9/pci_intr_establish.9 comp-sys-man .man
./usr/share/man/man9/pci_intr_evcnt.9 comp-sys-man .man
./usr/share/man/man9/pci_intr_map.9 comp-sys-man .man
Index: src/share/man/man9/Makefile
diff -u src/share/man/man9/Makefile:1.390 src/share/man/man9/Makefile:1.391
--- src/share/man/man9/Makefile:1.390 Fri Aug 14 02:04:16 2015
+++ src/share/man/man9/Makefile Mon Aug 17 06:28:11 2015
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile,v 1.390 2015/08/14 02:04:16 knakahara Exp $
+# $NetBSD: Makefile,v 1.391 2015/08/17 06:28:11 knakahara Exp $
# Makefile for section 9 (kernel function and variable) manual pages.
@@ -27,9 +27,9 @@ MAN= accept_filter.9 accf_data.9 accf_ht
ieee80211_node.9 ieee80211_output.9 ieee80211_proto.9 \
ieee80211_radiotap.9 iic.9 imax.9 \
in_getifa.9 \
- in4_cksum.9 inittodr.9 intro.9 ioasic.9 ioctl.9 ipkdb.9 ipi.9 isa.9 \
- isapnp.9 itimerfix.9 kauth.9 kcopy.9 kcpuset.9 kmem.9 \
- kpause.9 \
+ in4_cksum.9 inittodr.9 interrupt_distribute.9 intro.9 ioasic.9 \
+ ioctl.9 ipkdb.9 ipi.9 isa.9 isapnp.9 itimerfix.9 kauth.9 kcopy.9 \
+ kcpuset.9 kmem.9 kpause.9 \
kfilter_register.9 knote.9 \
kprintf.9 kthread.9 linedisc.9 lock.9 log.9 ltsleep.9 \
LWP_CACHE_CREDS.9 \
@@ -40,7 +40,7 @@ MAN= accept_filter.9 accf_data.9 accf_ht
mstohz.9 mutex.9 m_tag.9 namecache.9 \
namei.9 nullop.9 opencrypto.9 optstr.9 \
panic.9 pathbuf.9 pci.9 pci_configure_bus.9 pci_intr.9 \
- pci_intr_distribute.9 pci_msi.9 pckbport.9 pcmcia.9 pcq.9 pcu.9 \
+ pci_msi.9 pckbport.9 pcmcia.9 pcq.9 pcu.9 \
percpu.9 pfil.9 physio.9 pmap.9 pmatch.9 pmc.9 pmf.9 pool.9 \
pool_cache.9 powerhook_establish.9 ppi.9 ppsratecheck.9 preempt.9 \
proc_find.9 pserialize.9 putter.9 \
Added files:
Index: src/share/man/man9/interrupt_distribute.9
diff -u /dev/null src/share/man/man9/interrupt_distribute.9:1.1
--- /dev/null Mon Aug 17 06:28:11 2015
+++ src/share/man/man9/interrupt_distribute.9 Mon Aug 17 06:28:11 2015
@@ -0,0 +1,54 @@
+.\" $NetBSD: interrupt_distribute.9,v 1.1 2015/08/17 06:28:11 knakahara Exp $
+.\"
+.\" Copyright (c) 2015 Internet Initiative Japan Inc.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in the
+.\" documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (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 17, 2015
+.Dt INTERRUPT_DISTRIBUTE 9
+.Os
+.Sh NAME
+.Nm interrupt_distribute
+.Sh SYNOPSIS
+.In sys/interrupt.h
+.Ft int
+.Fn interrupt_distribute "void *ich" "const kcpuset_t *newset" \
+"kcpuset_t *oldset"
+.Sh DESCRIPTION
+The
+.Nm
+function exists to assign an interrupt to a CPU.
+.Pp
+If a driver (or the other kernel component) wishes to assign an
+interrupt to a CPU, it should pass a interrupt handler such as
+the return value of
+.Fn pci_intr_establish
+as
+.Fa ich
+argument, and it should pass the kcpuset to which it should be
+assigned as
+.Fa newset .
+To get the previous value, pass a
+.Pf non- Dv NULL
+value to
+.Ft oldset .
