usb-devices(1) — Linux manual page


usb-devices(1)             Linux USB Utilities            usb-devices(1)

NAME         top

       usb-devices - print USB device details

SYNOPSIS         top


DESCRIPTION         top

       usb-devices is a shell script that can be used to display details
       of USB buses in the system and the devices connected to them.

       The output of the script is similar to the usb/devices file
       available either under /proc/bus (if usbfs is mounted), or under
       /sys/kernel/debug (if debugfs is mounted there). The script is
       primarily intended to be used if the file is not available.

       In contrast to the usb/devices file, this script only lists
       active interfaces (those marked with a "*" in the usb/devices
       file) and their endpoints.

       Be advised that there can be differences in the way information
       is sorted, as well as in the format of the output.

RETURN VALUE         top

       If sysfs is not mounted, a non-zero exit code is returned.

FILES         top

              The part of the sysfs tree the script walks through to
              assemble the printed information.

              Location where the usb/devices file can normally be found
              for Linux kernels before 2.6.31, if usbfs is mounted.

              Location where the usb/devices file can normally be found
              for Linux kernel 2.6.31 and later, if debugfs is mounted.

SEE ALSO         top

       lsusb(8), usbview(8).

AUTHORS         top

       Greg Kroah-Hartman <>

       Randy Dunlap <>

       Frans Pop <>

COLOPHON         top

       This page is part of the usbutils (USB utilities for Linux)
       project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug report for this
       manual page, send it to  This page was
       obtained from the project's upstream Git repository
       ⟨⟩ on 2023-06-23.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2023-03-01.)  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

usbutils-014                  23 June 2009                usb-devices(1)