This package contains the PCI Utilities, version @VERSION@.
-Copyright (c) 1997--2010 Martin Mares <mj@ucw.cz>
+Copyright (c) 1997--2024 Martin Mares <mj@ucw.cz>
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.
+(at your opinion) any newer version. See https://www.gnu.org/ for details.
+
+The author wants to clarify that he does not consider programs which link
+dynamically to the libpci to be derived works of the library.
1. What's that?
Linux (via /sys/bus/pci, /proc/bus/pci or i386 ports)
FreeBSD (via /dev/pci)
NetBSD (via libpci)
- OpenBSD (via /dev/pci)
+ OpenBSD (via /dev/pci or i386 ports)
GNU/kFreeBSD (via /dev/pci)
Solaris/i386 (direct port access)
Aix (via /dev/pci and odmget)
GNU Hurd (direct port access)
- Windows (direct port access)
+ Windows (via cfgmgr32 or direct port access, see README.Windows for caveats)
CYGWIN (direct port access)
+ BeOS (via syscalls)
+ Haiku (via /dev/misc/poke)
+ Darwin (via IOKit)
+ DOS/DJGPP (via i386 ports)
+ SylixOS (via /proc/pci)
+ AmigaOS on PPC (via Expansion library)
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
- update-pciids: download the current version of the pci.ids file.
+ - pcilmr: performs margining on PCIe links.
+
2. Compiling and (un)installing
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Just run "make" to compile the package and then "make install" to install it.
-Please note that GNU make is needed on most platforms.
+Please note that a C compiler supporting the C99 standard is required.
+Also, GNU make is needed on most platforms.
If you want to change the default installation location, please override
the PREFIX variable specified in the Makefile -- e.g., you can use
specify this option, the configure script will try to guess
automatically based on the presence of zlib.
- DNS=yes/no Enable support for querying the central database of PCI ID's
+ DNS=yes/no Enable support for querying the central database of PCI IDs
using DNS. Requires libresolv (which is available on most
systems as a part of the standard libraries) and tries to
autodetect its presence if the option is not specified.
When you are bored of dumping PCI registers, just use "make uninstall".
-3. Getting new ID's
+3. Getting new IDs
~~~~~~~~~~~~~~~~~~~
-The database of PCI ID's (the pci.ids file) gets out of date much faster
-than I release new versions of this package.
+The database of PCI IDs (the pci.ids file) gets out of date much faster
+than I release new versions of this package, so it is maintained separately.
-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).
+It lives at https://pci-ids.ucw.cz/, where you can browse the database,
+download the most recent pci.ids file (e.g., by running the update-ids utility)
+and also submit new entries.
Alternatively, you can use `lspci -q' to query the central database
for new entries via network.
-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.
+The pci.ids file is also mirrored at https://github.com/pciutils/pciids.
+
+On Linux systems with a recent enough version of libudev, UDEV's HWDB
+database is consulted when pci.ids lacks the device.
4. Getting new versions
~~~~~~~~~~~~~~~~~~~~~~~
-New versions of pciutils are available at the following places:
+The current version of pciutils is available at:
+
+ https://mj.ucw.cz/sw/pciutils/
- ftp://atrey.karlin.mff.cuni.cz/pub/linux/pci/
- ftp://ftp.kernel.org/pub/software/utils/pciutils/ (expect a couple of hours delay)
- ftp://metalab.unc.edu/pub/Linux/hardware/ (expect a couple of days delay)
+The tarball can be downloaded at the following places:
+
+ https://mj.ucw.cz/download/linux/pci/
+ ftp://ftp.ucw.cz/pub/mj/linux/pci/
+ https://www.kernel.org/pub/software/utils/pciutils/ (expect a couple of hours delay)
There is also a public GIT tree at:
- git://git.kernel.org/pub/scm/utils/pciutils/pciutils.git
+ https://git.kernel.org/pub/scm/utils/pciutils/pciutils.git
+ https://github.com/pciutils/pciutils
5. Using the library
~~~~~~~~~~~
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@vger.kernel.org (take a look at
-http://vger.kernel.org/ for instructions).
-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://mj.ucw.cz/pciutils.shtml .
+If you have any new IDs, I'll be very glad to add them to the database.
+Just submit them at https://pci-ids.ucw.cz/.
-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.
+Announcements of new versions are sent to linux-pci@vger.kernel.org
+(see http://vger.kernel.org/ for instructions).
Have fun
Martin
projects / thirdparty / pciutils.git / blobdiff