From 7059c71191b16b439bc6c01803a3c670649da202 Mon Sep 17 00:00:00 2001 From: Martin Mares Date: Mon, 11 Feb 2008 22:03:02 +0100 Subject: [PATCH] Documented the DNS query switches. --- TODO | 4 ++-- lspci.man | 22 ++++++++++++++++++++++ 2 files changed, 24 insertions(+), 2 deletions(-) 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 -- 2.39.2