lspci(8) – Linux man page

Navn

lspci-liste alle PCI-enheter

Lspci Er et verktøy for å vise informasjon om PCI busser i systemer og enheter som er koblet til dem.

som standard viser den en kort liste over enheter. Bruk alternativene som er beskrevet nedenfor for å be om enten en mer detaljert utgang eller utgang beregnet for parsing av andre programmer.

hvis du skal rapportere feil I PCI – enhetsdrivere eller i lspci selv, må du inkludere utdata av «lspci-vvx» eller enda bedre «lspci-vvxxx» (men se nedenfor for mulige advarsler).

Noen deler av utgangen, spesielt i de svært verbose modusene, er trolig bare forståelige for erfarne PCI-hackere. For nøyaktige definisjoner av thefields, vennligst se ENTEN PCI-spesifikasjonene eller overskriften.h og / usr / inkluderer / linux / pci.h inkluderer filer.

Tilgang til enkelte DELER AV PCI-konfigurasjonsområdet er begrenset til rot på mange operativsystemer, så funksjonene til lspci tilgjengelig for normalbrukerne er begrenset. Lspci prøver imidlertid sitt beste for å vise så mye som tilgjengelig og markere all annen informasjon med < access denied > tekst.

Alternativer

Grunnleggende visningsmoduser

– m

Dump PCI-enhetsdata i en bakoverkompatibel maskinlesbar form. Se nedenfor for detaljer.

-mm

Dump PCI-enhetsdata i en maskinlesbar form for enkel parsing av skript. Se nedenfor for detaljer.

-t

Vis et trelignende diagram som inneholder alle busser, broer, enheter og forbindelser mellom dem.

Visningsalternativer

– v

Vær detaljert og vis detaljert informasjon om alle enheter.

– vv

Vær veldig detaljert og vis flere detaljer. Dette nivået inkluderer alt som anses nyttig.

– vvv

Vær enda mer detaljert og vis alt vi kan analysere, selv om det ikke ser interessant ut i det hele tatt(f. eks.

-k

Vis kjernedrivere som håndterer hver enhet og også kjernemoduler som er i stand til å håndtere den. Slått på som standard når-v er gitt i normal modus forutgang. (Foreløpig fungerer bare På Linux med kernel 2.6 eller nyere.)

-x

Vis heksadesimal dump av standarddelen av konfigurasjonsområdet(de første 64 byte eller 128 byte For CardBus-broer).

-xxx

Vis heksadesimal dump av HELE PCI-konfigurasjonsområdet. Det er bare tilgjengelig for rot som FLERE PCI-enheter krasjer når du prøver å lese noen partsof config-plassen (denne oppførselen bryter sannsynligvis IKKE PCI-standarden, men det er i det minste veldig dumt). Imidlertid er slike enheter sjeldne, så du trengerbekymre deg mye.

– xxxx

Vis heksadesimal dump av utvidet (4096-byte) PCI konfigurasjon plass tilgjengelig PÅ PCI-X 2.0 OG PCI Express busser.

-b

Buss-sentrisk visning. Vis ALLE IRQ-tall og adresser som sett av kortene på PCI-bussen i stedet for som sett av kjernen.

-D

vis ALLTID PCI-domenenumre. Som standard undertrykker lspci dem på maskiner som bare har domene 0.

Alternativer for å kontrollere løse ID-ER til navn

– n

Vis PCI-leverandør og enhetskoder som tall i stedet for å se dem opp I PCI ID-listen.

– nn

Vis PCI-leverandør-og enhetskoder som både tall og navn.

-q

Bruk DNS til å spørre den sentrale PCI-ID-databasen hvis en enhet ikke finnes i den lokale pci.id-fil. HVIS DNS-spørringen lykkes, bufres resultatet i~/.pciids-cache og det gjenkjennes i etterfølgende løp selv om-q ikke er gitt lenger. Vennligst bruk denne bryteren i automatiserte skript baremed forsiktighet for å unngå overbelastning av databaseservere.

-qq

Samme som-q, men den lokale hurtigbufferen tilbakestilles.

-Q

Spør den sentrale databasen selv for oppføringer som gjenkjennes lokalt. Bruk dette hvis du mistenker at den viste oppføringen er feil.

Valg for valg av enheter

– s:] < buss >]:]] Vis bare enheter i det angitte domenet (hvis maskinen din har flere vertsbroer, kan de enten dele en felles buss nummerplass eller hver av demkan adressere et EGET PCI-domene; domener er nummerert fra 0 til ffff), buss (0 til ff), slot (0 til 1f) og funksjon (0 til 7). Hver komponent av deviceaddress kan utelates eller settes til»*», begge betyr «noen verdi». Alle tall er heksadesimale. «0:» betyr alle enheter på buss 0,» 0 » betyr alle funksjonene til enhet 0 på hvilken som helst buss,» 0.3 » velger tredje funksjon av enhet 0 på alle busser og «.4 » viser bare den fjerde funksjonen til hver enhet. – d: Vis bare enheter med spesifisert leverandør OG enhets-ID. BEGGE ID-ENE er gitt i heksadesimale OG kan utelates eller gis som»*», begge betyr «anyvalue».

