The `-P' option has been removed.

[pciutils.git] / lspci.man

diff --git a/lspci.man b/lspci.man
index 1d5583bb31d7aa98023593fd0a4d0711cbeb157a..e3b1c05ff90c975cd1f0da00ef1eb26a8a5899c6 100644 (file)
--- a/lspci.man
+++ b/lspci.man
@@ -57,6 +57,25 @@ PCI ID list.
 .B -nn
 Show PCI vendor and device codes as both numbers and names.
 .TP
 .B -nn
 Show PCI vendor and device codes as both numbers and names.
 .TP

+.B -q
+Use DNS to query the central PCI ID database if a device is not found in the local
+.B pci.ids
+file. If the DNS query succeeds, the result is cached in
+.B ~/.pciids-cache
+and it is recognized in subsequent runs even if
+.B -q
+is not given any more. Please use this switch inside automated scripts only
+with caution to avoid overloading the database servers.
+.TP
+.B -qq
+Same as
+.BR -q ,
+but the local cache is reset.
+.TP
+.B -Q
+Query the central database even for entries which are recognized locally.
+Use this if you suspect that the displayed entry is wrong.
+.TP

 .B -x
 Show hexadecimal dump of the standard part of the configuration space (the first
 64 bytes or 128 bytes for CardBus bridges).
 .B -x
 Show hexadecimal dump of the standard part of the configuration space (the first
 64 bytes or 128 bytes for CardBus bridges).


@@ -73,6 +92,13 @@ devices are rare, so you needn't worry much.
 Show hexadecimal dump of the extended (4096-byte) PCI configuration space available
 on PCI-X 2.0 and PCI Express buses.
 .TP
 Show hexadecimal dump of the extended (4096-byte) PCI configuration space available
 on PCI-X 2.0 and PCI Express buses.
 .TP

+.B -k
+Show kernel drivers handling each device and also kernel modules capable of handling it.
+Turned on by default when
+.B -v
+is given in the normal mode of output.
+(Currently works only on Linux with kernel 2.6 or newer.)
+.TP

 .B -b
 Bus-centric view. Show all IRQ numbers and addresses as seen by the cards on the
 PCI bus instead of as seen by the kernel.
 .B -b
 Bus-centric view. Show all IRQ numbers and addresses as seen by the cards on the
 PCI bus instead of as seen by the kernel.


@@ -100,6 +126,14 @@ Use
 <file>
 as the PCI ID list instead of @IDSDIR@/pci.ids.
 .TP
 <file>
 as the PCI ID list instead of @IDSDIR@/pci.ids.
 .TP

+.B -p <file>
+Use
+.B
+<file>
+as the map of PCI ID's handled by kernel modules. By default, lspci uses
+.RI /lib/modules/ kernel_version /modules.pcimap.
+Applies only to Linux systems with recent enough module tools.
+.TP

 .B -m
 Dump PCI device data in a backward-compatible machine readable form.
 See below for details.
 .B -m
 Dump PCI device data in a backward-compatible machine readable form.
 See below for details.


@@ -134,7 +168,8 @@ the following access methods:
 The
 .B /sys
 filesystem on Linux 2.6 and newer. The standard header of the config space is available
 The
 .B /sys
 filesystem on Linux 2.6 and newer. The standard header of the config space is available

-to all users, the rest only to root. Supports extended configuration space and PCI domains.
+to all users, the rest only to root. Supports extended configuration space, PCI domains
+and information on attached kernel drivers.

 .TP
 .B linux_proc
 The
 .TP
 .B linux_proc
 The


@@ -285,6 +320,15 @@ Revision number (optional).
 .B ProgIf
 Programming interface (optional).
 
 .B ProgIf
 Programming interface (optional).
 

+.TP
+.B Driver
+Kernel driver currently handling the device (optional, Linux only).
+
+.TP
+.B Module
+Kernel module reporting that it is capable of handling the device
+(optional, Linux only).
+

 .P
 New tags can be added in future versions, so you should silently ignore any tags you don't recognize.
 
 .P
 New tags can be added in future versions, so you should silently ignore any tags you don't recognize.
 


@@ -308,6 +352,9 @@ utility to download the most recent version.
 .B @IDSDIR@/pci.ids.gz
 If lspci is compiled with support for compression, this file is tried before pci.ids.
 .TP
 .B @IDSDIR@/pci.ids.gz
 If lspci is compiled with support for compression, this file is tried before pci.ids.
 .TP

+.B ~/.pciids-cache
+All ID's found in the DNS query mode are cached in this file.
+.TP

 .B /proc/bus/pci
 An interface to PCI bus configuration space provided by the post-2.1.82 Linux
 kernels. Contains per-bus subdirectories with per-card config space files and a
 .B /proc/bus/pci
 An interface to PCI bus configuration space provided by the post-2.1.82 Linux
 kernels. Contains per-bus subdirectories with per-card config space files and a