Tue Jul 21 03:12:50 2015 UTC ()
add pci_intr_alloc() man


(knakahara)
diff -r1.1970 -r1.1971 src/distrib/sets/lists/comp/mi
diff -r1.388 -r1.389 src/share/man/man9/Makefile
diff -r1.3 -r1.4 src/share/man/man9/pci_msi.9
cvs diff -r1.1970 -r1.1971 src/distrib/sets/lists/comp/mi (expand / switch to unified diff)

--- src/distrib/sets/lists/comp/mi 2015/07/12 08:11:27 1.1970
+++ src/distrib/sets/lists/comp/mi 2015/07/21 03:12:50 1.1971
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1# $NetBSD: mi,v 1.1970 2015/07/12 08:11:27 hannken Exp $ 1# $NetBSD: mi,v 1.1971 2015/07/21 03:12:50 knakahara Exp $
2# 2#
3# Note: don't delete entries from here - mark them as "obsolete" instead. 3# Note: don't delete entries from here - mark them as "obsolete" instead.
4# 4#
5#./usr/libdata/lint/llib-ldtrace.ln comp-c-lintlib lint,dtrace 5#./usr/libdata/lint/llib-ldtrace.ln comp-c-lintlib lint,dtrace
6./etc/mtree/set.comp comp-sys-root 6./etc/mtree/set.comp comp-sys-root
7./usr/bin/addr2line comp-debug-bin binutils 7./usr/bin/addr2line comp-debug-bin binutils
8./usr/bin/ar comp-util-bin binutils 8./usr/bin/ar comp-util-bin binutils
9./usr/bin/as comp-util-bin binutils 9./usr/bin/as comp-util-bin binutils
10./usr/bin/asa comp-fortran-bin 10./usr/bin/asa comp-fortran-bin
11./usr/bin/atf-compile comp-obsolete obsolete 11./usr/bin/atf-compile comp-obsolete obsolete
12./usr/bin/c++ comp-cxx-bin gcccmds 12./usr/bin/c++ comp-cxx-bin gcccmds
13./usr/bin/c++filt comp-cxx-bin binutils 13./usr/bin/c++filt comp-cxx-bin binutils
14./usr/bin/c89 comp-c-bin 14./usr/bin/c89 comp-c-bin
@@ -10608,32 +10608,35 @@ @@ -10608,32 +10608,35 @@
10608./usr/share/man/cat9/pci_conf_hook.0 comp-sys-catman .cat 10608./usr/share/man/cat9/pci_conf_hook.0 comp-sys-catman .cat
10609./usr/share/man/cat9/pci_conf_interrupt.0 comp-sys-catman .cat 10609./usr/share/man/cat9/pci_conf_interrupt.0 comp-sys-catman .cat
10610./usr/share/man/cat9/pci_conf_print.0 comp-sys-catman .cat 10610./usr/share/man/cat9/pci_conf_print.0 comp-sys-catman .cat
10611./usr/share/man/cat9/pci_conf_read.0 comp-sys-catman .cat 10611./usr/share/man/cat9/pci_conf_read.0 comp-sys-catman .cat
10612./usr/share/man/cat9/pci_conf_write.0 comp-sys-catman .cat 10612./usr/share/man/cat9/pci_conf_write.0 comp-sys-catman .cat
10613./usr/share/man/cat9/pci_configure_bus.0 comp-sys-catman .cat 10613./usr/share/man/cat9/pci_configure_bus.0 comp-sys-catman .cat
10614./usr/share/man/cat9/pci_decompose_tag.0 comp-sys-catman .cat 10614./usr/share/man/cat9/pci_decompose_tag.0 comp-sys-catman .cat
10615./usr/share/man/cat9/pci_devinfo.0 comp-sys-catman .cat 10615./usr/share/man/cat9/pci_devinfo.0 comp-sys-catman .cat
10616./usr/share/man/cat9/pci_find_device.0 comp-sys-catman .cat 10616./usr/share/man/cat9/pci_find_device.0 comp-sys-catman .cat
10617./usr/share/man/cat9/pci_findvendor.0 comp-sys-catman .cat 10617./usr/share/man/cat9/pci_findvendor.0 comp-sys-catman .cat
10618./usr/share/man/cat9/pci_get_capability.0 comp-sys-catman .cat 10618./usr/share/man/cat9/pci_get_capability.0 comp-sys-catman .cat
10619./usr/share/man/cat9/pci_get_powerstate.0 comp-sys-catman .cat 10619./usr/share/man/cat9/pci_get_powerstate.0 comp-sys-catman .cat
10620./usr/share/man/cat9/pci_intr.0 comp-sys-catman .cat 10620./usr/share/man/cat9/pci_intr.0 comp-sys-catman .cat
 10621./usr/share/man/cat9/pci_intr_alloc.0 comp-sys-catman .cat
