lspci-liste alle PCI-enheder
Synopsis
lspci
beskrivelse
lspci er et værktøj til visning af oplysninger om PCI-busser i systemet og de enheder, der er forbundet til dem.
som standard viser den en kort liste over enheder. Brug indstillingerne beskrevet nedenfor til at anmode om enten en mere detaljeret output eller output beregnet til parsing af andre programmer.
hvis du vil rapportere fejl i PCI-enhedsdrivere eller i lspci selv, skal du medtage output af “lspci-vvks” eller endnu bedre “lspci-vvks”(se dog nedenfor for mulige advarsler).
nogle dele af output, især i de meget detaljerede tilstande, er sandsynligvis kun forståelige for erfarne PCI-hackere. For nøjagtige definitioner af felter, se enten PCI-specifikationerne eller overskriften.h og/usr / inkluderer / Linuks / pci.h omfatter filer.
adgang til nogle dele af PCI-konfigurationsrummet er begrænset til root på mange operativsystemer, så funktionerne i lspci, der er tilgængelige for normalusers, er begrænsede. Lspci forsøger dog sit bedste for at vise så meget som tilgængeligt og markere alle andre oplysninger med <Adgang nægtet>tekst.
indstillinger
grundlæggende visningstilstande
-m
Dump PCI-enhedsdata i en bagudkompatibel maskinlæsbar form. Se nedenfor for detaljer.
-mm
Dump PCI-enhedsdata i en maskinlæsbar form for nem parsing af scripts. Se nedenfor for detaljer.
-t
Vis et trælignende diagram, der indeholder alle busser, broer, enheder og forbindelser mellem dem.
visningsindstillinger
– v
vær detaljeret og vis detaljerede oplysninger om alle enheder.
-vv
Vær meget detaljeret og vis flere detaljer. Dette niveau inkluderer alt, hvad der anses for nyttigt.
-vvv
Vær endnu mere detaljeret og vis alt, hvad vi er i stand til at analysere, selvom det slet ikke ser interessant ud (f.eks. udefinerede hukommelsesregioner).
-k
Vis kernedrivere, der håndterer hver enhed, og også kernemoduler, der er i stand til at håndtere den. Tændt som standard, når-v er angivet i normal tilstand afoutput. (Fungerer i øjeblikket kun på kernel 2.6 eller nyere.)
–
Vis seksadecimal dump af standarddelen af konfigurationsrummet (de første 64 bytes eller 128 bytes til CardBus broer).
–
Vis seksadecimal dump af hele PCI-konfigurationsrummet. Det er kun tilgængeligt for rod, da flere PCI-enheder går ned, når du prøver at læse nogle deleaf config-rummet (denne opførsel overtræder sandsynligvis ikke PCI-standarden, men det er i det mindste meget dumt). Sådanne enheder er dog sjældne, så du har brug forbekymre dig meget.
–
Vis den udvidede (4096-byte) PCI-konfigurationsplads, der er tilgængelig på PCI-2.0 og PCI-ekspresbusser.
-b
Bus-centreret visning. Vis alle numre og adresser som set af kortene på PCI-bussen i stedet for som set af kernen.
-D
Vis altid PCI-domænenumre. Som standard undertrykker lspci dem på maskiner, der kun har domæne 0.
muligheder for at styre løse ID ‘ er til navne
– N
Vis PCI leverandør og enhedskoder som tal i stedet for at slå dem op i PCI ID-listen.
– nn
Vis PCI leverandør-og enhedskoder som både tal og navne.
– spørgsmål
brug DNS til at forespørge den centrale PCI ID-database, hvis en enhed ikke findes i den lokale pci.ids-fil. Hvis DNS-forespørgslen lykkes, cachelagres resultatet i~/.pciids-cache, og det genkendes i efterfølgende kørsler, selvom-C ikke gives mere. Brug kun denne kontakt inde i automatiserede scripts med forsigtighed for at undgå overbelastning af databaseserverne.
-KK
samme som-k, men den lokale cache nulstilles.
-spørgsmål
Forespørg den centrale database, selv for poster, der genkendes lokalt. Brug dette, hvis du har mistanke om, at den viste post er forkert.
valg til valg af enheder
– s:] < bus >]:]] Vis kun enheder i det angivne domæne (hvis din maskine har flere værtsbroer, kan de enten dele et fælles busnummerrum eller hver af demkan adressere et eget PCI-domæne; domæner er nummereret fra 0 til ffff), bus (0 til ff), slot (0 til 1F) og funktion (0 til 7). Hver komponent i enhedenadress kan udelades eller indstilles til “*”, begge betyder “enhver værdi”. Alle tal er seksadecimale. F. eks. betyder “0: “alle enheder på bus 0,” 0 “betyder alle funktioner i enhed 0 på enhver bus,” 0.3 “vælger tredje funktion af enhed 0 på alle busser og”.4 ” viser kun den fjerde funktion af hver enhed. – d: Vis kun enheder med specificeret leverandør og enheds-ID. Begge ID ‘ er er angivet i heksadecimal og kan udelades eller gives som “*”, begge betyder “anyvalue”.
andre muligheder
– i < fil>brug < fil> som PCI ID-liste i stedet for /usr/share/hdata/pci.ID. – p <fil >brug < fil> som kortet over PCI ID ‘ er håndteres af kernel moduler. Som standard bruger lspci/lib/modules/kernel_version / modules.pcimap. Det gælder kun for Linuks-systemer med nyere nok modulværktøjer. – M
påberåbe bus kortlægning tilstand, som udfører en grundig scanning af alle PCI-enheder, herunder dem bag fejlkonfigurerede broer, etc. Denne mulighed giver meningsfuldtresultater kun med en direkte adgangstilstand, som normalt kræver rodrettigheder. Bemærk, at bus mapper Kun scanner PCI domæne 0.
– version viser lspci version. Denne mulighed skal bruges stand-alone.
PCI-adgangsindstillinger
PCI-hjælpeprogrammerne bruger PCI-biblioteket til at tale med PCI-enheder (se pcilib(7) for detaljer). Du kan bruge følgende muligheder for at påvirke densadfærd:- En< metode > biblioteket understøtter en række forskellige metoder til at få adgang til PCI-udstyr. Som standard bruger den den første tilgængelige adgangsmetode, men du kan bruge denne indstilling tiloverride denne beslutning. Se – en hjælp til en liste over tilgængelige metoder og deres beskrivelser. – O <param >=< værdi> bibliotekets opførsel styres af flere navngivne parametre. Denne indstilling gør det muligt at indstille værdien af en af parametrene. Brug – O hjælp fora liste over kendte parametre og deres standardværdier. – H1
brug direkte udstyrsadgang via Intel-konfigurationsmekanisme 1. (Dette er en stenografi for-en intel-conf1.)
-H2
brug direkte adgang til udstyr via Intel-konfigurationsmekanisme 2. (Dette er en stenografi for-en intel-conf2.)
-f <fil> i stedet for at få adgang til ægte udstyr, skal du læse listen over enheder og værdier for deres konfigurationsregistre fra den givne fil, der er produceret af en tidligere kørsel oflspci-h. Dette er meget nyttigt til analyse af brugerleverede fejlrapporter, fordi du kan vise udstyrskonfigurationen på enhver måde, du vil udenforstyrre brugeren med anmodninger om flere dumper. – G
Forøg debug niveau af biblioteket.
maskinlæsbart Output
hvis du agter at behandle output fra lspci automatisk, skal du bruge et af de maskinlæsbare outputformater (- m,- vm,- vmm)beskrevet i dette afsnit. Alle andre formater vil sandsynligvis skifte mellem versioner af lspci.
alle numre udskrives altid i seksadecimal. Hvis du vil behandle numeriske ID ‘ er i stedet for Navne, skal du tilføje-n-kontakten.
simpelt format (- m)
i det enkle format beskrives hver enhed på en enkelt linje, der er formateret som parametre, der er egnede til at overføre til et shell-script, dvs., værdier adskilt af hvide rum, Citeret og undslap om nødvendigt. Nogle af argumenterne er positionelle: slot, klasse, leverandørnavn, enhedsnavn, delsystemleverandørnavn og delsystemnavn (de sidste to er tomme, hvis enheden ikke har noget delsystem); de resterende argumenter er option-lignende: -Rrev
revisionsnummer.
– pprogif programmeringsgrænseflade. Den relative rækkefølge af positionelle argumenter og indstillinger er udefineret. Nye muligheder kan tilføjes i fremtidige versioner, men de vil altid have et singleargument, der ikke er adskilt fra indstillingen med mellemrum, så de let kan ignoreres, hvis de ikke genkendes.
Verbose format (- vmm)
verbose output er en sekvens af poster adskilt af tomme linjer. Hver post beskriver en enkelt enhed ved en sekvens af linjer, hver linje indeholder asingle ‘tag: værdi’ par. Tagget og værdien er adskilt af et enkelt tabulatortegn. Hverken posterne eller linjerne i arecord er i nogen bestemt rækkefølge. Tags er store og små bogstaver.
følgende tags er defineret:
Slot
navnet på den slot, hvor enheden befinder sig (bus:enhed.funktion). Dette tag er altid det første i en rekord.
klasse
klassens navn.
leverandør
leverandørens navn.
enhed
enhedens navn.
svendor navn på delsystemleverandøren (valgfrit). Delsystemets navn (valgfrit). PhySlot den fysiske slot, hvor enheden befinder sig (valgfrit). Rev
revisionsnummer (valgfrit).
ProgIf
programmeringsgrænseflade (valgfrit).
Driver
Kernel driver, der i øjeblikket håndterer enheden.
modul
kernemodul, der rapporterer, at det er i stand til at håndtere enheden (kun valgfri).
nye tags kan tilføjes i fremtidige versioner, så du bør lydløst ignorere alle tags, du ikke genkender.
bagudkompatibelt verbose format (- vm)
i denne tilstand forsøger lspci at være perfekt kompatibel med sine gamle versioner. Det er næsten det samme som det almindelige verbose-format, men Enhedsmærket bruges til både slot og enhedsnavn, så det forekommer to gange i en enkelt post. Undgå at bruge dette format i en ny kode.
filer
/usr/share/PCI.ids
en liste over alle kendte PCI-ID ‘ er (leverandører, enheder, klasser og underklasser). Vedligeholdt på http://pciids.sourceforge.net/, brug update – pciids værktøjat hente den nyeste version. /usr/share/PCI.ID.hvis lspci er kompileret med understøttelse af komprimering, er denne fil forsøgt før pci.ID. ~/.pciids-cache Alle ID ‘ er, der findes i DNS-forespørgselstilstanden, cachelagres i denne fil.
Bugs
nogle gange er lspci ikke i stand til at afkode konfigurationsregistrene fuldstændigt. Dette sker normalt, når der ikke var tilstrækkelig dokumentation til rådighed forforfattere. I sådanne tilfælde udskriver den i det mindste <?> marker for at signalere, at der potentielt er noget mere at sige. Hvis du kender detaljerne, vil patches naturligvis være velkomne.
adgang til det udvidede konfigurationsrum understøttes i øjeblikket kun af back-end.
Se også
setpci (8), update-pciids (8), pcilib(7)
forfatter
PCI-hjælpeprogrammerne vedligeholdes af Martin Mares <[email protected]>.
