lsusb(8)

๐Ÿ“ฆ
version 020 ยท 6 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, centos-stream 10, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

๐Ÿ’– lsusb(8) ๐Ÿ’– Linux USB Utilities โœจ

๐ŸŽ€ NAME

lsusb - list USB devices

๐Ÿฆ‹ SYNOPSIS

lsusb [ options ]

๐Ÿ’… DESCRIPTION

okay so lsusb is the utility you use to look at the USB buses in your system and all the devices plugged into them ๐Ÿ”Œโœจ it's giving detective energy. It uses udev's hardware database to match the vendor ID and the product ID to a full human-readable name, so you get actual names instead of just random hex ๐Ÿ™ˆ

๐ŸŒธ OPTIONS

  • -v, --verbose โ€” main character mode ๐Ÿ’… tells lsusb to be verbose and show detailed info about each device. This includes the configuration descriptors for the device's current speed. Class descriptors get shown too, when they're available, for USB device classes like hub, audio, HID, communications, and chipcard. You can use it with the -t option ๐Ÿซถ
  • -s [[bus]:][devnum] โ€” only show devices on a specific bus and/or devnum. Both IDs are in decimal, and you can skip either one ๐Ÿ“
  • -d [vendor]:[product] โ€” only show devices matching a specific vendor and product ID. Both IDs are in hexadecimal ๐Ÿ”ฅ
  • -D device โ€” okay this one's a little different ๐Ÿ‘€ it skips scanning the /dev/bus/usb directory and only shows info about the device whose device file you give it. That file should look something like /dev/bus/usb/001/001. This option shows detailed info like -v does, and you must be root to use it ๐Ÿ’€
  • -t, --tree โ€” dumps the physical USB device hierarchy as a tree ๐ŸŒณ and you can crank up the verbosity by using -v twice ๐Ÿงš
  • -V, --version โ€” prints the version info to standard output, then exits successfully โœจ

๐Ÿ”ฎ RETURN VALUE

if the device you asked for isn't found, you get a non-zero exit code ๐Ÿ˜ญ

๐Ÿซง SEE ALSO

lspci(8), usbview(8). ๐Ÿ’œ

๐ŸŒˆ AUTHOR

Thomas Sailer, <sailer@ife.ee.ethz.ch>. the OG ๐Ÿ‘‘


bestie that's the whole lsusb(8) page ๐ŸŽ€ usbutils, 11 February 2019, lsusb(8) ๐Ÿ’– stay curious and go touch some grass (or your USB ports) ๐Ÿฆ‹

๐Ÿ“ฆ where this page comes from