10621./usr/share/man/cat9/pci_intr_disestablish.0 comp-sys-catman .cat 10622./usr/share/man/cat9/pci_intr_disestablish.0 comp-sys-catman .cat
10622./usr/share/man/cat9/pci_intr_distribute.0 comp-sys-catman .cat 10623./usr/share/man/cat9/pci_intr_distribute.0 comp-sys-catman .cat
10623./usr/share/man/cat9/pci_intr_establish.0 comp-sys-catman .cat 10624./usr/share/man/cat9/pci_intr_establish.0 comp-sys-catman .cat
10624./usr/share/man/cat9/pci_intr_evcnt.0 comp-sys-catman .cat 10625./usr/share/man/cat9/pci_intr_evcnt.0 comp-sys-catman .cat
10625./usr/share/man/cat9/pci_intr_map.0 comp-sys-catman .cat 10626./usr/share/man/cat9/pci_intr_map.0 comp-sys-catman .cat
 10627./usr/share/man/cat9/pci_intr_release.0 comp-sys-catman .cat
10626./usr/share/man/cat9/pci_intr_string.0 comp-sys-catman .cat 10628./usr/share/man/cat9/pci_intr_string.0 comp-sys-catman .cat
 10629./usr/share/man/cat9/pci_intr_type.0 comp-sys-catman .cat
10627./usr/share/man/cat9/pci_intx_alloc.0 comp-sys-catman .cat 10630./usr/share/man/cat9/pci_intx_alloc.0 comp-sys-catman .cat
10628./usr/share/man/cat9/pci_intx_release.0 comp-sys-catman .cat 10631./usr/share/man/cat9/pci_intx_release.0 comp-sys-catman .cat
10629./usr/share/man/cat9/pci_make_tag.0 comp-sys-catman .cat 10632./usr/share/man/cat9/pci_make_tag.0 comp-sys-catman .cat
10630./usr/share/man/cat9/pci_mapreg_info.0 comp-sys-catman .cat 10633./usr/share/man/cat9/pci_mapreg_info.0 comp-sys-catman .cat
10631./usr/share/man/cat9/pci_mapreg_map.0 comp-sys-catman .cat 10634./usr/share/man/cat9/pci_mapreg_map.0 comp-sys-catman .cat
10632./usr/share/man/cat9/pci_mapreg_type.0 comp-sys-catman .cat 10635./usr/share/man/cat9/pci_mapreg_type.0 comp-sys-catman .cat
10633./usr/share/man/cat9/pci_msi.0 comp-sys-catman .cat 10636./usr/share/man/cat9/pci_msi.0 comp-sys-catman .cat
10634./usr/share/man/cat9/pci_msi_alloc.0 comp-sys-catman .cat 10637./usr/share/man/cat9/pci_msi_alloc.0 comp-sys-catman .cat
10635./usr/share/man/cat9/pci_msi_alloc_exact.0 comp-sys-catman .cat 10638./usr/share/man/cat9/pci_msi_alloc_exact.0 comp-sys-catman .cat
10636./usr/share/man/cat9/pci_msi_count.0 comp-sys-catman .cat 10639./usr/share/man/cat9/pci_msi_count.0 comp-sys-catman .cat
10637./usr/share/man/cat9/pci_msi_disestablish.0 comp-sys-catman .cat 10640./usr/share/man/cat9/pci_msi_disestablish.0 comp-sys-catman .cat
10638./usr/share/man/cat9/pci_msi_establish.0 comp-sys-catman .cat 10641./usr/share/man/cat9/pci_msi_establish.0 comp-sys-catman .cat
10639./usr/share/man/cat9/pci_msi_release.0 comp-sys-catman .cat 10642./usr/share/man/cat9/pci_msi_release.0 comp-sys-catman .cat
@@ -17412,32 +17415,35 @@ @@ -17412,32 +17415,35 @@
17412./usr/share/man/html9/pci_conf_hook.html comp-sys-htmlman html 17415./usr/share/man/html9/pci_conf_hook.html comp-sys-htmlman html
17413./usr/share/man/html9/pci_conf_interrupt.html comp-sys-htmlman html 17416./usr/share/man/html9/pci_conf_interrupt.html comp-sys-htmlman html
17414./usr/share/man/html9/pci_conf_print.html comp-sys-htmlman html 17417./usr/share/man/html9/pci_conf_print.html comp-sys-htmlman html
17415./usr/share/man/html9/pci_conf_read.html comp-sys-htmlman html 17418./usr/share/man/html9/pci_conf_read.html comp-sys-htmlman html
17416./usr/share/man/html9/pci_conf_write.html comp-sys-htmlman html 17419./usr/share/man/html9/pci_conf_write.html comp-sys-htmlman html
17417./usr/share/man/html9/pci_configure_bus.html comp-sys-htmlman html 17420./usr/share/man/html9/pci_configure_bus.html comp-sys-htmlman html
17418./usr/share/man/html9/pci_decompose_tag.html comp-sys-htmlman html 17421./usr/share/man/html9/pci_decompose_tag.html comp-sys-htmlman html
17419./usr/share/man/html9/pci_devinfo.html comp-sys-htmlman html 17422./usr/share/man/html9/pci_devinfo.html comp-sys-htmlman html
17420./usr/share/man/html9/pci_find_device.html comp-sys-htmlman html 17423./usr/share/man/html9/pci_find_device.html comp-sys-htmlman html
17421./usr/share/man/html9/pci_findvendor.html comp-sys-htmlman html 17424./usr/share/man/html9/pci_findvendor.html comp-sys-htmlman html
17422./usr/share/man/html9/pci_get_capability.html comp-sys-htmlman html 17425./usr/share/man/html9/pci_get_capability.html comp-sys-htmlman html
17423./usr/share/man/html9/pci_get_powerstate.html comp-sys-htmlman html 17426./usr/share/man/html9/pci_get_powerstate.html comp-sys-htmlman html
17424./usr/share/man/html9/pci_intr.html comp-sys-htmlman html 17427./usr/share/man/html9/pci_intr.html comp-sys-htmlman html
 17428./usr/share/man/html9/pci_intr_alloc.html comp-sys-htmlman html
