lspci(8) Les utilitaires PCI lspci(8) NOM lspci - Lister tous les peripheriques PCI SYNOPSIS lspci [options] DESCRIPTION lspci est un utilitaire pour afficher des informations sur les bus PCI dans le systeme et les peripheriques qui y sont connectes. Il montre une courte liste de peripheriques par defaut. Utilisez les options decrites ci-dessous pour demander une sortie plus detaillee ou une sortie destinee a etre interpretee par d'autres programmes. Si vous voulez rapporter des bogues de pilotes de peripheriques PCI ou dans lspci lui-meme, merci d'y inclure la sortie de << lspci -vvx >> ou encore mieux << lspci -vvxx >> (toutefois, voir ci-dessous pour d'eventuelles mises en garde). Quelques parties de la sortie, specialement dans les modes tres detailles, ne sont probablement intelligibles que par des informaticiens experimentes dans le domaine de PCI. Pour des definitions exactes des champs, merci de consulter les specifications PCI ou les fichiers joints header.h et /usr/include/linux/pci.h. L'acces a certaines parties de l'espace de configuration PCI est restreint au superutilisateur sur de nombreux systemes d'exploitation, ce qui limite les caracteristiques de lspci disponibles pour les utilisateurs non privilegies. Cependant, lspci essaie de faire de son mieux pour afficher le plus d'informations disponibles et marquer les autres informations avec le texte . OPTIONS Modes d'affichage basiques -m Extraire les donnees du dispositif PCI dans un format retrocompatible lisible par une machine. Voir ci-dessous pour les details. -mm Extraire les donnees d'un peripherique PCI sous une forme lisible par les machines pour etre facilement partageable par les scripts. Voir ci-dessous pour les details. -t Afficher un diagramme sous forme d'arbre contenant tous les bus, ponts, peripheriques et les connexions entre eux. Options d'affichage -v Etre bavard et afficher des informations detaillees sur tous les peripheriques. -vv Etre tres bavard et afficher encore plus de details. Ce niveau comprend tout ce qui est juge utile. -vvv Etre encore plus bavard et afficher tout ce qui peut l'etre, meme si cela ne semble pas du tout interessant (par exemple, les regions de la memoire non definies). -k Afficher les pilotes du noyau qui gerent chaque peripherique ainsi que les modules du noyau capables de le gerer. Active par defaut lorsque v est specifie dans la sortie en mode normal. (Ne fonctionne actuellement que sous Linux avec un noyau 2.6 ou plus recent.) -x Afficher le vidage en hexadecimal de la partie standard de l'espace de configuration (les premiers 64 octets ou 128 octets pour les ponts CardBus). -xxx Afficher le vidage hexadecimal de tout l'espace de configuration PCI. Cela n'est valable que pour le superutilisateur, etant donne que plusieurs peripheriques PCI plantent lorsque vous essayez de lire des parties de l'espace de configuration (ce comportement ne viole probablement pas le standard PCI, mais c'est tres stupide). Toutefois, de tels peripheriques sont rares, donc vous n'avez pas besoin de trop vous en inquieter. -xxxx Afficher le vidage hexadecimal de l'espace de configuration PCI etendu (4096-octets) disponible sur PCI-X 2.0 et les bus PCI Express. -b Vue centree sur le bus. Afficher tous les numeros d'IRQ (<< Interrupt ReQuest >>, interruption materielle) et les adresses comme vues par les cartes du bus PCI au lieu de les montrer vues par le noyau. -D Toujours afficher les numeros de domaines PCI. lspci les supprime par defaut sur les machines qui n'ont que le domaine 0. -P Identifier les peripheriques PCI par le chemin a travers chaque pont et non par numero de bus. -PP Identifier les peripheriques PCI par le chemin a travers chaque pont, en affichant le numero de bus ainsi que le numero du peripherique. Options pour controler la resolution d'ID en noms -n Afficher les codes des appareils et fabricants PCI sous forme de nombres au lieu de les chercher dans la liste d'identifiants PCI. -nn Afficher les codes appareils et fabricants PCI a la fois sous forme de nombres et de noms. -q Utiliser le DNS pour interroger la base de donnees centrale des identifiants PCI si un peripherique n'a pas ete trouve dans le fichier pci.ids local. Si la requete DNS reussit, le resultat est mis en cache dans ~/.pciids-cache et sera reconnu dans les appels ulterieurs, meme si l'option -q n'est pas fournie. Merci de bien vouloir utiliser avec parcimonie cette option dans des scripts automatises afin d'eviter la surcharge des serveurs de bases de donnees. -qq Identique a -q, sauf que le cache local est reinitialise. -Q Interroger la base de donnees centrale meme pour les entrees reconnues localement. Utilisez cette option si vous suspectez que l'entree affichee est erronee. Options de selection des peripheriques -s [[[[]:]]:][][.[]] Montrer seulement les peripheriques du domaine indique (si votre machine possede plusieurs ponts d'hotes, soit ils peuvent partager le meme numero de bus, soit chacun d'eux peut s'adresser a un domaine PCI ; les domaines sont numerotes de 0 a ffff), le bus (0 a ff), le peripherique (0 a 1f) et la fonction (0 a 7). Chaque element de l'adresse du peripherique peut etre omis ou defini a << * >>, les deux signifiant << valeur quelconque >>. Tous les numeros sont hexadecimaux. Par exemple, << 0 >> : signifie tous les peripheriques sur le bus 0, << 0 >> signifie toutes les fonctions du peripherique 0 de tous les bus, << 0.3 >> selectionne la troisieme fonction du peripherique 0 sur tous les bus et << .4 >> montre seulement la quatrieme fonction de chaque peripherique. -d []:[][:[:]] Afficher seulement les peripheriques dont les identifiants de classe, fabricant, peripherique et interface de programmation sont specifies. Les identifiants sont indiques sous forme hexadecimale et peuvent etre omis ou definis sous la forme << * >>, les deux signifiant << valeur quelconque >>. L'identifiant de classe peut contenir des caracteres << x >> qui signifient << tout chiffre >>. Autres options -i Utiliser comme liste d'identifiant PCI au lieu de /usr/share/hwdata/pci.ids. -p Utiliser comme carte des identifiants PCI pris en charge par le noyau. lspci utilise /lib/modules/version_noyau/modules.pcimap par defaut. Cela n'est utilise que sur les systemes Linux avec des outils de module assez recents. -M Invoquer le mode de correspondance de bus qui effectue un balayage exhaustif de tous les peripheriques PCI, y compris ceux qui se trouvent derriere des ponts mal configures, etc. Cette option ne donne des resultats significatifs qu'avec un acces direct au materiel, ce qui necessite generalement les privileges du superutilisateur. Le mappeur de bus examine le domaine 0 par defaut. Vous pouvez utiliser l'option -s pour choisir un domaine different. --version Afficher la version de lspci. Cette option doit etre utilisee seule. Options d'acces PCI Les utilitaires PCI utilisent la bibliotheque PCI pour dialoguer avec les peripheriques PCI (voir pcilib(7) pour plus de details). Vous pouvez utiliser les options suivantes pour modifier son comportement : -A Cette bibliotheque prend en charge des methodes diverses pour acceder au materiel PCI. Par defaut, c'est la premiere methode d'acces disponible qui est utilisee, mais vous pouvez utiliser cette option pour surcharger cette decision. Consulter -A help pour une liste des methodes disponibles et leur description. -O = Le comportement de la bibliotheque est controle par plusieurs parametres nommes. Cette option permet de definir la valeur de chaque parametre. Utiliser -O help pour une liste des parametres et leur valeur par defaut. -H1 Utiliser l'acces direct au materiel a l'aide du mecanisme 1 de la configuration d'Intel (Intel configuration mechanism 1). (Il s'agit d'un raccourci de -A intel-conf1.) -H2 Utiliser l'acces direct au materiel a l'aide du mecanisme 2 de la configuration Intel. (Cela est un raccourci de -A intel-conf2.) -F Plutot que d'acceder vraiment au materiel, lire la liste des peripheriques et les valeurs de leurs registres de configurations a partir du fichier fourni produit par une execution precedente de lspci -x. Cela est tres pratique pour l'analyse des rapports de bogues fournis par les utilisateurs, car vous pouvez afficher la configuration materielle de la maniere que vous le voulez sans deranger l'utilisateur en lui reclamant plus de vidage. -G Accroitre le niveau de debogage de la bibliotheque. SORTIE LISIBLE PAR LES MACHINES Si vous avez l'intention de traiter automatiquement la sortie de lspci, veuillez utiliser l'un des formats de sortie lisible par les machines (-m, -vm, -vmm) decrits dans cette section. Tous les autres formats sont susceptibles d'etre modifies entre deux versions de lspci. Tous les nombres sont toujours affiches sous forme hexadecimale. Si vous voulez traiter les identifiants numeriques plutot que les noms, veuillez ajouter l'option -n. Format simple (-m) Dans le format simple, chaque peripherique est decrit sur une seule ligne, formatee sous forme de parametres appropries a leur passage a un script d'interpreteur, c'est-a-dire des valeurs separees par des espaces, entourees de guillemets et echappees si necessaire. Certains arguments sont positionnels : emplacement (slot), classe, nom du fabricant, nom du peripherique, nom du fabricant du sous-systeme et nom du sous-systeme (les deux derniers arguments sont vides si le peripherique n'a pas de sous-systeme) ; les arguments restants sont de type option : -rrev Numero de revision. -pprogif Interface de programmation. L'ordre relatif des arguments positionnels et des options n'est pas defini. De nouvelles options peuvent etre introduites dans de futures versions, mais elles auront toujours un seul parametre accole (sans espace entre l'option et le parametre), ainsi ils peuvent etre facilement ignores s'ils ne sont pas reconnus. Format detaille (-vmm) La sortie detaillee est une sequence d'enregistrements separes par des lignes vides. Chaque enregistrement decrit un seul peripherique dans une sequence de lignes, chaque ligne contenant une seule paire << etiquette : valeur >>. L'etiquette et la valeur sont separees par un simple caractere de tabulation. Ni les enregistrements, ni les lignes contenant un enregistrement ne sont dans un ordre particulier. Les etiquettes sont sensibles a la casse. Les etiquettes suivantes sont definies : Slot Le nom de l'emplacement ou se situe le peripherique ([domaine:]bus:peripherique.fonction). Cette etiquette est toujours en premier dans un enregistrement. Class Nom de la classe. Vendor Nom du fabricant. Device Nom du peripherique. SVendor Nom du fabricant du sous-systeme (optionnel). SDevice Nom du sous-systeme (optionnel). PhySlot L'emplacement physique ou se situe le peripherique (optionnel, uniquement sous Linux). Rev Numero de revision (optionnel). ProgIf Interface de programmation (optionnel). Driver Le pilote du noyau gerant actuellement le peripherique (optionnel, seulement sous Linux). Module Module du noyau indiquant qu'il est capable de gerer le peripherique (optionnel, seulement sous Linux). Il peut y avoir plusieurs lignes avec cette etiquette. NUMANode Noeud NUMA auquel est connecte ce peripherique (optionnel, seulement sous Linux). IOMMUGroup Groupe IOMMU auquel appartient ce peripherique (optionnel, Linux seulement). De nouvelles etiquettes peuvent etre ajoutees dans des versions futures, vous devriez ignorer silencieusement toute etiquette que vous ne reconnaissez pas. Format bavard retro-compatible (-vm) Dans ce mode, lspci essaie d'etre parfaitement compatible avec ses anciennes versions. Cela est similaire au format detaille classique, mais l'etiquette peripherique est utilisee a la fois pour l'emplacement et le nom de peripherique, donc cela apparait deux fois dans un enregistrement unique. Merci d'eviter l'utilisation de ce format dans tout nouveau code. FICHIERS /usr/share/hwdata/pci.ids Une liste de tous les identifiants PCI connus (fabricants, peripheriques, classes et sous classes). Entretenue sur https://pci-ids.ucw.cz/. Utilisez l'outil update-pciids pour telecharger la version la plus recente. /usr/share/hwdata/pci.ids.gz Si lspci est compile avec la prise en charge de la compression, ce fichier est essaye avant pci.ids. ~/.pciids-cache Tous les identifiants trouves dans le mode requete DNS sont mis en cache dans ce fichier. BOGUES Quelquefois, lspci n'est pas capable de decoder entierement les registres de configuration. Cela survient generalement quand il n'y avait pas assez de documentation disponible pour les auteurs. Dans ces cas, il affiche au moins le symbole pour signaler qu'il y a potentiellement quelque chose de plus a dire. Si vous connaissez ces details, les correctifs sont bien sur bienvenus. L'acces a l'espace de configuration etendue n'est actuellement pris en charge que par le dorsal linux_sysfs. VOIR AUSSI setpci(8), pci.ids(5), update-pciids(8), pcilib(7) AUTEUR Les utilitaires PCI sont entretenus par Martin Mares . TRADUCTION La traduction francaise de cette page de manuel a ete creee par Alain Portal et bubu Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . pciutils-3.11.1 25 fevrier 2024 lspci(8)