]> git.ipfire.org Git - thirdparty/pciutils.git/blob - lspci.8
- Added a man page and updated README
[thirdparty/pciutils.git] / lspci.8
1 .TH lspci 8 "7 February 98" "pciutils-0.92" "Linux PCI Utilities"
2 .IX lspci
3 .SH NAME
4 lspci \- list all PCI devices
5 .SH SYNOPSIS
6 .B lspci
7 .RB [ options ]
8 .SH DESCRIPTION
9 .B lspci
10 is a utility for displaying information about all PCI busses in the system and
11 all devices connected to them. It requires Linux kernel 2.1.82 or newer and
12 supersedes the original /proc/pci interface found in earlier kernels.
13
14 If you are going to report bugs in PCI device drivers or in
15 .I lspci
16 itself, please include output of "lspci -vvx".
17
18 .SH OPTIONS
19 .TP
20 .B -v
21 Tells
22 .I lspci
23 to be verbose and display detailed information about all devices.
24 .TP
25 .B -vv
26 Tells
27 .I lspci
28 to be very verbose and display even more information (actually everything the
29 PCI device is able to tell). The exact meaning of these data is not explained
30 in this manual page, if you want to know more, consult
31 .B /usr/include/linux/pci.h
32 or the PCI specs.
33 .TP
34 .B -n
35 Show PCI vendor and device codes as numbers instead of looking them up in the
36 PCI ID database.
37 .TP
38 .B -x
39 Show hexadecimal dump of first 64 bytes of the PCI configuration space (the standard
40 header). Useful for debugging of drivers and
41 .I lspci
42 itself.
43 .TP
44 .B -xx
45 Show hexadecimal dump of whole PCI configuration space. Available only for root
46 as several PCI devices crash when you try to read undefined portions of the config
47 space (although this directly violates the PCI standard).
48 .TP
49 .B -b
50 Bus-centric view. Show all IRQ numbers and addresses as seen by the cards on the
51 PCI bus instead of as seen by the kernel.
52 .TP
53 .B -t
54 Show a tree-like diagram containing all busses, bridges, devices and connections
55 between them.
56 .TP
57 .B -B <bus>
58 Show only devices on specified bus.
59 .TP
60 .B -S <slot>
61 Show only devices in specified slot number.
62 .TP
63 .B -F <func>
64 Show only specified function number of all devices (you can mix it with
65 .B -B
66 and
67 .B -S
68 to select single device).
69 .TP
70 .B -V <vendor>
71 Show only devices having specified vendor ID.
72 .TP
73 .B -D <devid>
74 Show only devices having specified device ID.
75 .TP
76 .B -i <file>
77 Use
78 .B
79 <file>
80 as PCI ID database instead of /etc/pci.ids.
81 .TP
82 .B -p <dir>
83 Use
84 .B <dir>
85 as directory containing PCI bus information instead of /proc/bus/pci.
86
87 .SH FILES
88 .TP
89 .B /etc/pci.ids
90 A list of all known PCI ID's (vendors, devices, classes and subclasses).
91 .TP
92 .B /proc/bus/pci
93 An interface to PCI bus configuration space provided by the kernel. Contains
94 per-bus subdirectories with per-card config space files and a
95 .I
96 devices
97 file containing a list of all PCI devices.
98
99 .SH AUTHOR
100 The Linux PCI Utilities are maintained by Martin Mares <mj@atrey.karlin.mff.cuni.cz>.