17425./usr/share/man/html9/pci_intr_disestablish.html comp-sys-htmlman html 17429./usr/share/man/html9/pci_intr_disestablish.html comp-sys-htmlman html
17426./usr/share/man/html9/pci_intr_distribute.html comp-sys-htmlman html 17430./usr/share/man/html9/pci_intr_distribute.html comp-sys-htmlman html
17427./usr/share/man/html9/pci_intr_establish.html comp-sys-htmlman html 17431./usr/share/man/html9/pci_intr_establish.html comp-sys-htmlman html
17428./usr/share/man/html9/pci_intr_evcnt.html comp-sys-htmlman html 17432./usr/share/man/html9/pci_intr_evcnt.html comp-sys-htmlman html
17429./usr/share/man/html9/pci_intr_map.html comp-sys-htmlman html 17433./usr/share/man/html9/pci_intr_map.html comp-sys-htmlman html
 17434./usr/share/man/html9/pci_intr_release.html comp-sys-htmlman html
17430./usr/share/man/html9/pci_intr_string.html comp-sys-htmlman html 17435./usr/share/man/html9/pci_intr_string.html comp-sys-htmlman html
 17436./usr/share/man/html9/pci_intr_type.html comp-sys-htmlman html
17431./usr/share/man/html9/pci_intx_alloc.html comp-sys-htmlman html 17437./usr/share/man/html9/pci_intx_alloc.html comp-sys-htmlman html
17432./usr/share/man/html9/pci_intx_release.html comp-sys-htmlman html 17438./usr/share/man/html9/pci_intx_release.html comp-sys-htmlman html
17433./usr/share/man/html9/pci_make_tag.html comp-sys-htmlman html 17439./usr/share/man/html9/pci_make_tag.html comp-sys-htmlman html
17434./usr/share/man/html9/pci_mapreg_info.html comp-sys-htmlman html 17440./usr/share/man/html9/pci_mapreg_info.html comp-sys-htmlman html
17435./usr/share/man/html9/pci_mapreg_map.html comp-sys-htmlman html 17441./usr/share/man/html9/pci_mapreg_map.html comp-sys-htmlman html
17436./usr/share/man/html9/pci_mapreg_type.html comp-sys-htmlman html 17442./usr/share/man/html9/pci_mapreg_type.html comp-sys-htmlman html
17437./usr/share/man/html9/pci_msi.html comp-sys-htmlman html 17443./usr/share/man/html9/pci_msi.html comp-sys-htmlman html
17438./usr/share/man/html9/pci_msi_alloc.html comp-sys-htmlman html 17444./usr/share/man/html9/pci_msi_alloc.html comp-sys-htmlman html
17439./usr/share/man/html9/pci_msi_alloc_exact.html comp-sys-htmlman html 17445./usr/share/man/html9/pci_msi_alloc_exact.html comp-sys-htmlman html
17440./usr/share/man/html9/pci_msi_count.html comp-sys-htmlman html 17446./usr/share/man/html9/pci_msi_count.html comp-sys-htmlman html
17441./usr/share/man/html9/pci_msi_disestablish.html comp-sys-htmlman html 17447./usr/share/man/html9/pci_msi_disestablish.html comp-sys-htmlman html
17442./usr/share/man/html9/pci_msi_establish.html comp-sys-htmlman html 17448./usr/share/man/html9/pci_msi_establish.html comp-sys-htmlman html
17443./usr/share/man/html9/pci_msi_release.html comp-sys-htmlman html 17449./usr/share/man/html9/pci_msi_release.html comp-sys-htmlman html
@@ -24381,32 +24387,35 @@ @@ -24381,32 +24387,35 @@
24381./usr/share/man/man9/pci_conf_hook.9 comp-sys-man .man 24387./usr/share/man/man9/pci_conf_hook.9 comp-sys-man .man
24382./usr/share/man/man9/pci_conf_interrupt.9 comp-sys-man .man 24388./usr/share/man/man9/pci_conf_interrupt.9 comp-sys-man .man
24383./usr/share/man/man9/pci_conf_print.9 comp-sys-man .man 24389./usr/share/man/man9/pci_conf_print.9 comp-sys-man .man
24384./usr/share/man/man9/pci_conf_read.9 comp-sys-man .man 24390./usr/share/man/man9/pci_conf_read.9 comp-sys-man .man
24385./usr/share/man/man9/pci_conf_write.9 comp-sys-man .man 24391./usr/share/man/man9/pci_conf_write.9 comp-sys-man .man
24386./usr/share/man/man9/pci_configure_bus.9 comp-sys-man .man 24392./usr/share/man/man9/pci_configure_bus.9 comp-sys-man .man
24387./usr/share/man/man9/pci_decompose_tag.9 comp-sys-man .man 24393./usr/share/man/man9/pci_decompose_tag.9 comp-sys-man .man
24388./usr/share/man/man9/pci_devinfo.9 comp-sys-man .man 24394./usr/share/man/man9/pci_devinfo.9 comp-sys-man .man
24389./usr/share/man/man9/pci_find_device.9 comp-sys-man .man 24395./usr/share/man/man9/pci_find_device.9 comp-sys-man .man
24390./usr/share/man/man9/pci_findvendor.9 comp-sys-man .man 24396./usr/share/man/man9/pci_findvendor.9 comp-sys-man .man
24391./usr/share/man/man9/pci_get_capability.9 comp-sys-man .man 24397./usr/share/man/man9/pci_get_capability.9 comp-sys-man .man
24392./usr/share/man/man9/pci_get_powerstate.9 comp-sys-man .man 24398./usr/share/man/man9/pci_get_powerstate.9 comp-sys-man .man
24393./usr/share/man/man9/pci_intr.9 comp-sys-man .man 24399./usr/share/man/man9/pci_intr.9 comp-sys-man .man
 24400./usr/share/man/man9/pci_intr_alloc.9 comp-sys-man .man
24394./usr/share/man/man9/pci_intr_disestablish.9 comp-sys-man .man 24401./usr/share/man/man9/pci_intr_disestablish.9 comp-sys-man .man
24395./usr/share/man/man9/pci_intr_distribute.9 comp-sys-man .man 24402./usr/share/man/man9/pci_intr_distribute.9 comp-sys-man .man
24396./usr/share/man/man9/pci_intr_establish.9 comp-sys-man .man 24403./usr/share/man/man9/pci_intr_establish.9 comp-sys-man .man
24397./usr/share/man/man9/pci_intr_evcnt.9 comp-sys-man .man 24404./usr/share/man/man9/pci_intr_evcnt.9 comp-sys-man .man
24398./usr/share/man/man9/pci_intr_map.9 comp-sys-man .man 24405./usr/share/man/man9/pci_intr_map.9 comp-sys-man .man
 24406./usr/share/man/man9/pci_intr_release.9 comp-sys-man .man
24399./usr/share/man/man9/pci_intr_string.9 comp-sys-man .man 24407./usr/share/man/man9/pci_intr_string.9 comp-sys-man .man
 24408./usr/share/man/man9/pci_intr_type.9 comp-sys-man .man
24400./usr/share/man/man9/pci_intx_alloc.9 comp-sys-man .man 24409./usr/share/man/man9/pci_intx_alloc.9 comp-sys-man .man
24401./usr/share/man/man9/pci_intx_release.9 comp-sys-man .man 24410./usr/share/man/man9/pci_intx_release.9 comp-sys-man .man
24402./usr/share/man/man9/pci_make_tag.9 comp-sys-man .man 24411./usr/share/man/man9/pci_make_tag.9 comp-sys-man .man
24403./usr/share/man/man9/pci_mapreg_info.9 comp-sys-man .man 24412./usr/share/man/man9/pci_mapreg_info.9 comp-sys-man .man
24404./usr/share/man/man9/pci_mapreg_map.9 comp-sys-man .man 24413./usr/share/man/man9/pci_mapreg_map.9 comp-sys-man .man
24405./usr/share/man/man9/pci_mapreg_type.9 comp-sys-man .man 24414./usr/share/man/man9/pci_mapreg_type.9 comp-sys-man .man
24406./usr/share/man/man9/pci_msi.9 comp-sys-man .man 24415./usr/share/man/man9/pci_msi.9 comp-sys-man .man
24407./usr/share/man/man9/pci_msi_alloc.9 comp-sys-man .man 24416./usr/share/man/man9/pci_msi_alloc.9 comp-sys-man .man
24408./usr/share/man/man9/pci_msi_alloc_exact.9 comp-sys-man .man 24417./usr/share/man/man9/pci_msi_alloc_exact.9 comp-sys-man .man
24409./usr/share/man/man9/pci_msi_count.9 comp-sys-man .man 24418./usr/share/man/man9/pci_msi_count.9 comp-sys-man .man
24410./usr/share/man/man9/pci_msi_disestablish.9 comp-sys-man .man 24419./usr/share/man/man9/pci_msi_disestablish.9 comp-sys-man .man
24411./usr/share/man/man9/pci_msi_establish.9 comp-sys-man .man 24420./usr/share/man/man9/pci_msi_establish.9 comp-sys-man .man
24412./usr/share/man/man9/pci_msi_release.9 comp-sys-man .man 24421./usr/share/man/man9/pci_msi_release.9 comp-sys-man .man
cvs diff -r1.388 -r1.389 src/share/man/man9/Makefile (expand / switch to unified diff)

