Thu Feb 11 18:11:37 2010 UTC ()
Do not reference deprecated API shutdownhook_establish(9), but reference
pmf(9), instead.


(dyoung)
diff -r1.29 -r1.30 src/share/man/man9/pci.9
cvs diff -r1.29 -r1.30 src/share/man/man9/pci.9 (expand / switch to unified diff)

--- src/share/man/man9/pci.9 2009/04/17 19:02:03 1.29
+++ src/share/man/man9/pci.9 2010/02/11 18:11:37 1.30
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: pci.9,v 1.29 2009/04/17 19:02:03 cegger Exp $ 1.\" $NetBSD: pci.9,v 1.30 2010/02/11 18:11:37 dyoung Exp $
2.\" 2.\"
3.\" Copyright (c) 2001, 2003 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2001, 2003 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Gregory McGarry. 7.\" by Gregory McGarry.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -17,27 +17,27 @@ @@ -17,27 +17,27 @@
17.\" 17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE. 28.\" POSSIBILITY OF SUCH DAMAGE.
29.\" 29.\"
30.Dd April 17, 2009 30.Dd February 11, 2010
31.Dt PCI 9 31.Dt PCI 9
32.Os 32.Os
33.Sh NAME 33.Sh NAME
34.Nm PCI , 34.Nm PCI ,
35.Nm pci_activate , 35.Nm pci_activate ,
36.Nm pci_conf_read , 36.Nm pci_conf_read ,
37.Nm pci_conf_write , 37.Nm pci_conf_write ,
38.Nm pci_conf_print , 38.Nm pci_conf_print ,
39.Nm pci_conf_capture , 39.Nm pci_conf_capture ,
40.Nm pci_conf_restore , 40.Nm pci_conf_restore ,
41.Nm pci_find_device , 41.Nm pci_find_device ,
42.Nm pci_get_capability , 42.Nm pci_get_capability ,
43.Nm pci_mapreg_type , 43.Nm pci_mapreg_type ,
@@ -570,27 +570,27 @@ Device registers can now be accessed usi @@ -570,27 +570,27 @@ Device registers can now be accessed usi
570.Pp 570.Pp
571Details of using PCI interrupts is described in 571Details of using PCI interrupts is described in
572.Xr pci_intr 9 . 572.Xr pci_intr 9 .
573.Sh DMA SUPPORT 573.Sh DMA SUPPORT
574The PCI bus supports bus-mastering operations from any device on the bus. 574The PCI bus supports bus-mastering operations from any device on the bus.
575The DMA facilities are accessed through the standard 575The DMA facilities are accessed through the standard
576.Xr bus_dma 9 576.Xr bus_dma 9
577interface. 577interface.
578To support DMA transfers from the device to the host, it is necessary 578To support DMA transfers from the device to the host, it is necessary
579to enable bus-mastering in the PCI configuration space for the device. 579to enable bus-mastering in the PCI configuration space for the device.
580.Pp 580.Pp
581During system shutdown, it is necessary to abort any DMA transfers in 581During system shutdown, it is necessary to abort any DMA transfers in
582progress by registering a shutdown hook (see 582progress by registering a shutdown hook (see
583.Xr shutdownhook_establish 9 ) . 583.Xr pmf 9 ) .
584.Sh CODE REFERENCES 584.Sh CODE REFERENCES
585This section describes places within the 585This section describes places within the
586.Nx 586.Nx
587source tree where actual code implementing or using the 587source tree where actual code implementing or using the
588machine-independent PCI subsystem can be found. 588machine-independent PCI subsystem can be found.
589All pathnames are relative to 589All pathnames are relative to
590.Pa /usr/src . 590.Pa /usr/src .
591.Pp 591.Pp
592The PCI subsystem itself is implemented within the files 592The PCI subsystem itself is implemented within the files
593.Pa sys/dev/pci/pci.c , 593.Pa sys/dev/pci/pci.c ,
594.Pa sys/dev/pci/pci_subr.c , 594.Pa sys/dev/pci/pci_subr.c ,
595.Pa sys/dev/pci/pci_map.c , 595.Pa sys/dev/pci/pci_map.c ,
596.Pa sys/dev/pci/pci_quirks.c , 596.Pa sys/dev/pci/pci_quirks.c ,
@@ -604,17 +604,17 @@ The database of known devices exists wit @@ -604,17 +604,17 @@ The database of known devices exists wit
604and is generated automatically from the file 604and is generated automatically from the file
605.Pa sys/dev/pci/pcidevs . 605.Pa sys/dev/pci/pcidevs .
606New vendor and product identifiers should be added to this file. 606New vendor and product identifiers should be added to this file.
607The database can be regenerated using the Makefile 607The database can be regenerated using the Makefile
608.Pa sys/dev/pci/Makefile.pcidevs . 608.Pa sys/dev/pci/Makefile.pcidevs .
609.Sh SEE ALSO 609.Sh SEE ALSO
610.Xr pci 4 , 610.Xr pci 4 ,
611.Xr autoconf 9 , 611.Xr autoconf 9 ,
612.Xr bus_dma 9 , 612.Xr bus_dma 9 ,
613.Xr bus_space 9 , 613.Xr bus_space 9 ,
614.Xr driver 9 , 614.Xr driver 9 ,
615.Xr pci_configure_bus 9 , 615.Xr pci_configure_bus 9 ,
616.Xr pci_intr 9 , 616.Xr pci_intr 9 ,
617.Xr shutdownhook_establish 9 617.Xr pmf 9
618.Sh HISTORY 618.Sh HISTORY
619The machine-independent PCI subsystem appeared in 619The machine-independent PCI subsystem appeared in
620.Nx 1.2 . 620.Nx 1.2 .