1: This package contains the PCI Utilities, version 3.1.9.
2:
3: Copyright (c) 1997--2012 Martin Mares <mj@ucw.cz>
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
7: (at your opinion) any newer version. See http://www.gnu.org/ for details.
8:
9:
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.
14:
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: CYGWIN (direct port access)
27: BeOS (via syscalls)
28: Haiku (via /dev/misc/poke)
29:
30: It should be very easy to add support for other systems as well (volunteers
31: wanted; if you want to try that, I'll be very glad to see the patches and
32: include them in the next version).
33:
34: The utilities include: (See manual pages for more details)
35:
36: - lspci: displays detailed information about all PCI buses and devices.
37:
38: - setpci: allows to read from and write to PCI device configuration
39: registers. For example, you can adjust the latency timers with it.
40: CAUTION: There is a couple of dangerous points and caveats, please read
41: the manual page first!
42:
43: - update-pciids: download the current version of the pci.ids file.
44:
45:
46: 2. Compiling and (un)installing
47: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
48: Just run "make" to compile the package and then "make install" to install it.
49: Please note that GNU make is needed on most platforms.
50:
51: If you want to change the default installation location, please override
52: the PREFIX variable specified in the Makefile -- e.g., you can use
53: "make PREFIX=/opt/pciutils install" to create a separate installation
54: not interfering with the rest of your system. Setting the DESTDIR variable
55: will allow you to install to a different directory from the one you intend
56: to eventually run it from. This is useful for people who are packaging
57: pciutils to install on other computers.
58:
59: There are several options which can be set in the Makefile or overridden
60: when running make:
61:
62: ZLIB=yes/no Enable support for compressed pci.ids (requires zlib).
63: If it is enabled, pciutils will use pci.ids.gz in preference to
64: pci.ids, even if the pci.ids file is newer. If the pci.ids.gz
65: file is missing, it will use pci.ids instead. If you do not
66: specify this option, the configure script will try to guess
67: automatically based on the presence of zlib.
68:
69: DNS=yes/no Enable support for querying the central database of PCI IDs
70: using DNS. Requires libresolv (which is available on most
71: systems as a part of the standard libraries) and tries to
72: autodetect its presence if the option is not specified.
73:
74: SHARED=yes/ Build libpci as a shared library. Requires GCC 4.0 or newer.
75: no/local The ABI of the shared library is intended to remain backward
76: compatible for a long time (we use symbol versioning to achieve
77: that, like GNU libc does). The value `local' includes the
78: right directory name in the binaries, so the utilities can be
79: run without installation. This is not recommended for any
80: production builds.
81:
82: "make install-lib" installs the library together with its header files
83: for use by other programs.
84:
85: When you are bored of dumping PCI registers, just use "make uninstall".
86:
87:
88: 3. Getting new IDs
89: ~~~~~~~~~~~~~~~~~~~
90: The database of PCI IDs (the pci.ids file) gets out of date much faster
91: than I release new versions of this package, so it is maintained separately.
92:
93: It lives at http://pci-ids.ucw.cz/, where you can browse the database,
94: download the most recent pci.ids file (e.g., by running the update-ids utility)
95: and also submit new entries.
96:
97: Alternatively, you can use `lspci -q' to query the central database
98: for new entries via network.
99:
100: The pci.ids file is also mirrored at http://pciids.sourceforge.net/
101:
102:
103: 4. Getting new versions
104: ~~~~~~~~~~~~~~~~~~~~~~~
105: The current version of pciutils is available at:
106:
107: http://mj.ucw.cz/sw/pciutils/
108:
109: The tarball can be downloaded at the following places:
110:
111: ftp://atrey.karlin.mff.cuni.cz/pub/linux/pci/
112: ftp://ftp.kernel.org/pub/software/utils/pciutils/ (expect a couple of hours delay)
113: ftp://metalab.unc.edu/pub/Linux/hardware/ (expect a couple of days delay)
114:
115: There is also a public GIT tree at:
116:
117: git://git.kernel.org/pub/scm/utils/pciutils/pciutils.git
118:
119:
120: 5. Using the library
121: ~~~~~~~~~~~~~~~~~~~~
122: So far, there is only a little documentation for the library except for the
123: general introduction in the pcilib(7) man page. If you want to use the
124: library in your programs, please follow the comments in lib/pci.h and in
125: the example program example.c.
126:
127:
128: 6. Feedback
129: ~~~~~~~~~~~
130: If you have any bug reports or suggestions, send them to the author.
131:
132: If you have any new IDs, I'll be very glad to add them to the database.
133: Just submit them at http://pci-ids.ucw.cz/.
134:
135: Announcements of new versions are sent to linux-pci@vger.kernel.org
136: (see http://vger.kernel.org/ for instructions).
137:
138: Have fun
139: Martin
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to README CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / pciutils