--- src/share/man/man9/Makefile 2015/07/12 08:11:27 1.388
+++ src/share/man/man9/Makefile 2015/07/21 03:12:50 1.389
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1# $NetBSD: Makefile,v 1.388 2015/07/12 08:11:27 hannken Exp $ 1# $NetBSD: Makefile,v 1.389 2015/07/21 03:12:50 knakahara Exp $
2 2
3# Makefile for section 9 (kernel function and variable) manual pages. 3# Makefile for section 9 (kernel function and variable) manual pages.
4 4
5MAN= accept_filter.9 accf_data.9 accf_http.9 \ 5MAN= accept_filter.9 accf_data.9 accf_http.9 \
6 altq.9 arp.9 audio.9 autoconf.9 \ 6 altq.9 arp.9 audio.9 autoconf.9 \
7 bcdtobin.9 bcmp.9 bcopy.9 bintime_add.9 bluetooth.9 boothowto.9 bpf.9 \ 7 bcdtobin.9 bcmp.9 bcopy.9 bintime_add.9 bluetooth.9 boothowto.9 bpf.9 \
8 buffercache.9 bufferio.9 bufq.9 bus_dma.9 bus_space.9 byteorder.9 \ 8 buffercache.9 bufferio.9 bufq.9 bus_dma.9 bus_space.9 byteorder.9 \
9 bzero.9 \ 9 bzero.9 \
10 callback.9 callout.9 cardbus.9 clock.9 cnmagic.9 condvar.9 config.9 \ 10 callback.9 callout.9 cardbus.9 clock.9 cnmagic.9 condvar.9 config.9 \
11 cons.9 copy.9 coredump_write.9 \ 11 cons.9 copy.9 coredump_write.9 \
12 cpu_configure.9 cpu_coredump.9 cpu_dumpconf.9 \ 12 cpu_configure.9 cpu_coredump.9 cpu_dumpconf.9 \
13 cpu_lwp_fork.9 \ 13 cpu_lwp_fork.9 \
14 cpu_idle.9 cpu_initclocks.9 cpu_need_resched.9 \ 14 cpu_idle.9 cpu_initclocks.9 cpu_need_resched.9 \
@@ -568,26 +568,29 @@ MLINKS+=pci.9 pci_conf_read.9 \ @@ -568,26 +568,29 @@ MLINKS+=pci.9 pci_conf_read.9 \
568 pci.9 pci_intr_disestablish.9 \ 568 pci.9 pci_intr_disestablish.9 \
569 pci.9 pci_get_powerstate.9 \ 569 pci.9 pci_get_powerstate.9 \
570 pci.9 pci_set_powerstate.9 \ 570 pci.9 pci_set_powerstate.9 \
571 pci.9 pci_vpd_read.9 \ 571 pci.9 pci_vpd_read.9 \
572 pci.9 pci_vpd_write.9 \ 572 pci.9 pci_vpd_write.9 \
573 pci.9 pci_make_tag.9 \ 573 pci.9 pci_make_tag.9 \
574 pci.9 pci_decompose_tag.9 \ 574 pci.9 pci_decompose_tag.9 \
575 pci.9 pci_findvendor.9 \ 575 pci.9 pci_findvendor.9 \
576 pci.9 pci_devinfo.9 \ 576 pci.9 pci_devinfo.9 \
577 pci.9 PCI_VENDOR.9 \ 577 pci.9 PCI_VENDOR.9 \
578 pci.9 PCI_PRODUCT.9 \ 578 pci.9 PCI_PRODUCT.9 \
579 pci.9 PCI_REVISION.9 579 pci.9 PCI_REVISION.9
580MLINKS+=pci_msi.9 pci_msix.9 \ 580MLINKS+=pci_msi.9 pci_msix.9 \
 581 pci_msi.9 pci_intr_alloc.9 \
 582 pci_msi.9 pci_intr_release.9 \
 583 pci_msi.9 pci_intr_type.9 \
581 pci_msi.9 pci_intx_alloc.9 \ 584 pci_msi.9 pci_intx_alloc.9 \
582 pci_msi.9 pci_intx_release.9 \ 585 pci_msi.9 pci_intx_release.9 \
583 pci_msi.9 pci_msi_count.9 \ 586 pci_msi.9 pci_msi_count.9 \
584 pci_msi.9 pci_msi_alloc.9 \ 587 pci_msi.9 pci_msi_alloc.9 \
585 pci_msi.9 pci_msi_alloc_exact.9 \ 588 pci_msi.9 pci_msi_alloc_exact.9 \
586 pci_msi.9 pci_msi_release.9 \ 589 pci_msi.9 pci_msi_release.9 \
587 pci_msi.9 pci_msi_establish.9 \ 590 pci_msi.9 pci_msi_establish.9 \
588 pci_msi.9 pci_msi_disestablish.9 \ 591 pci_msi.9 pci_msi_disestablish.9 \
589 pci_msi.9 pci_msix_count.9 \ 592 pci_msi.9 pci_msix_count.9 \
590 pci_msi.9 pci_msix_alloc.9 \ 593 pci_msi.9 pci_msix_alloc.9 \
591 pci_msi.9 pci_msix_alloc_exact.9 \ 594 pci_msi.9 pci_msix_alloc_exact.9 \
592 pci_msi.9 pci_msix_alloc_map.9 \ 595 pci_msi.9 pci_msix_alloc_map.9 \
593 pci_msi.9 pci_msix_release.9 \ 596 pci_msi.9 pci_msix_release.9 \
cvs diff -r1.3 -r1.4 src/share/man/man9/pci_msi.9 (expand / switch to unified diff)

--- src/share/man/man9/pci_msi.9 2015/05/15 08:39:14 1.3
+++ src/share/man/man9/pci_msi.9 2015/07/21 03:12:50 1.4
@@ -1,81 +1,89 @@ @@ -1,81 +1,89 @@
1.\" $NetBSD: pci_msi.9,v 1.3 2015/05/15 08:39:14 knakahara Exp $ 1.\" $NetBSD: pci_msi.9,v 1.4 2015/07/21 03:12:50 knakahara Exp $
2.\" 2.\"
3.\" Copyright (c) 2015 Internet Initiative Japan Inc. 3.\" Copyright (c) 2015 Internet Initiative Japan Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 15.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 18.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25.\" POSSIBILITY OF SUCH DAMAGE. 25.\" POSSIBILITY OF SUCH DAMAGE.
26.\" 26.\"
27.Dd May 11, 2015 27.Dd Jul 15, 2015
28.Dt PCI_MSI 9 28.Dt PCI_MSI 9
29.Os 29.Os
30.Sh NAME 30.Sh NAME
31.Nm pci_msi , 31.Nm pci_msi ,
32.Nm pci_msix , 32.Nm pci_msix ,
33.Nm pci_msi_count , 33.Nm pci_msi_count ,
34.Nm pci_msi_alloc , 34.Nm pci_msi_alloc ,
35.Nm pci_msi_alloc_exact , 35.Nm pci_msi_alloc_exact ,
36.Nm pci_msix_count , 36.Nm pci_msix_count ,
37.Nm pci_msix_alloc , 37.Nm pci_msix_alloc ,
38.Nm pci_msix_alloc_exact , 38.Nm pci_msix_alloc_exact ,
39.Nm pci_msix_alloc_map , 39.Nm pci_msix_alloc_map ,
40.Nm pci_intx_alloc , 40.Nm pci_intx_alloc ,
41.Nm pci_intr_release 41.Nm pci_intr_alloc ,
 42.Nm pci_intr_release,
 43.Nm pci_intr_type
