man7.org > Linux > man-pages

Linux/UNIX system programming training

lsusb(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | RETURN VALUE | SEE ALSO | AUTHOR | COLOPHON 

lsusb(8)                   Linux USB Utilities                  lsusb(8)

NAME         top

       lsusb - list USB devices

SYNOPSIS         top

       lsusb [ options ]

DESCRIPTION         top

       lsusb is a utility for displaying information about USB buses in
       the system and the devices connected to them. It uses udev's
       hardware database to associate a full human-readable name to the
       vendor ID and the product ID.

OPTIONS         top

       -v, --verbose
              Tells lsusb to be verbose and display detailed information
              about the devices shown.  This includes configuration
              descriptors for the device's current speed.  Class
              descriptors will be shown, when available, for USB device
              classes including hub, audio, HID, communications, and
              chipcard. Can be used with the -t option.

       -s [[bus]:][devnum]
              Show only devices in specified bus and/or devnum.  Both
              IDs are given in decimal and may be omitted.

       -d [vendor]:[product]
              Show only devices with the specified vendor and product
              ID.  Both IDs are given in hexadecimal.

       -D device
              Do not scan the /dev/bus/usb directory, instead display
              only information about the device whose device file is
              given.  The device file should be something like
              /dev/bus/usb/001/001.  This option displays detailed
              information like the -v option; you must be root to do
              this.

       -t, --tree
              Tells lsusb to dump the physical USB device hierarchy as a
              tree. Verbosity can be increased twice with the -v option.

       -V, --version
              Print version information on standard output, then exit
              successfully.

RETURN VALUE         top

       If the specified device is not found, a non-zero exit code is
       returned.

SEE ALSO         top

       lspci(8), usbview(8).

AUTHOR         top

       Thomas Sailer, <sailer@ife.ee.ethz.ch>.

COLOPHON         top

       This page is part of the usbutils (USB utilities for Linux)
       project.  Information about the project can be found at 
       ⟨http://www.linux-usb.org/⟩.  If you have a bug report for this
       manual page, send it to linux-usb@vger.kernel.org.  This page was
       obtained from the project's upstream Git repository
       ⟨https://github.com/gregkh/usbutils.git⟩ on 2024-06-14.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2024-01-04.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

usbutils-015                11 February 2019                    lsusb(8)

Pages that refer to this page: usb-devices(1)

HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI