From: Martin Mares <mj@ucw.cz>
Date: Mon, 11 Feb 2008 21:03:02 +0000 (+0100)
Subject: Documented the DNS query switches.
X-Git-Tag: v3.0.0~1^2~52
X-Git-Url: http://mj.ucw.cz/gitweb/?a=commitdiff_plain;h=7059c71191b16b439bc6c01803a3c670649da202;p=pciutils.git

Documented the DNS query switches.
---

diff --git a/TODO b/TODO
index b33d209..87b20d7 100644
--- a/TODO
+++ b/TODO
@@ -1,9 +1,9 @@
 - review class names
 
 DNS mode:
-- update man pages
+- update README
 - check negative caching
-- check network errors
+- check handling of network errors
 - try to avoid libresolv.a
 
 Capabilities with partial decoding:
diff --git a/lspci.man b/lspci.man
index 5ce14f0..e3b1c05 100644
--- a/lspci.man
+++ b/lspci.man
@@ -57,6 +57,25 @@ PCI ID list.
 .B -nn
 Show PCI vendor and device codes as both numbers and names.
 .TP
+.B -q
+Use DNS to query the central PCI ID database if a device is not found in the local
+.B pci.ids
+file. If the DNS query succeeds, the result is cached in
+.B ~/.pciids-cache
+and it is recognized in subsequent runs even if
+.B -q
+is not given any more. Please use this switch inside automated scripts only
+with caution to avoid overloading the database servers.
+.TP
+.B -qq
+Same as
+.BR -q ,
+but the local cache is reset.
+.TP
+.B -Q
+Query the central database even for entries which are recognized locally.
+Use this if you suspect that the displayed entry is wrong.
+.TP
 .B -x
 Show hexadecimal dump of the standard part of the configuration space (the first
 64 bytes or 128 bytes for CardBus bridges).
@@ -333,6 +352,9 @@ utility to download the most recent version.
 .B @IDSDIR@/pci.ids.gz
 If lspci is compiled with support for compression, this file is tried before pci.ids.
 .TP
+.B ~/.pciids-cache
+All ID's found in the DNS query mode are cached in this file.
+.TP
 .B /proc/bus/pci
 An interface to PCI bus configuration space provided by the post-2.1.82 Linux
 kernels. Contains per-bus subdirectories with per-card config space files and a