42.Nd PCI MSI{,-X} manipulation functions 44.Nd PCI MSI{,-X} manipulation functions
43.Sh SYNOPSIS 45.Sh SYNOPSIS
44.Ft int 46.Ft int
45.Fn pci_msi_count "struct pci_attach_args *pa" 47.Fn pci_msi_count "struct pci_attach_args *pa"
46.Ft int 48.Ft int
47.Fn pci_msi_alloc "struct pci_attach_args *pa" \ 49.Fn pci_msi_alloc "struct pci_attach_args *pa" \
48"pci_intr_handle_t **ihps" "int *count" 50"pci_intr_handle_t **ihps" "int *count"
49.Ft int 51.Ft int
50.Fn pci_msi_alloc_exect "struct pci_attach_args *pa" \ 52.Fn pci_msi_alloc_exect "struct pci_attach_args *pa" \
51"pci_intr_handle_t **ihps" "int count" 53"pci_intr_handle_t **ihps" "int count"
52.Ft int 54.Ft int
53.Fn pci_msix_count "struct pci_attach_args *pa" 55.Fn pci_msix_count "struct pci_attach_args *pa"
54.Ft int 56.Ft int
55.Fn pci_msix_alloc "struct pci_attach_args *pa" \ 57.Fn pci_msix_alloc "struct pci_attach_args *pa" \
56"pci_intr_handle_t **ihps" "int *count" 58"pci_intr_handle_t **ihps" "int *count"
57.Ft int 59.Ft int
58.Fn pci_msix_alloc_exect "struct pci_attach_args *pa" \ 60.Fn pci_msix_alloc_exect "struct pci_attach_args *pa" \
59"pci_intr_handle_t **ihps" "int count" 61"pci_intr_handle_t **ihps" "int count"
60.Ft int 62.Ft int
61.Fn pci_msix_alloc_map "struct pci_attach_args *pa" \ 63.Fn pci_msix_alloc_map "struct pci_attach_args *pa" \
62"pci_intr_handle_t **ihps" "u_int *table_indexes" "int count" 64"pci_intr_handle_t **ihps" "u_int *table_indexes" "int count"
63.Ft int 65.Ft int
64.Fn pci_intx_alloc "struct pci_attach_args *pa" \ 66.Fn pci_intx_alloc "struct pci_attach_args *pa" \
65"pci_intr_handle_t **ihp" 67"pci_intr_handle_t **ihp"
 68.Ft int
 69.Fn pci_intr_alloc "struct pci_attach_args *pa" \
 70"pci_intr_handle_t **ihp" "int *counts" \
 71"pci_intr_type_t max_type"
66.Ft void 72.Ft void
67.Fn pci_intr_release "pci_chipset_tag_t pc" \ 73.Fn pci_intr_release "pci_chipset_tag_t pc" \
68"pci_intr_handle_t *pih" "int count" 74"pci_intr_handle_t *pih" "int count"
 75.Ft pci_intr_type_t
 76.Fn pci_intr_type "pci_intr_handle_t ih"
