[src/trunk]: src/share/man/man9 Add missing pci_intr_setattr(). The function ...

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

details:   https://anonhg.NetBSD.org/src/rev/4fd0a19cd16e
branches:  trunk
changeset: 340959:4fd0a19cd16e
user:      msaitoh <msaitoh%NetBSD.org@localhost>
date:      Tue Oct 13 04:34:38 2015 +0000

description:
Add missing pci_intr_setattr(). The function first appeared in NetBSD 5.0.

diffstat:

 share/man/man9/pci_intr.9 |  24 ++++++++++++++++++++++--
 1 files changed, 22 insertions(+), 2 deletions(-)

diffs (59 lines):

diff -r e790de22bde3 -r 4fd0a19cd16e share/man/man9/pci_intr.9
--- a/share/man/man9/pci_intr.9 Tue Oct 13 04:33:21 2015 +0000
+++ b/share/man/man9/pci_intr.9 Tue Oct 13 04:34:38 2015 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pci_intr.9,v 1.20 2015/08/06 06:56:00 wiz Exp $
+.\" $NetBSD: pci_intr.9,v 1.21 2015/10/13 04:34:38 msaitoh Exp $
 .\"
 .\" Copyright (c) 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd August 4, 2015
+.Dd October 13, 2015
 .Dt PCI_INTR 9
 .Os
 .Sh NAME
@@ -37,6 +37,7 @@
 .Nm pci_intr_evcnt ,
 .Nm pci_intr_establish ,
 .Nm pci_intr_disestablish
+.Nm pci_intr_setattr
 .Nd PCI bus interrupt manipulation functions
 .Sh SYNOPSIS
 .In dev/pci/pcivar.h
@@ -51,6 +52,7 @@
 "int ipl" "int (*intrhand)(void *)" "void *intrarg"
 .Ft void
 .Fn pci_intr_disestablish "pci_chipset_tag_t pc" "void *ih"
+.Fn pci_intr_setattr "pci_chipset_tag_t pc" "pci_intr_handle_t *ih" "int attr" "uint64_t data"
 .Sh DESCRIPTION
 The
 .Nm
@@ -111,6 +113,24 @@
 when the driver is no longer interested in interrupts from the device.
 .Pp
 The
+.Fn pci_intr_setattr
+function sets an attribute
+.Fa attr
+of the interrupt handler to
+.Fa data .
+Currenty, only the following attribute is supported:
+.Bl -tag -width PCI_INTR_MPSAFE
+.It Dv PCI_INTR_MPSAFE
+If this attribute is set to
+.Dv true ,
+it specifies that the interrupt handler is multiprocessor safe and works its
+own locking; otherwise the kernel lock will be held for the call to the
+interrupt handler.
+The default is
+.Dv false .
+.El
+.Pp
+The
 .Fn pci_intr_evcnt
 function should return an evcnt structure pointer or
 .Dv NULL