====== lsusb ======

  * Objet : la commande lsusb
  * Niveau requis :{{tag>débutant avisé}}
  * Commentaires : //Pour lister l'ensemble des périphériques connectés aux bus USB du système//
  * Débutant, à savoir : [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !]] :-)
  * Suivi :  
    * Création par [[user>smolski]] le 02/08/2010 
    * Testé par [[user>milou]] le 19/09/2015
  * Commentaires sur le forum : [[https://debian-facile.org/viewtopic.php?pid=132117#p132117|C'est ici]]((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))

Voir : [[doc:systeme:ls|ls]] \\
La commande pour les périphériques PCI : [[doc:systeme:lspci|lspci]]

===== Introduction =====

La commande ''lsusb'' permet d'afficher des informations relatives aux bus USB du système et aux périphériques qui y sont connectés.

===== Syntaxe =====

Contrairement à une légende relativement tenace, la commande ''lsusb'', utilisée sans l'option ''-v'', **n'a pas** à être exécutée avec les privilèges du super-utilisateur ([[doc:systeme:superutilisateur|root]]) :

<code user>lsusb</code>
Donne par exemple : 
<code config retour de la commande>Bus 008 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 010 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 009 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 007 Device 003: ID 0781:b6b7 SanDisk Corp. 
Bus 007 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 005 Device 002: ID 046d:c31c Logitech, Inc. Keyboard K120
Bus 005 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 004 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 003 Device 002: ID 046d:c05a Logitech, Inc. M90/M100 Optical Mouse
Bus 003 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 006 Device 005: ID 2357:0109  
Bus 006 Device 002: ID 0951:1642 Kingston Technology DT101 G2
Bus 006 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 002 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 001 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub</code>

Par contre, pour fournir des informations détaillées, la commande ''lsusb'' doit ouvrir les fichiers du répertoire ''/proc/bus/usb'' en lecture/écriture. Vous **devez** donc être "root" pour pouvoir le faire :

<code root>lsusb -v</code>

===== Options =====

^  OPTION  ^  RÉSULTAT  ^
|**-v**, **%%--verbose%%** |Demander à **lsusb** d'être volubile et d'afficher des informations détaillées sur les périphériques. Cela inclut les descripteurs de configuration pour la vitesse actuelle des périphériques. Lorsqu'ils sont disponibles, les descripteurs de classe sont également affichés pour les classes de périphériques USB tels que les hubs, les périphériques audio, HID, de communications et les cartes à puce. |
|**-s** [[//bus//]:][//devnum//] |N'afficher que les périphériques indiqués par //bus// et/ou //devnum//. Les deux identifiants doivent être fournis sous forme décimale et peuvent être omis. |
|**-d** [//vendor//]:[//product//] |N'afficher que les périphériques dont on indique les identifiants du vendeur et du produit. Les deux identifiants doivent être fournis sous forme hexadécimale. |
|**-D** //device// |Ne pas balayer le répertoire ///proc/bus/usb//, afficher plutôt seulement les informations du périphérique dont on a indiqué le nom de fichier de périphérique. Le fichier de périphérique devrait être quelque chose comme ///proc/bus/usb/001/001//. Cette option permet d'afficher des informations détaillées comme avec l'option **-v** ; vous devez être le superutilisateur pour pouvoir l'utiliser. |
|**-t** |Demander à **lsusb** d'afficher la hiérarchie physique des périphériques USB sous forme d'arbre. |
|**-V**, **%%--version%%** |Afficher les informations de version et quitter. |

===== Liens utiles =====

  * Manuel de l'administrateur Linux (2007) : https://delafond.org/traducmanfr/man/man8/lsusb.8.html
  * (en) //The USB ID Repository// (dépôt de référence pour les identifiants USB) : https://usb-ids.gowdy.us/