]> git.ipfire.org Git - thirdparty/pciutils.git/blobdiff - lspci.man
ls-ecaps: extend decode support for more fields for AER CE and UE status
[thirdparty/pciutils.git] / lspci.man
index 5b3acbea51696cce06a0cb1eb34e7a97b2f55448..7907aeb8a5dcaa9dd6dd9cb8a51f0f806ed930fb 100644 (file)
--- a/lspci.man
+++ b/lspci.man
@@ -95,6 +95,13 @@ PCI bus instead of as seen by the kernel.
 .B -D
 Always show PCI domain numbers. By default, lspci suppresses them on machines which
 have only domain 0.
+.TP
+.B -P
+Identify PCI devices by path through each bridge, instead of by bus number.
+.TP
+.B -PP
+Identify PCI devices by path through each bridge, showing the bus number as
+well as the device number.
 
 .SS Options to control resolving ID's to names
 .TP
@@ -109,7 +116,7 @@ Show PCI vendor and device codes as both numbers and names.
 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
+.B $XDG_CACHE_HOME/pci-ids
 and it is recognized in subsequent runs even if
 .B -q
 is not given any more. Please use this switch inside automated scripts only
@@ -135,10 +142,10 @@ hexadecimal.  E.g., "0:" means all devices on bus 0, "0" means all functions of
 on any bus, "0.3" selects third function of device 0 on all buses and ".4" shows only
 the fourth function of each device.
 .TP
-.B -d [<vendor>]:[<device>][:<class>]
-Show only devices with specified vendor, device and class ID. The ID's are
-given in hexadecimal and may be omitted or given as "*", both meaning
-"any value".
+.B -d [<vendor>]:[<device>][:<class>[:<prog-if>]]
+Show only devices with specified vendor, device, class ID, and programming interface.
+The ID's are given in hexadecimal and may be omitted or given as "*", both meaning
+"any value". The class ID can contain "x" characters which stand for "any digit".
 
 .SS Other options
 .TP
@@ -160,7 +167,9 @@ Applies only to Linux systems with recent enough module tools.
 Invoke bus mapping mode which performs a thorough scan of all PCI devices, including
 those behind misconfigured bridges, etc. This option gives meaningful results only
 with a direct hardware access mode, which usually requires root privileges.
-Please note that the bus mapper only scans PCI domain 0.
+By default, the bus mapper scans domain. You can use the
+.B -s
+option to select a different domain.
 .TP
 .B --version
 Shows
@@ -181,7 +190,7 @@ available methods and their descriptions.
 .TP
 .B -O <param>=<value>
 The behavior of the library is controlled by several named parameters.
-This option allows to set the value of any of the parameters. Use \fB-O help\fP
+This option allows one to set the value of any of the parameters. Use \fB-O help\fP
 for a list of known parameters and their default values.
 .TP
 .B -H1
@@ -303,7 +312,15 @@ 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).
+(optional, Linux only). Multiple lines with this tag can occur.
+
+.TP
+.B NUMANode
+NUMA node this device is connected to (optional, Linux only).
+
+.TP
+.B IOMMUGroup
+IOMMU group that this device is part of (optional, Linux only).
 
 .P
 New tags can be added in future versions, so you should silently ignore any tags you don't recognize.
@@ -321,14 +338,14 @@ in a single record. Please avoid using this format in any new code.
 .TP
 .B @IDSDIR@/pci.ids
 A list of all known PCI ID's (vendors, devices, classes and subclasses). Maintained
-at http://pciids.sourceforge.net/, use the
+at https://pci-ids.ucw.cz/, use the
 .B update-pciids
 utility to download the most recent version.
 .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
+.B $XDG_CACHE_HOME/pci-ids
 All ID's found in the DNS query mode are cached in this file.
 
 .SH BUGS
@@ -346,6 +363,7 @@ back-end.
 
 .SH SEE ALSO
 .BR setpci (8),
+.BR pci.ids (5),
 .BR update-pciids (8),
 .BR pcilib (7)