]>
Commit | Line | Data |
---|---|---|
ab12277e | 1 | This package contains the PCI Utilities, version @VERSION@. |
2f48f637 | 2 | |
1d5cf727 | 3 | Copyright (c) 1997--2006 Martin Mares <mj@ucw.cz> |
2f48f637 MM |
4 | |
5 | All files in this package can be freely distributed and used according | |
6 | to the terms of the GNU General Public License, either version 2 or | |
deaad187 | 7 | (at your opinion) any newer version. See http://www.gnu.org/ for details. |
2f48f637 | 8 | |
727ce158 | 9 | |
07159913 MM |
10 | 1. What's that? |
11 | ~~~~~~~~~~~~~~~ | |
12 | The PCI Utilities package contains a library for portable access to PCI bus | |
13 | configuration registers and several utilities based on this library. | |
727ce158 | 14 | |
0ac282f2 MM |
15 | In runs on the following systems: |
16 | ||
17 | Linux (via /sys/bus/pci, /proc/bus/pci or i386 ports) | |
18 | FreeBSD (via /dev/pci) | |
19 | NetBSD (via libpci) | |
20 | OpenBSD (via /dev/pci) | |
21 | GNU/kFreeBSD (via /dev/pci) | |
22 | Solaris/i386 (direct port access) | |
23 | Aix (via /dev/pci and odmget) | |
24 | GNU Hurd (direct port access) | |
25 | Windows (direct port access) | |
26 | ||
81abd2a7 MM |
27 | It should be very easy to add support for other systems as well (volunteers |
28 | wanted; if you want to try that, I'll be very glad to see the patches and | |
29 | include them in the next version). | |
b2c9b373 | 30 | |
07159913 | 31 | The utilities include: (See manual pages for more details) |
b2c9b373 | 32 | |
46ea554d | 33 | - lspci: displays detailed information about all PCI buses and devices. |
b2c9b373 | 34 | |
07159913 MM |
35 | - setpci: allows to read from and write to PCI device configuration |
36 | registers. For example, you can adjust the latency timers with it. | |
37 | CAUTION: There is a couple of dangerous points and caveats, please read | |
38 | the manual page first! | |
2f48f637 | 39 | |
1b95f396 MM |
40 | - update-pciids: download the current version of the pci.ids file. |
41 | ||
f3395cc5 | 42 | |
07159913 MM |
43 | 2. Compiling and (un)installing |
44 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
45 | Just run "make" to compile the package and then "make install" to install it. | |
2f48f637 | 46 | |
07159913 | 47 | If you want to change the default installation location, please override |
f4ddb8d3 MM |
48 | the PREFIX variable specified in the Makefile -- e.g., you can use |
49 | "make PREFIX=/opt/pciutils install" to create a separate installation | |
50 | not interfering with the rest of your system. Setting the DESTDIR variable | |
51 | will allow you to install to a different directory from the one you intend | |
52 | to eventually run it from. This is useful for people who are packaging | |
53 | pciutils to install on other computers. | |
07159913 | 54 | |
cc062b4a MM |
55 | The configure script will automatically enable support for a compressed |
56 | pci.ids if you have zlib installed. You can override its guess by using | |
57 | "make ZLIB=no" or "make ZLIB=yes". If compressed support is enabled, | |
58 | pciutils will use pci.ids.gz in preference to pci.ids, even if the | |
59 | pci.ids file is newer. If the pci.ids.gz file is missing, it will use | |
60 | pci.ids instead. | |
61 | ||
07159913 MM |
62 | When you are bored of dumping PCI registers, just use "make uninstall". |
63 | ||
64 | ||
65 | 3. Getting new ID's | |
66 | ~~~~~~~~~~~~~~~~~~~ | |
67 | The database of PCI ID's (the pci.ids file) gets out of date much faster | |
68 | than I release new versions of this package. | |
69 | ||
70 | If you are missing names for any of your devices or you just want to stay | |
71 | on the bleeding edge, download the most recent pci.ids file from | |
1b95f396 | 72 | http://pciids.sf.net/ (e.g., by running the update-ids utility). |
a33d0eb7 MM |
73 | |
74 | If your devices still appear as unknown, please send us their ID's and | |
75 | names, the detailed instructions for submissions are listed on the | |
76 | sf.net web page. | |
07159913 MM |
77 | |
78 | ||
0ac282f2 MM |
79 | 4. Getting new versions |
80 | ~~~~~~~~~~~~~~~~~~~~~~~ | |
81 | New versions of pciutils are available at the following places: | |
82 | ||
83 | ftp://atrey.karlin.mff.cuni.cz/pub/linux/pci/ | |
84 | ftp://ftp.kernel.org/pub/software/utils/pciutils/ (expect a couple of hours delay) | |
85 | ftp://metalab.unc.edu/pub/Linux/hardware/ (expect a couple of days delay) | |
86 | ||
87 | There is also a public GIT tree at: | |
88 | ||
89 | git://git.kernel.org/pub/scm/utils/pciutils/pciutils.git | |
07159913 MM |
90 | |
91 | ||
92 | 5. Using the library | |
93 | ~~~~~~~~~~~~~~~~~~~~ | |
94 | There is still no documentation for the library, if you want to use it | |
95 | in your programs, please follow the comments in lib/pci.h and in the | |
96 | example program lib/example.c. | |
97 | ||
98 | ||
99 | 6. Feedback | |
100 | ~~~~~~~~~~~ | |
101 | If you have any bug reports or suggestions, send them to the author. | |
102 | ||
103 | If you have any new ID's, I'll be very glad to add them to the database, but | |
104 | please take a look at http://pciids.sf.net/ first and follow the instructions. | |
105 | ||
106 | If you want, subscribe to linux-pci@atrey.karlin.mff.cuni.cz (send | |
783ed67d | 107 | "subscribe linux-pci" to majordomo@atrey.karlin.mff.cuni.cz). |
2f48f637 MM |
108 | Release notes about new versions will be send to the list and problems with |
109 | the Linux PCI support will be probably discussed there, too. | |
110 | ||
2f48f637 | 111 | |
07159913 MM |
112 | 7. Miscellanea |
113 | ~~~~~~~~~~~~~~ | |
114 | You also might want to look at the pciutils web page containing release | |
81abd2a7 | 115 | notes and other news: http://atrey.karlin.mff.cuni.cz/~mj/pciutils.shtml . |
783ed67d | 116 | |
07159913 | 117 | There also exists a utility called PowerTweak which is able to fine tune |
2bea6231 | 118 | parameters of many chipsets much better than the Bridge Optimization code |
783ed67d | 119 | in Linux kernel (already removed in 2.3.x). See http://powertweak.sf.net/ |
2bea6231 MM |
120 | for more information. |
121 | ||
55c815b5 MM |
122 | Have fun |
123 | Martin |