]>
Commit | Line | Data |
---|---|---|
f2bf13dc | 1 | .TH pcilib 7 "@TODAY@" "@VERSION@" "The PCI Utilities" |
f2bf13dc MM |
2 | .SH NAME |
3 | pcilib \- a library for accessing PCI devices | |
4 | ||
5 | .SH DESCRIPTION | |
6 | ||
7 | The PCI library (also known as \fIpcilib\fP and \fIlibpci\fP) is a portable library | |
8 | for accessing PCI devices and their configuration space. | |
9 | ||
10 | .SH ACCESS METHODS | |
11 | ||
12 | .PP | |
13 | The library supports a variety of methods to access the configuration space | |
14 | on different operating systems. By default, the first matching method in this | |
15 | list is used, but you can specify override the decision (see the \fB-A\fP switch | |
16 | of \fIlspci\fP). | |
17 | ||
18 | .TP | |
19 | .B linux-sysfs | |
20 | The | |
21 | .B /sys | |
22 | filesystem on Linux 2.6 and newer. The standard header of the config space is available | |
9bd5b1cf | 23 | to all users, the rest only to root. Supports extended configuration space, PCI domains, |
e16e04e8 MM |
24 | VPD (from Linux 2.6.26), physical slots (also since Linux 2.6.26) and information on attached |
25 | kernel drivers. | |
f2bf13dc MM |
26 | .TP |
27 | .B linux-proc | |
28 | The | |
29 | .B /proc/bus/pci | |
30 | interface supported by Linux 2.1 and newer. The standard header of the config space is available | |
31 | to all users, the rest only to root. | |
32 | .TP | |
33 | .B intel-conf1 | |
34 | Direct hardware access via Intel configuration mechanism 1. Available on i386 and compatibles | |
40e253d7 | 35 | on Linux, Solaris/x86, GNU Hurd, Windows, BeOS and Haiku. Requires root privileges. |
f2bf13dc MM |
36 | .TP |
37 | .B intel-conf2 | |
38 | Direct hardware access via Intel configuration mechanism 2. Available on i386 and compatibles | |
40e253d7 | 39 | on Linux, Solaris/x86, GNU Hurd, Windows, BeOS and Haiku. Requires root privileges. Warning: This method |
f2bf13dc MM |
40 | is able to address only the first 16 devices on any bus and it seems to be very |
41 | unreliable in many cases. | |
42 | .TP | |
43 | .B fbsd-device | |
44 | The | |
45 | .B /dev/pci | |
46 | device on FreeBSD. Requires root privileges. | |
47 | .TP | |
48 | .B aix-device | |
49 | Access method used on AIX. Requires root privileges. | |
50 | .TP | |
51 | .B nbsd-libpci | |
52 | The | |
53 | .B /dev/pci0 | |
54 | device on NetBSD accessed using the local libpci library. | |
55 | .TP | |
56 | .B obsd-device | |
57 | The | |
58 | .B /dev/pci | |
59 | device on OpenBSD. Requires root privileges. | |
60 | .TP | |
61 | .B dump | |
62 | Read the contents of configuration registers from a file specified in the | |
63 | .B dump.name | |
64 | parameter. The format corresponds to the output of \fIlspci\fP \fB-x\fP. | |
d4c2ab05 MM |
65 | .TP |
66 | .B darwin | |
67 | Access method used on Mac OS X / Darwin. Must be run as root and the system | |
68 | must have been booted with debug=0x144. | |
f2bf13dc MM |
69 | |
70 | .SH PARAMETERS | |
71 | ||
72 | .PP | |
73 | The library is controlled by several parameters. They should have sensible default | |
74 | values, but in case you want to do something unusual (or even something weird), | |
75 | you can override them (see the \fB-O\fP switch of \fIlspci\fP). | |
76 | ||
77 | .SS Parameters of specific access methods | |
78 | ||
79 | .TP | |
80 | .B dump.name | |
81 | Name of the bus dump file to read from. | |
82 | .TP | |
83 | .B fbsd.path | |
84 | Path to the FreeBSD PCI device. | |
85 | .TP | |
86 | .B nbsd.path | |
87 | Path to the NetBSD PCI device. | |
88 | .TP | |
89 | .B obsd.path | |
90 | Path to the OpenBSD PCI device. | |
91 | .TP | |
92 | .B proc.path | |
93 | Path to the procfs bus tree. | |
94 | .TP | |
95 | .B sysfs.path | |
96 | Path to the sysfs device tree. | |
97 | ||
98 | .SS Parameters for resolving of ID's via DNS | |
99 | .TP | |
100 | .B net.domain | |
101 | DNS domain containing the ID database. | |
102 | .TP | |
103 | .B net.cache_name | |
104 | Name of the file used for caching of resolved ID's. | |
105 | ||
ac357d3b MM |
106 | .SS Parameters for resolving of ID's via UDEV's HWDB |
107 | .TP | |
108 | .B hwdb.disable | |
109 | Disable use of HWDB if set to a non-zero value. | |
110 | ||
f2bf13dc MM |
111 | .SH SEE ALSO |
112 | ||
113 | .BR lspci (8), | |
114 | .BR setpci (8), | |
115 | .BR update-pciids (8) | |
116 | ||
117 | .SH AUTHOR | |
118 | The PCI Utilities are maintained by Martin Mares <mj@ucw.cz>. |