[src/trunk]: src/share/man/man9 document pci_intr_evcnt()

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

details:   https://anonhg.NetBSD.org/src/rev/4ec59bbb9b3f
branches:  trunk
changeset: 809852:4ec59bbb9b3f
user:      mrg <mrg%NetBSD.org@localhost>
date:      Wed Aug 05 07:00:34 2015 +0000

description:
document pci_intr_evcnt()

diffstat:

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

diffs (56 lines):

diff -r 848e8fc9991d -r 4ec59bbb9b3f share/man/man9/pci_intr.9
--- a/share/man/man9/pci_intr.9 Wed Aug 05 06:54:39 2015 +0000
+++ b/share/man/man9/pci_intr.9 Wed Aug 05 07:00:34 2015 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pci_intr.9,v 1.18 2015/02/25 17:03:42 riastradh Exp $
+.\" $NetBSD: pci_intr.9,v 1.19 2015/08/05 07:00:34 mrg Exp $
 .\"
 .\" Copyright (c) 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,13 +27,14 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd February 25, 2015
+.Dd August 4, 2015
 .Dt PCI_INTR 9
 .Os
 .Sh NAME
 .Nm pci_intr ,
 .Nm pci_intr_map ,
 .Nm pci_intr_string ,
+.Nm pci_intr_evcnt ,
 .Nm pci_intr_establish ,
 .Nm pci_intr_disestablish
 .Nd PCI bus interrupt manipulation functions
@@ -43,6 +44,8 @@
 .Fn pci_intr_map "const struct pci_attach_args *pa" "pci_intr_handle_t *ih"
 .Ft const char *
 .Fn pci_intr_string "pci_chipset_tag_t pc" "pci_intr_handle_t ih" "char *buf" "size_t len"
+.Ft const struct evcnt *
+.Fn pci_intr_evcnt "pci_chipset_tag_t pc" "pci_intr_handle_t ih"
 .Ft void *
 .Fn pci_intr_establish "pci_chipset_tag_t pc" "pci_intr_handle_t ih" \
 "int ipl" "int (*intrhand)(void *)" "void *intrarg"
@@ -106,6 +109,14 @@
 .Fn pci_intr_disestablish
 to disable the interrupt handler
 when the driver is no longer interested in interrupts from the device.
+.Pp
+The
+.Fn pci_intr_evcnt
+function should return an evcnt structure pointer or NULL if there is
+no evcnt associated with this interrupt.
+See
+.Xr evcnt 9
+for more details.
 .Ss PORTING
 A port's implementation of
 .Fn pci_intr_map
@@ -147,3 +158,6 @@
 contains the PCI tag of the device itself, and
 .Ft pa_intrtag
 contains the PCI tag of the uppermost bridge device.
+.Sh SEE ALSO
+.Xr evcnt 9 ,
+.Xr pci 9 .