]> mj.ucw.cz Git - pciids.git/blob - index.html
cab7ac35ad6547a01bd9c7cba51caf95c731946b
[pciids.git] / 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>If you download the snapshots automatically, please put the name of your
59 program to the <code>User-Agent</code> HTTP header and tell us
60 about it. Please cache the files responsively. Thousands of requests per
61 day from your automated build system could lead to a ban on your IP addresses.
62
63 <h2>Submit new data</h2>
64
65 <p>The database is maintained by volunteers like you, so if you have any
66 devices which are not identified properly, please help us by adding them
67 to the database or by fixing the existing entry.
68
69 <p>New entries are always welcome, but please submit only accurate information
70 &ndash; descriptions like "unknown modem device" are hardly useful for anybody.
71 of existing entries to clarify the description or to correct mistakes are also
72 welcome, but in this case please always add a discussion comment explaining the
73 reason for the change.
74
75 <p>Updates can be submitted either via the web interface, or as patches to the <code>pci.ids</code>
76 file sent by e-mail to our mail robot at <a href="mailto:pci-ids@ucw.cz">pci-ids@ucw.cz</a>
77 (see the <a href="https://admin.pci-ids.ucw.cz/mods/?action=help?help=mailsubmit">mail submit help</a>).
78
79 <p><em>In all cases, please read the <a href="https://admin.pci-ids.ucw.cz/mods/?action=help?help=newitem">submission guidelines</a>
80 first.</em>
81
82 <h2>Maintainers</h2>
83
84 <p>The PCI ID database is currently maintained by Albert Pool and
85 <a href='http://mj.ucw.cz/'>Martin Mares</a>.
86
87 <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>.
88
89 <h2>Mirrors</h2>
90
91 <p>The pci.ids file is mirrored in a <a href='https://github.com/pciutils/pciids'>GitHub repository</a>.
92
93 <p>Server capacity and bandwidth for this site are generously donated by
94 <a href='http://economia.cz/'>Economia</a>,
95 <a href='http://kam.mff.cuni.cz/'>KAM MFF UK</a>, and
96 <a href='http://nic.cz/'>CZ.NIC</a>. Thanks!
97
98 <h2>Source code</h2>
99
100 <p>The source code of this web application is publicly available.
101 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>.
102
103 </body></html>