Documented the DNS query switches.

diff --git a/TODO b/TODO
index b33d20932989a27307bb2bcf5716325bb9a2fc5b..87b20d7512a1e80ec188b3c62d8f869b60ecef31 100644 (file)
--- 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 5ce14f00ba2e646acd315024b713430108792296..e3b1c05ff90c975cd1f0da00ef1eb26a8a5899c6 100644 (file)
--- 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