lspci(8) Utilitaile PCI lspci(8) NUME lspci - listeaza toate dispozitivele PCI SINOPSIS lspci [opiuni] DESCRIERE lspci este un instrument pentru afiarea informaiilor despre magistralele PCI din sistem i despre dispozitivele conectate la acestea. In mod implicit, se afieaza o lista scurta de dispozitive. Utilizai opiunile descrise mai jos pentru a solicita fie o ieire mai abundenta, fie o ieire destinata analizei de catre alte programe. Daca avei de gand sa raportai erori ale controlorilor de dispozitive PCI sau ale lui lspci insui, va rugam sa includei rezultatul <> sau inca i mai bine <> (totui, consultai mai jos pentru posibile restricii). Unele pari ale rezultatului, in special in modurile foarte descriptive, sunt, probabil, inteligibile doar pentru hackerii PCI experimentai. Pentru definiiile exacte ale campurilor, va rugam sa consultai fie specificaiile PCI, fie fiierele de includere header.h i /usr/include/linux/pci.h. Accesul la unele pari ale spaiului de configurare PCI este restricionat pentru root pe multe sisteme de operare, astfel incat caracteristicile lspci disponibile pentru utilizatorii normali sunt limitate. Cu toate acestea, lspci face tot posibilul sa afieze cat mai multe informaii disponibile i sa marcheze toate celelalte informaii cu textul (access denied). OPIUNI Modurile de afiare de baza -m Afieaza datele dispozitivelor PCI intr-un format de citire pentru maina compatibil cu versiunile anterioare. A se vedea mai jos pentru detalii. -mm Afieaza datele dispozitivelor PCI intr-un format lizibil de catre maina pentru a fi uor de analizat de catre scripturi. A se vedea mai jos pentru detalii. -t Afieaza o diagrama arborescenta care conine toate magistralele, punile, dispozitivele i conexiunile dintre acestea. Opiuni de afiare -v Face o descriere mai ampla i afieaza informaii detaliate despre toate dispozitivele. -vv Face o descriere foarte clara i afieaza mai multe detalii. Acest nivel include tot ceea ce se considera util. -vvv Face i mai multa descriere i afieaza tot ceea ce putem analiza, chiar daca nu pare deloc interesant (de exemplu, regiuni de memorie nedefinite). -k Afieaza controlorii de nucleu care gestioneaza fiecare dispozitiv i modulele de nucleu capabile sa le gestioneze. Activata in mod implicit atunci cand se da -v in modul normal de ieire; (in prezent funcioneaza numai pe Linux cu nucleul 2.6 sau mai nou). -x Afieaza o extragere hexazecimala a parii standard a spaiului de configurare (primii 64 de octei sau 128 de octei pentru punile CardBus). -xxx Afieaza o extragere hexazecimala a intregului spaiu de configurare PCI. Este disponibila numai pentru root, deoarece mai multe dispozitive PCI clacheaza atunci cand incercai sa citii unele pari ale spaiului de configurare (acest comportament probabil ca nu incalca standardul PCI, dar este cel puin foarte stupid). Cu toate acestea, astfel de dispozitive sunt rare, aa ca nu trebuie sa va facei prea multe griji. -xxxx Afieaza o extragere hexazecimala a spaiului de configurare PCI extins (4096 de octei) disponibil pe magistralele PCI-X 2.0 i PCI Express. -b Vizualizare centrata pe magistrala. Afieaza toate numerele i adresele IRQ aa cum sunt vazute de placile de pe magistrala PCI in loc sa fie vazute de nucleu. -D Afieaza intotdeauna numerele de domeniu PCI. In mod implicit, lspci le suprima pe mainile care au doar domeniul 0. -P Identifica dispozitivele PCI in funcie de ruta prin fiecare punte, in loc de numarul de magistrala. -PP Identifica dispozitivele PCI in funcie de ruta prin fiecare punte, indicand numarul de magistrala, precum i numarul dispozitivului. Opiuni pentru a controla transformarea ID-urilor in nume -n Afieaza codurile fabricantului PCI i ale dispozitivului PCI sub forma de numere in loc sa le caute in lista de ID-uri PCI. -nn Afieaza codurile fabricantului PCI i ale dispozitivelor atat sub forma de numere, cat i de nume. -q Utilizeaza DNS pentru a interoga baza de date de ID-uri PCI centrala in cazul in care un dispozitiv nu este gasit in fiierul local pci.ids. Daca interogarea DNS reuete, rezultatul este stocat in fiierul $XDG_CACHE_HOME/pci-ids i este recunoscut in execuiile ulterioare, chiar daca opiunea -q nu mai este data. Va rugam sa utilizai aceasta opiune in interiorul scripturilor automate numai cu prudena pentru a evita supraincarcarea serverelor de baze de date. -qq La fel precum -q, dar fiierul de stocare local este reiniializat. -Q Interogheaza baza de date centrala chiar i pentru intrarile care sunt recunoscute la nivel local. Utilizai aceasta opiune daca banuii ca intrarea afiata este greita. Opiuni pentru selectarea dispozitivelor -s [[[[]:]]:][][.[ie>]] Afieaza numai dispozitivele din domeniul specificat (in cazul in care maina dvs. are mai multe puni gazda, acestea pot impari un spaiu comun de numere de magistrala sau fiecare dintre ele poate adresa un domeniu PCI propriu; domeniile sunt numerotate de la 0 la ffff), magistrala (de la 0 la ff), dispozitivul (de la 0 la 1f) i funcia (de la 0 la 7). Fiecare componenta a adresei dispozitivului poate fi omisa sau stabilita la ,,*", ambele insemnand ,,orice valoare". Toate numerele sunt in hexazecimal. De exemplu, ,,0:" inseamna toate dispozitivele de pe magistrala 0, ,,0" inseamna toate funciile dispozitivului 0 pe orice magistrala, ,,0.3" selecteaza a treia funcie a dispozitivului 0 pe toate magistralele, iar ,,.4" afieaza doar a patra funcie a fiecarui dispozitiv. -d []:[][:[:a-prog>]] Afieaza numai dispozitivele cu fabricantul, dispozitivul, ID-ul clasei i interfaa de programare specificate. ID-urile sunt date in hexazecimal i pot fi omise sau date ca ,,*", ambele insemnand ,,orice valoare". ID-ul de clasa poate conine caractere ,,x", care inseamna ,,orice cifra". Alte opiuni -i ier> Utilizeaza ier> ca lista de ID-uri PCI in loc de fiierul ,,/usr/share/hwdata/pci.ids". -p ier> Utilizeaza ier> ca harta a ID-urilor PCI gestionate de modulele nucleului. In mod implicit, <> utilizeaza fiierul ,,/lib/modules/versiune_nucleu/modules.pcimap". Se aplica numai la sistemele Linux cu instrumente de module suficient de recente. -M Invoca modul de cartografiere a magistralei, care efectueaza o scanare amanunita a tuturor dispozitivelor PCI, inclusiv a celor care se afla in spatele unor puni neconfigurate, etc. Aceasta opiune ofera rezultate semnificative numai cu un mod de acces direct la hardware, care necesita, de obicei, privilegii de root. In mod implicit, cartograful de magistrala scaneaza domeniul. Putei utiliza opiunea -s pentru a selecta un alt domeniu. --version Afieaza versiunea lspci. Aceasta opiune ar trebui sa fie utilizata de sine statator (ca opiune unica a <>). Opiuni de acces PCI Utilitaile PCI utilizeaza biblioteca PCI pentru a comunica cu dispozitivele PCI (a se vedea pcilib(7) pentru detalii). Putei utiliza urmatoarele opiuni pentru a influena comportamentul acesteia: -A Biblioteca accepta o varietate de metode de accesare a hardware-ului PCI. In mod implicit, aceasta utilizeaza prima metoda de acces disponibila, dar putei utiliza aceasta opiune pentru a anula aceasta decizie. Consultai -A help pentru o lista a metodelor disponibile i descrierile acestora. -O = Comportamentul bibliotecii este controlat de mai muli parametri numii. Aceasta opiune permite stabilirea valorii oricaruia dintre aceti parametri. Utilizai -O help pentru o lista a parametrilor cunoscui i a valorilor lor implicite. -H1 Utilizeaza accesul direct la hardware prin mecanismul de configurare Intel 1; (aceasta este o prescurtare pentru -A intel-conf1). -H2 Utilizeaza accesul hardware direct prin mecanismul de configurare Intel 2; (aceasta este o prescurtare pentru -A intel-conf2). -F ier> In loc sa acceseze hardware real, citete lista de dispozitive i valorile registrelor de configurare ale acestora din fiierul dat, produs de o execuie anterioara a comenzii <>. Acest lucru este foarte util pentru analiza rapoartelor de eroare furnizate de utilizator, deoarece putei afia configuraia hardware in orice mod dorii fara a deranja utilizatorul cu cereri de mai multe extrageri. -G Crete nivelul de depanare al bibliotecii. IEIRE LIZIBILA DE CATRE MAINA Daca intenionai sa procesai automat ieirea lui <>, va rugam sa utilizai unul dintre formatele de ieire lizibile de catre maina (-m, -vm, -vmm) descrise in aceasta seciune. Toate celelalte formate sunt susceptibile de a se modifica intre versiunile <>. Toate numerele sunt intotdeauna afiate in hexazecimal. Daca dorii sa procesai ID-uri numerice in loc de nume, va rugam sa adaugai opiunea -n. Formatul simplu (-m) In formatul simplu, fiecare dispozitiv este descris pe o singura linie, care este formatata ca parametru adecvat pentru a fi transmis unui script shell, adica valori separate prin spaii albe, incadrate de ghilimele i eludate daca este necesar. Unele dintre argumente sunt poziionale: slot, clasa, numele fabricantului, numele dispozitivului, numele fabricantului subsistemului i numele subsistemului (ultimele doua sunt goale daca dispozitivul nu are un subsistem); restul argumentelor sunt de tip opiune: -rrev Numarul de revizuire. -pinterfaa-progf Interfaa de programare. Ordinea relativa a argumentelor poziionale i a opiunilor este nedefinita. In versiunile viitoare pot fi adaugate noi opiuni, dar acestea vor avea intotdeauna un singur argument care nu va fi separat de opiune prin spaii, astfel incat sa poata fi uor ignorate daca nu sunt recunoscute. Formatul descriptiv (-vmm) Ieirea descriptiva este o secvena de inregistrari separate de linii goale. Fiecare inregistrare descrie un singur dispozitiv printr-o secvena de linii, fiecare linie coninand o singura pereche ,,eticheta: valoare". eticheta i valoarea sunt separate de un singur caracter de tabulare. Nici inregistrarile, nici liniile din cadrul unei inregistrari nu se afla intr-o anumita ordine. Etichetele sunt sensibile la majuscule i minuscule. Sunt definite urmatoarele etichete: Slot Numele slotului in care se afla dispozitivul ([domeniu:]magistrala:dispozitiv.funcie). Aceasta eticheta este intotdeauna prima dintr-o inregistrare. Class Numele clasei. Vendor Numele fabricantului. Device Numele dispozitivului. SVendor Numele fabricantului subsistemului (opional). SDevice Numele subsistemului (opional). PhySlot Slotul fizic in care se afla dispozitivul (opional, numai pentru Linux). Rev Numarul de revizie (opional). ProgIf Interfaa de programare (opional). Driver Controlorul de nucleu care gestioneaza in prezent dispozitivul (opional, numai pentru Linux). Module Modulul nucleului care raporteaza ca este capabil sa gestioneze dispozitivul (opional, numai pentru Linux). Pot aparea mai multe linii cu aceasta eticheta. NUMANode Nodul NUMA la care este conectat acest dispozitiv (opional, numai pentru Linux). IOMMUGroup Grupul IOMMU din care face parte acest dispozitiv (opional, numai pentru Linux). In versiunile viitoare pot fi adaugate noi etichete, aa ca ar trebui sa ignorai linitit orice etichete pe care nu le recunoatei. Format descriptiv compatibil cu versiunile anterioare (-vm) In acest mod, <> incearca sa fie perfect compatibil cu vechile sale versiuni. Este aproape la fel ca formatul descriptiv obinuit, dar eticheta Device este utilizata atat pentru slot, cat i pentru numele dispozitivului, astfel incat apare de doua ori intr-o singura inregistrare. Va rugam sa evitai utilizarea acestui format in orice cod nou. FIIERE /usr/share/hwdata/pci.ids O lista a tuturor ID-urilor PCI cunoscute (fabricani, dispozitive, clase i subclase). Meninuta la https://pci-ids.ucw.cz/, utilizai instrumentul update-pciids pentru a descarca cea mai recenta versiune. /usr/share/hwdata/pci.ids.gz Daca <> este compilat cu suport pentru comprimare, acest fiier este incercat inainte de fiierul ,,pci.ids". $XDG_CACHE_HOME/pci-ids Toate ID-urile gasite in modul de interogare DNS sunt stocate in acest fiier. ERORI Uneori, <> nu este capabil sa decodifice complet registrele de configurare. Acest lucru se intampla de obicei atunci cand autorii nu au avut la dispoziie suficienta documentaie. In astfel de cazuri, acesta imprima cel puin marcajul pentru a semnala ca este posibil sa mai fie ceva de spus. Daca cunoatei detaliile, coreciile vor fi bineineles binevenite. Accesul la spaiul de configurare extins este in prezent oferit doar de catre modulul linux_sysfs. CONSULTAI I setpci(8), pci.ids(5), update-pciids(8), pcilib(7) AUTOR Utilitaile PCI sunt intreinute de Martin Mares . TRADUCERE Traducerea in limba romana a acestui manual a fost facuta de Remus- Gabriel Chelu Aceasta traducere este documentaie gratuita; citii Licena publica generala GNU Versiunea 3 sau o versiune ulterioara cu privire la condiii privind drepturile de autor. NU se asuma NICIO RESPONSABILITATE. Daca gasii erori in traducerea acestui manual, va rugam sa trimitei un e-mail la . pciutils-3.12.0 5 aprilie 2024 lspci(8)