X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;f=index.html;h=387bbdadeaa483fbba01940560b692351dc1df4d;hb=HEAD;hp=992f9e1571b3797366c08e74b5765d2d123f28a6;hpb=415726c838222fd92f41a3f8f3170b6269835e10;p=pciids.git diff --git a/index.html b/index.html index 992f9e1..387bbda 100644 --- a/index.html +++ b/index.html @@ -1,12 +1,114 @@ -
Welcome to new webside of Pci IDs database. -
+ +The home of the pci.ids
file
+
This is a public repository of all known ID's used in PCI devices: +ID's of vendors, devices, subsystems and device classes. It is used in +various programs (e.g., The PCI Utilities) +to display full human-readable names instead of cryptic numeric codes. + +
You can use our web interface to browse the lists and also to submit new +entries or to update the existing ones: + +
+ +You may want to read help before you start using the +web interface. + +
We generate daily snapshots of the database in form of a
+pci.ids
file. You can download the snapshot to update
+the list used by your system:
+
+
The above files require pciutils v2.2 or newer. If you are still using an older +version for some reason, please get these instead: pci.ids-2.0, +pci.ids-2.0.gz, or pci.ids-2.0.bz2. They +could however lack some subsystems. + +
The contents of the database and the generated files can be distributed +under the terms of either the GNU General Public License (version 2 or later) +or of the 3-clause BSD License. +The database is a compilation of factual data, and as such the copyright +only covers the aggregation and formatting. + +
If the snapshot is a couple of days old, it usually means that no changes +were approved recently. + +
Automated downloads:
+If you download the snapshots automatically, please put the name of your
+program in the User-Agent
HTTP header and tell us about it.
+Please cache the files responsively.
+Please use compression (by either downloading the compressed version
+or requesting Accept-Encoding: gzip
in HTTP headers).
+Excessive downloads (hundreds of requests per day or more)
+could lead to a ban on your IP addresses.
+
+
Online queries: +Alternatively, you can query the database online via DNS. The libpci library from the pciutils +can do it on request. If you want to implement your own client, please ask the database +admins for help. Again, please use the DNS interface responsively and avoid excessive +queries. If you want to run your own replica, we are happy to provide you with +automated zone updates. + +
The database is maintained by volunteers like you, so if you have any +devices which are not identified properly, please help us by adding them +to the database or by fixing the existing entry. + +
New entries are always welcome, but please submit only accurate information +– descriptions like "unknown modem device" are hardly useful for anybody. +of existing entries to clarify the description or to correct mistakes are also +welcome, but in this case please always add a discussion comment explaining the +reason for the change. + +
Updates can be submitted either via the web interface, or as patches to the pci.ids
+file sent by e-mail to our mail robot at pci-ids@ucw.cz
+(see the mail submit help).
+
+
In all cases, please read the submission guidelines +first. + +
The PCI ID database is currently maintained by Albert Pool and +Martin Mares. + +
If you have encountered any problems or if you have any suggestions, please let us know. + +
The pci.ids file is mirrored in a GitHub repository. + +
Server capacity and bandwidth for this site are generously donated by +Economia, +KAM MFF UK, and +CZ.NIC. Thanks! + +
The source code of this web application is publicly available. +If you want to examine it or need some similar application, you can find it here. +