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