index.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
   2 <html lang="en"><head><title>The PCI ID Repository</title>
   3 <link rel="stylesheet" type="text/css" media="all" href="/static/common.css">
   4 <link rel="stylesheet" type="text/css" media="screen" href="/static/screen.css">
   5 <link rel="stylesheet" type="text/css" media="print" href="/static/print.css">
   6 </head><body>
   7
   8 <div class="top"><div class="bigbluesquare">
   9 <h1>The PCI ID Repository</h1>
  10 <p class="home">The home of the <code>pci.ids</code> file
  11 </div></div>
  12
  13 <p>This is a public repository of all known ID's used in PCI devices:
  14 ID's of vendors, devices, subsystems and device classes. It is used in
  15 various programs (e.g., <a href="http://mj.ucw.cz/sw/pciutils/">The PCI Utilities</a>)
  16 to display full human-readable names instead of cryptic numeric codes.
  17
  18 <h2>Browse</h2>
  19
  20 <p>You can use our web interface to browse the lists and also to submit new
  21 entries or to update the existing ones:
  22
  23 <ul>
  24         <li><a href="https://admin.pci-ids.ucw.cz/read/PC/">PCI devices</a>
  25         <li><a href="https://admin.pci-ids.ucw.cz/read/PD/">PCI device classes</a>
  26 </ul>
  27
  28 <p>You may want to read <a href="/mods/?action=help?help=index">help</a> before you start using the
  29 web interface.
  30
  31 <h2>Download</h2>
  32
  33 <p>We generate daily snapshots of the database in form of a
  34 <code>pci.ids</code> file. You can download the snapshot to update
  35 the list used by your system:
  36
  37 <ul>
  38         <li><a href="/v2.2/pci.ids">pci.ids</a>
  39         <li><a href="/v2.2/pci.ids.gz">pci.ids.gz</a> (compressed by gzip)
  40         <li><a href="/v2.2/pci.ids.bz2">pci.ids.bz2</a> (compressed by bzip2)
  41         <li><a href="/v2.2/pci.ids.xz">pci.ids.xz</a> (compressed by xz)
  42 </ul>
  43
  44 <p>The above files require pciutils v2.2 or newer. If you are still using an older
  45 version for some reason, please get these instead: <a href="/pci.ids">pci.ids-2.0</a>,
  46 <a href="/pci.ids.gz">pci.ids-2.0.gz</a>, or <a href="/pci.ids.bz2">pci.ids-2.0.bz2</a>. They
  47 could however lack some subsystems.
  48
  49 <p>The contents of the database and the generated files can be distributed
  50 under the terms of either the <a href="http://www.opensource.org/licenses/gpl-license.php">GNU General Public License</a> (version 2 or later)
  51 or of the <a href="http://opensource.org/licenses/BSD-3-Clause">3-clause BSD License.</a>
  52 The database is a compilation of factual data, and as such the copyright
  53 only covers the aggregation and formatting.
  54
  55 <p>If the snapshot is a couple of days old, it usually means that no changes
  56 were approved recently.
  57
  58 <p><em>Automated downloads:</em>
  59 If you download the snapshots automatically, please put the name of your
  60 program in the <code>User-Agent</code> HTTP header and tell us about it.
  61 Please cache the files responsively.
  62 Please use compression (by either downloading the compressed version
  63 or requesting <code>Accept-Encoding: gzip</code> in HTTP headers).
  64 Excessive downloads (hundreds of requests per day or more)
  65 could lead to a ban on your IP addresses.
  66
  67 <p><em>Online queries:</em>
  68 Alternatively, you can query the database online via DNS. The libpci library from the <a href='https://mj.ucw.cz/sw/pciutils/'>pciutils</a>
  69 can do it on request. If you want to implement your own client, please ask the database
  70 admins for help. Again, please use the DNS interface responsively and avoid excessive
  71 queries. If you want to run your own replica, we are happy to provide you with
  72 automated zone updates.
  73
  74 <h2>Submit new data</h2>
  75
  76 <p>The database is maintained by volunteers like you, so if you have any
  77 devices which are not identified properly, please help us by adding them
  78 to the database or by fixing the existing entry.
  79
  80 <p>New entries are always welcome, but please submit only accurate information
  81 &ndash; descriptions like "unknown modem device" are hardly useful for anybody.
  82 of existing entries to clarify the description or to correct mistakes are also
  83 welcome, but in this case please always add a discussion comment explaining the
  84 reason for the change.
  85
  86 <p>Updates can be submitted either via the web interface, or as patches to the <code>pci.ids</code>
  87 file sent by e-mail to our mail robot at <a href="mailto:pci-ids@ucw.cz">pci-ids@ucw.cz</a>
  88 (see the <a href="https://admin.pci-ids.ucw.cz/mods/?action=help?help=mailsubmit">mail submit help</a>).
  89
  90 <p><em>In all cases, please read the <a href="https://admin.pci-ids.ucw.cz/mods/?action=help?help=newitem">submission guidelines</a>
  91 first.</em>
  92
  93 <h2>Maintainers</h2>
  94
  95 <p>The PCI ID database is currently maintained by Albert Pool and
  96 <a href='http://mj.ucw.cz/'>Martin Mares</a>.
  97
  98 <p>If you have encountered any problems or if you have any suggestions, please <a href="mailto:pci-admins@ucw.cz">let us know</a>.
  99
 100 <h2>Mirrors</h2>
 101
 102 <p>The pci.ids file is mirrored in a <a href='https://github.com/pciutils/pciids'>GitHub repository</a>.
 103
 104 <p>Server capacity and bandwidth for this site are generously donated by
 105 <a href='http://economia.cz/'>Economia</a>,
 106 <a href='http://kam.mff.cuni.cz/'>KAM MFF UK</a>, and
 107 <a href='http://nic.cz/'>CZ.NIC</a>. Thanks!
 108
 109 <h2>Source code</h2>
 110
 111 <p>The source code of this web application is publicly available.
 112 If you want to examine it or need some similar application, you can find it <a href='http://vorner.cz/en/pciids.html'>here</a>.
 113
 114 </body></html>