X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;f=README;h=fe5ccf1140e5dffadf3fd29d159adb1cf5927bcc;hb=cce2caac70e8052540e783de03001101c38d937c;hp=6de00d58b0fafa1637937c25d9615b47bd786a87;hpb=c0340fd1a2f73c50bcf9f3cd5f388d244ae5f684;p=pciutils.git diff --git a/README b/README index 6de00d5..fe5ccf1 100644 --- a/README +++ b/README @@ -1,4 +1,122 @@ -This is an experimental version of the Linux PCI Utilities package. -Maintained by Martin Mares +This package contains the PCI Utilities, version @VERSION@. -pci.ids should be copied to /etc if you want textual PCI ID's. +Copyright (c) 1997--2003 Martin Mares + +All files in this package can be freely distributed and used according +to the terms of the GNU General Public License, either version 2 or +(at your opinion) any newer version. See http://www.gnu.org/ for details. + + +############################################################################ + +Beware, this is a preliminary test version! Anything might not work! + +Some more things I intend to merge before the 2.2.0 release: + + o pcimodules and possibly other Linux module related stuff + o New ID's from the pciids project + o Cross-compilation support + +############################################################################ + + + +1. What's that? +~~~~~~~~~~~~~~~ +The PCI Utilities package contains a library for portable access to PCI bus +configuration registers and several utilities based on this library. + +Currently, pciutils work on all versions of Linux and they also have somewhat +experimental support for FreeBSD, NetBSD, AIX, GNU Hurd and Solaris/x86. +It should be very easy to add support for other systems as well (volunteers +wanted; if you want to try that, I'll be very glad to see the patches and +include them in the next version). + +The utilities include: (See manual pages for more details) + + - lspci: displays detailed information about all PCI busses and devices. + + - setpci: allows to read from and write to PCI device configuration + registers. For example, you can adjust the latency timers with it. + CAUTION: There is a couple of dangerous points and caveats, please read + the manual page first! + + - update-pciids: download the current version of the pci.ids file. + + +2. Compiling and (un)installing +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Just run "make" to compile the package and then "make install" to install it. + +If you want to change the default installation location, please override +the ROOT and PREFIX variables specified in the Makefile -- e.g., you can +use "make PREFIX=/opt/pciutils ROOT=/opt/pciutils install" to create +a separate installation not interfering with the rest of your system. + +When you are bored of dumping PCI registers, just use "make uninstall". + + +3. Getting new ID's +~~~~~~~~~~~~~~~~~~~ +The database of PCI ID's (the pci.ids file) gets out of date much faster +than I release new versions of this package. + +If you are missing names for any of your devices or you just want to stay +on the bleeding edge, download the most recent pci.ids file from +http://pciids.sf.net/ (e.g., by running the update-ids utility). + +If your devices still appear as unknown, please send us their ID's and +names, the detailed instructions for submissions are listed on the +sf.net web page. + + +4. Available access methods +~~~~~~~~~~~~~~~~~~~~~~~~~~~ +The library (and therefore all the utilities) know a variety of methods for +accessing the PCI registers. Here is a list of them, sorted by autodetection +priority: + + /proc/bus/pci on all Linux systems since kernel 2.1.82. + /sys/bus/pci on all Linux systems since kernel 2.5.xx. + direct port access on i386 systems running Linux, GNU Hurd or Solaris/x86; + available only to root, useful if no other access + method is available or you want to hunt kernel bugs + /dev/pci used on FreeBSD + lsdev + odmget used on AIX + libpci used on NetBSD + dumps reading of dumps produced by `lspci -x' + (this one is not autodetected) + + +5. Using the library +~~~~~~~~~~~~~~~~~~~~ +There is still no documentation for the library, if you want to use it +in your programs, please follow the comments in lib/pci.h and in the +example program lib/example.c. + + +6. Feedback +~~~~~~~~~~~ +If you have any bug reports or suggestions, send them to the author. + +If you have any new ID's, I'll be very glad to add them to the database, but +please take a look at http://pciids.sf.net/ first and follow the instructions. + +If you want, subscribe to linux-pci@atrey.karlin.mff.cuni.cz (send +"subscribe linux-pci" to majordomo@atrey.karlin.mff.cuni.cz). +Release notes about new versions will be send to the list and problems with +the Linux PCI support will be probably discussed there, too. + + +7. Miscellanea +~~~~~~~~~~~~~~ +You also might want to look at the pciutils web page containing release +notes and other news: http://atrey.karlin.mff.cuni.cz/~mj/pciutils.shtml . + +There also exists a utility called PowerTweak which is able to fine tune +parameters of many chipsets much better than the Bridge Optimization code +in Linux kernel (already removed in 2.3.x). See http://powertweak.sf.net/ +for more information. + + Have fun + Martin