Andre alternativer

– i < fil>Bruk < fil> som PCI ID-liste i stedet for /usr / share / hwdata / pci.ID. – p <fil > Bruk < fil > som kart OVER PCI ID håndteres av kjernemoduler. Som standard bruker lspci / lib / modules / kernel_version / modules.pcimap. Brukbare Til Linux-systemer med nylig nok modulverktøy. – M

Invoke bus mapping mode som utfører en grundig skanning av ALLE PCI-enheter, inkludert de bak feilkonfigurerte broer, etc. Dette alternativet gir meningsfyltresultater bare med en direkte maskinvaretilgangsmodus, som vanligvis krever root-privilegier. Vær oppmerksom på at bus mapper bare skanner PCI domain 0.

– versjonen Viser lspci versjon. Dette alternativet bør brukes frittstående.

PCI access options

PCI-verktøyene bruker PCI-biblioteket til å snakke MED PCI-enheter(se pcilib (7) for detaljer). Du kan bruke følgende alternativer for å påvirke densoppførsel:- En <metode> biblioteket støtter en rekke metoder for å få TILGANG TIL PCI-maskinvaren. Som standard bruker den den første tilgangsmetoden som er tilgjengelig, men du kan bruke dette alternativet for å endre denne beslutningen. Se-en hjelp for en liste over tilgjengelige metoder og deres beskrivelser. – O <param > = < verdi > bibliotekets oppførsel styres av flere navngitte parametere. Dette alternativet lar deg angi verdien av noen av parametrene. Bruk-o hjelp foren liste over kjente parametere og deres standardverdier. – H1

Bruk direkte maskinvaretilgang via Intel-konfigurasjonsmekanisme 1. (Dette er en forkortelse for-en intel-conf1.)

-H2

Bruk direkte maskinvaretilgang via Intel-konfigurasjonsmekanisme 2. (Dette er en forkortelse for-en intel-conf2.)

– F < fil > i Stedet for å få tilgang til ekte maskinvare, les listen over enheter og verdier av deres konfigurasjonsregistre fra den gitte filen produsert av en tidligere kjøring oflspci-x. Dette er veldig nyttig for analyse av brukerleverte feilrapporter, fordi du kan vise maskinvarekonfigurasjonen på noen måte du vil utenforstyrre brukeren med forespørsler om flere dumper. – G

Øke debug nivå av biblioteket .

Maskinlesbar Utgang

hvis du har tenkt å behandle utdataene fra lspci automatisk, må du bruke et av de maskinlesbare utdataformatene (- m,- vm, – vmm)som er beskrevet i denne delen. Alle andre formater er sannsynlig å endre mellom versjoner av lspci.

