Source-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[src/trunk]: src Add man about kernel APIs to support intrctl(8).



details:   https://anonhg.NetBSD.org/src/rev/dce79721d50f
branches:  trunk
changeset: 810050:dce79721d50f
user:      knakahara <knakahara%NetBSD.org@localhost>
date:      Mon Aug 17 06:28:11 2015 +0000

description:
Add man about kernel APIs to support intrctl(8).

diffstat:

 distrib/sets/lists/comp/mi            |   8 ++--
 share/man/man9/Makefile               |  10 +++---
 share/man/man9/interrupt_distribute.9 |  54 +++++++++++++++++++++++++++++++++++
 share/man/man9/pci_intr_distribute.9  |  53 ----------------------------------
 4 files changed, 63 insertions(+), 62 deletions(-)

diffs (203 lines):

diff -r d4b9f5a3cb2f -r dce79721d50f distrib/sets/lists/comp/mi
--- a/distrib/sets/lists/comp/mi        Mon Aug 17 06:16:02 2015 +0000
+++ b/distrib/sets/lists/comp/mi        Mon Aug 17 06:28:11 2015 +0000
@@ -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
diff -r d4b9f5a3cb2f -r dce79721d50f share/man/man9/Makefile
--- a/share/man/man9/Makefile   Mon Aug 17 06:16:02 2015 +0000
+++ b/share/man/man9/Makefile   Mon Aug 17 06:28:11 2015 +0000
@@ -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 @@
        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 @@
        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 \
diff -r d4b9f5a3cb2f -r dce79721d50f share/man/man9/interrupt_distribute.9
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man9/interrupt_distribute.9     Mon Aug 17 06:28:11 2015 +0000
@@ -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 .
diff -r d4b9f5a3cb2f -r dce79721d50f share/man/man9/pci_intr_distribute.9
--- a/share/man/man9/pci_intr_distribute.9      Mon Aug 17 06:16:02 2015 +0000
+++ /dev/null   Thu Jan 01 00:00:00 1970 +0000
@@ -1,53 +0,0 @@
-.\" $NetBSD: pci_intr_distribute.9,v 1.2 2015/04/27 10:32:22 wiz 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 April 8, 2015
-.Dt PCI_INTR_DISTRIBUTE 9
-.Os
-.Sh NAME
-.Nm pci_intr_distribute
-.Sh SYNOPSIS
-.In dev/pci/pcivar.h
-.Ft int
-.Fn pci_intr_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 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 .



Home | Main Index | Thread Index | Old Index