X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;ds=sidebyside;f=lspci.man;h=624404e8671237dfd75fb1b94bd3a5858a55b67a;hb=9d9aa7055bea757fbe88b8667b07ea2102849e82;hp=441bc2bc791b2a2aed0abaf9e870b084fd396c81;hpb=2849a16541917b641d861bac8dfadd1056231c12;p=pciutils.git diff --git a/lspci.man b/lspci.man index 441bc2b..624404e 100644 --- a/lspci.man +++ b/lspci.man @@ -1,5 +1,4 @@ .TH lspci 8 "@TODAY@" "@VERSION@" "The PCI Utilities" -.IX lspci .SH NAME lspci \- list all PCI devices .SH SYNOPSIS @@ -96,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 @@ -127,18 +133,19 @@ Use this if you suspect that the displayed entry is wrong. .SS Options for selection of devices .TP -.B -s [[[[]:]]:][][.[]] +.B -s [[[[]:]]:][][.[]] Show only devices in the specified domain (in case your machine has several host bridges, they can either share a common bus number space or each of them can address a PCI domain -of its own; domains are numbered from 0 to ffff), bus (0 to ff), slot (0 to 1f) and function (0 to 7). +of its own; domains are numbered from 0 to ffff), bus (0 to ff), device (0 to 1f) and function (0 to 7). Each component of the device address can be omitted or set to "*", both meaning "any value". All numbers are hexadecimal. E.g., "0:" means all devices on bus 0, "0" means all functions of device 0 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 []:[] -Show only devices with specified vendor and device ID. Both ID's are given in -hexadecimal and may be omitted or given as "*", both meaning "any value". +.B -d []:[][:[:]] +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 @@ -158,10 +165,11 @@ Applies only to Linux systems with recent enough module tools. .TP .B -M Invoke bus mapping mode which performs a thorough scan of all PCI devices, including -those behind misconfigured bridges etc. This option is available only to root and it -gives meaningful results only if combined with direct hardware access mode (otherwise -the results are identical to normal listing modes, modulo bugs in lspci). Please note -that the bus mapper doesn't support PCI domains and scans only domain 0. +those behind misconfigured bridges, etc. This option gives meaningful results only +with a direct hardware access mode, which usually requires root privileges. +By default, the bus mapper scans domain. You can use the +.B -s +option to select a different domain. .TP .B --version Shows @@ -182,7 +190,7 @@ available methods and their descriptions. .TP .B -O = 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 @@ -304,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. @@ -322,7 +338,7 @@ 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 @@ -347,6 +363,7 @@ back-end. .SH SEE ALSO .BR setpci (8), +.BR pci.ids (5), .BR update-pciids (8), .BR pcilib (7)