Module Name: src
Committed By: mrg
Date: Wed Aug 5 07:00:34 UTC 2015
Modified Files:
src/share/man/man9: pci_intr.9
Log Message:
document pci_intr_evcnt()
To generate a diff of this commit:
cvs rdiff -u -r1.18 -r1.19 src/share/man/man9/pci_intr.9
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man9/pci_intr.9
diff -u src/share/man/man9/pci_intr.9:1.18 src/share/man/man9/pci_intr.9:1.19
--- src/share/man/man9/pci_intr.9:1.18 Wed Feb 25 17:03:42 2015
+++ src/share/man/man9/pci_intr.9 Wed Aug 5 07:00:34 2015
@@ -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 @@ may be saved and passed to
.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 original interrupt pin;
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 .
