Penguin
Recent Changes
Annotated edit history of lspci(8) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 lspci
2 !!!lspci
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 PCILIB OPTIONS
8 FILES
9 SEE ALSO
10 AUTHOR
11 ----
12 !!NAME
13
14
15 lspci - list all PCI devices
16 !!SYNOPSIS
17
18
19 __lspci__ [[__options__]
20 !!DESCRIPTION
21
22
23 __lspci__ is a utility for displaying information about
24 all PCI buses in the system and all devices connected to
25 them.
26
27
28 To make use of all the features of this program, you need to
29 have Linux kernel 2.1.82 or newer which supports the
30 /proc/bus/pci interface. With older kernels, the PCI
31 utilities have to use direct hardware access which is
32 available only to root and it suffers from numerous race
33 conditions and other problems.
34
35
36 If you are going to report bugs in PCI device drivers or in
37 ''lspci'' itself, please include output of
38 ''
39 !!OPTIONS
40
41
42 __-v__
43
44
45 Tells ''lspci'' to be verbose and display detailed
46 information about all devices.
47
48
49 __-vv__
50
51
52 Tells ''lspci'' to be very verbose and display even more
53 information (actually everything the PCI device is able to
54 tell). The exact meaning of these data is not explained in
55 this manual page, if you want to know more, consult
56 __/usr/include/linux/pci.h__ or the PCI
57 specs.
58
59
60 __-n__
61
62
63 Show PCI vendor and device codes as numbers instead of
64 looking them up in the PCI ID database.
65
66
67 __-x__
68
69
70 Show hexadecimal dump of first 64 bytes of the PCI
71 configuration space (the standard header). Useful for
72 debugging of drivers and ''lspci'' itself.
73
74
75 __-xxx__
76
77
78 Show hexadecimal dump of whole PCI configuration space.
79 Available only for root as several PCI devices __crash__
80 when you try to read undefined portions of the config space
81 (this behaviour probably doesn't violate the PCI standard,
82 but it's at least very stupid).
83
84
85 __-b__
86
87
88 Bus-centric view. Show all IRQ numbers and addresses as seen
89 by the cards on the PCI bus instead of as seen by the
90 kernel.
91
92
93 __-t__
94
95
96 Show a tree-like diagram containing all buses, bridges,
97 devices and connections between them.
98
99
100 __-s
101 [[[[__
102
103
104 Show only devices in specified bus, slot and function. Each
105 component of the device address can be omitted or set as
106
107
108 __-d [[__
109
110
111 Show only devices with specified vendor and device ID. Both
112 ID's are given in hexadecimal and may be omitted or given as
113
114
115 __-i __
116
117
118 Use ____ as PCI ID database instead of
119 /usr/share/misc/pci.ids.
120
121
122 __-p __
123
124
125 Use ____ as directory containing PCI bus
126 information instead of /proc/bus/pci.
127
128
129 __-m__
130
131
132 Dump PCI device data in machine readable form (both normal
133 and verbose format supported) for easy parsing by
134 scripts.
135
136
137 __-M__
138
139
140 Invoke bus mapping mode which scans the bus extensively to
141 find all devices including those behind misconfigured
142 bridges etc. Please note that this is intended only for
143 debugging and as it can crash the machine (only in case of
144 buggy devices, but unfortunately these happen to exist),
145 it's available only to root. Also using -M on PCI access
146 methods which don't directly touch the hardware has no sense
147 since the results are (modulo bugs in lspci) identical to
148 normal listing modes.
149
150
151 __--version__
152
153
154 Shows ''lspci'' version. This option should be used
155 standalone.
156 !!PCILIB OPTIONS
157
158
159 The PCI utilities use PCILIB (a portable library providing
160 platform-independent functions for PCI configuration space
161 access) to talk to the PCI cards. The following options
162 control parameters of the library, especially what access
163 method it uses. By default, PCILIB uses the first available
164 access method and displays no debugging messages. Each
165 switch is accompanied by a list of hardware/software
166 configurations it's supported in.
167
168
169 __-P __
170
171
172 Use Linux 2.1 style configuration access to directory
173 ____ instead of /proc/bus/pci. (Linux 2.1 or
174 newer only)
175
176
177 __-H1__
178
179
180 Use direct hardware access via Intel configuration mechanism
181 1. (i386 and compatible only)
182
183
184 __-H2__
185
186
187 Use direct hardware access via Intel configuration mechanism
188 2. Warning: This method is able to address only first 16
189 devices on any bus and it seems to be very unrealiable in
190 many cases. (i386 and compatible only)
191
192
193 __-S__
194
195
2 perry 196 Use PCI access syscalls. (Linux on Alpha and !UltraSparc
1 perry 197 only)
198
199
200 __-F __
201
202
203 Extract all information from given file containing output of
204 lspci -x. This is very useful for analysis of user-supplied
205 bug reports, because you can display the hardware
206 configuration in any way you want without disturbing the
207 user with requests for more dumps. (All
208 systems)
209
210
211 __-G__
212
213
214 Increase debug level of the library. (All
215 systems)
216 !!FILES
217
218
219 __/usr/share/misc/pci.ids__
220
221
222 A list of all known PCI ID's (vendors, devices, classes and
223 subclasses).
224
225
226 __/proc/bus/pci__
227
228
229 An interface to PCI bus configuration space provided by the
230 post-2.1.82 Linux kernels. Contains per-bus subdirectories
231 with per-card config space files and a ''devices'' file
232 containing a list of all PCI devices.
233 !!SEE ALSO
234
235
236 setpci(8)
237 !!AUTHOR
238
239
240 The Linux PCI Utilities are maintained by Martin Mares
241 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.