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
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
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
.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
.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.
.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