alle tall skrives alltid ut i heksadesimal. Hvis du vil behandle numeriske ID-ER i stedet for navn, må du legge til-n-bryteren.

Enkelt format (- m)

i det enkle formatet beskrives hver enhet på en enkelt linje, som er formatert som parametere egnet for å passere til et skallskript, dvs., verdierseparert av hvite rom, sitert og rømt om nødvendig. Noen av argumentene er posisjonelle: spor, klasse, leverandørnavn, enhetsnavn, delsystemleverandørnavn og delsystemnavn (de to siste er tomme hvis enheten ikke har delsystem); de resterende argumentene er alternativ-som: -rrev

Revisjonsnummer.

– Pprogif Programmeringsgrensesnitt. Den relative rekkefølgen av posisjonelle argumenter og alternativer er udefinert. Nye alternativer kan legges til i fremtidige versjoner, men de vil alltid ha et singleargument som ikke er skilt fra alternativet av noen mellomrom, slik at de lett kan ignoreres hvis de ikke gjenkjennes.

Detaljert format (- vmm)

detaljert utdata er en sekvens av poster atskilt med tomme linjer. Hver post beskriver en enkelt enhet av en sekvens av linjer, hver linje som inneholder asingle ‘tag: value’ par. Koden og verdien er atskilt med et enkelt tabulatortegn. Verken postene eller linjene i arecord er i en bestemt rekkefølge. Tags er case-sensitive.

følgende koder er definert:

Slot

navnet på sporet der enheten befinner seg (buss: enhet.funksjon). Denne koden er alltid den første i en post.

Klasse

navn på klassen.

Leverandør

navnet på leverandøren.

Enhet

navn på enheten.

SVendor-Navnet på delsystemleverandøren (valgfritt). SDevice Navn på delsystemet (valgfritt). PhySlot den fysiske sporet der enheten ligger (valgfritt, Kun Linux). Rev

Revisjonsnummer (valgfritt).

ProgIf

Programmeringsgrensesnitt (valgfritt).

Driver

kjernedriver som for øyeblikket håndterer enheten (valgfritt, Kun Linux).

Modul

Kjernemodul som rapporterer at Den er i stand Til å håndtere enheten (valgfritt, Kun Linux).

Nye koder kan legges til i fremtidige versjoner, så du bør stille ignorere eventuelle koder du ikke gjenkjenner.

Bakoverkompatibelt verbose format (- vm)

i denne modusen prøver lspci å være perfekt kompatibel med sine gamle versjoner. Det er nesten det samme som det vanlige verbose formatet, men Enhetskoden brukes til både sporet og enhetsnavnet, så det skjer to ganger i en enkelt post. Vennligst unngå å bruke dette formatet i noen ny kode.

Filer

/ usr / del / hwdata / pci.ids

en liste over alle KJENTE PCI ID-ER(leverandører, enheter, klasser og underklasser). Opprettholdt på http://pciids.sourceforge.net/, bruk update-pciids utilityå laste ned den nyeste versjonen. / usr / dele / hwdata / pci.ID.gz hvis lspci er kompilert med støtte for komprimering, er denne filen prøvd før pci.ID. ~/.pciids-cache ALLE ID er funnet I DNS-spørring modus bufres i denne filen.

Bugs

noen ganger kan lspci ikke dekode konfigurasjonsregistrene helt. Dette skjer vanligvis når ikke nok dokumentasjon var tilgjengelig forforfattere. I slike tilfeller skriver det i det minste <?> merk for å signalisere at det potensielt er noe mer å si. Hvis du vet detaljene, vil patcher selvfølgelig være velkommen.

Tilgang til det utvidede konfigurasjonsområdet støttes for øyeblikket bare av linux_sysfs-bakenden.

Se Også

setpci(8), oppdatering-pciids (8), pcilib (7)

Forfatter

PCI-Verktøyene vedlikeholdes av Martin Mares <[email protected] >.



+