NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | FILES | SEE ALSO | AUTHORS | COLOPHON

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

NAME         top

       usb-devices - print USB device details

SYNOPSIS         top

       usb-devices

DESCRIPTION         top

       usb-devices is a (bash) 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

       /sys/bus/usb/devices/usb*
              The part of the sysfs tree the script walks through to
              assemble the printed information.
       /proc/bus/usb/devices
              Location where the usb/devices file can normally be found for
              Linux kernels before 2.6.31, if usbfs is mounted.
       /sys/kernel/debug/usb/devices
              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 <greg@kroah.com>
       Randy Dunlap <rdunlap@xenotime.net>
       Frans Pop <elendil@planet.nl>

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 2017-07-05.  If you dis‐
       cover 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-008                    23 June 2009                  usb-devices(1)