[src/trunk]: src/share/man/man9 document pci_aprint_devinfo(9) (not the _fanc...

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

details:   https://anonhg.NetBSD.org/src/rev/e4532f53d400
branches:  trunk
changeset: 773306:e4532f53d400
user:      drochner <drochner%NetBSD.org@localhost>
date:      Mon Jan 30 19:20:13 2012 +0000

description:
document pci_aprint_devinfo(9) (not the _fancy variant yet because
it is still experimental)

diffstat:

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

diffs (48 lines):

diff -r 0671664deb39 -r e4532f53d400 share/man/man9/pci.9
--- a/share/man/man9/pci.9      Mon Jan 30 19:19:55 2012 +0000
+++ b/share/man/man9/pci.9      Mon Jan 30 19:20:13 2012 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: pci.9,v 1.35 2011/08/25 02:01:32 dyoung Exp $
+.\"     $NetBSD: pci.9,v 1.36 2012/01/30 19:20:13 drochner Exp $
 .\"
 .\" Copyright (c) 2001, 2003 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 24, 2011
+.Dd January 30, 2012
 .Dt PCI 9
 .Os
 .Sh NAME
@@ -145,6 +145,8 @@
 .Fn pci_findvendor "pcireg_t id"
 .Ft void
 .Fn pci_devinfo "pcireg_t id" "pcireg_t class" "int show" "char *cp" "size_t len"
+.Ft void
+.Fn pci_aprint_devinfo "struct pci_attach_args *pa" "const char *naive"
 .Ft int
 .Fn PCI_VENDOR "pcireg_t id"
 .Ft int
@@ -673,6 +675,20 @@
 .Fa show
 specifies whether the PCI subsystem should report the string to the
 console.
+.It Fn pci_aprint_devinfo "pa" "naive"
+Print device information to the console and system log, using the
+.Xr aprint_normal 9
+and
+.Xr aprint_naive 9
+functions.
+For the device information, the
+.Dq pci_devinfo
+function above is used, or the
+.Ar naive
+argument in the
+.Dq AB_QUIET
+case.
+This function is intended to be used early in device attach.
 .It Fn PCI_VENDOR "id"
 Return the PCI vendor id for device
 .Fa id .