69.Sh DESCRIPTION 77.Sh DESCRIPTION
70The 78The
71.Nm 79.Nm
72functions exist to allow device drivers to use MSI/MSI-X. 80functions exist to allow device drivers to use MSI/MSI-X.
73When the system uses MSI/MSI-X, it must define the 81When the system uses MSI/MSI-X, it must define the
74.Dv __HAVE_PCI_MSI_MSIX 82.Dv __HAVE_PCI_MSI_MSIX
75build option. 83build option.
76.Pp 84.Pp
77Each driver has an 85Each driver has an
78.Fn attach 86.Fn attach
79function which has a bus-specific 87function which has a bus-specific
80.Ft attach_args 88.Ft attach_args
81structure. 89structure.
@@ -175,15 +183,121 @@ If the driver wants to fall back to INTx @@ -175,15 +183,121 @@ If the driver wants to fall back to INTx
175and 183and
176.Fn pci_intr_release 184.Fn pci_intr_release
177instead of 185instead of
178.Fn pci_intr_map 186.Fn pci_intr_map
179to resolve contradiction of the interrupt handler ownership. 187to resolve contradiction of the interrupt handler ownership.
180I.e., 188I.e.,
181.Fn pci_intr_map 189.Fn pci_intr_map
182does not have the ownership (the function just calculates value), 190does not have the ownership (the function just calculates value),
183in contrast, 191in contrast,
184.Fn pci_msi_alloc 192.Fn pci_msi_alloc
185and 193and
186.Fn pci_msix_alloc 194.Fn pci_msix_alloc
187have (the functions allocate memory for interrupt handlers). 195have (the functions allocate memory for interrupt handlers).
 196.Pp
 197.Fn pci_intr_alloc
 198is wrapper function which select and automatically fallback
 199allocation functions according to the argument
 200.Fa counts .
 201The elements of
 202.Fa counts
 203array means each required interrupt count for INTx, MSI, and MSI-X.
 204The index count of
 205.Fa counts
 206must be
 207.Dv PCI_INTR_TYPE_SIZE .
 208.Fa max_type
 209must be PCI_INTR_TYPE_MSIX, PCI_INTR_TYPE_MSI, or PCI_INTR_TYPE_INTX.
 210The parameter does not mean array index counts of
 211.Fa counts .
 212The parameter means the interrupt type which
 213.Fn pci_intr_alloc
 214tries to allocate first.
 215I.e., if the driver wants to allocate interrupt the following way:
 216.Bd -literal
 217 5 MSI-X
 218 1 MSI (if MSI-X allocation failed)
 219 INTx (if MSI allocation failed either)
 220.Ed
 221the driver should call
 222.Fn pci_intr_alloc
 223in the following way:
 224.Bd -literal
 225 int counts[PCI_INTR_TYPE_SIZE];
 226 counts[PCI_INTR_TYPE_MSIX] = 5;
 227 counts[PCI_INTR_TYPE_MSI] = 1;
 228 counts[PCI_INTR_TYPE_INTX] = 1;
 229 error = pci_intr_alloc(pa, ihps, counts,
 230 PCI_INTR_TYPE_MSIX);
 231.Ed
 232If the driver wants to allocate int the following way:
 233.Bd -literal
 234 hardware max number MSI-X
 235 1 MSI (if MSI-X allocation failed)
 236.Ed
 237that is, the driver does not use INTx, the driver should call
 238.Fn pci_intr_alloc
 239in the following way:
 240.Bd -literal
 241 int counts[PCI_INTR_TYPE_SIZE];
 242 counts[PCI_INTR_TYPE_MSIX] = -1; /* -1 means max */
 243 counts[PCI_INTR_TYPE_MSI] = 1;
 244 counts[PCI_INTR_TYPE_INTX] = 0; /* 0 means not use */
 245 error = pci_intr_alloc(pa, ihps, counts,
 246 PCI_INTR_TYPE_MSIX);
 247.Ed
 248If the driver wants to allocate int the following way:
 249.Bd -literal
 250 3 MSI
 251 INTx (if MSI allocation failed)
 252.Ed
 253that is, the driver does not use MSI-X, the driver should call
 254.Fn pci_intr_alloc
 255in the following way:
 256.Bd -literal
 257 int counts[PCI_INTR_TYPE_SIZE];
 258 counts[PCI_INTR_TYPE_MSIX] = 0; /* 0 means not use */
 259 counts[PCI_INTR_TYPE_MSI] = 3;
 260 counts[PCI_INTR_TYPE_INTX] = 1;
 261 error = pci_intr_alloc(pa, ihps, counts,
 262 PCI_INTR_TYPE_MSI);
 263.Ed
 264If the driver wants to allocate int the following way:
 265.Bd -literal
 266 1 MSI
 267 INTx (if MSI allocation failed)
 268.Ed
 269that is, general usage, the driver should call simply
 270.Fn pci_intr_alloc
 271in the following way:
 272.Bd -literal
 273 error = pci_intr_alloc(pa, ihps, NULL, 0);
 274.Ed
 275.Fa max_type
 276is ignored in this case.
 277.Fn pci_intr_alloc
 278return zero on any allocation function success, and nonzero on
 279all allocation functions failure. On success,
 280.Fa counts
 281is overwritten by a really allocated count.
 282I.e, if 5 MSI-X is allocated,
 283.Fa counts
 284is
 285.Bd -literal
 286 counts[PCI_INTR_TYPE_MSIX] == 5
 287 counts[PCI_INTR_TYPE_MSI] == 0
 288 counts[PCI_INTR_TYPE_INTX] == 0
 289.Ed
 290on return.
 291.Pp
 292.Ft pci_intr_type_t
 293return the interrupt type of
 294.Fa ih .
 295The return value is
 296.Dv PCI_INTR_TYPE_MSIX
 297for MSI-X,
 298.Dv PCI_INTR_TYPE_MSI
 299for MSI
 300.Dv PCI_INTR_TYPE_INTX
 301for others.
188.Sh SEE ALSO 302.Sh SEE ALSO
189.Xr pci_intr 9 303.Xr pci_intr 9